6.2 基本SQL服務(wù)標簽
1. selectSet標簽
示例：
<selectSet id="getUserList" dsKey="ds" txRef="tx_01">
select * from user
</selectSet>
說明
上面示例表示我們定義了一個ID為getUserList的基本服務(wù)，服務(wù)使用ds所代表的數(shù)據(jù)源靡砌，使用tx_01所定義的事務(wù)厕宗，執(zhí)行一條查詢語句骗炉，返回結(jié)果為一個查詢結(jié)果集厕鹃，默認的數(shù)據(jù)結(jié)構(gòu)為List<XCO>.
Schema設(shè)計圖
selectSet節(jié)點屬性說明
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| id | 服務(wù)標識,需要唯一察蹲；作為輔助標簽此項無意義，可省略 | Y | 用戶定義 |
| dsKey | 所使用的數(shù)據(jù)源標識采驻，如果用戶沒有則使用之前設(shè)置的默認數(shù)據(jù)源。 | N | 用戶定義 |
| txRef | 所使用的事務(wù)定義標識，如果用戶未指定，則根據(jù)setDefaultTransaction所定義的規(guī)則進行默認匹配，如果還未匹配上跟磨，系統(tǒng)則會跑出異常僵蛛。 | N | 用戶定義 |
| resultKey | 作為輔助標簽時候使用，后續(xù)說明 | N | 用戶定義 |
| resultType | 返回類型，7. 數(shù)據(jù)映射 | N | 用戶定義 |
| resultMap | 數(shù)據(jù)映射，7. 數(shù)據(jù)映射 | N | 用戶定義 |
| fetchSize | 每次查詢的最大獲取條數(shù)旺隙，默認255 | N | 用戶定義 |
| cacheUse | 緩存使用,此項將在緩存一節(jié)詳細說明 | N | 用戶定義 |
2. selectOne標簽
示例：
<selectOne id="getUser" dsKey="ds" txRef="tx_01">
select * from user where id = #{id}
</selectOne>
說明
上面示例表示我們定義了一個ID為getUser的基本服務(wù)凰兑，服務(wù)使用ds所代表的數(shù)據(jù)源，使用tx_01所定義的事務(wù)审丘，執(zhí)行一條查詢語句吏够，返回結(jié)果為一條數(shù)據(jù)庫行記錄，默認的數(shù)據(jù)結(jié)構(gòu)為XCO.
Schema設(shè)計圖
selectOne節(jié)點屬性說明
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| id | 服務(wù)標識,需要唯一滩报；作為輔助標簽此項無意義锅知，可省略 | Y | 用戶定義 |
| dsKey | 所使用的數(shù)據(jù)源標識，如果用戶沒有則使用之前設(shè)置的默認數(shù)據(jù)源脓钾。 | N | 用戶定義 |
| txRef | 所使用的事務(wù)定義標識售睹，如果用戶未指定，則根據(jù)setDefaultTransaction所定義的規(guī)則進行默認匹配可训，如果還未匹配上昌妹，系統(tǒng)則會跑出異常。 | N | 用戶定義 |
| resultKey | 作為輔助標簽時候使用沉噩，后續(xù)說明 | N | 用戶定義 |
| resultType | 返回類型捺宗，7. 數(shù)據(jù)映射 | N | 用戶定義 |
| resultMap | 數(shù)據(jù)映射柱蟀，7. 數(shù)據(jù)映射 | N | 用戶定義 |
| fetchSize | 每次查詢的最大獲取條數(shù)川蒙，默認255 | N | 用戶定義 |
| cacheUse | 緩存使用,此項將在緩存一節(jié)詳細說明 | N | 用戶定義 |
3. selectVar標簽
示例：
<selectVar id="getName" dsKey="ds" txRef="tx_01">
select name from user where id = #{id}
</selectVar>
說明
上面示例表示我們定義了一個ID為getName的基本服務(wù)，服務(wù)使用ds所代表的數(shù)據(jù)源长已，使用tx_01所定義的事務(wù)畜眨，執(zhí)行一條查詢語句，返回結(jié)果為name字段术瓮，返回結(jié)果的數(shù)據(jù)類型視字段的數(shù)據(jù)庫數(shù)據(jù)類型而定康聂。上述例子中name在數(shù)據(jù)庫中的數(shù)據(jù)類型為VARCHAR(32)，因此對應(yīng)的Java類型為String胞四。
Schema設(shè)計圖
selectVar節(jié)點屬性說明
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| id | 服務(wù)標識,需要唯一恬汁；作為輔助標簽此項無意義，可省略 | Y | 用戶定義 |
| dsKey | 所使用的數(shù)據(jù)源標識辜伟，如果用戶沒有則使用之前設(shè)置的默認數(shù)據(jù)源氓侧。 | N | 用戶定義 |
| txRef | 所使用的事務(wù)定義標識，如果用戶未指定导狡，則根據(jù)setDefaultTransaction所定義的規(guī)則進行默認匹配约巷，如果還未匹配上，系統(tǒng)則會跑出異常旱捧。 | N | 用戶定義 |
| resultKey | 作為輔助標簽時候使用独郎，后續(xù)說明 | N | 用戶定義 |
| cacheUse | 緩存使用,此項將在緩存一節(jié)詳細說明 | N | 用戶定義 |
4. update標簽
示例：
<update id="updateName" dsKey="ds" txRef="tx_02">
update user set name = '張三' where id = #{id}
</update>
說明
上面示例表示我們定義了一個ID為updateName的基本服務(wù)踩麦，服務(wù)使用ds所代表的數(shù)據(jù)源，使用tx_01所定義的事務(wù)氓癌，執(zhí)行一條更新語句谓谦，返回結(jié)果為其影響行數(shù)。
Schema設(shè)計圖
update節(jié)點屬性說明
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| id | 服務(wù)標識,需要唯一贪婉；作為輔助標簽此項無意義茁计，可省略 | Y | 用戶定義 |
| dsKey | 所使用的數(shù)據(jù)源標識，如果用戶沒有則使用之前設(shè)置的默認數(shù)據(jù)源谓松。 | N | 用戶定義 |
| txRef | 所使用的事務(wù)定義標識星压，如果用戶未指定，則根據(jù)setDefaultTransaction所定義的規(guī)則進行默認匹配鬼譬，如果還未匹配上娜膘，系統(tǒng)則會跑出異常沃暗。 | N | 用戶定義 |
| rowCount | 作為輔助標簽時候使用况褪，后續(xù)說明 | N | 用戶定義 |
| cacheClear | 緩存使用,此項將在緩存一節(jié)詳細說明 | N | 用戶定義 |
5. delete標簽
示例：
<delete id="deleteUser" dsKey="ds" txRef="tx_02">
delete from user where where id = #{id}
</delete>
說明
上面示例表示我們定義了一個ID為deleteUser的基本服務(wù)土铺，服務(wù)使用ds所代表的數(shù)據(jù)源火鼻，使用tx_01所定義的事務(wù)舱呻，執(zhí)行一條刪除語句媒峡，返回結(jié)果為其影響行數(shù)嚷炉。
Schema設(shè)計圖
delete節(jié)點屬性說明
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| id | 服務(wù)標識,需要唯一捅厂；作為輔助標簽此項無意義避乏，可省略 | Y | 用戶定義 |
| dsKey | 所使用的數(shù)據(jù)源標識爷耀，如果用戶沒有則使用之前設(shè)置的默認數(shù)據(jù)源。 | N | 用戶定義 |
| txRef | 所使用的事務(wù)定義標識拍皮，如果用戶未指定歹叮，則根據(jù)setDefaultTransaction所定義的規(guī)則進行默認匹配，如果還未匹配上铆帽，系統(tǒng)則會跑出異常咆耿。 | N | 用戶定義 |
| rowCount | 作為輔助標簽時候使用，后續(xù)說明 | N | 用戶定義 |
| cacheClear | 緩存使用,此項將在緩存一節(jié)詳細說明 | N | 用戶定義 |
6. insert標簽
示例：
<insert id="insertUser" dsKey="ds" txRef="tx_02">
insert into user(name, age) values('李四', 26);
</insert>
說明
上面示例表示我們定義了一個ID為insertUser的基本服務(wù)爹橱，服務(wù)使用ds所代表的數(shù)據(jù)源萨螺，使用tx_01所定義的事務(wù)，執(zhí)行一條插入語句愧驱，返回結(jié)果可以是操作的影響行數(shù)慰技，也可以是插入操作后數(shù)據(jù)庫返回的自增主鍵，具體情況參照insert標簽resultType屬性的設(shè)置冯键。
Schema設(shè)計圖
insert節(jié)點屬性說明
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| id | 服務(wù)標識,需要唯一惹盼；作為輔助標簽此項無意義，可省略 | Y | 用戶定義 |
| dsKey | 所使用的數(shù)據(jù)源標識惫确，如果用戶沒有則使用之前設(shè)置的默認數(shù)據(jù)源手报。 | N | 用戶定義 |
| txRef | 所使用的事務(wù)定義標識蚯舱，如果用戶未指定，則根據(jù)setDefaultTransaction所定義的規(guī)則進行默認匹配掩蛤，如果還未匹配上枉昏，系統(tǒng)則會跑出異常。 | N | 用戶定義 |
| resultType | 返回類型：這里只做標識使用揍鸟，如果用戶未設(shè)置此項兄裂，則返回影響行數(shù)，如果用戶設(shè)置此項阳藻，無論任何內(nèi)容晰奖，則返回插入后的主鍵（數(shù)據(jù)庫自動生成的）。建議如果需要返回主鍵腥泥，則使用固定的內(nèi)容標識匾南，如ID。<br />關(guān)于返回主鍵蛔外，有以下幾種情況：<br />1.插入一條記錄蛆楞，返回單個主鍵，其結(jié)果類型視主鍵的數(shù)據(jù)庫數(shù)據(jù)類型而定夹厌。<br />2.插入多條記錄豹爹，返回多個主鍵數(shù)組，數(shù)組元素類型視主鍵的數(shù)據(jù)庫數(shù)據(jù)類型而定矛纹。<br /> | N | 用戶定義 |
| rowCount | 作為輔助標簽時候使用臂聋，后續(xù)說明 | N | 用戶定義 |
| incrementKey | 作為輔助標簽時候使用，后續(xù)說明 | N | 用戶定義 |
| cacheClear | 緩存使用,此項將在緩存一節(jié)詳細說明 | N | 用戶定義 |
