第一步: 生成http 的 swagger json 文件。這裏注意他是在mvn compile 的時候執行的,生成json 文件。
生成的文件:
第二步:生成項目文件路徑,注意這個地方需要執行mvn install 命令
生成的項目文件目錄:
第三步:修改項目的repository 配置。
就是上傳到mvn 私服 nexus 上,進入目錄之後 執行以下的:
這樣就上傳到nexus 上.
最後調用方需要配置這麼一行配置或者是引用一個spring security 的配置,因爲生成的項目會有auth2-client 的包,這樣會使調用方的swagger 有security 的認證。
1.配置方法:
2.java config 配置:
注意事項:@Api 需要添加tags,不然生成的swaggerclient 會放在defultApi 之中,
@Api
(tags =
"FileService"
)
這個用來指定生成的接口類名,不然會生成統一的DefaultApi 和DefaultApiClient