jstl sql tag
SQL标签库
JSTL提供了与数据库相关操作的标签，可以直接从页面上实现数据库操作的功能，在开发小型网站是可以很方便的实现数据的读取和操作。本章将详细介绍这些标签的功能和使用方法。
SQL标签库从功能上可以划分为两类：设置数据源标签、SQL指令标签。
引入SQL标签库的指令代码为：
<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>
9.4.1 设置数据源
使用<sql:setDataSource>标签可以实现对数据源的配置。
【语法1】：直接使用已经存在的数据源。
<sql:setDataSource dataSource=”dataSource”[var=”name”]
[scope=”page|request|session|application”]/>
【语法2】：使用JDBC方式建立数据库连接。
<sql:setDataSource driver=”driverClass” url=”jdbcURL”
user=”username”
password=”pwd”
[var=”name”]
[scope=”page|request|session|application”]/>
【参数说明】：见表9-15
表9-15 <sql:DataSource>标签属性说明
|
参数名 |
说明 |
EL |
类型 |
必须 |
默认值 |
|
dataSource |
数据源 |
是 |
String Javax.sql.DataSource |
否 |
无 |
|
driver |
使用的JDBC驱动 |
是 |
String |
否 |
无 |
|
url |
连接数据库的路径 |
是 |
String |
否 |
无 |
|
user |
连接数据库的用户名 |
是 |
String |
否 |
无 |
|
password |
连接数据库的密码 |
是 |
String |
否 |
无 |
|
var |
指定存储数据源的变量名 |
否 |
String |
否 |
无 |
|
scope |
指定数据源存储的JSP范围 |
否 |
String |
否 |
page |
提示：是否必须是相对的，比如说如果使用数据源则，driver、url等就不再被使用。如果使用JDBC则要用到driver、url、user、password属性。
例如连接SQL Server需要进行如下配置：
Driver="com.microsoft.jdbc.sqlserver.SQLServerDriver"
url=” jdbc:microsoft:sqlserver://localhost:1433; DatabaseName=pubs"
user=”sa”
password=””
使用<fmt:setDataSource>配置的代码如下：
<fmt:setDataSource driver=”com.microsoft.jdbc.sqlserver.SQLServerDriver”
url=”jdbc.microsoft:sqlserver://localhost:1433;DatabaseName=pubs”
user=”sa”
password=””>
如果连接其他数据库，只须把相对应的项修改即可。
提示：可以把数据连接的配置存入session中，如果再用到数据库连接只须配置使用DataSource属性。
9.4.2 SQL操作标签
JSTL提供了<sql:query>、<sql:update>、<sql:param>、<sql:dateParam>和<sql:transaction>这5个标签，通过使用SQL语言操作数据库，实现增加、删除、修改等操作。下面将介绍这5个标签的功能和使用方式。
1．<sql:query>标签
<sql:query>标签用来查询数据。
【语法1】：
<sql:query sql=”sqlQuery” var=”name” [scope=”page|request|session|application”]
[dataSource=”dateSource”]
[maxRow=”maxRow”]
[startRow=”starRow”]/>
【语法2】：
<sql:query var=”name” [scope=”page|request|session|application”]
[dataSource=”dateSource”]
[maxRow=”maxRow”]
[startRow=”starRow”]
>
sqlQuery
</sql:query>
【属性说明】：见表9-16。
表9-16 <sql:query>标签属性说明
|
参数名 |
说明 |
EL |
类型 |
必须 |
默认值 |
|
sql |
查询数据的SQL语句 |
是 |
String |
是 |
无 |
|
dataSource |
数据源对象 |
是 |
String Javax.sql.DataSoutce |
否 |
无 |
|
maxRow |
设定最多可以暂存数据的行数 |
是 |
String |
否 |
无 |
|
startRow |
设定从那一行数据开始 |
是 |
String |
否 |
无 |
|
var |
指定存储查询结果的变量名 |
否 |
String |
是 |
无 |
|
scope |
指定结果的作用域 |
否 |
String |
否 |
page |
使用<sql:query>必须指定数据源，dataSource是可选的，如果未给定该属性标签会在page范围内查找是否设置过数据源，如果没有找到将抛出异常。
一般情况下使用<sql:setDateSource>标签设置一个数据源存储在session范围中，当需要数据库连接时使用dataSource属性并实现数据库的操作。
<sql:query>的var属性是必须的用来存放结果集，如果没有指定scope范围则默认为page，即在当前页面我们可以随时输出查询结果。结果集有一系列的属性如表9-17所示。
maxRows和startRow属性用来操作结果集，使用SQL语句首先吧数据放入内存中，检查是否设置了startRow属性，如果设置了就从starRow指定的那一行开始取maxRows个值，如果没有设定则从第一行开始取。
表9-17 结果集参数说明
|
属性名 |
类型 |
说明 |
|
rowCount |
int |
结果集中的记录总数 |
|
Rows |
Java.util.Map |
以字段为索引查询的结果 |
|
rowsByIndex |
Object[] |
以数字为作索引的查询结果 |
|
columnNames |
String[] |
字段名称数组 |
|
limitedByMaxRows |
boolean |
是否设置了maxRows属性来限制查询记录的数量 |
提示：limitedByMaxRows用来判断程序是否收到maxRows属性的限制。并不是说设定了maxRows属性，得到结果集的limitedByMaxRows的属性都为true，当取出的结果集小于maxRows时，则maxRows没有对结果集起到作用此时也为false。例如可以使用startRow属性限制结果集的数据量。
结果集的作用就是定义了数据在页面中的显示方式。下面给出了结果集每个属性的作用。
q rowCount属性。该属性统计结果集中有效记录的量，可以使用于大批量数据分页显示。
q Rows属性。等到每个字段对应的值。返回的结果为：字段名={字段值···}
q rowsByIndex属性。常用得到数据库中数据的方式，从有效行的第一个元素开始遍历，到最后一个有效行的最后一个元素。
q columnNames属性。用于得到数据库中的字段名。
q limitedByMaxRows属性。用于判断是否受到了maxRows的限制。
【示例代码】：代码9.20给出了配置数据库连接，和使用<sql:query>查询数据以及结果集属性的使用。
代码9.20 数据库示查询示例：sqldemo01.jsp
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>
<%@ page contentType="text/html;charset=GBK"%>
<html>
<head>
<title>JSTL: SQL标签</title>
</head>
<body >
<h3>SQL标签库</h3>
<hr>
<sql:setDataSource driver="com.microsoft.jdbc.sqlserver.SQLServerDriver"
url="jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=pubs"
user="sa" password="" />
<sql:query var="result" sql="select * from person" maxRows="2" startRow="1"/>
结果集的实质是：${result}<br>
得到的行数为：${result.rowCount}<br>
是否收到了maxRows的限制：${result.limitedByMaxRows}
<hr>
<table border="1" align="center">
<tr><c:forEach var="columnName" items="${result.columnNames}">
<td>
<c:out value="${columnName}"/>
</td>
</c:forEach> </tr>
<c:forEach var="row" items="${result.rowsByIndex}">
<tr>
<c:forEach var="column" items="${row}">
<td><c:out value="${column}"/></td>
</c:forEach>
</tr>
</c:forEach>
</table>
</body>
</html>
【代码解析】：
（1）配置数据源。使用<sql:dataSource>标签配置数据源，因为只共本页使用因此存储在默认的page范围中。
（2）使用<sql:query>标签进行数据库查询，并定义了maxRows和startRow属性。并把结果集存储于作用于page范围的result变量。使用${result}输出可以发现结果集就是一个ResultImpl类。
提示：在进行数据源配置时程序不会检查数据库连接是否配置正确，直接根据设定的数据库及连接访问，如果没有找到则抛出操作的表异常，因此要放如<c:catch></c:catch>同时在编写程序时一定要注意数据源是否配置正确。
（3）使用结果集的rowCount属性得到记录的总量。代码为：
${result.rowCount}
（4）使用结果集的limitedMaxRows属性判断是否收到maxRows设定的影响。代码为：
${result.limitedMaxRows}
（5）从结果集中得到数据库中定义的所有的字段。${result.columnnames}得到的结果是一个字符串数组，因此需要使用<c:forEach>循环输出。代码如下：
<c:forEach var="columnName" items="${result.columnNames}">
<c:out value="${columnName}"/>
</c:forEach>
（6）从结果集中得到所有的值。首先要遍历每一行，然后遍历每一行中的元素，因此需要循环嵌套。代码如下：
<c:forEach var="columnName" items="${result.columnNames}">
<c:out value="${columnName}"/>
</c:forEach>
<c:forEach var="row" items="${result.rowsByIndex}">
<c:forEach var="column" items="${row}">
<c:out value="${column}"/></td>
</c:forEach>
</c:forEach>
提示：在代码解析中省略了html元素表格等标签的元素，本示例适用于任何数据库表，只要把数据库的URL、使用的JDBC进行相应的配置和操作的数据表名进行相应的修改即可看到结果。
程序运行结果如图9.23所示。
图9.23 查询操作结果图
2．<sql:update>标签
<sql:update>用来实现操作数据库如：使用create、update、delete和insert等SQL语句，并返回影响记录的条数。
【语法1】：SQL语句放在标签属性中。
<sql:update sql=”SQL语句” [var=”name”] [scope=”page|request|session|application”]
[dateSource=”dateSource”]/>
【语法2】：SQL语句放在标签体内。
<sql:update [var=”name”] [scope=”page|request|session|application”]
[dateSource=”dateSource”]
>
SQL语句
</sql:update>
【参数说明】：见表9-18。
表9-18 <sql:update>标签属性说明
|
参数名 |
说明 |
EL |
类型 |
必须 |
默认值 |
|
sql |
查询数据的SQL语句 |
是 |
String |
是 |
无 |
|
dataSource |
数据源对象 |
是 |
String Javax.sql.DataSoutce |
否 |
无 |
|
var |
指定存储查询结果的变量名 |
否 |
String |
是 |
无 |
|
scope |
指定结果的作用域 |
否 |
String |
否 |
page |
提示：<sql:update>标签的属性同<sql:query>标签的属性相比只减少了maxRows和startRow2个属性。其他参数用法一样。
使用<sql:update>可以实现数据表的创建、插入数据、更行数据、删除数据。使用时只须在标签中放入正确的SQL语句即可，同时要捕获可能产生的异常。本节只对一个简单的插入操作进行说明。
【示例代码】：代码9.21实现了创建一个表、实现数据的插入。
代码9.21 数据库创建、数据插入示例：sqldemo02.jsp
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>
<%@ page contentType="text/html;charset=GBK"%>
<html>
<head>
<title>JSTL: SQL标签</title>
</head>
<body >
<h3>SQL标签库</h3>
<hr>
<sql:setDataSource driver="com.microsoft.jdbc.sqlserver.SQLServerDriver"
url="jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=pubs"
user="sa" password="" />
实现数据库表的创建<br>
<sql:update var="result1">
create table c_user (
id int primary key ,
name varchar(80),
sex varchar(80),
)
</sql:update>
<c:catch var="error">
<sql:update var="result2" >
insert c_user values(05,'Linda','女')
insert c_user values(01,'Rom','男' )
</sql:update>
影响的记录数为：<c:out value="${result2}"></c:out>
</c:catch>
<c:out value="${error}"></c:out><br>
<hr>
</body>
</html>
【代码解析】：
（1）配置数据源。
（2）使用<sql:update>标签创建一个新表。
（3）向表中插入两行数据。
提示：本示例也没有针对固定的表进行操作，在使用时直接运行即可，如果使用的是其他数据库，需要更改数据源配置和SQL语句部分修改。
程序运行结果如图9.24所示。
图9.24 sqldemo02.jsp运行效果
从图9.24中可以发现，使用<sql:update>的var属性记录结果是不准确的，尤其是在一个标签中使用多条sql语句只能记录下第一条。在数据库中创建的c_user表如图9.25所示。
图9.25 SQL表的内容
3．<sql:param>标签
<sql:param>标签用于动态的为SQL语句设定参数，同<sql:query>标签共同使用。可以防止SQL注入作用类似于java.sql.PreparedStatement。
【语法1】：
<sql:param value=”value”/>
【语法2】：
<sql:param>
Value
</sql:param>
【参数说明】：
value的作用为SQL中的参数赋值。
【使用示例】：
<sql:query var=”result”>
select * from person where 序号=？
<sql:query>
4．<sql:dateParam>标签
<sql:dataParam>标签主要用于为SQL标签填充日期类型的参数值。
【语法】：
<sql:dateParam value=”date”[type=”timestamp|time|date”]/>
【参数说明】：
q value属性：java.util.Date类型的参数。
q type属性：指定填充日期的类型timestamp（全部日期和时间）、time（填充的参数为时间）、date（填充的参数为日期）。
5．<sql:transaction>标签
<sql:transaction>标签提供了数据操作的一种安全机制（即事务回滚），当操作数据库的某条SQL语句发生异常时，取消<sql:transaction>标签体中的所有操作，恢复原来的状态，重新对数据库进行操作。
【语法】：
<sql:transaction [dataSource=”dataSource”]
[isolation=”read_committed|read_uncommitted|repeatable|serializable”]
>
<sql:query>
<sql:uptade>
</sql:transation>
