小Hub领读:
继续弄我们的开源项目eblog,今天,内容比较简单,我们先来弄一下基础的东西,异常处理与返回结果封装类的编写。
项目名称:eblog
项目Git仓库:https://github.com/MarkerHub/eblog(给个star支持哈)
前几篇文章:
1、Github上最值得学习的Springboot开源博客项目!
2、小Hub手把手教你如何从0搭建一个开源项目架构
1. 优雅的异常处理
有时候不可避免服务器报错的情况,如果不配置异常处理机制,就会默认返回tomcat或者nginx的5XX页面,对普通用户来说,不太友好,用户也不懂什么情况。这时候需要我们程序员设计返回一个友好简单的页面给用户。
处理办法如下:通过使用@ControllerAdvice来进行统一异常处理,@ExceptionHandler(value = Exception.class)来指定捕获的Exception各个类型异常 ,这个异常的处理,是全局的,所有类似的异常,都会跑到这个地方处理。
步骤一、首先我们自定义一个异常HwException,需要继承RuntimeException,这样涉及到事务时候才会有回滚。HwException将作为我们系统catch到错误时候报出来的异常。
public class HwException extends RuntimeException {
private int code;
public HwException() {}
public HwException(int code) {
this.code = code;
}
public HwException(String message) {
super(message);
}
public HwException(int code, String message) {
super(message);
this.code = code;
}
public int getCode() {
return code;
}
public void setCode(int code) {
this.code = code;
}
}
步骤二、定义全局异常处理,@ControllerAdvice表示定义全局控制器异常处理,@ExceptionHandler表示针对性异常处理,可对每种异常针对性处理。
@Slf4j
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(value = Exception.class)
public ModelAndView defaultErrorHandler(HttpServletRequest req, Exception e) {
log.error("------------------>捕捉到全局异常", e);
if(e instanceof HwException) {
//...
}
ModelAndView mav = new ModelAndView();
mav.addObject("exception", e);
mav.addObject("message", e.getMessage());
mav.addObject("url", req.getRequestURL());
mav.setViewName("error");
return mav;
}
@ExceptionHandler(value = HwException.class)
@ResponseBody
public Result jsonErrorHandler(HttpServletRequest req, HwException e) {
return Result.fail(e.getMessage(), "some error data");
}
}
步骤三、定义异常error页面。打开layui页面,有个tips.ftl的页面比较符合我们的异常页面。可用于展示异常。
class="layui-container fly-marginTop">
class="fly-panel">
class="fly-none">
class="iconfont icon-tishilian">
${message}
@layout>
2. 统一的结果返回封装(异步返回)
上面我们用到了一个Result的类,这个用于我们的异步统一返回的结果封装。一般来说,结果里面有几个要素必要的
所以可得到封装如下:
@Data
public class Result implements Serializable {
private String code;
private String msg;
private Object data;
public static Result succ(Object data) {
Result m = new Result();
m.setCode("0");
m.setData(data);
m.setMsg("操作成功");
return m;
}
public static Result succ(String mess, Object data) {
Result m = new Result();
m.setCode("0");
m.setData(data);
m.setMsg(mess);
return m;
}
public static Result fail(String mess) {
Result m = new Result();
m.setCode("-1");
m.setData(null);
m.setMsg(mess);
return m;
}
public static Result fail(String mess, Object data) {
Result m = new Result();
m.setCode("-1");
m.setData(data);
m.setMsg(mess);
return m;
}
}
3、集成redis
在redis课程中,我们演示过redis的主从、还有哨兵配置,高可用的redis集群中,可以帮我们完成主库下线,从库自动切换的功能。
集成到springboot中
第一步、导入redis的pom包
org.springframework.boot
spring-boot-starter-data-redis
第二步、配置redis的连接信息
spring:
redis:
sentinel:
master: mymaster
nodes: 47.106.38.101:26379,47.106.38.101:26380
以上的两个redis是我自己的阿里云上配置,大家可以用,也可以自己配置一个。 致此,redis已经集成到我们的springboot项目中了。
以上是哨兵的配置,如果单机redis的话,配置也简单:
spring:
redis:
host: localhost
port: 6379
第三步、为了让我们的存到redis中的缓存数据能更加容易看懂,这里换一种序列化方式,默认的是jdk的序列化方式,这里选用jackson2JsonRedisSerializer。只需要重写redisTemplate操作模板的生成方式即可。新建一个config包,放在这个包下。
@Configuration
public class RedisConfiguration {
@Bean
public RedisTemplate redisTemplate(RedisConnectionFactory redisConnectionFactory) throws UnknownHostException {
RedisTemplate template = new RedisTemplate();
template.setConnectionFactory(redisConnectionFactory);
Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer(Object.class);
jackson2JsonRedisSerializer.setObjectMapper(new ObjectMapper());
template.setKeySerializer(jackson2JsonRedisSerializer);
template.setValueSerializer(jackson2JsonRedisSerializer);
return template;
}
}
第四步、使用redisTemplate操作数据相对比较麻烦,我们使用一个util封装类,让我们操作redis更加方便。放在utils包下 RedisUtil.java(https://uploader.shimo.im/f/HTgtITdNfuklQepB.java)
至此,能操作redis的工具类和配置我们已经集成进来。后面我们需要用到缓存注解的时候我们再单独说明。
集成redis之后可以使用的地方又很多,比如我们的侧边栏热议功能,还有我们的缓存注解Cacheable等。但是使用了redis的缓存注解,你会发现不能给注解设定一个缓存过期时间,为了解决这个问题,我们引入redission。
首先开启一下我们的缓存注解功能,添加一个配置WebMvcConfig 。加上开启注解@EnableCaching。如下:
@EnableCaching
@Configuration
publicclassWebMvcConfig{
}
接下来,引入redission,其实很简单,首先引入jar包:
org.redisson
redisson-spring-boot-starter
3.10.6
因为redission其实也有引入spring-boot-starter-data-redis包,所以配置redis的属性其实和引入redis是一样的的,因此,引入了jar包之后,我们就可以使用redission功能了,比如做分布式锁、给缓存注解一个过期时间等 ok、关于 redis模块就说到这里,下面我们去填充一下首页的数据先。
(完)
MarkerHub文章索引:
https://github.com/MarkerHub/JavaIndex
【项目相关文章】
1、Github上最值得学习的Springboot开源博客项目!
2、小Hub手把手教你如何从0搭建一个开源项目架构
给eblog一个star,感谢支持哈