创建数据库用户并分配权限，这里就不详细说了。我已经有一个本地数据库的用户huchen.

在用户下创建表

插入数据：

设置数据库连接

在XSQLConfig.xml文件中找到connection节点，并根据你的数据库设置如下：

2）第一个xsql page

创建一个java web项目，在src目录下添加XSQLconfig.xml

在WebRoot目录下增加一个文件夹xsql，并在xsql文件夹下添加文件test1.xsql，在该文件下添加代码：

访问http://localhost:8088/xsql_test/xsql/test1.xsql

将看到如下页面：

如果你的查询没匹配任何行，你又想在这种情况下执行另一个查询，你可以用

xsql:no-rows-query标签，他必须使用在xsql:query标签之下。如：

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 属性来设置。如：

运行结果如下：

如果你需要在同一个page里使用多个xsql:query，则他们需要包含在一个跟节点下。因为一个xml文档必须要有一个根节点。

如：

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}。

下面来看一个例子：

如果你键入url不带参数，你将会的到报错信息。

键入以下url，将返回表中所有行

http://localhost:8088/xsql_test/xsql/very-unsecure.xsql?conn=xsql_test&fields=*&tables=xsql_employee

参数必须放在xsql：动作标签内，不然xsql解析器不会去替换参数的。

如果你把刚才xsql文档改为如下：

2)显示参数

在前面的例子中，我们知道了如何关联参数，但是如果你想要参数包括在输出中，需要使用<xsql:include-param> 或者<xsql:include-request-params>

例：

这个操作将输出所有的参数到xml中。

在这种情况下，你必须为每一个显示的参数写代码，如果你想显示所有的参数，你可以用<xsql:include-request-params>标签

如：

3)参数类型

a)request parameters

在上面的例子中，我们用到的就是请求参数。这很好理解，请求参数是是http请求的一部分。刚才的例子中我们用到的是http的 get 方法获得的request，post方法也可以获得参数。例：

这个页面将获得同样的结果。

b)Page-Private Parameters

page-private parameters 是当前页面的私有的参数，不像session parameters和cookie parameters能够跨多个页面。

你可以通过<xsql:set-page-param>标签来明确的在你的页面中设置私有参数。

设置方法有两种,第一种直接指定参数值，第二种通过sql返回一个参数值。

如：

c)session parameters

略

d)cookie

略

4)默认参数

在上面的例子中，我们的xsql依赖于参数的设定或者是request参数，有时，我们希望给他一个默认值。

如:

输入http://localhost:8088/xsql_test/xsql/very-unsecure.xsql

5)使用绑定变量

目前，我们使用的的都是通过{@param}这种方式引用参数，这种方式在解析的时候只是简单的字符串的替换，这种方式在某些情况下是很方便的，但是他并不会对sql进行优化.

让我们先来看下下面的例子：

这里我们没有用{@param}这种形式，而用了问号。在解析的时候，问号被按照<bind-params>属性中列出的参数顺序替代。

绑定变量使得优化sql语句变的简单，当你没有绑定变量的时候，sql优化器只能一次优化一个sql语句，优化器不知道将会有很多很多按照这种结构写出的sql，但是用绑定变量方式，sql优化器将预计会有很多同样结构的sql，在上面的例子中，优化器将知道会有很多按照职位和姓来查找员工.