Если ваша компания не использовала Swagger или даже не слышала о Swagger, поторопитесь и выучите этот блог, пять минут быстрого, интеграции в стиле дураков, но такое простое приложение наверняка их шокирует.
Во-первых, давайте кратко представим Swagger: Swagger-это волшебный инструмент для развития и канал для переднего общения. Что вы можете сделать с Swagger? Прежде всего, вы можете в основном попрощаться с единичным тестированием в будущем; Во -вторых, вам больше не нужно писать интерфейсные документы, и вам не нужно поддерживать документы после их написания. Swagger может полностью имитировать HTTP -запросы, а разница между входящими и исходящими параметрами и фактическими условиями почти равен нулю. Сказав это, давайте просто сделаем некоторую информацию!
Интегрированный четырех частей:
Шаг 1: импортируйте две зависимости. Если вы не проект Maven, то вы можете найти пакет JAR. Помните, что только два необходимы. Я видел, что я представил семь или восемь из них в других учебных пособиях, которые являются пустой тратой.
<depervice> <groupid> io.springfox </groupid> <artifactid> springfox-swagge2 </artifactid> <sersive> 2.6.1 </version> </depertive> <dependency> <groupid> io.springfox </GroupD> <artifactid> springfox-swager-uii </artifactid> </Ground> <artifactid> springfox-swager-ui </artifactid> </GroupD>.
Шаг 2: Добавьте класс (скопируйте следующий, обратите внимание, что вы можете изменить имя и адрес пакета)
/** * Конфигурация Swagger * * @author wq * @since 2017-05-16 */ @enablewebmvc @enatorswagger2 @configurationpublic class swaggerconfig {@bean public docket createrestapi () {return docket (documenttype.swagger_2) .apiinfo (apiinfo () .shipectem. .APIS (requestHandlerselectors.basepackage ("com.z*.b*.c*.controller")) // Обратите внимание, что вы изменяете имя пакета здесь. Paths (pathselectors.any ()) .build (); } private apiinfo apiinfo () {return new apiinfobuilder () .title ("Список интерфейса v1.1.0") // any, пожалуйста, регулируйте его. Ваш собственный ip: port .contact ("laowu") // Это не имеет значения (вот псевдоним автора) .version ("1.1.0") .build (); }} Шаг 3: Добавьте следующую конфигурацию в файл конфигурации MVC. Может быть, ваш файл может называться Dispatcher.xml! (Просто копируйте, модификация не требуется)
<MVC: Resources Mapping = "swagger-ui.html" location = "classpath:/meta-ourment/resources/"/>> <mvc: ресурсы mapping = "/webjars/**" location = "classpath:/meta-inf/resources/webjars/"/>
Шаг 4: Добавьте аннотации по методам и параметрам
Метод:
@ApioPeration (value = "turniory", httpmethod = "post", notes = "Учебник")
Поместите это в реестр:
@Apiparam (обязательно = true, name = "test", value = "Параметр обучения")
Я волнуюсь, что некоторые друзья не совсем понимают, так что давайте разместим!
Шаг 5: Запустите службу и введите в браузер:
http: // ip: port/swagger-ui.html
Появится следующий экран означает, что задача завершена:
Примечание. Если вы используете перехватчик в своем проекте, отпустите ресурс Swagger (вы все равно можете скопировать следующую конфигурацию напрямую, не сомневайтесь v2)
<mvc: exclide mapping path = "/swagger*/**"> </mvc: exklide mapping> <mvc: exclide mapping path = "/v2/**"> </mvc: exlude mapping> <mvc: exclide mapping = "/webjars/**"
Выше всего содержание этой статьи. Я надеюсь, что это будет полезно для каждого обучения, и я надеюсь, что все будут поддерживать Wulin.com больше.