swgger2簡單配置類以及常用註解

2021-09-25 13:43:38 字數 1063 閱讀 4671

public

class

swagger2config

private apiinfo apiinfo()

}

1.@api()

用於類;表示標識這個類是swagger的資源

tags–表示說明

value–也是說明,可以使用tags替代

但是tags如果有多個值,會生成多個list

2.@apioperation()

用於方法;表示乙個http請求的操作

value用於方法描述

notes用於提示內容

tags可以重新分組(視情況而用)

3.@apiparam()

用於方法,引數,字段說明;表示對引數的新增元資料(說明或是否必填等)

name–引數名

value–引數說明

required–是否必填

4.@apimodelproperty()

用於方法,字段; 表示對model屬性的說明或者資料操作更改

value–字段說明

name–重寫屬性名字

datatype–重寫屬性型別

required–是否必填

example–舉例說明

hidden–隱藏

5.@apiignore()

用於類或者方法上,可以不被swagger顯示在頁面上

比較簡單, 這裡不做舉例

6.@apiimplicitparam()

用於方法

表示單獨的請求引數

7.@apiimplicitparams()

用於方法,包含多個 @apiimplicitparam

name–引數ming

value–引數說明

datatype–資料型別

paramtype–引數型別

example–舉例說明

iTerms2 簡單配置

趁著今天那個半死不活對模型還在訓著,簡單配置一下mac上的iterms 2。之前沒有感覺iterms 2比mac自帶對終端好用在哪,不過imgcat只能在iterms 2下用,沒辦法。preference profiles colors 右下角選擇 solarized dark power是乙個比較...

2 dubbo簡單配置

示例 xmlns xsi xmlns dubbo xsi schemalocation spring beans 4.3.xsd dubbo.xsd registry address multicast protocol name dubbo port 20880 service inte ce c...

初學structs2,簡單配置

一 structs2 demo1專案下新建structs.xml檔案,檔名必須是structs 二 package節點配置及其子節點配置 index.jsp 三 在web.xml檔案下新增filter並配置 struts2 org.apache.struts2.dispatcher.ng.filte...