## 一、概述 簡單介紹幾個常用注解： ## 二、核心業務 **@RayServiceMethod** 這個是最常用的注解，所有的業務方法，都應該加入它，平臺依據他進行一些參數編碼，加密解密，token解析與校驗、前端公用數據預準備等邏輯； ## 三、定制業務 **@RayValidateCodeMethod** 用于驗證碼業務邏輯，所有需要在前端進行驗證碼操作的業務，加上這個標記，即可解決驗證碼的業務，非常簡單高效； ## 四、性能跟蹤 **@RayTraceMethod和@RayTraceClass** 用于調試業務的兩個有用的注解，用它可以跟蹤業務邏輯，后臺會生成調用堆棧，一般用于業務調試用，生產的時候，會禁用； **@RayPerformanceMonitorMethod** **@RayDangerMethod和@RayDangerClass** 用于敏感和高風險業務的注解，增強安全約束； ## 五、登陸及安全校驗 ### **token驗證系列：** **@RayEscapeTokenValidateControllerMethod** 默認的，所有的api都需要驗證頭部的rayAccessToken，如果有些業務無須驗證，加上該注解，即可； **@RayOptionalTokenValidateControllerMethod** 有時候，同一個方法接口，需要同時支持頭部放token和不放兩種情形，那么加上該注解，即可； 舉例： ``` @ApiOperation(value = "購物車詳情", notes = "手機端顯示購物車詳情") @ApiOperationSupport(order = 1) @ApiImplicitParams({ // @ApiImplicitParam(name = RayConstants.rayAccessToken, value = "授權token", required = false, dataTypeClass = String.class, paramType = "header") }) @PostMapping("/api/business/rmall/mobile/cart/detail") @RayOptionalTokenValidateControllerMethod public ResponseEntity<ResponseObject> detail(@RequestHeader(required = false) String rayAccessToken) throws Exception { return ResponseEntity.ok(mobileCartService.detail()); } ``` **@RayValidateTokenInParamControllerMethod** 有時候，rayAccessToken不存放到頭部，而是放到參數里面，那么，需要通過這個注解來標記； ### **客戶端合法性驗證系列：** **@RayEscapeRequestValidateControllerMethod** 默認的，所有的api都需要驗證客戶端請求的合法性和合理性，如果某些業務需要規避驗證，加上這個注解，即可； ## 六、字典翻譯 **@RayDynamicConvert**系列注解 用于動態反應后端數據給前端業務匹配的注解，這個非常靈活，可以大幅度精簡后端代碼，是為了解決后端模型與前端業務的不匹配這個問題而設計實現的；