Demo地址:https:gitee。compenglddemoswaggerdemoMaven依赖!SwaggerdependencygroupIdio。springfoxgroupIdspringfoxswagger2artifactIdversion2。9。2versionexclusionsexclusiongroupIdio。swaggergroupIdswaggermodelsartifactIdexclusionexclusionsdependencydependencygroupIdio。swaggergroupIdswaggermodelsartifactIdversion1。5。21versiondependencydependencygroupIdio。swaggergroupIdswaggerannotationsartifactIdversion1。5。21versiondependencydependencygroupIdio。springfoxgroupIdspringfoxswaggeruiartifactIdversion2。9。2versiondependencydependencygroupIdcom。github。xiaoymingroupIdswaggerbootstrapuiartifactIdversion1。9。6versiondependencySwagger配置packagecn。pengld。swagger。importcom。google。common。base。Fimportcom。google。common。base。Oimportcom。google。common。base。Pimportorg。springframework。beans。factory。annotation。Vimportorg。springframework。context。annotation。Bimportorg。springframework。context。annotation。Cimportorg。springframework。util。StringUimportorg。springframework。web。servlet。config。annotation。EnableWebMimportorg。springframework。web。servlet。config。annotation。WebMvcConfigurationSimportspringfox。documentation。RequestHimportspringfox。documentation。builders。ApiInfoBimportspringfox。documentation。builders。ParameterBimportspringfox。documentation。builders。PathSimportspringfox。documentation。schema。ModelRimportspringfox。documentation。service。ApiIimportspringfox。documentation。service。Pimportspringfox。documentation。spi。DocumentationTimportspringfox。documentation。spring。web。plugins。Dimportspringfox。documentation。swagger2。annotations。EnableSwagger2;importjava。util。ArrayLimportjava。util。L项目名称:apidoc设置devtest环境开启prod环境就关闭了EnableWebMvcEnableSwagger2ConfigurationProfile({local,dev,fat,uat,prefive,pre})publicclassSwaggerConfigextendsWebMvcConfigurationSupport{Value({swagger。path})privateStringswaggerPValue({spring。application。name})privateStringapplicationNBeanpublicDocketcreateRestApi(){在配置好的配置类中增加此段代码即可ParameterBuilderticketParnewParameterBuilder();ListParameterparametersnewArrayListParameter();name表示名称,description表示描述required表示是否必填,defaultvalue表示默认值ticketPar。name(ticket)。description(ticket)。modelRef(newModelRef(string))。parameterType(header)。required(false)。build();parameters。add(ticketPar。build());returnnewDocket(DocumentationType。SWAGGER2)。apiInfo(apiInfo())。select()。apis(basePackage(swaggerPath))。paths(PathSelectors。any())。build()。globalOperationParameters(parameters);}api文档的详细信息函数,注意这里的注解引用的是哪个returnprivateApiInfoapiInfo(){returnnewApiInfoBuilder()。title(!StringUtils。isEmpty(applicationName)?applicationName。toUpperCase()服务API接口:API接口)。version(1。0)。description(API描述)。build();}publicstaticPredicateRequestHandlerbasePackage(finalStringbasePackage){returninputdeclaringClass(input)。transform(handlerPackage(basePackage))。or(true);}privatestaticFunctionC?,BooleanhandlerPackage(finalStringbasePackage){returninput{循环判断匹配for(StringstrPackage:basePackage。split(,)){booleanisMatchinput。getPackage()。getName()。startsWith(strPackage);if(isMatch){}}};}privatestaticO?extendsC?declaringClass(RequestHandlerinput){returnOptional。fromNullable(input。declaringClass());}}packagecn。pengld。swagger。importorg。springframework。context。annotation。Cimportorg。springframework。web。servlet。config。annotation。EnableWebMimportorg。springframework。web。servlet。config。annotation。ResourceHandlerRimportorg。springframework。web。servlet。config。annotation。WebMvcCConfigurationEnableWebMvcpublicclassWebMvcConfigimplementsWebMvcConfigurer{OverridepublicvoidaddResourceHandlers(ResourceHandlerRegistryregistry){registry。addResourceHandler(swaggerui。html)。addResourceLocations(classpath:METAINFresources);registry。addResourceHandler(doc。html)。addResourceLocations(classpath:METAINFresources);registry。addResourceHandler(webjars)。addResourceLocations(classpath:METAINFresourceswebjars);}}controller配置packagecn。pengld。swagger。web。importio。swagger。annotations。Aimportio。swagger。annotations。ApiModelPimportio。swagger。annotations。ApiOimportlombok。AllArgsCimportlombok。Dimportorg。springframework。web。bind。annotation。GetMimportorg。springframework。web。bind。annotation。RequestMimportorg。springframework。web。bind。annotation。RestCimportjava。util。ArrayLimportjava。util。LRestControllerRequestMapping(user)Api(valueuser,tags用户相关接口)publicclassUserController{ApiOperation(valuegetUserList,notes获取用户列表,httpMethodGET)GetMapping(valuegetUserList)publicListUsergetUserList(){ListUseruserListnewArrayList();userList。add(newUser(1L,Jack));returnuserL}}DataAllArgsConstructorclassUser{ApiModelProperty(valueid,nameid)LApiModelProperty(valuename,namename)S}