TangYuan使用教程-SQL服务及标签介绍

#6.1 SQL服务及标签介绍

---

什么是SQL服务？SQL服务的本质是一个服务，包含了一系列的SQL语句和XML标签。SQL服务分为基本SQL服务和组合SQL服务，基本服务就是一条完整的SQL语句和标签构成的服务，好比：

<selectOne id="getUserById">
		SELECT * from user WHERE user_id = #{user_id}
</selectOne>

而组合SQL服务是由一系列的基本服务和标签组成，是一个服务集合，好比：

<sql-service id="insertAndGet" txRef="tx_01" dsKey="ds">
	<!-- 插入一条记录 -->
	<insert rowCount="{nCount}" incrementKey="{user_id}">
		INSERT into user(user_name, user_age, create_time) VALUES(#{user_name}, #{user_age}, #{create_time|now()})
	</insert>
	<!-- 打印一条日志 -->
	<log message="插入一条用户数据: {user_name}, nCount: {nCount}, user_id: {user_id}"/>
	<!-- 查询用户列表 -->
	<selectSet resultKey="{users}">
		SELECT * from user
	</selectSet>
	<!-- 返回 -->
	<return>
		<property value="{users}"/>
	</return>
</sql-service>

SQL服务的编写位置：全部的SQL服务都须要写在SQL服务文件中：如：tangyuan-sqlservices.xml，详细规范可参考tangyuan-sqlservices.xsd文件，该文件位于src\main\java\org\xson\tangyuan\xml\schema

对于一个SQL服务，SQL语句自己没有什么新奇的内容，下面更多的是介绍SQL服务的标签。Tangyuan中的sqlservices标签分为两类，一类是服务标签，表示此标签表明了一个SQL服务，应用程序能够直接访问和调用，包括以下标签：

标签	说明
selectSet	查询一个结果集，如select * from user<br />若是在sql-service内使用，将变成一个辅助标签，不能被单独调用，而且部分属性的使用将会有些变化。
selectOne	查询一条记录，如select * from user where id = 1<br />若是在sql-service内使用，将变成一个辅助标签，不能被单独调用，而且部分属性的使用将会有些变化。
selectVar	查询一条记录中一个指定的字段，如select name from user where id = 1<br />若是在sql-service内使用，将变成一个辅助标签，不能被单独调用，而且部分属性的使用将会有些变化。
update	更新操做，如update user set name ......<br />若是在sql-service内使用，将变成一个辅助标签，不能被单独调用，而且部分属性的使用将会有些变化。
delete	删除，如DELETE FROM user where ...<br />若是在sql-service内使用，将变成一个辅助标签，不能被单独调用，而且部分属性的使用将会有些变化。
insert	插入，如INSERT into user ....<br />若是在sql-service内使用，将变成一个辅助标签，不能被单独调用，而且部分属性的使用将会有些变化。
sql-service	组合SQL服务标签，包含一些其余的服务标签和辅助标签，但不能包含自身标签
sql	定义一些公共的SQL语句，供其余SQL服务调用，此标签服务不能单独调用，也不能包含在其余标签内。

另外一类是辅助标签，经过这些辅助标签，可实现一些复杂的服务功能，有以下标签：

标签	说明
if	条件控制标签，好比：<if test="{x} &lt; 0">
elseif	条件控制标签，须要和if标签配合使用，好比：<elseif test="{x} &lt; 1">
else	条件控制标签，须要和elseif标签配合使用，好比：<else>
foreach	循环遍历标签，好比：<br /><foreach collection="{ids}" index="{i}">
return	结果返回标签，只能在sql-service内使用，好比：<br /><return value="{set}" />
exception	异常标签，当条件检测失败的时候会跑出异常，中断服务，只能在sql-service内使用，<br />如：<exception test="{x} &gt; 1" code="1" message="错误提示信息" />
setvar	变量设置标签，在XML中给一个变量赋值，只能在sql-service内使用，好比：<br /><setvar key="{x}" value="1" />
log	日志打印标签，用于服务流程的检测和日志的输出，只能在sql-service内使用，好比：<br /><log level="info" message="日志信息" />
call	服务调用标签，在XML中调用其余服务，包括SQL服务，只能在sql-service内使用。
transGroup	事务组表，表示该标签内的SQL将会运行在一个新的事务当中，只能在sql-service内使用。
include	SQL包含标签，能够引入以前sql标签订义的SQL语句内容。