主要业务：为公司活动（如年会等）提供在线抽奖功能，满足奖品、抽奖人员的管理，及抽奖活动的需要。
https://github.com/JACK-QBS/Project
数据库表关系图：
（业务上一对一）
为什么要有设置表？
要实现功能，需要先明确前后端约定好的接口。需要说明的是，接口的定义一般是前后端约定好的，所以也和前端代码息息相关，前端需要什么数据，需要什么格式的数据，也会在接口中体现。
接口主要体现在：
前端请求：
POST api/user/login （请求路径）
Content-Type: application/json
{username: “qbs”, password: “123”}
响应：
{ “success” : true }
后端实现接口：
前端请求：
POST api/user/register （请求路径）
Content-Type: multipart/form-data; boundary=----
WebKitFormBoundarypOUwkGIMUyL0aOZT
username: qbs
password: 123
nickname: 帅哥
email: 666@163.com
age: 18
headFile: (binary)
响应：
{ “success” : true }
后端实现：
前端请求：
POST api/user/login （请求路径）
后端实现：
前端请求：
GET api/setting/query（请求路径）
后端实现：
前端请求：
GET api/setting/update?batchNumber=5（请求路径）
（接口对应抽奖设置页面中，点每次抽奖人数下拉菜单切换时修改）
后端实现：
前端请求：
POST api/award/add （请求路径）
Content-Type: application/json
{name: “特等奖”, count: 1, award: “全球旅行7日游”}
后端实现：
前端请求：
POST api/award/update （请求路径）
Content-Type: application/json
后端响应：
前端请求：
GET api/award/delete/4（请求路径）
最后的数字4，对应奖项的id
后端实现：
前端请求：
POST api/member/add （请求路径）
Content-Type: application/json
后端实现：
前端请求：
POST api/member/update
Content-Type: application/json
后端实现：
前端请求：
GET api/member/delete/97
（最后的数字为抽奖人员的id）
后端实现：
前端请求：
POST api/record/add/3
Content-Type: application/json
（以上路径中最后的数字代表奖项id，请求数据为抽奖人员id组成的数组）
后端实现：
抽奖后端只是插入记录（人员id、奖项id），具体的抽奖是前端实现的，而且也是简单的实现方式，没有任何算法。（只是在当前奖项剩余名额中，每次抽奖人数，在所有未中奖的人员列表中，随机抽取）
前端请求：
GET api/record/delete/member?id=22
（根据 人员id 删除对应的获奖记录）
GET api/record/delete/award?id=3
（根据 奖项id 删除对应所有获奖人员记录）
后端实现：
（1）设计数据库的实体类：
通过 mybatis 生成工具（tool包）：生成 mapper、数据库表实体类（model包）、xml 文件
（2）设计统一响应类：
主要是为了返回数据的统一字段设计
/**
* 统一响应的数据格式
*/
public class JSONResponse {
private boolean success;
private String code;
private String message;
private Object data;
}
/**
* 统一数据封装
*/
public class RequestResponseBodyMethodProcessorWrapper implements HandlerMethodReturnValueHandler {
private final HandlerMethodReturnValueHandler delegate;
public RequestResponseBodyMethodProcessorWrapper(HandlerMethodReturnValueHandler delegate) {
this.delegate = delegate;
}
@Override
public boolean supportsReturnType(MethodParameter returnType) {
return delegate.supportsReturnType(returnType);
}
@Override
public void handleReturnValue(Object returnValue, MethodParameter returnType, ModelAndViewContainer mavContainer, NativeWebRequest webRequest) throws Exception {
//returnValue是Controller请求方法执行完，返回值
if(!(returnValue instanceof JSONResponse)){//返回值本身就是需要的类型，不进行处理
JSONResponse json = new JSONResponse();
json.setSuccess(true);
json.setData(returnValue);
returnValue = json;
}
delegate.handleReturnValue(returnValue, returnType, mavContainer, webRequest);
}
}
（3）设计自定义异常：
主要针对不同的场景，需要抛异常来处理时，能定位业务含义。
主要分为：
/**
* 自定义异常：保存错误码和错误消息
*/
@Getter
@Setter
public class AppException extends RuntimeException {
private String code;
public AppException( String code, String message) {
super(message);
this.code = code;
}
public AppException( String code, String message, Throwable cause) {
super(message, cause);
this.code = code;
}
}
//统一异常处理
@ControllerAdvice
@Slf4j//使用lombok日志日志注解，之后使用log属性来完成日志打印
public class ExceptionAdvice {
//自定义异常报错错误码和错误消息
@ExceptionHandler(AppException.class)
@ResponseBody
public Object handle1(AppException e){
JSONResponse json = new JSONResponse();
json.setCode(e.getCode());
json.setMessage(e.getMessage());
log.debug("自定义异常", e);
return json;
}
//非自定义异常（英文错误信息，堆栈信息，不能给用户看）：
// 指定一个错误码，错误消息（未知错误，请联系管理员）
@ExceptionHandler(Exception.class)
@ResponseBody
public Object handle2(Exception e){
JSONResponse json = new JSONResponse();
json.setCode("ERR000");
json.setMessage("未知错误，请联系管理员");
log.error("未知错误", e);
return json;
}
}
（4）设计统一会话管理的拦截器
public class LoginInterceptor implements HandlerInterceptor {
private ObjectMapper objectMapper;
public LoginInterceptor(ObjectMapper objectMapper) {
this.objectMapper = objectMapper;
}
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
HttpSession session = request.getSession(false);
if(session != null){//获取登录时设置的用户信息
User user = (User) session.getAttribute("user");
if(user != null){//登录了，允许访问
return true;
}
}
//登录失败，不允许访问的业务：区分前后端
//TODO：前端跳转登录页面，后端返回json
// new ObjectMapper().writeValueAsString(object);//序列化对象为json字符串
//请求的服务路径
String servletPath = request.getServletPath();// /apiXXX.html
if(servletPath.startsWith("/api/")){//后端逻辑：返回json
response.setCharacterEncoding("UTF-8");
response.setContentType(MediaType.APPLICATION_JSON_VALUE);
JSONResponse json = new JSONResponse();
json.setCode("USR000");
json.setMessage("用户没有登录，不允许访问");
String s = objectMapper.writeValueAsString(json);
response.setStatus(HttpStatus.UNAUTHORIZED.value());
PrintWriter pw = response.getWriter();
pw.println(s);
pw.flush();
}else{//前端逻辑：跳转到登录页面 /views/index.html
//相对路径的写法，一定是请求路径作为相对位置的参照点
//使用绝对路径来重定向，不建议使用相对路径和转发
String schema = request.getScheme();//http
String host = request.getServerName();//ip
int port = request.getServerPort();//port
String contextPath = request.getContextPath();//application Context path应用上下文路径
String basePath = schema+"://"+host+":"+port+contextPath;
//重定向到登录页面
response.sendRedirect(basePath+"/index.html");
}
return false;
}
}
（5）设计Mybatis中Mapper的基类：
使用Mybatis的接口方法，所有接口方法都是类似，只是传入参数和返回值不同，可以考虑设计统一的基类，以泛型的方式定义出不同的参数类型、返回类型
/**
* 所有 mapper 父接口
*/
public interface BaseMapper<T> {
int deleteByPrimaryKey(Integer id);
int insert(T record);
int insertSelective(T record);
T selectByPrimaryKey(Integer id);//通过主键查询
int updateByPrimaryKeySelective(T record);//根据主键修改其他非主键字段
int updateByPrimaryKey(T record);
}