TangYuan之事務
1. 事務的定義
Tangyuan中，我們可以通過以下配置定義一個事務：
<transaction id="tx_01" behavior="required" isolation="default" />
transaction節點屬性說明：
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| id | 事務定義標識，不可重復 | Y | 用戶定義 |
| behavior | 事務的傳播級別,默認required，可參考Spring事務，默認required | N | required<br />supports<br />mandatory<br />requires_new<br />not_supported<br />never<br /> |
| never | 事務的隔離級別，默認default | N | default<br />read_uncommitted<br />read_committed<br />repeatable_read<br />serializable<br /> |
behavior事務傳播屬性說明：
| 取值 | 用途說明 |
|---|---|
| required | 表示當前方法必須在一個具有事務的上下文中運行，如有客戶端有事務在進行，那么被調用端將在該事務中運行，否則的話重新開啟一個事務。 |
| supports | 表示當前方法不必需要具有一個事務上下文，但是如果有一個事務的話，它也可以在這個事務中運行 |
| mandatory | 表示當前方法必須在一個事務中運行，如果沒有事務，將拋出異常 |
| requires_new | 表示當前方法必須運行在它自己的事務中。一個新的事務將啟動，而且如果有一個現有的事務在運行的話，則這個方法將在運行期被掛起，直到新的事務提交或者回滾才恢復執行。 |
| not_supported | 表示該方法不應該在一個事務中運行。如果有一個事務正在運行，他將在運行期被掛起，直到這個事務提交或者回滾才恢復執行 |
| never | 表示當方法務不應該在一個事務中運行，如果存在一個事務，則拋出異常 |
isolation說明:
| 取值 | 用途說明 |
|---|---|
| default | 默認設置，同read_uncommitted |
| read_uncommitted | 臟讀<br /> * 臟讀又稱無效數據的讀出，是指在數據庫訪問中，事務T1將某一值修改，然后事務T2讀取該值，此后T1因為某種原因撤銷對該值的修改，這就導致了T2所讀取到的數據是無效的。<br /> * 臟讀就是指當一個事務正在訪問數據，并且對數據進行了修改，而這種修改還沒有提交到數據庫中，這時，另外一個事務也訪問這個數據，然后使用了這個數據。 因為這個數據是還沒有提交的數據，那么另外一個事務讀到的這個數據是臟數據，依據臟數據所做的操作可能是不正確的。 |
| read_committed | 不可重復讀<br /> * 不可重復讀，是指在數據庫訪問中，一個事務范圍內兩個相同的查詢卻返回了不同數據。<br /> * 這是由于查詢時系統中其他事務修改的提交而引起的。比如事務T1讀取某一數據，事務T2讀取并修改了該數據，T1為了對讀取值進行檢驗而再次讀取該數據，便得到了不同的結果。<br /> * 一種更易理解的說法是：在一個事務內，多次讀同一個數據。在這個事務還沒有結束時，另一個事務也訪問該同一數據。<br /> * 那么，在第一個事務的兩次讀數據之間。由于第二個事務的修改，那么第一個事務讀到的數據可能不一樣，這樣就發生了在一個事務內兩次讀到的數據是不一樣的，因此稱為不可重復讀，即原始讀取不可重復。 |
| repeatable_read | 可重復讀取<br />* 可重復讀(Repeatable Read)，當使用可重復讀隔離級別時，在事務執行期間會鎖定該事務以任何方式引用的所有行。 因此，如果在同一個事務中發出同一個SELECT語句兩次或更多次，那么產生的結果數據集總是相同的。<br /> * 因此，使用可重復讀隔離級別的事務可以多次檢索同一行集，并對它們執行任意操作，直到提交或回滾操作終止該事務。 |
| serializable | 同步事務<br /> * 提供嚴格的事務隔離。它要求事務序列化執行，事務只能一個接著一個地執行，但不能并發執行。<br /> * 如果僅僅通過“行級鎖”是無法實現事務序列化的，必須通過其他機制保證新插入的數據不會被剛執行查詢操作的事務訪問到。 |
2. 事務的使用
有了上述事務的定義，接下來開始事務的使用。Tangyuan中每個SQL服務都需要使用事務，或者說每個SQL服務在執行期間都需要按照指定的事務定義開啟事務，執行SQL命令。我們可以通過三種方式設置SQL服務使用的事務定義。
1.在SQL服務中，手工設置
<selectOne id="getUserById" txRef="tx_01" dsKey="ds">
SELECT * from user WHERE user_id = #{user_id}
</selectOne>
示例中的配置通過txRef屬性手工指定使用tx_01的事務定義
2.按照SQL服務ID匹配
<setDefaultTransaction type="method">
<property name="select*" value="tx_01"/>
<property name="get*" value="tx_01"/>
<property name="update*" value="tx_02"/>
<property name="insert*" value="tx_02"/>
<property name="delete*" value="tx_02"/>
</setDefaultTransaction>
示例中的配置表示按照SQL服務的名稱也就是ID來匹配需要使用的事務定義。比如SQL服務selectUser將使用tx_01事務定義，SQL服務updateUser將使用tx_02事務定義，需要注意的復合SQL將不會根據setDefaultTransaction來匹配事務，需要用戶手工指定。
3.按照SQL服務類型匹配
<setDefaultTransaction type="command">
<property name="selectOne" value="tx_01"/>
<property name="selectSet" value="tx_01"/>
<property name="update" value="tx_01"/>
<property name="insert" value="tx_01"/>
<property name="delete" value="tx_01"/>
</setDefaultTransaction>
示例中的配置表示按照SQL服務的類型也就是標簽來匹配需要使用的事務定義。比如用<selectOne>標簽定義SQL服務將使用tx_01事務定義，用<update>標簽定義的SQL服務將使用tx_02事務定義，需要注意的復合SQL將不會根據setDefaultTransaction來匹配事務，需要用戶手工指定。
3. setDefaultTransaction節點配置
Schema設計圖
schema設計圖
setDefaultTransaction節點屬性說明
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| type | 默認事務的匹配模式 | Y | method:按照SQL服務的名稱匹配<br />command：按照SQL服務的類型匹配 |
property節點屬性說明
| 屬性名 | 用途及說明 | 必填 | 取值 |
|---|---|---|---|
| name | method模式下：SQL服務名稱，支持*表達式<br />command模式下:SQL服務標簽名 | Y | 用戶定義 |
| value | 需要引用的事務定義ID | Y | 用戶定義 |
