Java 項目構建基礎，“ 三個統(tǒng)一” 天下！
戳這里，加關注哦～
統(tǒng)一結果返回
目前的前后端開發(fā)大部分數(shù)據(jù)的傳輸格式都是json，因此定義一個統(tǒng)一規(guī)范的數(shù)據(jù)格式有利于前后端的交互與UI的展示。
統(tǒng)一結果的一般形式
是否響應成功； 響應狀態(tài)碼； 狀態(tài)碼描述； 響應數(shù)據(jù) 其他標識符
結果類枚舉
前三者可定義結果枚舉，如：success，code，message
@Getter
public?enum?ResultCodeEnum?{
????SUCCESS(true,20000,"成功"),
????UNKNOWN_ERROR(false,20001,"未知錯誤"),,
????PARAM_ERROR(false,20002,"參數(shù)錯誤"),
????;
????//?響應是否成功
????private?Boolean?success;
????//?響應狀態(tài)碼
????private?Integer?code;
????//?響應信息
????private?String?message;
????ResultCodeEnum(boolean?success,?Integer?code,?String?message)?{
????????this.success?=?success;
????????this.code?=?code;
????????this.message?=?message;
????}
}
統(tǒng)一結果類
第5個屬于自定義返回，利用前4者可定義統(tǒng)一返回對象
注意：
外接只可以調用統(tǒng)一返回類的方法，不可以直接創(chuàng)建，影刺構造器私有； 內置靜態(tài)方法，返回對象； 為便于自定義統(tǒng)一結果的信息，建議使用鏈式編程，將返回對象設類本身，即return this; 響應數(shù)據(jù)由于為json格式，可定義為JsonObject或Map形式；
@Data
public?class?R?{
????private?Boolean?success;
????private?Integer?code;
????private?String?message;
????private?Map?data?=?new?HashMap<>();
????//?構造器私有
????private?R(){}
????//?通用返回成功
????public?static?R?ok()?{
????????R?r?=?new?R();
????????r.setSuccess(ResultCodeEnum.SUCCESS.getSuccess());
????????r.setCode(ResultCodeEnum.SUCCESS.getCode());
????????r.setMessage(ResultCodeEnum.SUCCESS.getMessage());
????????return?r;
????}
????//?通用返回失敗，未知錯誤
????public?static?R?error()?{
????????R?r?=?new?R();
????????r.setSuccess(ResultCodeEnum.UNKNOWN_ERROR.getSuccess());
????????r.setCode(ResultCodeEnum.UNKNOWN_ERROR.getCode());
????????r.setMessage(ResultCodeEnum.UNKNOWN_ERROR.getMessage());
????????return?r;
????}
????//?設置結果，形參為結果枚舉
????public?static?R?setResult(ResultCodeEnum?result)?{
????????R?r?=?new?R();
????????r.setSuccess(result.getSuccess());
????????r.setCode(result.getCode());
????????r.setMessage(result.getMessage());
????????return?r;
????}
????/**------------使用鏈式編程，返回類本身-----------**/
????//?自定義返回數(shù)據(jù)
????public?R?data(Map?map)?{
????????this.setData(map);
????????return?this;
????}
????//?通用設置data
????public?R?data(String?key,Object?value)?{
????????this.data.put(key,?value);
????????return?this;
????}
????//?自定義狀態(tài)信息
????public?R?message(String?message)?{
????????this.setMessage(message);
????????return?this;
????}
????//?自定義狀態(tài)碼
????public?R?code(Integer?code)?{
????????this.setCode(code);
????????return?this;
????}
????//?自定義返回結果
????public?R?success(Boolean?success)?{
????????this.setSuccess(success);
????????return?this;
????}
}
控制層返回
視圖層使用統(tǒng)一結果
@RestController
@RequestMapping("/api/v1/users")
public?class?TeacherAdminController?{
????@Autowired
????private?UserService?userService;
????@GetMapping
????public?R?list()?{
????????List?list?=?teacherService.list(null);
????????return?R.ok().data("itms",?list).message("用戶列表");
????}
}
json結果
{
??"success":?true,
??"code":?20000,
??"message":?"查詢用戶列表",
??"data":?{
????"itms":?[
??????{
????????"id":?"1",
????????"username":?"admin",
????????"role":?"ADMIN",
????????"deleted":?false,
????????"gmtCreate":?"2019-12-26T15:32:29",
????????"gmtModified":?"2019-12-26T15:41:40"
??????},{
????????"id":?"2",
????????"username":?"zhangsan",
????????"role":?"USER",
????????"deleted":?false,
????????"gmtCreate":?"2019-12-26T15:32:29",
????????"gmtModified":?"2019-12-26T15:41:40"
??????}
????]
??}
}
統(tǒng)一結果類的使用參考了mybatis-plus中R對象的設計
統(tǒng)一異常處理
使用統(tǒng)一返回結果時，還有一種情況，就是程序的保存是由于運行時異常導致的結果，有些異常我們可以無法提前預知，不能正常走到我們return的R對象返回。
因此，我們需要定義一個統(tǒng)一的全局異常來捕獲這些信息，并作為一種結果返回控制層
@ControllerAdvice
該注解為統(tǒng)一異常處理的核心
是一種作用于控制層的切面通知（Advice），該注解能夠將通用的@ExceptionHandler、@InitBinder和@ModelAttributes方法收集到一個類型，并應用到所有控制器上
該類中的設計思路：
使用@ExceptionHandler注解捕獲指定或自定義的異常； 使用@ControllerAdvice集成@ExceptionHandler的方法到一個類中； 必須定義一個通用的異常捕獲方法，便于捕獲未定義的異常信息； 自定一個異常類，捕獲針對項目或業(yè)務的異常; 異常的對象信息補充到統(tǒng)一結果枚舉中；
自定義全局異常類
@Data
public?class?CMSException?extends?RuntimeException?{
????private?Integer?code;
????public?CMSException(Integer?code,?String?message)?{
????????super(message);
????????this.code?=?code;
????}
????public?CMSException(ResultCodeEnum?resultCodeEnum)?{
????????super(resultCodeEnum.getMessage());
????????this.code?=?resultCodeEnum.getCode();
????}
????@Override
????public?String?toString()?{
????????return?"CMSException{"?+?"code="?+?code?+?",?message="?+?this.getMessage()?+?'}';
????}
}
統(tǒng)一異常處理器
//?...
import?org.springframework.web.bind.annotation.ControllerAdvice;
import?org.springframework.web.bind.annotation.ExceptionHandler;
import?org.springframework.web.bind.annotation.ResponseBody;
@ControllerAdvice
public?class?GlobalExceptionHandler?{
????/**--------?通用異常處理方法?--------**/
????@ExceptionHandler(Exception.class)
????@ResponseBody
????public?R?error(Exception?e)?{
????????e.printStackTrace();
????????return?R.error();?//?通用異常結果
????}
????/**--------?指定異常處理方法?--------**/
????@ExceptionHandler(NullPointerException.class)
????@ResponseBody
????public?R?error(NullPointerException?e)?{
????????e.printStackTrace();
????????return?R.setResult(ResultCodeEnum.NULL_POINT);
????}
????@ExceptionHandler(HttpClientErrorException.class)
????@ResponseBody
????public?R?error(IndexOutOfBoundsException?e)?{
????????e.printStackTrace();
????????return?R.setResult(ResultCodeEnum.HTTP_CLIENT_ERROR);
????}
????/**--------?自定義定異常處理方法?--------**/
????@ExceptionHandler(CMSException.class)
????@ResponseBody
????public?R?error(CMSException?e)?{
????????e.printStackTrace();
????????return?R.error().message(e.getMessage()).code(e.getCode());
????}
}
控制層展示
以下為展示當遇到null指定異常時，返回的結果信息
{
??"success":?false,
??"code":?20007,
??"message":?"空指針異常",
??"data":?{}
}
本節(jié)介紹統(tǒng)一異常較為簡略，推薦博客SpringBoot之全局異常處理
統(tǒng)一日志收集
日志是追蹤錯誤定位問題的關鍵，尤其在生產(chǎn)環(huán)境中，需要及時修復熱部署，不會提供開發(fā)者debug的環(huán)境，此時日志將會是最快解決問題的關鍵
日志的框架比較豐富，由于spring boot對logback的集成，因此推薦使用logback在項目中使用。
Logback
關于logback的配置和介紹，可以參考官網(wǎng)或推薦博客glmapper的logback博客，logback-spring.xml配置文件
配置
以下直接貼出配置信息，介紹信息科直接參考備注
"1.0"?encoding="UTF-8"?>
"true"?scanPeriod="10?seconds">
????logback
????
????"log.path"?value="D:/Documents/logs/edu"?/>
????
????
????"clr"?converterClass="org.springframework.boot.logging.logback.ColorConverter"?/>
????"wex"?converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter"?/>
????"wEx"?converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter"?/>
????
????"CONSOLE_LOG_PATTERN"?value="${CONSOLE_LOG_PATTERN:-%clr(%d{yyyy-MM-dd?HH:mm:ss.SSS}){faint}?%clr(${LOG_LEVEL_PATTERN:-%5p})?%clr(${PID:-?}){magenta}?%clr(---){faint}?%clr([%15.15t]){faint}?%clr(%-40.40logger{39}){cyan}?%clr(:){faint}?%m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
????
????"CONSOLE"?class="ch.qos.logback.core.ConsoleAppender">
????????
????????"ch.qos.logback.classic.filter.ThresholdFilter">
????????????debug
????????
????????
????????????${CONSOLE_LOG_PATTERN}
????????????
????????????UTF-8
????????
????
????
????
????"DEBUG_FILE"?class="ch.qos.logback.core.rolling.RollingFileAppender">
????????
????????${log.path}/edu_debug.log
????????
????????
????????????%d{yyyy-MM-dd?HH:mm:ss.SSS}?[%thread]?%-5level?%logger{50}?-?%msg%n
????????????UTF-8 ?
????????
????????
????????"ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
????????????
????????????${log.path}/web-debug-%d{yyyy-MM-dd}.%i.log
????????????"ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
????????????????100MB
????????????
????????????
????????????15
????????
????????
????????"ch.qos.logback.classic.filter.LevelFilter">
????????????debug
????????????ACCEPT
????????????DENY
????????
????
????
????"INFO_FILE"?class="ch.qos.logback.core.rolling.RollingFileAppender">
????????
????????${log.path}/edu_info.log
????????
????????
????????????%d{yyyy-MM-dd?HH:mm:ss.SSS}?[%thread]?%-5level?%logger{50}?-?%msg%n
????????????UTF-8
????????
????????
????????"ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
????????????
????????????${log.path}/web-info-%d{yyyy-MM-dd}.%i.log
????????????"ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
????????????????100MB
????????????
????????????
????????????15
????????
????????
????????"ch.qos.logback.classic.filter.LevelFilter">
????????????info
????????????ACCEPT
????????????DENY
????????
????
????
????"WARN_FILE"?class="ch.qos.logback.core.rolling.RollingFileAppender">
????????
????????${log.path}/edu_warn.log
????????
????????
????????????%d{yyyy-MM-dd?HH:mm:ss.SSS}?[%thread]?%-5level?%logger{50}?-?%msg%n
????????????UTF-8 ?
????????
????????
????????"ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
????????????${log.path}/web-warn-%d{yyyy-MM-dd}.%i.log
????????????"ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
????????????????100MB
????????????
????????????
????????????15
????????
????????
????????"ch.qos.logback.classic.filter.LevelFilter">
????????????warn
????????????ACCEPT
????????????DENY
????????
????
????
????"ERROR_FILE"?class="ch.qos.logback.core.rolling.RollingFileAppender">
????????
????????${log.path}/edu_error.log
????????
????????
????????????%d{yyyy-MM-dd?HH:mm:ss.SSS}?[%thread]?%-5level?%logger{50}?-?%msg%n
????????????UTF-8 ?
????????
????????
????????"ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
????????????${log.path}/web-error-%d{yyyy-MM-dd}.%i.log
????????????"ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
????????????????100MB
????????????
????????????
????????????15
????????
????????
????????"ch.qos.logback.classic.filter.LevelFilter">
????????????ERROR
????????????ACCEPT
????????????DENY
????????
????
????
????
????
????
????
????"dev">
????????"com.cms"?level="info"/>
????????"info">
????????????"CONSOLE"?/>
????????????"DEBUG_FILE"?/>
????????????"INFO_FILE"?/>
????????????"WARN_FILE"?/>
????????????"ERROR_FILE"?/>
????????
????
????
????"pro">
????????"com.cms"?level="warn"/>
????????"info">
????????????"ERROR_FILE"?/>
????????????"WARN_FILE"?/>
????????
????
日志收集異常信息
日志信息往往伴隨著異常信息的輸出，因此，我們需要修改統(tǒng)一異常的處理器，將異常信息以流的方式寫到日志文件中
異常信息文件工具類
@Slf4j
public?class?ExceptionUtil?{
????/**
?????*?打印異常信息
?????*/
????public?static?String?getMessage(Exception?e)?{
????????String?swStr?=?null;
????????try?(StringWriter?sw?=?new?StringWriter();?PrintWriter?pw?=?new?PrintWriter(sw))?{
????????????e.printStackTrace(pw);
????????????pw.flush();
????????????sw.flush();
????????????swStr?=?sw.toString();
????????}?catch?(IOException?ex)?{
????????????ex.printStackTrace();
????????????log.error(ex.getMessage());
????????}
????????return?swStr;
????}
}
修改統(tǒng)一異常處理器，將異常方法中的直接打印改為日志輸入并打印
//?...
import?lombok.extern.slf4j.Slf4j;
@ControllerAdvice
@Slf4j
public?class?GlobalExceptionHandler?{
????/**--------?通用異常處理方法?--------**/
????@ExceptionHandler(Exception.class)
????@ResponseBody
????public?R?error(Exception?e)?{
????????//?e.printStackTrace();
????????log.error(ExceptionUtil.getMessage(e));
????????return?R.error();
????}
???//?...
}
注意
日志的環(huán)境即spring.profiles.acticve，跟隨項目啟動； 啟動后，即可到自定目錄查找到生成的日志文件； 本地idea調試時，推薦Grep Console插件可實現(xiàn)控制臺的自定義顏色輸出
來源：juejin.im/post/5e073980f265da33f8653f2e
?關注公眾號：Java后端編程，回復下面關鍵字?
要Java學習完整路線，回復??路線?
缺Java入門視頻，回復：?視頻?
要Java面試經(jīng)驗，回復??面試?
缺Java項目，回復：?項目?
進Java粉絲群：?加群?
PS：如果覺得我的分享不錯，歡迎大家隨手點贊、在看。
（完） 加我"微信"?獲取一份 最新Java面試題資料 請備注：666，不然不通過～
最近好文
最近面試BAT，整理一份面試資料《Java面試BAT通關手冊》，覆蓋了Java核心技術、JVM、Java并發(fā)、SSM、微服務、數(shù)據(jù)庫、數(shù)據(jù)結構等等。 獲取方式：關注公眾號并回復?java?領取，更多內容陸續(xù)奉上。 明天見(??ω??)??
評論
圖片
表情