嵌入式Redis服務器在Spring Boot測試中的使用教程

更新時間：2021年07月19日 08:40:31 作者：碼農熊貓

這篇文章主要介紹了嵌入式Redis服務器在Spring Boot測試中的使用,本文通過實例代碼場景分析給大家介紹的非常詳細，需要的朋友參考下吧

1、概述

Spring Data Redis提供了一種與Redis實例集成的簡單方法。

但是，在某些情況下，使用嵌入式服務器比使用真實服務器創(chuàng)建開發(fā)和測試環(huán)境更方便。

因此，我們將學習如何設置和使用嵌入式Redis服務器。

2、依賴

讓我們首先添加必要的依賴項：

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

<dependency>
  <groupId>it.ozimov</groupId>
  <artifactId>embedded-redis</artifactId>
  <version>0.7.2</version>
  <scope>test</scope>
</dependency>

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

這個spring-boot-starter-test包含我們需要運行集成測試的各種依賴。

此外，embedded-redis包含我們將使用的嵌入式服務器。

3、設置

添加依賴項后，我們應該定義Redis服務器和我們的應用程序之間的連接設置。

讓我們首先創(chuàng)建一個類來保存我們的屬性：

@Configuration
public class RedisProperties {
    private int redisPort;
    private String redisHost;

    public RedisProperties(
      @Value("${spring.redis.port}") int redisPort, 
      @Value("${spring.redis.host}") String redisHost) {
        this.redisPort = redisPort;
        this.redisHost = redisHost;
    }

    // getters
}

接下來，我們應該創(chuàng)建一個配置類來定義連接并使用我們的屬性：

@Configuration
@EnableRedisRepositories
public class RedisConfiguration {

    @Bean
    public LettuceConnectionFactory redisConnectionFactory(
      RedisProperties redisProperties) {
        return new LettuceConnectionFactory(
          redisProperties.getRedisHost(), 
          redisProperties.getRedisPort());
    }

    @Bean
    public RedisTemplate<?, ?> redisTemplate(LettuceConnectionFactory connectionFactory) {
        RedisTemplate<byte[], byte[]> template = new RedisTemplate<>();
        template.setConnectionFactory(connectionFactory);
        return template;
    }
}

配置非常簡單。這樣我們的嵌入式服務器可以在其他的端口上運行。

4、嵌入式Redis服務器

現(xiàn)在，我們將配置嵌入式服務器并在我們的一項測試中使用它。

首先，讓我們在測試的資源目錄（src/test/resources）中創(chuàng)建一個application.properties文件：

spring.redis.host=localhost
spring.redis.port=6370

之后，我們將創(chuàng)建一個@TestConfiguration注解的配置類：

@TestConfiguration
public class TestRedisConfiguration {

    private RedisServer redisServer;

    public TestRedisConfiguration(RedisProperties redisProperties) {
        this.redisServer = new RedisServer(redisProperties.getRedisPort());
    }

    @PostConstruct
    public void postConstruct() {
        redisServer.start();
    }

    @PreDestroy
    public void preDestroy() {
        redisServer.stop();
    }
}

當context上下文啟動，服務器就跟著啟動。它根據我們在屬性中定義的端口運行在我們的機器上。有了它，我們現(xiàn)在可以在不停止實際Redis服務器的情況下運行測試了。

理想情況下，我們希望在隨機可用端口上啟動它，但嵌入式Redis尚不具備此功能。我們現(xiàn)在可以做的是通過ServerSocket API 獲取隨機端口。

此外，當上下文停止，服務器也跟著停止。

服務器也可以由我們自己的可執(zhí)行文件來提供：

this.redisServer = new RedisServer("/path/redis", redisProperties.getRedisPort());

此外，可執(zhí)行文件可以按不同的操作系統(tǒng)來定義：

RedisExecProvider customProvider = RedisExecProvider.defaultProvider()
.override(OS.UNIX, "/path/unix/redis")
.override(OS.Windows, Architecture.x86_64, "/path/windows/redis")
.override(OS.MAC_OS_X, Architecture.x86_64, "/path/macosx/redis");

this.redisServer = new RedisServer(customProvider, redisProperties.getRedisPort());

最后，讓我們創(chuàng)建一個使用TestRedisConfiguration類的測試吧：

@RunWith(SpringRunner.class)
@SpringBootTest(classes = TestRedisConfiguration.class)
public class UserRepositoryIntegrationTest {

    @Autowired
    private UserRepository userRepository;

    @Test
    public void shouldSaveUser_toRedis() {
        UUID id = UUID.randomUUID();
        User user = new User(id, "name");

        User saved = userRepository.save(user);

        assertNotNull(saved);
    }
}

這樣用戶保存就到了我們的嵌入式Redis服務器。

此外，我們必須手動將TestRedisConfiguration添加到SpringBootTest。正如我們之前所說，服務器在測試之前啟動并在測試之后停止。