引言
最近花了大概20天来完成了一个单体的前后端分离的项目，从8.25开始，到现在，也是挺心累的。整体的代码没致命的问题，但是也有些小bug没有解决。总体来说也算是一个小阶段性成果吧。
数据库建设
1 spring报错sql语法异常
确保表名、数据库名、字段名都不使用关键词
数据库名，表的表名，字段名都不允许使用mysql相关的关键词，否则会报sql语法异常的错误！
这个坑导致我前前后后找了3个小时，原因是把一个表名设成了order，我们都知道,order是mysql里面的关键字，因此当Mysql处理sql语句时把这个order当作order by来处理了！
具体的mysql关键字在这个网址里：mysql关键词查询
2 字段名数量
首先在设计整个项目的数据库时就要考虑清楚，哪些字段名是传参时候就必须的，哪些是使用DTO来扩展的，哪些是使用公共字段自动填充的，哪些是直接丢在Redis里面的或者在mongodb里面的，否则，当你发现前端传回来的值有多余或者缺少时是件非常麻烦的事情。
DTO解决简化了多次数据传输的冗余以及简化了数据库
3 公共字段自动处理
最新操作时间、最新操作人这类所有操作都会触发的字段，可以封装成一个全局公共字段自动处理类来使用（没错，就是aop），简化了业务层的开发
第三方中间件缓存的坑
当前端传回一个值时，我们在后端需要有相应的地址来接收，并且处理相应的参数值缓存到第三方中间件内（比如redis），而前端传回的值参差不齐，如果没有统一的前后端交互协议以及结果处理，那么很有可能导致后期代码扩展性差
我们需要一个共有的字段来处理同一个缓存结果，否则其它的更新/删除操作而产生的数据的更新将不及时（会按照cache的储存时长TTL来更新）
这个共有字段的问题困扰了我一个晚上，最终因前端页面写死，无法大刀阔斧地改动而罢休
通用处理类
1 线程副本
可以使用ThrealLocal线程副本来保存登录信息
但是这种方法在分布式中无法使用
2 自定义业务异常类处理
在全局异常里面使用
这样的好处是可以捕获运行时的异常进行相应的处理
3 Json序列化器
这个序列化器是用于保证json正确地将值在spring框架中传送的
/**
* 对象映射器:基于jackson将Java对象转为json，或者将json转为Java对象
* 将JSON解析为Java对象的过程称为 [从JSON反序列化Java对象]
* 从Java对象生成JSON的过程称为 [序列化Java对象到JSON]
*/
public class JacksonObjectMapper extends ObjectMapper {
public static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
public static final String DEFAULT_DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";
public static final String DEFAULT_TIME_FORMAT = "HH:mm:ss";
public JacksonObjectMapper() {
super();
//收到未知属性时不报异常
this.configure(FAIL_ON_UNKNOWN_PROPERTIES, false);
//反序列化时，属性不存在的兼容处理
this.getDeserializationConfig().withoutFeatures(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
SimpleModule simpleModule = new SimpleModule()
.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
.addDeserializer(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
.addDeserializer(LocalTime.class, new LocalTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)))
.addSerializer(BigInteger.class, ToStringSerializer.instance)
.addSerializer(Long.class, ToStringSerializer.instance)
.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
.addSerializer(LocalDate.class, new LocalDateSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
.addSerializer(LocalTime.class, new LocalTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)));
//注册功能模块 例如，可以添加自定义序列化器和反序列化器
this.registerModule(simpleModule);
}
}
4 前后端协议联调
设置一个R结果处理集，在R内的是T任意类型，以保证其通用性
@Data
public class R<T> {
/**
* 状态码：1成功，0失败
*/
private Integer code;
/**
* 错误信息
*/
private String msg;
/**
* 数据
*/
private T data;
/**
* 动态数据
*/
private Map map = new HashMap();
/**
* 响应成功状态
*
* @param object
* @param <T>
* @return r
*/
public static <T> R<T> success(T object) {
R<T> r = new R<T>();
r.data = object;
r.code = 1;
return r;
}
/**
* 响应失败状态
*
* @param msg
* @param <T>
* @return r
*/
public static <T> R<T> error(String msg) {
R<T> r = new R<T>();
r.msg = msg;
r.code = 0;
return r;
}
/**
* 增加动态数据
* @param key
* @param value
* @return R
*/
public R<T> add(String key, Object value) {
this.map.put(key, value);
return this;
}
}
通用配置类
1 mybatisplus分页配置类
若要使插件生效，必须加上配置类
@Configuration
public class MybatisPlusConfig {
/**
* 分页查询插件的配置类
*
* @return
*/
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor mybatisPlusInterceptor = new MybatisPlusInterceptor();
mybatisPlusInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());
return mybatisPlusInterceptor;
}
}
2 redis序列化配置类
为保证redis的key名能够被接收并调用，必须对key进行序列化，否则会出现/0x/6x之类的代码（value不需要，当然，加上也没关系）
@Configuration
public class RedisConfig extends CachingConfigurerSupport {
@Bean
public RedisTemplate<Object, Object> redisTemplate(RedisConnectionFactory connectionFactory) {
RedisTemplate<Object, Object> redisTemplate = new RedisTemplate<>();
redisTemplate.setKeySerializer(new StringRedisSerializer());
redisTemplate.setHashKeySerializer(new StringRedisSerializer());
redisTemplate.setConnectionFactory(connectionFactory);
return redisTemplate;
}
}
3 前端JS精度丢失问题
由于我们的数据库id是雪花算法生成的，因此使用Intenger已经不再能接收值（Long才可以），对于JS来说，更为致命（由于数字过长，JS会将后两位处理为0，即精度丢失）
@Slf4j
@Configuration
//springboot建这个项目的写这个mvc配置类要实现WebMvcConfigurer接口，而不是继承WebMvcConfigurationSupport
public class WebMvcConfig implements WebMvcConfigurer {
/**
* 扩展mvc框架的消息转换器，可以兼容前端js与后端java的数据类型，处理精度丢失等问题
*
* @param converters
*/
@Override
public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
log.info("创建转换器");
//创建消息转换器对象
MappingJackson2HttpMessageConverter messageConverter = new MappingJackson2HttpMessageConverter();
//设置对象转换器，底层使用jackson将java对象转为json
messageConverter.setObjectMapper(new JacksonObjectMapper());
//将上面的消息转换器对象追加到mvc框架的转换器内
converters.add(0, messageConverter);
}
}
4 拦截器
拦截器可以有多个，这里因为代码是在本地跑的，就只需要一个了
@WebFilter(filterName = "loginCheckFilter", urlPatterns = "/*")
@Slf4j
public class LoginCheckFilter implements Filter {
//路径匹配器，支持通配符
public static final AntPathMatcher PATH_MATCHER = new AntPathMatcher();
@Override
public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
HttpServletRequest request = (HttpServletRequest) servletRequest;
HttpServletResponse response = (HttpServletResponse) servletResponse;
//1.获取本次请求的uri
String requestURI = request.getRequestURI();
log.info("拦截到请求: {}", requestURI);
//2.定义不需要处理的请求路径
String[] urls = new String[]{
"/employee/login",
"/employee/logout",
"/backend/**",
"/favicon.ico",
"front/**",
"common/**",
"/user/**"
};
//3.判断本次请求是否需要处理
boolean check = check(urls, requestURI);
//请求合法，不需要处理
if (check) {
log.info("放行{}", requestURI);
filterChain.doFilter(request, response);
return;
}
//后台：请求不合法，需要处理，判断用户是否登录，如果登录，那就放行；如果未登录，那就通过输出流的方式向客户端页面响应数据
if (request.getSession().getAttribute("employee") != null) {
log.info("用户已登录，id为{}", request.getSession().getAttribute("employee"));
Long empId = (Long) request.getSession().getAttribute("employee");
BaseContext.setCurrentId(empId);
filterChain.doFilter(request, response);
return;
}
//前台：请求不合法，需要处理，判断用户是否登录，如果登录，那就放行；如果未登录，那就通过输出流的方式向客户端页面响应数据
if (request.getSession().getAttribute("user") != null) {
log.info("用户已登录，id为{}", request.getSession().getAttribute("user"));
Long userId = (Long) request.getSession().getAttribute("user");
BaseContext.setCurrentId(userId);
filterChain.doFilter(request, response);
return;
}
log.info("用户未登录");
response.getWriter().write(JSON.toJSONString(R.error("NOTLOGIN")));
return;
}
/**
* 路径匹配，检查本次请求是否需要放行，匹配的上与否
*
* @param urls
* @param requestURI
* @return boolean
*/
public boolean check(String[] urls, String requestURI) {
for (String url : urls) {
boolean match = PATH_MATCHER.match(url, requestURI);
if (match) {
return true;
}
}
return false;
}
}
其它
1 实体类
实体类必须序列化，以保证数据的安全性implements Serializable
再自定义一个UIDprivate static final long serialVersionUID = 1L;
如果遇到公共字段，需要使用@TableField注解来使公共类自动装配生效
2 工具类
工具类也要注意需要加上@Component
否则无法被spring给装配到core容器内
3 事务
如果业务需要调用事务的，那么需要在业务层加上事务注解
并且在启动项里开启事务
SpringCloud版本问题
