知道了swagger2的好,但要怎樣的好好利用,才能好上加好?
1,用swagger2註解代替掉字段註釋吧
爲什麼這樣說,字段註釋是我們寫來解釋字段含義的
public class PageVO {
/**
* 第幾頁
*/
private Integer current;
/**
* 每頁條數
*/
private Integer size;
}
這樣寫,沒毛病,但是就只能我們自己看。
@ApiModel(description = "分頁入參模型")
public class PageVO {
@ApiModelProperty(value = "第幾頁")
private Integer current;
@ApiModelProperty(value = "每頁條數")
private Integer size;
}
而這樣寫,不僅我們自己能看,swagger2還能依據這些註解生成出文檔給別人看,就不用再寫接口文檔了。
2,把註解寫全,當做接口文檔來寫
@ApiModel(description = "分頁入參模型")
public class PageVO {
@ApiModelProperty(value = "第幾頁",required = true,example = "1")
private Integer current;
@ApiModelProperty(value = "每頁條數",required = true,example = "10")
private Integer size;
}
不用多說,寫的越全,自己看的明白,別人也更明白。
3,換一個更好看的swagger-ui
個人覺得自帶的swagger-ui很醜,有人也這麼覺得,所以有人改進了swagger界面。
怎麼換呢?
<!--https://doc.xiaominfo.com/knife4j/-->
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
<version>${knife4j.version}</version>
</dependency>
引入這個依賴,將
http://localhost:20001/swagger-ui.html
改成
http://localhost:20001/doc.html
o了