spring-best-practices 总结了下这几年 Spring 开发的一些优雅实现

[rizon]

Github 地址： https://github.com/othorizon/spring-best-practices

---

spring 最佳实践

总结了本人 3 年 Java 开发中的一些开发经验和工具类以及 Spring 框架的应用
采用了 Spring 项目的模式来最简单直观的呈现，直接拿来作为初始化项目也是不错的选择
该项目还在打磨中，仍有很多需要完善和优化的地方

持续更新，欢迎 PR

概要

• 如何配置拦截器：interceptor、filter、 @RestControllerAdvice
• bean 的初始化：InitializingBean 接口、 @conditionXXX 注解
• 如何获取 applicationContext 上下文：ApplicationContextAware
• 枚举的优雅使用：1、如何把枚举作为接口的交互参数：@JsonCreator、 @JsonValue ,要注意 fastjson 和 spring 采用的 jackson 对注解的支持 2、valueOfByXX
• 缓存的优雅使用： @Cacheable、CaffeineCacheManager、请求级别的缓存 RequestScopedCacheManager，注意防止副作用操作污染缓存数据
• 配置文件配置时间属性：java.time.Duration
• 正确的报错方式，message 的国际化
• 日志的优雅配置：log4j 与 logback 的基础、使用 MDC 增加 tractId 跟踪日志

第三方工具的使用

• RestTemplate 的优雅使用：工具类的封装、header 的注入
• 借助 Mybatis-Plus 实现零 SQL 开发
• 借助 MapStruct 实现 po、bo、vo 等对象之间的转换
• 健康接口，版本检查：buildnumber-maven-plugin
• 如何深度复制对象：json 复制、mapStruct
• apache-common 系列、hutool 等基本工具类
• 自定义的时间格式化工具类、jackson 的封装工具

运维

• 数据库版本维护 flyway
• Jenkins 的常用配置方式

---

Github 地址： https://github.com/othorizon/spring-best-practices

先起个头，后面会花时间去整理、沉淀和打磨的。

不知道这东西到底有没有写的价值，所以有些小纠结， 不过对别人来说也许毫无用处，但是对我来说却是非常有意义的了。
如果您觉得这里面有能对你有点用处的东西，麻烦给个 star 支持下哈～～

[rizon]

v 站大佬太多，其实怕大家笑话，有些不太敢发帖的，唉～～

[chenshun00]

提交的概要好像没有啥是我需要的 :(

[crclz]

star 一哈

[a852695]

不错 正在学习 java

[wysnylc]

配置和工具交流可还行....

[Sunyanzi]

看到这个列表我突然想到一个问题 ... 使用 Interceptor 的正确姿势到底是什么 ..?

我个人一直在用 AOP 实现类似的功能 ... 而且感觉语法更优雅一些 ...

有哪些需求是切面织入无法完成必须要用拦截器的吗 ..?

[beginor]

居然没有 Spring.Security 相关的？

[Takamine]

@Sunyanzi 我感觉单从前置来说。……你想要对一个妹纸伸手，拦截器是装了道门 AOP 是穿了件衣服吧。:doge:

[magicnobob]

很好，向大佬学习，spring 要多学多用

[diagram2048]

向大佬学习

[FanError]

@beginor Spring Security 太复杂了，感觉很多人都用拦截器，AOP 自己实现权限等验证操作。

[securityCoding]

@Sunyanzi aop 做的事情多一些，interceptor 针对的是 http 调用链

[rizon]

@Sunyanzi #6 嗯，还有 aop，把这个给忘了，回头补上 aop 的使用，
个人觉得拦截器是专门专事，aop 则就是更粗暴的去解决了问题，有失优雅
我只拿 aop 写过打印方法执行时间的日志，和自定义注解的处理。今天找个时间加上哈

[rizon]

@Sunyanzi #6 java 写代码就是要把事情说清楚，说的有规矩有框子，虽然不够潇洒自由，但对于企业级的项目，可维护性、健壮性才是最重要的，避免技术负债。所以 aop 在可维护性上是低于拦截器的，而且因为 AOP 的手脚太长，容易被错误使用带来无法预期的和难以排查的问题

[palmers]

还有 spring profile 以及 bean 声明的 xml 头的一些 default 配置 也挺好用的 很多场景可以使用到 可以一定程度上做到依赖分离处理 统一异常处理等等 如果整理需要全面一些，个人觉得是很有意义的 支持你

[palmers]

哦对了 记得加上 spring 对应版本范围

[Allianzcortex]

@FanError 举手 ！ 我就是这么做的： https://github.com/Allianzcortex/LaraForum/blob/master/src/main/java/com/laraforum/authorization/RolesAndPermissionsChecker.java 用 AOP 来判断权限

[rizon]

@palmers #15 感谢支持，Spring 的 IOC 方面的东西 我会好好整理一下哈，
spring boot 用的是 2.1.X，本来想用的 2.2 的，不过考虑到之前项目一直用的 2.1，那时候 Spring cloud 的兼容 2.2 版本的 Hoxton 还没有出，所以还是继续用 2.1 吧

[rizon]

@FanError #11
@Allianzcortex #17

我在项目中一直用的是拦截器，在我整理的这个项目里也写了一个简单的 auth 实现，特点是解耦。
aop 是针对方法的，拦截器则是针对 http 请求的，我们的权限认证都是针对接口请求的。

我们的权限认证服务是单独开发的，采用 sdk 的方式从公司的私有 maven 仓库分发到各个组件的服务，使用方只要把 sdk 中的拦截器注册进来就可以了。
这样代码侵入最低，当然这种方式也有他的适用范围，各个项目的开发都有自己的不同处境，aop 也有它独有的优势。

[m1862897]

看了一下，其中的 mapstruct 非常不好用

spring 本身就提供 beansutil 做拷贝，你这个画蛇添足
另外 hutool 是好东西，比 google 的 guava 还好用，值得推荐

其他的都是 spring 的基本用法，不值一提