oracle xsql 详解(一)
创建数据库用户并分配权限，这里就不详细说了。我已经有一个本地数据库的用户huchen.
在用户下创建表
create table XSQL_EMPLOYEE
(
ID NUMBER,
LASTNAME VARCHAR2(15),
FIRSTNAME VARCHAR2(15),
JOB VARCHAR2(30)
)
tablespace USERS
pctfree 10
initrans 1
maxtrans 255
storage
(
initial 64K
minextents 1
maxextents unlimited
);
插入数据：
values (1, 'chen', 'hu', 'coder');
insert into xsql_employee (ID, LASTNAME, FIRSTNAME, JOB)
values (2, 'lijun', 'zhang', 'Director ');
设置数据库连接
在XSQLConfig.xml文件中找到connection节点，并根据你的数据库设置如下：
<username>huchen</username>
<password>huchen</password>
<dburl>jdbc:oracle:thin:@localhost:1521:hcdb</dburl>
<driver>oracle.jdbc.driver.OracleDriver</driver>
<autocommit>false</autocommit>
</connection>
2）第一个xsql page
创建一个java web项目，在src目录下添加XSQLconfig.xml
在WebRoot目录下增加一个文件夹xsql，并在xsql文件夹下添加文件test1.xsql，在该文件下添加代码：
<?xml-stylesheet type=text/xsl" href="helloworld.xsl"?>
<page connection="xsql_test" xmlns:xsql="urn:oracle-xsql">
<xsql:query>
select * from xsql_employee
</xsql:query>
</page>
访问http://localhost:8088/xsql_test/xsql/test1.xsql
将看到如下页面：
如果你的查询没匹配任何行，你又想在这种情况下执行另一个查询，你可以用
xsql:no-rows-query标签，他必须使用在xsql:query标签之下。如：
<?xml-stylesheet type=text/xsl" href="helloworld.xsl"?>
<page connection="xsql_test" xmlns:xsql="urn:oracle-xsql">
<xsql:query>
select * from xsql_employee where id = 1111
<xsql:no-rows-query>
select * from xsql_employee
</xsql:no-rows-query>
</xsql:query>
</page>
2.writing xsql pages
1)查询数据库
xsql:query 标签是用来从数据库检索信息的。在前面的例子中，我们都简单的把一个sql放在该标签中，这个标签中只能放select 语句，如果你放一个insert语句在该标签中，那么xsql
page processor将拒绝它。
在上面的例子中，查询语句查出的结果被转变成xml标签替代了xsql:query标签，表中的列名在每一行中替换成了xml元素的标签名字。如果你不喜欢列名，你可以用”select id as
employee_id 来替代。
特别是当你的输出列名中有特殊字符的时候，如：
select id, to_char(hiredate, ‘YYYY-MON’)
from xsql_employee
如果你这么写，你将得到一个错误，第二列包含了”(“，这是xml标签名不能允许的，所以你需要给他一个别名，如：
select id, to_char(hiredate, ‘YYYY-MON’) as hiredate from xsql_employee
你同样可以设置程序自己生成的rowset
和row标签，使用xsql:query的row-element 和 rowset-element 属性来设置。如：
<xsql:query connection="xsql_test" xmlns:xsql="urn:oracle-xsql" row-element="EMPLOYEES" rowset-element="EMPLOYEE_LIST">
select * from xsql_employee
</xsql:query>
运行结果如下：
如果你需要在同一个page里使用多个xsql:query，则他们需要包含在一个跟节点下。因为一个xml文档必须要有一个根节点。
如：
<?xml-stylesheet type=text/xsl" href="helloworld.xsl"?>
<page connection="xsql_test" xmlns:xsql="urn:oracle-xsql">
<xsql:query>
select * from xsql_employee
</xsql:query>
<xsql:query>
select * from xsql_employee
</xsql:query>
</page>
3.xsql parameters
xsql分为4种参数:
a.request parameters
b.page-private parameters
c.stylesheet parameters
d.session parameters
e.cookies
后面将说明各种类型的参数的用处。但是在此之前，我们的第一步是知道怎样去关联参数和参数值怎么在xml中呈现的。
1)关联参数
xsql page processor 通过寻找{@paramName}来解析xsql 页的参数,当他找到这种形式的参数时，它将用参数的值来替换{@paramName}。
下面来看一个例子：
<page xmlns:xsql="urn:oracle-xsql" connection="{@conn}">
<xsql:query>
select {@fields} from {@tables}
</xsql:query>
</page>
如果你键入url不带参数，你将会的到报错信息。
键入以下url，将返回表中所有行
http://localhost:8088/xsql_test/xsql/very-unsecure.xsql?conn=xsql_test&fields=*&tables=xsql_employee
参数必须放在xsql：动作标签内，不然xsql解析器不会去替换参数的。
如果你把刚才xsql文档改为如下：
<page xmlns:xsql="urn:oracle-xsql" connection="{@conn}">
<xsql:query>
select {@fields} from {@tables}
</xsql:query>
<conn>{@conn}</conn>
<fields>{@fields}</fields>
<tables>{@tables}</tables>
</page>
2)显示参数
在前面的例子中，我们知道了如何关联参数，但是如果你想要参数包括在输出中，需要使用<xsql:include-param> 或者<xsql:include-request-params>
例：
<page xmlns:xsql="urn:oracle-xsql" connection="{@conn}">
<xsql:include-param name="conn" />
<xsql:include-param name="fields" />
<xsql:include-param name="tables" />
</page>
这个操作将输出所有的参数到xml中。
在这种情况下，你必须为每一个显示的参数写代码，如果你想显示所有的参数，你可以用<xsql:include-request-params>标签
如：
<page xmlns:xsql="urn:oracle-xsql" connection="{@conn}">
<xsql:include-request-params/>
</page>
3)参数类型
a)request parameters
在上面的例子中，我们用到的就是请求参数。这很好理解，请求参数是是http请求的一部分。刚才的例子中我们用到的是http的 get 方法获得的request，post方法也可以获得参数。例：
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>post param form</title>
</head>
<body>
<form action="xsql/very-unsecure.xsql" method="post">
<table border="0">
<tr>
<td>connection:</td>
<td><input type="text" name="conn" /></td>
</tr>
<tr>
<td>fields:</td>
<td><input type="text" name="fields" /></td>
</tr>
<tr>
<td>tables:</td>
<td><input type="text" name="tables" /></td>
</tr>
<tr>
<td colspan="2" align="center">
<input name="submitButton" type="submit" value="select" />
</td>
</tr>
</table>
</form>
</body>
</html>
这个页面将获得同样的结果。
b)Page-Private Parameters
page-private parameters 是当前页面的私有的参数，不像session parameters和cookie parameters能够跨多个页面。
你可以通过<xsql:set-page-param>标签来明确的在你的页面中设置私有参数。
设置方法有两种,第一种直接指定参数值，第二种通过sql返回一个参数值。
如：
<page xmlns:xsql="urn:oracle-xsql" connection="xsql_test">
<xsql:set-page-param name="lastname" value="chen"/>
<xsql:set-page-param name="job">
select job from xsql_employee where lastname='{@lastname}'
</xsql:set-page-param>
<xsql:include-param name="lastname"/>
<xsql:include-param name="job"/>
<xsql:query>
select * from xsql_employee where job='{@job}'
</xsql:query>
</page>
c)session parameters
略
d)cookie
略
4)默认参数
在上面的例子中，我们的xsql依赖于参数的设定或者是request参数，有时，我们希望给他一个默认值。
如:
<page fields="*" conn="xsql_test" tables="xsql_employee" xmlns:xsql="urn:oracle-xsql" connection="{@conn}">
<xsql:include-request-params />
<xsql:query>
select {@fields} from {@tables}
</xsql:query>
</page>
输入http://localhost:8088/xsql_test/xsql/very-unsecure.xsql
5)使用绑定变量
目前，我们使用的的都是通过{@param}这种方式引用参数，这种方式在解析的时候只是简单的字符串的替换，这种方式在某些情况下是很方便的，但是他并不会对sql进行优化.
让我们先来看下下面的例子：
<page job="coder" firstname="hu" xmlns:xsql="urn:oracle-xsql" connection="xsql_test">
<xsql:query bind-params="job firstname">
select * from xsql_employee where job=? and firstname=?
</xsql:query>
</page>
这里我们没有用{@param}这种形式，而用了问号。在解析的时候，问号被按照<bind-params>属性中列出的参数顺序替代。
绑定变量使得优化sql语句变的简单，当你没有绑定变量的时候，sql优化器只能一次优化一个sql语句，优化器不知道将会有很多很多按照这种结构写出的sql，但是用绑定变量方式，sql优化器将预计会有很多同样结构的sql，在上面的例子中，优化器将知道会有很多按照职位和姓来查找员工.
