快速入門

在Spring Boot中，當我們使用了spring-boot-starter-jdbc或spring-boot-starter-data-jpa依賴的時候，框架會自動預設分別注入DataSourceTransactionManager或JpaTransactionManager。所以我們不需要任何額外配置就可以用@Transactional註解進行事務的使用。

我們以之前實現的《用spring-data-jpa訪問資料庫》的示例Chapter3-2-2作為基礎工程進行事務的使用常識。

在該樣例工程中（若對該資料訪問方式不瞭解，可先閱讀該文章），我們引入了spring-data-jpa，並建立了User實體以及對User的資料訪問物件UserRepository，在ApplicationTest類中實現了使用UserRepository進行資料讀寫的單元測試用例，如下：

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(Application.class)
public class ApplicationTests {

	@Autowired
	private UserRepository userRepository;

	@Test
	public void test() throws Exception {

		// 建立10條記錄
		userRepository.save(new User("AAA", 10));
		userRepository.save(new User("BBB", 20));
		userRepository.save(new User("CCC", 30));
		userRepository.save(new User("DDD", 40));
		userRepository.save(new User("EEE", 50));
		userRepository.save(new User("FFF", 60));
		userRepository.save(new User("GGG", 70));
		userRepository.save(new User("HHH", 80));
		userRepository.save(new User("III", 90));
		userRepository.save(new User("JJJ", 100));

		// 省略後續的一些驗證操作
	}


}
 

可以看到，在這個單元測試用例中，使用UserRepository物件連續建立了10個User實體到資料庫中，下面我們人為的來製造一些異常，看看會發生什麼情況。

通過定義User的name屬性長度為5，這樣通過建立時User實體的name屬性超長就可以觸發異常產生。

@Entity
public class User {

    @Id
    @GeneratedValue
    private Long id;

    @Column(nullable = false, length = 5)
    private String name;

    @Column(nullable = false)
    private Integer age;

    // 省略建構函式、getter和setter

}
 

// 建立10條記錄
userRepository.save(new User("AAA", 10));
userRepository.save(new User("BBB", 20));
userRepository.save(new User("CCC", 30));
userRepository.save(new User("DDD", 40));
userRepository.save(new User("EEE", 50));
userRepository.save(new User("FFF", 60));
userRepository.save(new User("GGG", 70));
userRepository.save(new User("HHHHHHHHHH", 80));
userRepository.save(new User("III", 90));
userRepository.save(new User("JJJ", 100));

2016-05-27 10:30:35.948  WARN 2660 --- [           main] o.h.engine.jdbc.spi.SqlExceptionHelper   : SQL Error: 1406, SQLState: 22001
2016-05-27 10:30:35.948 ERROR 2660 --- [           main] o.h.engine.jdbc.spi.SqlExceptionHelper   : Data truncation: Data too long for column 'name' at row 1
2016-05-27 10:30:35.951  WARN 2660 --- [           main] o.h.engine.jdbc.spi.SqlExceptionHelper   : SQL Warning Code: 1406, SQLState: HY000
2016-05-27 10:30:35.951  WARN 2660 --- [           main] o.h.engine.jdbc.spi.SqlExceptionHelper   : Data too long for column 'name' at row 1

org.springframework.dao.DataIntegrityViolationException: could not execute statement; SQL [n/a]; nested exception is org.hibernate.exception.DataException: could not execute statement

@Test
@Transactional
public void test() throws Exception {

    // 省略測試內容

}

2016-05-27 10:35:32.210  WARN 5672 --- [           main] o.h.engine.jdbc.spi.SqlExceptionHelper   : SQL Error: 1406, SQLState: 22001
2016-05-27 10:35:32.210 ERROR 5672 --- [           main] o.h.engine.jdbc.spi.SqlExceptionHelper   : Data truncation: Data too long for column 'name' at row 1
2016-05-27 10:35:32.213  WARN 5672 --- [           main] o.h.engine.jdbc.spi.SqlExceptionHelper   : SQL Warning Code: 1406, SQLState: HY000
2016-05-27 10:35:32.213  WARN 5672 --- [           main] o.h.engine.jdbc.spi.SqlExceptionHelper   : Data too long for column 'name' at row 1
2016-05-27 10:35:32.221  INFO 5672 --- [           main] o.s.t.c.transaction.TransactionContext   : Rolled back transaction for test context [[email protected] testClass = ApplicationTests, testInstance = [email protected], testMethod = [email protected], testException = org.springframework.dao.DataIntegrityViolationException: could not execute statement; SQL [n/a]; nested exception is org.hibernate.exception.DataException: could not execute statement, mergedContextConfiguration = [[email protected] testClass = ApplicationTests, locations = '{}', classes = '{class com.didispace.Application}', contextInitializerClasses = '[]', activeProfiles = '{}', propertySourceLocations = '{}', propertySourceProperties = '{}', contextLoader = 'org.springframework.boot.test.SpringApplicationContextLoader', parent = [null]]].

再看資料庫中，User表就沒有AAA到GGG的使用者資料了，成功實現了自動回滾。

這裡主要通過單元測試演示瞭如何使用註解來宣告一個函式需要被事務管理，通常我們單元測試為了保證每個測試之間的資料獨立，會使用註解讓每個單元測試都能在結束時回滾。而真正在開發業務邏輯時，我們通常在service層介面中使用來對各個業務邏輯進行事務管理的配置，例如：

public interface UserService {
    
    @Transactional
    User login(String name, String password);
    
}

事務詳解

上面的例子中我們使用了預設的事務配置，可以滿足一些基本的事務需求，但是當我們專案較大較複雜時（比如，有多個數據源等），這時候需要在宣告事務時，指定不同的事務管理器。對於不同資料來源的事務管理配置可以見《Spring Boot多資料來源配置與使用》中的設定。在宣告事務時，只需要通過value屬性指定配置的事務管理器名即可，例如：@Transactional(value="transactionManagerPrimary")。

除了指定不同的事務管理器之後，還能對事務進行隔離級別和傳播行為的控制，下面分別詳細解釋：

####　隔離級別

隔離級別是指若干個併發的事務之間的隔離程度，與我們開發時候主要相關的場景包括：髒讀取、重複讀、幻讀。

我們可以看org.springframework.transaction.annotation.Isolation列舉類中定義了五個表示隔離級別的值：

public enum Isolation {
    DEFAULT(-1),
    READ_UNCOMMITTED(1),
    READ_COMMITTED(2),
    REPEATABLE_READ(4),
    SERIALIZABLE(8);
}

• DEFAULT：這是預設值，表示使用底層資料庫的預設隔離級別。對大部分資料庫而言，通常這值就是：READ_COMMITTED。
• READ_UNCOMMITTED：該隔離級別表示一個事務可以讀取另一個事務修改但還沒有提交的資料。該級別不能防止髒讀和不可重複讀，因此很少使用該隔離級別。
• READ_COMMITTED：該隔離級別表示一個事務只能讀取另一個事務已經提交的資料。該級別可以防止髒讀，這也是大多數情況下的推薦值。
• REPEATABLE_READ：該隔離級別表示一個事務在整個過程中可以多次重複執行某個查詢，並且每次返回的記錄都相同。即使在多次查詢之間有新增的資料滿足該查詢，這些新增的記錄也會被忽略。該級別可以防止髒讀和不可重複讀。
• SERIALIZABLE：所有的事務依次逐個執行，這樣事務之間就完全不可能產生干擾，也就是說，該級別可以防止髒讀、不可重複讀以及幻讀。但是這將嚴重影響程式的效能。通常情況下也不會用到該級別。

指定方法：通過使用isolation屬性設定，例如：

@Transactional(isolation = Isolation.DEFAULT)

傳播行為

所謂事務的傳播行為是指，如果在開始當前事務之前，一個事務上下文已經存在，此時有若干選項可以指定一個事務性方法的執行行為。

我們可以看org.springframework.transaction.annotation.Propagation列舉類中定義了6個表示傳播行為的列舉值：

public enum Propagation {
    REQUIRED(0),
    SUPPORTS(1),
    MANDATORY(2),
    REQUIRES_NEW(3),
    NOT_SUPPORTED(4),
    NEVER(5),
    NESTED(6);
}

• REQUIRED：如果當前存在事務，則加入該事務；如果當前沒有事務，則建立一個新的事務。
• SUPPORTS：如果當前存在事務，則加入該事務；如果當前沒有事務，則以非事務的方式繼續執行。
• MANDATORY：如果當前存在事務，則加入該事務；如果當前沒有事務，則丟擲異常。
• REQUIRES_NEW：建立一個新的事務，如果當前存在事務，則把當前事務掛起。
• NOT_SUPPORTED：以非事務方式執行，如果當前存在事務，則把當前事務掛起。
• NEVER：以非事務方式執行，如果當前存在事務，則丟擲異常。
• NESTED：如果當前存在事務，則建立一個事務作為當前事務的巢狀事務來執行；如果當前沒有事務，則該取值等價於REQUIRED。

指定方法：通過使用propagation屬性設定，例如：

@Transactional(propagation = Propagation.REQUIRED)