TangYuan之SQL服务及标签介绍

6.1 SQL服务及标签介绍

---

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

        SELECT * from user WHERE user_id = #{user_id}

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

    
    
        INSERT into user(user_name, user_age, create_time) VALUES(#{user_name}, #{user_age}, #{create_time|now()})
    
    
    
    
    
        SELECT * from user
    
    
    
        
    

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

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

标签	说明
if	条件控制标签，比如：
elseif	条件控制标签，需要和if标签配合使用，比如：
else	条件控制标签，需要和elseif标签配合使用，比如：
foreach	循环遍历标签，比如：
return	结果返回标签，只能在sql-service内使用，比如：
exception	异常标签，当条件检测失败的时候会跑出异常，中断服务，只能在sql-service内使用， 如：
setvar	变量设置标签，在XML中给一个变量赋值，只能在sql-service内使用，比如：
log	日志打印标签，用于服务流程的检测和日志的输出，只能在sql-service内使用，比如：
call	服务调用标签，在XML中调用其他服务，包括SQL服务，只能在sql-service内使用。
transGroup	事务组表，表示该标签内的SQL将会运行在一个新的事务当中，只能在sql-service内使用。
include	SQL包含标签，可以引入之前sql标签定义的SQL语句内容。