1、第一步，创建springboot项目，并导入依赖
如图，创建项目遇到的第一个问题就是，当type选择maven，jdk选择1.8时，java部分没办法选择1.8的版本，这怎么办呢？
原因：搜了一下，原来是官网的3.xx版本出来后，不再支持jdk1.8了，最低版本要求是jdk17
解决办法：如果是个人练习的话，jdk可以安装jdk1.8，也可以再安装一个jdk17，跟上主流版本。如果一定要使用的话，那么SpringBoot的Service URL可以使用阿里的版本：
https://start.aliyun.com/
SpringBoot的版本我建议还是用2.xx的版本，因为后面的swagger依赖对springboot的版本有要求，如果要用3.xx版本，那么建议先在网上看看springboot版本和swagger依赖的对应关系。
springboot swagger
版本号 3.xx 3.0.0 http://127.0.0.1:8080/swagger-ui/index.html
我将我的依赖贴出来了，你可以用3.0版本，也可以直接复制我的。版本不同配置可能有出入，但是这也是一种学习，遇到问题解决就是了。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.6.10</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.awd</groupId>
<artifactId>redis-demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>redis-demo</name>
<description>redis-demo</description>
<url/>
<licenses>
<license/>
</licenses>
<developers>
<developer/>
</developers>
<scm>
<connection/>
<developerConnection/>
<tag/>
<url/>
</scm>
<properties>
<java.version>17</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!--Springboot 与 Redis整合依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
<groupId>javax.annotation</groupId>
<artifactId>javax.annotation-api</artifactId>
<version>1.3.2</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-pool2</artifactId>
</dependency>
<!--swagger2-->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.9.2</version>
</dependency>
<!-- <dependency>-->
<!-- <groupId>org.springframework.plugin</groupId>-->
<!-- <artifactId>spring-plugin-core</artifactId>-->
<!-- <version>2.0.0.RELEASE</version>-->
<!-- </dependency>-->
<!--jedis-->
<dependency>
<groupId>redis.clients</groupId>
<artifactId>jedis</artifactId>
<version>2.9.1</version>
</dependency>
<!--lettuce-->
<!-- <dependency>-->
<!-- <groupId>io.lettuce</groupId>-->
<!-- <artifactId>lettuce-core</artifactId>-->
<!-- <version>6.1.8.RELEASE</version>-->
<!-- </dependency>-->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.30</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
2、配置文件
server.port = 8080 spring.application.name=redis-demo # ===================== logging ==================== logging.level.root=info logging.level.com.awd.redisdemo=info logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger- %msg%n logging.file.name=D:/project/mylogs2024/redis-demo.log logging.pattern.file=%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger- %msg%n # ======================== swagger ============================ spring.swagger2.enabled=true spring.mvc.pathmatch.matching-strategy=ant_path_matcher# ================== redis 单机 =================== spring.data.redis.database=0 #云服务或虚拟机，总之，ip地址和端口号对应，单机的redis的ip和端口spring.redis.host=192.168.xxx.xxx spring.redis.port=6379 # redis的启动密码 #spring.redis.password=xxxxx #spring.redis.lettuce.pool.max-active=8 #spring.redis.lettuce.pool.max-wait=-1ms #spring.redis.lettuce.pool.max-idle=8 #spring.redis.lettuce.pool.min-idle=0# ================== redis 集群 ====================== spring.redis.password=abc12345 # 获取失败 最大重定向次数 spring.redis.cluster.max-redirects=3 spring.redis.lettuce.pool.max-active=8 spring.redis.lettuce.pool.max-wait=-1ms spring.redis.lettuce.pool.max-idle=8 spring.redis.lettuce.pool.min-idle=0 # 这里应该不用加，加了也没事，主要是模拟集群某个主机宕机后，让从机上位，变成主机，集群中，根据虚拟机的测试，应该是上位成功了，变成添加key成功，但是springboot有可能没有重新刷新集群拓扑图，还是之前的，导致一直访问那个宕机的主机结点失败。 spring.redis.lettuce.cluster.refresh.adaptive=true # 定时刷新 spring.redis.lettuce.cluster.refresh.period=2000 # 集群所有的结点配置ip和端口，可以根据构建集群关系的那条语句看 spring.redis.cluster.nodes=192.168.xxx.xxx:xxxx,192.168.xxx.xxx:xxxx,192.168.xxx.xxx:xxxx,192.168.xxx.xxx:xxxx,192.168.xxx.xxx:xxxx,192.168.xxx.xxx:xxxx
3、Swagger配置文件
不必多说，这个直接复制粘贴就行。
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Value("${spring.swagger2.enabled}")
private Boolean enabled;
@Bean
public Docket createRestApi(){
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.enable(enabled)
.select()
.apis(RequestHandlerSelectors.basePackage("com.awd.redisdemo"))
.paths(PathSelectors.any())
.build();
}
public ApiInfo apiInfo(){
return new ApiInfoBuilder()
.title("springboot 利用swagger2构建api接口文档" + "\t" +
DateTimeFormatter.ofPattern("yyyy-MM-dd").format(LocalDateTime.now()))
.description("springboot + redis 整合")
.version("1.0")
.termsOfServiceUrl("https://www.baidu.com/")
.build();
}
}4、配置Controller层接口
这里遇到了一个问题，使用@Resource注解时，因为是自动引用，导入的包是错误的，缺少的包是：javax.annotation-api
@RestController
@Slf4j
@Api(tags = "订单接口")
public class OrderController {
@Resource
private OrderService orderService;
@Resource
private OldOrderService oldOrderService;
@ApiOperation("新增订单")
@RequestMapping(value = "/order/add",method = RequestMethod.POST)
public void addOrder(){
oldOrderService.addOrder();
}
@ApiOperation("查询订单")
@RequestMapping(value = "/order/{keyId}",method = RequestMethod.GET)
public String getOrderById(@PathVariable Integer keyId){
return oldOrderService.getOrderById(keyId);
}5、Service层配置
别忘了上面的两个注解
@Service
@Slf4j
public class OrderService {
public static final String ORDER_KEY= "ord:";
@Resource
private StringRedisTemplate stringRedisTemplate;
public void addOrder(){
int keyId = ThreadLocalRandom.current().nextInt(1000)+1;
String serialNo = UUID.randomUUID().toString();
String key = ORDER_KEY + keyId;
String values = "京东订单" + serialNo;
stringRedisTemplate.opsForValue().set(key,values);
log.info("***key:{}",key);
log.info("***value:{}",values);
}
public String getOrderById(Integer keyId){
return stringRedisTemplate.opsForValue().get(ORDER_KEY + keyId);
}
}6、通过java添加进redis库中的value出现乱码问题
这里我用的是SpringRedisTemplate，点击去会发现，对KEY和VALUE，HashKEY和HASHVALUE做了String序列化，所以不会出现乱码。但是如果换做是RedisTemplate，那么肯定是会乱码的，
SpringRedisTemplate继承了RedisTemplate，并在此基础上加了一些配置，包括初始化了String序列化配置。如果你想使用RedisTemplate，那么可以自己手动加序列化：
@Configuration
public class RedisConfig {
// @Bean
// public RedisTemplate<String , Object> redisTemplate(RedisConnectionFactory redisConnectionFactory){
// RedisTemplate<String , Object> redisTemplate = new RedisTemplate<>();
// redisTemplate.setConnectionFactory(redisConnectionFactory);
// // 开启序列化
// redisTemplate.setKeySerializer(new StringRedisSerializer());
// redisTemplate.setValueSerializer(new GenericJackson2JsonRedisSerializer());
// redisTemplate.setHashKeySerializer(new StringRedisSerializer());
// redisTemplate.setHashValueSerializer(new GenericJackson2JsonRedisSerializer());
// redisTemplate.afterPropertiesSet();
// return redisTemplate;
// }
@Bean
public RedisTemplate<String , Object> redisTemplate(LettuceConnectionFactory lettuceConnectionFactory){
RedisTemplate<String , Object> redisTemplate = new RedisTemplate<>();
redisTemplate.setConnectionFactory(lettuceConnectionFactory);
// 开启序列化
redisTemplate.setKeySerializer(new StringRedisSerializer());
redisTemplate.setValueSerializer(new GenericJackson2JsonRedisSerializer());
redisTemplate.setHashKeySerializer(new StringRedisSerializer());
redisTemplate.setHashValueSerializer(new GenericJackson2JsonRedisSerializer());
redisTemplate.afterPropertiesSet();
return redisTemplate;
}
}7、我顺便做了一下单机的测试，用的jedis和Lettuce
// public static void main(String[] args) {
// Jedis jedis = new Jedis("192.168.xxx.xxx",xxxx);
// jedis.auth("xxxxxxx");
// String k1 = jedis.get("k1");
// System.out.println("k1:"+k1);
// }
public static void main(String[] args) {
// 使用构建器链式编程来builder我们RedisURI
RedisURI uri = RedisURI.builder().withHost("192.168.xxx.xxx")
.withPort(xxxx)
.withAuthentication("default","xxxxxxx")
.build();
// 创建客户端链接
RedisClient redisClient = RedisClient.create(uri);
// 连接客户端
StatefulRedisConnection<String, String> connect = redisClient.connect();
// 创建操作的command
RedisCommands<String, String> commands = connect.sync();
// 执行操作,会报错
// sync.set("k2","v2");
String k1 = commands.get("k1");
System.out.println(k1);
// System.out.println(k2);
// 关闭释放资源
connect.close();
redisClient.shutdown();
}8、Swagger测试
网址：http://localhost:8080/swagger-ui.html
整个流程大概就是这样子，遇到问题不要着急，看看报错，想一想，再搜一搜，总能找到解决办法的。
