TangYuan使用教程-基本SQL服務標籤

#6.2 基本SQL服務標籤

---

###1. selectSet標籤

示例：

<selectSet id="getUserList" dsKey="ds" txRef="tx_01">
	select * from user
</selectSet>

說明

上面示例表示咱們定義了一個ID爲getUserList的基本服務，服務使用ds所表明的數據源，使用tx_01所定義的事務，執行一條查詢語句，返回結果爲一個查詢結果集，默認的數據結構爲List<XCO>.

Schema設計圖

selectSet節點屬性說明

屬性名	用途及說明	必填	取值
id	服務標識,須要惟一；做爲輔助標籤此項無心義，可省略	Y	用戶定義
dsKey	所使用的數據源標識，若是用戶沒有則使用以前設置的默認數據源。	N	用戶定義
txRef	所使用的事務定義標識，若是用戶未指定，則根據setDefaultTransaction所定義的規則進行默認匹配，若是還未匹配上，系統則會跑出異常。	N	用戶定義
resultKey	做爲輔助標籤時候使用，後續說明	N	用戶定義
resultType	返回類型，7. 數據映射	N	用戶定義
resultMap	數據映射，7. 數據映射	N	用戶定義
fetchSize	每次查詢的最大獲取條數，默認255	N	用戶定義
cacheUse	緩存使用,此項將在緩存一節詳細說明	N	用戶定義

###2. selectOne標籤

示例：

<selectOne id="getUser" dsKey="ds" txRef="tx_01">
	select * from user where id = #{id}
</selectOne>

說明

上面示例表示咱們定義了一個ID爲getUser的基本服務，服務使用ds所表明的數據源，使用tx_01所定義的事務，執行一條查詢語句，返回結果爲一條數據庫行記錄，默認的數據結構爲XCO.

Schema設計圖

selectOne節點屬性說明

屬性名	用途及說明	必填	取值
id	服務標識,須要惟一；做爲輔助標籤此項無心義，可省略	Y	用戶定義
dsKey	所使用的數據源標識，若是用戶沒有則使用以前設置的默認數據源。	N	用戶定義
txRef	所使用的事務定義標識，若是用戶未指定，則根據setDefaultTransaction所定義的規則進行默認匹配，若是還未匹配上，系統則會跑出異常。	N	用戶定義
resultKey	做爲輔助標籤時候使用，後續說明	N	用戶定義
resultType	返回類型，7. 數據映射	N	用戶定義
resultMap	數據映射，7. 數據映射	N	用戶定義
fetchSize	每次查詢的最大獲取條數，默認255	N	用戶定義
cacheUse	緩存使用,此項將在緩存一節詳細說明	N	用戶定義

###3. selectVar標籤

示例：

<selectVar id="getName" dsKey="ds" txRef="tx_01">
	select name from user where id = #{id}
</selectVar>

說明

上面示例表示咱們定義了一個ID爲getName的基本服務，服務使用ds所表明的數據源，使用tx_01所定義的事務，執行一條查詢語句，返回結果爲name字段，返回結果的數據類型視字段的數據庫數據類型而定。上述例子中name在數據庫中的數據類型爲VARCHAR(32)，所以對應的Java類型爲String。

Schema設計圖

selectVar節點屬性說明

屬性名	用途及說明	必填	取值
id	服務標識,須要惟一；做爲輔助標籤此項無心義，可省略	Y	用戶定義
dsKey	所使用的數據源標識，若是用戶沒有則使用以前設置的默認數據源。	N	用戶定義
txRef	所使用的事務定義標識，若是用戶未指定，則根據setDefaultTransaction所定義的規則進行默認匹配，若是還未匹配上，系統則會跑出異常。	N	用戶定義
resultKey	做爲輔助標籤時候使用，後續說明	N	用戶定義
cacheUse	緩存使用,此項將在緩存一節詳細說明	N	用戶定義

###4. update標籤

示例：

<update id="updateName" dsKey="ds" txRef="tx_02">
	update user set name = '張三' where id = #{id}
</update>

說明

上面示例表示咱們定義了一個ID爲updateName的基本服務，服務使用ds所表明的數據源，使用tx_01所定義的事務，執行一條更新語句，返回結果爲其影響行數。

Schema設計圖

update節點屬性說明

屬性名	用途及說明	必填	取值
id	服務標識,須要惟一；做爲輔助標籤此項無心義，可省略	Y	用戶定義
dsKey	所使用的數據源標識，若是用戶沒有則使用以前設置的默認數據源。	N	用戶定義
txRef	所使用的事務定義標識，若是用戶未指定，則根據setDefaultTransaction所定義的規則進行默認匹配，若是還未匹配上，系統則會跑出異常。	N	用戶定義
rowCount	做爲輔助標籤時候使用，後續說明	N	用戶定義
cacheClear	緩存使用,此項將在緩存一節詳細說明	N	用戶定義

###5. delete標籤

示例：

<delete id="deleteUser" dsKey="ds" txRef="tx_02">
	delete from user where where id = #{id}
</delete>

說明

上面示例表示咱們定義了一個ID爲deleteUser的基本服務，服務使用ds所表明的數據源，使用tx_01所定義的事務，執行一條刪除語句，返回結果爲其影響行數。

Schema設計圖

delete節點屬性說明

屬性名	用途及說明	必填	取值
id	服務標識,須要惟一；做爲輔助標籤此項無心義，可省略	Y	用戶定義
dsKey	所使用的數據源標識，若是用戶沒有則使用以前設置的默認數據源。	N	用戶定義
txRef	所使用的事務定義標識，若是用戶未指定，則根據setDefaultTransaction所定義的規則進行默認匹配，若是還未匹配上，系統則會跑出異常。	N	用戶定義
rowCount	做爲輔助標籤時候使用，後續說明	N	用戶定義
cacheClear	緩存使用,此項將在緩存一節詳細說明	N	用戶定義

###6. insert標籤

示例：

<insert id="insertUser" dsKey="ds" txRef="tx_02">
	insert into user(name, age) values('李四', 26);
</insert>

說明

上面示例表示咱們定義了一個ID爲insertUser的基本服務，服務使用ds所表明的數據源，使用tx_01所定義的事務，執行一條插入語句，返回結果能夠是操做的影響行數，也能夠是插入操做後數據庫返回的自增主鍵，具體狀況參照insert標籤resultType屬性的設置。

Schema設計圖

insert節點屬性說明

屬性名	用途及說明	必填	取值
id	服務標識,須要惟一；做爲輔助標籤此項無心義，可省略	Y	用戶定義
dsKey	所使用的數據源標識，若是用戶沒有則使用以前設置的默認數據源。	N	用戶定義
txRef	所使用的事務定義標識，若是用戶未指定，則根據setDefaultTransaction所定義的規則進行默認匹配，若是還未匹配上，系統則會跑出異常。	N	用戶定義
resultType	返回類型：這裏只作標識使用，若是用戶未設置此項，則返回影響行數，若是用戶設置此項，不管任何內容，則返回插入後的主鍵（數據庫自動生成的）。建議若是須要返回主鍵，則使用固定的內容標識，如ID。<br />關於返回主鍵，有如下幾種狀況：<br />1.插入一條記錄，返回單個主鍵，其結果類型視主鍵的數據庫數據類型而定。<br />2.插入多條記錄，返回多個主鍵數組，數組元素類型視主鍵的數據庫數據類型而定。<br />	N	用戶定義
rowCount	做爲輔助標籤時候使用，後續說明	N	用戶定義
incrementKey	做爲輔助標籤時候使用，後續說明	N	用戶定義
cacheClear	緩存使用,此項將在緩存一節詳細說明	N	用戶定義