SpringBoot整合Redis使用Restful風格實現CRUD功能


前言

本篇文章主要介紹的是SpringBoot整合Redis,使用Restful風格實現的CRUD功能。

Redis 介紹

Redis 是完全開源免費的,遵守BSD協議,是一個高性能的key-value數據庫。 Redis 與其他 key - value緩存產品有以下三個特點:

  • Redis支持數據的持久化,可以將內存中的數據保存在磁盤中,重啟的時候可以再次加載進行使用。
  • Redis不僅僅支持簡單的key-value類型的數據,同時還提供list,set,zset,hash等數據結構的存儲。
  • Redis支持數據的備份,即master-slave模式的數據備份。

更多的使用說明可以查看官方的文檔。
官方文檔: https://redis.io

SpringBoot整合Redis

說明:如果想直接獲取工程那么可以直接跳到底部,通過鏈接下載工程代碼。

開發准備

環境要求
JDK:1.8
SpringBoot:1.5.15.RELEASE
Redis:3.2或以上。

Tips:Redis的偶數為穩定版本,奇數為非穩定版本,所以在使用的時候最好使用偶數的版本!

Reids的可以看我之前的寫的這篇文章: Redis安裝教程

首先還是Maven的相關依賴:

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
    <fastjson>1.2.41</fastjson>
    <springboot>1.5.15.RELEASE</springboot>
  </properties>

  <dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId> 
			<artifactId>spring-boot-starter-web</artifactId>
			<version>${springboot}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-devtools</artifactId>
			<optional>true</optional>
			<version>${springboot}</version>
		</dependency>
		
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<version>${springboot}</version>
			<scope>test</scope>
		</dependency>
  		
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-data-redis</artifactId>
			<version>${springboot}</version>
		</dependency>
  
		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>fastjson</artifactId>
			<version>${fastjson}</version>
		</dependency>
  
  </dependencies>

添加了相應的maven依賴之后,我們再來查看配置。
Redis配置的說明在下面中已經說的很詳細了,這里就不在過多說明了,不過需要注意的是如果Redis是集群版的話,需要使用這個spring.redis.cluster.nodes這個配置,該配置為Redis的Host加上Port,多個之間用,逗號隔開。
application.properties的配置如下:

# Redis服務器地址
# 單機版配置
spring.redis.host = 127.0.0.1
spring.redis.port = 6379
# redis最大重連數
redis.cluster.max-redirects=3
# Redis服務器連接密碼(默認為空)
redis.password=
# 最大空閑數  
redis.maxIdle=5  
# 連接池的最大數據庫連接數。
redis.maxTotal=5 
# 最大建立連接等待時間。如果超過此時間將接到異常。設為-1表示無限制。  
redis.maxWaitMillis=1000  
# 連接的最小空閑時間 默認1800000毫秒(30分鍾)  
redis.minEvictableIdleTimeMillis=300000  
# 每次釋放連接的最大數目,默認3  
redis.numTestsPerEvictionRun=3 
# 逐出掃描的時間間隔(毫秒) 如果為負數,則不運行逐出線程, 默認-1  
redis.timeBetweenEvictionRunsMillis=30000  
# 是否在從池中取出連接前進行檢驗,如果檢驗失敗,則從池中去除連接並嘗試取出另一個  
redis.testOnBorrow=true  
# 在空閑時檢查有效性, 默認false  
redis.testWhileIdle=true  

代碼編寫

首先是編寫Redis的配置類,對Redis這塊進行配置。
在使用SpringBoot整合Redis的時候,SpringBoot是可以根據配置自動完成Redis的相關配置,不過為了更靈活一點,我們這邊還是手動加載一下配置,配置成自己想要的那種效果吧。
首先,配置一個Redis的連接池,使用redis.clients.jedis.JedisPoolConfig這個類來進行實現,相關的配置在代碼的注釋中說明得很詳細了,這里就不在過多講述了;
然后,再來配置一個Redis的工廠,加載Redis的連接池配置,這里我們也可以進行一下設置,如果Redis設置了密碼,我們就加載改密碼,否則就不進行加載。
繼而,我們再來設置數據存入Redis的序列化的方式並開啟事務。這里也順便說下為什么要設置序列化器,如果不設置,那么在用實體類(未序列化)進行存儲的時候,會提示錯誤: Failed to serialize object using DefaultSerializer; 當然,也可以不設置,不過存儲的實體類必須進行序列化。
最后,我們再來實例化RedisTemplate的對象,加載上述的配置。在使用的時候,只需要使用如下的方式注入就可以使用了

@Autowired
RedisTemplate<String, Object> redisTemplate;

Redis的配置類的代碼如下:

/**
 * 
 * @Title: RedisConfig
 * @Description: redis初始化配置
 * @Version:1.0.0
 * @author pancm
 * @date 2018年6月7日
 */
@Component
public class RedisConfig {

	@Value("${redis.maxIdle}")
	private Integer maxIdle;

	@Value("${redis.maxTotal}")
	private Integer maxTotal;

	@Value("${redis.maxWaitMillis}")
	private Integer maxWaitMillis;

	@Value("${redis.minEvictableIdleTimeMillis}")
	private Integer minEvictableIdleTimeMillis;

	@Value("${redis.numTestsPerEvictionRun}")
	private Integer numTestsPerEvictionRun;

	@Value("${redis.timeBetweenEvictionRunsMillis}")
	private long timeBetweenEvictionRunsMillis;

	@Value("${redis.testOnBorrow}")
	private boolean testOnBorrow;

	@Value("${redis.testWhileIdle}")
	private boolean testWhileIdle;

	@Value("${redis.cluster.max-redirects}")
	private Integer mmaxRedirectsac;

	@Value("${redis.password}")
	private String redispwd;

	/**
	 * JedisPoolConfig 連接池
	 * 
	 * @return
	 */
	@Bean
	public JedisPoolConfig jedisPoolConfig() {
		JedisPoolConfig jedisPoolConfig = new JedisPoolConfig();
		// 最大空閑數
		jedisPoolConfig.setMaxIdle(maxIdle);
		// 連接池的最大數據庫連接數
		jedisPoolConfig.setMaxTotal(maxTotal);
		// 最大建立連接等待時間
		jedisPoolConfig.setMaxWaitMillis(maxWaitMillis);
		// 逐出連接的最小空閑時間 默認1800000毫秒(30分鍾)
		jedisPoolConfig.setMinEvictableIdleTimeMillis(minEvictableIdleTimeMillis);
		// 每次逐出檢查時 逐出的最大數目 如果為負數就是 : 1/abs(n), 默認3
		jedisPoolConfig.setNumTestsPerEvictionRun(numTestsPerEvictionRun);
		// 逐出掃描的時間間隔(毫秒) 如果為負數,則不運行逐出線程, 默認-1
		jedisPoolConfig.setTimeBetweenEvictionRunsMillis(timeBetweenEvictionRunsMillis);
		// 是否在從池中取出連接前進行檢驗,如果檢驗失敗,則從池中去除連接並嘗試取出另一個
		jedisPoolConfig.setTestOnBorrow(testOnBorrow);
		// 在空閑時檢查有效性, 默認false
		jedisPoolConfig.setTestWhileIdle(testWhileIdle);
		return jedisPoolConfig;
	}



	
	/**
	 * 配置工廠
	 */
	@Bean
	public JedisConnectionFactory JedisConnectionFactory(JedisPoolConfig jedisPoolConfig) {
		JedisConnectionFactory JedisConnectionFactory = new JedisConnectionFactory(jedisPoolConfig);
		if (redispwd == null || redispwd.length() == 0) {
			JedisConnectionFactory.setPassword(redispwd);
		}
		return JedisConnectionFactory;
	}

	

	/**
	 * 設置數據存入 redis 的序列化方式,並開啟事務
	 * 
	 * @param redisTemplate
	 * @param factory
	 */
	private void initDomainRedisTemplate(RedisTemplate<String, Object> redisTemplate, RedisConnectionFactory factory) {
		/*
		 * 設置 序列化器 .
		 * 如果不設置,那么在用實體類(未序列化)進行存儲的時候,會提示錯誤: Failed to serialize object using DefaultSerializer;
		 */
		redisTemplate.setKeySerializer(new StringRedisSerializer());
		redisTemplate.setHashKeySerializer(new StringRedisSerializer());
		redisTemplate.setHashValueSerializer(new GenericJackson2JsonRedisSerializer());
		redisTemplate.setValueSerializer(new GenericJackson2JsonRedisSerializer());
		// 開啟事務
		redisTemplate.setEnableTransactionSupport(true);
		// 將連接工廠設置到模板類中
		redisTemplate.setConnectionFactory(factory);
	}
	
	/**
	 * 實例化 RedisTemplate 對象
	 * @return
	 */
	@Bean
	public RedisTemplate<String, Object> functionDomainRedisTemplate(RedisConnectionFactory redisConnectionFactory) {
		RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>();
		initDomainRedisTemplate(redisTemplate, redisConnectionFactory);
		return redisTemplate;
	}
	
}

當然,如果自己想使用自定義的Redis工具類進行實現,那么只需在該配置類中注冊一個Bean注入封裝一下就可以了,然后在工具類中加載一下就可以了。
配置類中添加:


	@Bean(name = "redisUtil")
	public RedisUtil redisUtil(RedisTemplate<String, Object> redisTemplate) {
		RedisUtil redisUtil = new RedisUtil();
		redisUtil.setRedisTemplate(redisTemplate);
		return redisUtil;
	}'
	

Redis的工具類添加如下代碼:

	private RedisTemplate<String, Object> redisTemplate;

	public void setRedisTemplate(RedisTemplate<String, Object> redisTemplate) {
		this.redisTemplate = redisTemplate;
	}
	

使用Redis工具類示例:


    @Resource
	private RedisUtil redisUtil;
	

講完Redis的配置類之后,我們再來進行編寫相應的實體類、dao層、service層和Controller層的代碼了。
由於這塊的代碼比較簡單,而且格式和之前的項目基本類似,因此這里我就簡單的貼下代碼了。

實體類

又是萬能的用戶表 (^▽^)

代碼如下:


public class User implements Serializable{
	private static final long serialVersionUID = 1L;
	/** 編號 */
	 private int id;
	 /** 姓名 */
	 private String name;
	 /** 年齡 */
	 private int age;
	 
	 public User(){
	 }

	public int getId() {
		return id;
	}
	
	public void setId(int id) {
		this.id = id;
	}

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
	}

	public int getAge() {
		return age;
	}

	public void setAge(int age) {
		this.age = age;
	}

	public String toString() {
		return JSONObject.toJSONString(this);
	}
}

Dao 數據層

這里我是使用的自定義的Redis工具類,其實也就是對RedisTemplate做了二次封裝。
因為使用的是set(集合)方式存儲的,所以我這邊把用戶數據的ID作為key,用戶數據作為value了。

實現類的代碼如下:


@Repository
public class UserDaoImpl implements UserDao {

	@Resource
	private RedisUtil redisUtil;
	

	@Override
	public void addUser(User user) {
		redisUtil.set(String.valueOf(user.getId()), user.toString());
	}


	@Override
	public void updateUser(User user) {
		redisUtil.set(String.valueOf(user.getId()), user.toString());
	}


	@Override
	public void deleteUser(int id) {
		redisUtil.del(String.valueOf(id));
	}

	
	@Override
	public User findByUserId(int id) {
		String data = redisUtil.get(String.valueOf(id)).toString();
		User user = JSON.parseObject(data, User.class);
		return  user;
	}
}

Service 業務層

業務層這邊處理比較簡單,成功就返回true,失敗就返回false。

實現類的代碼如下:


@Service
public class UserServiceImpl implements UserService {	

	private  final Logger logger = LoggerFactory.getLogger(this.getClass());
	@Autowired
    private UserDao userDao;	
	
	@Override
	public boolean addUser(User user) {
		boolean flag=false;
		try{
			userDao.addUser(user);
			flag=true;
		}catch(Exception e){
			logger.error("新增失敗!",e);
		}
		return flag;
	}

	@Override
	public boolean updateUser(User user) {
		boolean flag=false;
		try{
			userDao.updateUser(user);
			flag=true;
		}catch(Exception e){
			logger.error("修改失敗!",e);
		}
		return flag;
	}

	@Override
	public boolean deleteUser(int id) {
		boolean flag=false;
		try{
			userDao.deleteUser(id);
			flag=true;
		}catch(Exception e){
			logger.error("刪除失敗!",e);
		}
		return flag;
	}


	@Override
	public User findByUserId(int id) {
		return userDao.findByUserId(id);
	}
}

Controller 控制層

控制層這邊也比較簡單,使用Restful風格實現的CRUD功能。

代碼如下:


@RestController
@RequestMapping(value = "/api")
public class UserRestController {
	
	private  final Logger logger = LoggerFactory.getLogger(this.getClass());

	
	@Autowired
    private UserService userService;
 
	@PostMapping("/user")
    public boolean addUser(@RequestBody User user) {
    	logger.info("開始新增...");
        return userService.addUser(user);
    }
    
	@PutMapping("/user")
    public boolean updateUser(@RequestBody User user) {
    	logger.info("開始更新...");
        return userService.updateUser(user);
    }
	
	@DeleteMapping("/user")
    public boolean delete(@RequestParam(value = "id", required = true) int userId) {
    	logger.info("開始刪除...");
        return userService.deleteUser(userId);
    }
	

    @GetMapping("/user")
    public User findByUserId(@RequestParam(value = "id", required = true) int userId) {
    	logger.info("開始查詢所有數據...");
        return userService.findByUserId(userId);
    }
}

App 入口

和普通的SpringBoot項目基本一樣。

代碼如下:


@SpringBootApplication
public class App 
{
    public static void main( String[] args )
    {
		SpringApplication.run(App.class, args);
		System.out.println("程序正在運行...");
    }
}

功能測試

我們成功啟動該程序之后,使用Postman工具來進行接口測試。

首先添加一條數據,使用POST方式進行請求

POST http://localhost:8180/api/user

Body參數為:

{"id":1,"name":"xuwujing","age":18}

在這里插入圖片描述
界面返回true,表示新增成功了!

然后在進行查詢,使用GET請求。

GET http://localhost:8180/api/user?id=1

返回:

{"id":1,"name":"xuwujing","age":18}

在這里插入圖片描述

我們再來使用RedisDesktopManager工具進行查詢看下,是否真的寫入到Redis中去了。

在這里插入圖片描述
可以看到已經成功寫入到Redis中了。

然后我們再來更新下更新該數據,使用PUT方式請求。

PUT http://localhost:8180/api/user

這里只是更改了下age年齡,Body參數為:

{"id":1,"name":"xuwujing","age":19}

在這里插入圖片描述
可以看到已經成功更新了。

最后我們再來查詢一遍看下是否成功更新。

GET http://localhost:8180/api/user?id=1

返回:

{"id":1,"name":"xuwujing","age":19}

在這里插入圖片描述
可以看到已經成功更新了。

其它

其實SpringBoot整合Redis整個項目很早之前就已經寫好並且上傳到Github了,但是一直沒有抽出時間寫篇博客講述(還有很多SpringBoot的項目也是如此),最近不是那么的忙了,於是准備了下時間編寫本篇博文。后續個人Github上的SpringBoot項目中以后有時間的話,也會對其中的一些發表博文進行講解,不過那是以后的事了ヽ(ー_ー)ノ

關於SpringBoot整合Redis的文章就講解到這里了,如有不妥,歡迎指正!

項目地址

SpringBoot整合Redis的項目工程地址:
https://github.com/xuwujing/springBoot-study/tree/master/springboot-Redis

SpringBoot整個集合的地址:
https://github.com/xuwujing/springBoot-study

SpringBoot整合系列的文章

音樂推薦

原創不易,如果感覺不錯,希望給個推薦!您的支持是我寫作的最大動力!
版權聲明:
作者:虛無境
博客園出處:http://www.cnblogs.com/xuwujing
CSDN出處:http://blog.csdn.net/qazwsxpcm    
個人博客出處:http://www.panchengming.com


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM