在Spring data中使用r2dbc

簡介

上篇文章咱們講到了怎麼在Spring webFlux中使用r2dbc,今天咱們看一下怎麼使用spring-data-r2dbc這個Spring data對r2dbc的封裝來進行r2dbc操做。

依賴關係

要使用Spring-datea-r2dbc須要配置下面的依賴關係：

<dependencies>
        <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-r2dbc</artifactId>
        <version>2.3.3.RELEASE</version>
    </dependency>

        <!-- R2DBC H2 Driver -->
        <dependency>
            <groupId>io.r2dbc</groupId>
            <artifactId>r2dbc-h2</artifactId>
            <version>${r2dbc-h2.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-webflux</artifactId>
        </dependency>

數據庫鏈接配置

Spring-data-r2dbc使用的是R2dbcProperties來進行配置文件的讀取：

簡單看一下R2dbcProperties的定義：

@ConfigurationProperties(prefix = "spring.r2dbc")
public class R2dbcProperties {

    /**
     * Database name. Set if no name is specified in the url. Default to "testdb" when
     * using an embedded database.
     */
    private String name;

    /**
     * Whether to generate a random database name. Ignore any configured name when
     * enabled.
     */
    private boolean generateUniqueName;

    /**
     * R2DBC URL of the database. database name, username, password and pooling options
     * specified in the url take precedence over individual options.
     */
    private String url;

    /**
     * Login username of the database. Set if no username is specified in the url.
     */
    private String username;

    /**
     * Login password of the database. Set if no password is specified in the url.
     */
    private String password;

相應的，看一下咱們的配置文件是怎麼樣的：

spring.r2dbc.url=r2dbc:h2:mem://./testdb
spring.r2dbc.username=sa
spring.r2dbc.password=password

這裏，咱們使用的是H2數據庫。

數據庫初始化

數據庫初始化過程當中，咱們須要建立一個users表格，這裏咱們在一個initDatabase bean中實現：

@Bean
    public ApplicationRunner initDatabase(DatabaseClient client, UsersDao usersDao) {
        List<String> statements = Arrays.asList(
                "DROP TABLE IF EXISTS USERS;",
                "CREATE TABLE IF NOT EXISTS USERS ( id SERIAL PRIMARY KEY, firstname VARCHAR(100) NOT NULL, lastname VARCHAR(100) NOT NULL);");

        statements.forEach(sql -> executeSql(client,sql)
                .doOnSuccess(count -> log.info("Schema created, rows updated: {}", count))
                .doOnError(error -> log.error("got error : {}",error.getMessage(),error))
                .subscribe()
        );

        return args ->getUser().flatMap(usersDao::save).subscribe(user -> log.info("User saved: {}", user));

    }

    private Flux<Users> getUser() {
        return Flux.just(new Users(null, "John", "Doe"), new Users(null, "Jane", "Doe"));
    }

    private Mono<Integer> executeSql(DatabaseClient client, String sql) {
        return client.execute(sql).fetch().rowsUpdated();
    }

上面的例子中，咱們建立數據庫分爲了兩部分，第一部分是數據庫schema的操做，咱們執行了drop和create table的操做。

第二部分是向數據庫表中插入數據。

注意，上面的兩部分操做都須要執行subscribe操做，以觸發真正的Reactive操做。

DAO操做

在DAO操做以前，咱們須要建立Users entity：

@Data
@AllArgsConstructor
public class Users {

    @Id
    private Integer id;
    private String firstname;
    private String lastname;

    boolean hasId() {
        return id != null;
    }
}

再看一下咱們建立的UserDao：

public interface UsersDao extends ReactiveCrudRepository<Users, Long> {

    @Query("select id, firstname, lastname from users c where c.lastname = :lastname")
    Flux<Users> findByLastname(String lastname);
}

注意，這裏並不須要添加@Component註解，由於咱們繼承了ReactiveCrudRepository，會自動幫咱們建立UsersDao的實例，咱們直接使用就能夠了。

ReactiveCrudRepository爲咱們封裝了一些DAO的基本操做，好比save，saveAll, findById ,existsById等基礎操做。

固然，咱們也能夠自定義本身的SQL語句，好比上面的findByLastname。

Service操做和Transaction

咱們看一下怎麼使用UserDao來進行具體的方法操做：

@Component
public class UsersService {

    @Resource
    private UsersDao usersDao;

    @Transactional
    public Mono<Users> save(Users user) {

        return usersDao.save(user).map(it -> {

            if (it.getFirstname().equals("flydean")) {
                throw new IllegalStateException();
            } else {
                return it;
            }
        });
    }

}

上面咱們建立了一個save方法，用來保存相應的User對象。

controller

最後，咱們建立一個controller來對外暴露相應的方法：

@RestController
@RequiredArgsConstructor
public class UsersController {

    private final UsersDao usersDao;

    @GetMapping("/users")
    public Flux<Users> findAll() {
        return usersDao.findAll();
    }
}

測試

好了，如今咱們的程序已經寫好了，能夠進行測試了。

運行程序，執行：

curl "localhost:8080/users"    
[{"id":1,"firstname":"John","lastname":"Doe"},{"id":2,"firstname":"Jane","lastname":"Doe"}]%

能夠看到取出了相應的結果。

完美，實驗成功。

本文的代碼：spring-data-r2dbc

本文做者：flydean程序那些事

本文連接：http://www.flydean.com/spring-data-r2dbc/

本文來源：flydean的博客

歡迎關注個人公衆號:「程序那些事」最通俗的解讀，最深入的乾貨，最簡潔的教程，衆多你不知道的小技巧等你來發現！