https://blog.csdn.net/stonexmx/article/details/77604571

自定義注解

package com.awj.mall.restfulapi.common.swagger.annotion;import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target;@Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) public @interface ApiVersion {String[] group();}

創建版本常量類

package com.awj.mall.restfulapi.common.swagger.consts;public interface ApiVersionConsts {String V_2_2_1 = "v_2_2_1";}

3.改造swagger2生成文檔類

package com.awj.mall.restfulapi.config;import java.util.Arrays;import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.web.context.request.async.DeferredResult;import com.awj.mall.restfulapi.common.swagger.annotion.ApiVersion; import com.awj.mall.restfulapi.common.swagger.consts.ApiVersionConsts; import com.google.common.base.Predicate;import io.swagger.annotations.ApiOperation; import springfox.documentation.RequestHandler; import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.builders.PathSelectors; import springfox.documentation.builders.RequestHandlerSelectors; import springfox.documentation.service.ApiInfo; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket;@Configuration public class Swagger2 {@Beanpublic Docket createRestApi() {return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select().apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class)).paths(PathSelectors.any()).build();}// @Bean // public Docket v2_2_1(){ // return new Docket(DocumentationType.SWAGGER_2) // .apiInfo(apiInfo()) // .groupName(ApiVersionConsts.V_2_2_1) // .select() // .apis(input -> { // ApiVersion apiVersion = input.getHandlerMethod().getMethodAnnotation(ApiVersion.class); // if(apiVersion!=null&& Arrays.asList(apiVersion.group()).contains(ApiVersionConsts.V_2_2_1)){ // return true; // } // return false; // })//controller路徑 // .paths(PathSelectors.any()) // .build(); // }@Beanpublic Docket v2_2_1(){return new Docket(DocumentationType.SWAGGER_2).groupName(ApiVersionConsts.V_2_2_1).genericModelSubstitutes(DeferredResult.class) // .genericModelSubstitutes(ResponseEntity.class).useDefaultResponseMessages(false).forCodeGeneration(false).select().apis(new Predicate<RequestHandler>() {@Overridepublic boolean apply(RequestHandler input) {ApiVersion apiVersion = input.getHandlerMethod().getMethodAnnotation(ApiVersion.class);if(apiVersion!=null&& Arrays.asList(apiVersion.group()).contains(ApiVersionConsts.V_2_2_1)){return true;}return false;}}).paths(PathSelectors.any())//過濾的接口.build().apiInfo(apiInfo());}/* @Beanpublic Docket packageApi() {return new Docket(DocumentationType.SWAGGER_2).groupName("app").apiInfo(apiInfo()).select().apis(RequestHandlerSelectors.basePackage("com.awj.mall.restfulapi.modular")).paths(PathSelectors.any()).build();}*/private ApiInfo apiInfo() {return new ApiInfoBuilder().title("安萬家-數據接口API").version("v1").build();} }

4.利用注解進行swagger2分組

/*** 刷新個人信息(app端登入之后使用)* * @param requestApiParam* @return*/ @RequestMapping(value = "v1/getuserbaseinfo", method = RequestMethod.POST) @ApiOperation(value = "刷新個人信息(app端登入之后使用)", notes = "一期一階") @ApiVersion(group= {ApiVersionConsts.V_2_2_1}) public ResultEntity<UserBaseInfoVO> getUserBaseInfo(@RequestBody RequestApiParam<EmptyDTO> requestApiParam) {assertUidNotNull(requestApiParam);UserBaseInfoVO userBaseInfoVO = new UserBaseInfoVO();UserBaseInfo userBaserInfo = this.userBaseInfoService.selectByUserId(HttpConsts.NO, HttpConsts.YES,requestApiParam.getUid());if (userBaserInfo == null) {return error(ResultCode.USER_NOT_EXIST);}BeanUtil.copyProperties(userBaserInfo, userBaseInfoVO);final String randomKey = jwtTokenUtil.getRandomKey();String jwtToken = jwtTokenUtil.generateToken(userBaseInfoVO.getId(), randomKey);// 設置jwtTokenuserBaseInfoVO.setRandomKey(randomKey);userBaseInfoVO.setAuthToken(jwtToken);userBaseInfoVO.setUserRole(UserUtil.getUserRoleByUserId(requestApiParam.getUid()));UserFirstpartyInfo userFirstpartyInfo = new UserFirstpartyInfo();if (UserConsts.SHOP_SERVICE.equals(userBaserInfo.getIdentity())) {List<UserFirstpartyInfo> userFirstpartyInfos = this.iUserFirstpartyInfoService.selectList(new EntityWrapper<UserFirstpartyInfo>().eq("is_deleted", HttpConsts.NO).eq("is_enable", HttpConsts.YES).eq("user_id", requestApiParam.getUid()).orderBy("created", false));if (userFirstpartyInfos != null && !userFirstpartyInfos.isEmpty()) {userFirstpartyInfo = userFirstpartyInfos.get(0);}}userBaseInfoVO.setUserFirstpartyInfo(userFirstpartyInfo);if (userBaserInfo.getpServiceUserId() != null) {UserBaseInfo pUserBaserInfo = this.userBaseInfoService.selectByUserId(HttpConsts.NO, HttpConsts.YES,userBaserInfo.getpServiceUserId());userBaseInfoVO.setpUserBaseInfo(pUserBaserInfo == null ? new UserBaseInfo() : pUserBaserInfo);}return success(userBaseInfoVO); } 創作挑戰賽新人創作獎勵來咯，堅持創作打卡瓜分現金大獎

總結

以上是生活随笔為你收集整理的swagger2 分组的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。