国产女人乱人伦精品一区二区,国产精品久久久久久a片戏梦巴黎,一边亲胸一边摸进内裤里

Swagger UI
關于Swagger UI官方解釋是這樣的：The Swagger UI is an open source project to visually render documentation for a Swagger defined API directly from the API’s Swagger specifcation 官網地址下面是官方的效果圖：

5F19E5D5-9FB4-45A0-BBF8-613E2014A5C1.png

我將上圖分成了兩部分
文檔地址：從改地址請求數據，獲取JSON格式數據，交給第二步顯示
API文檔顯示：將JSON數據轉化成可視圖的效果

Swagger可以將某種固定格式的JSON數據生成可以視圖的在線API文檔，支持在線測試，可以清楚的觀察到IO數據。
SpringMVC + Swagger
目的：在原有的SpringMVC系統中添加Swagger，通過在接口上添加注解實現，接口文檔的同步效果。下圖為我實現之后的效果：

10B721C3-92EB-467F-B7A9-D1764CF96CA8.png

項目搭建
我的工具：Eclipse開發工具（安裝spring插件，當然也可以不要，就是麻煩點）,Maven，Tomcat，Internet訪問，Chrome瀏覽器 1.創建Simple Spring Web Maven工程右鍵New->Spring Project，選擇對應類型，finish, 如下圖：[圖片上傳中。。。（3）] 我的工程的結構，注意那兩個配置文件，名稱不重要，可以隨便改，注意要對應好web.xml中的名稱就行。[圖片上傳中。。。（4）] 想了想還是把三個配置文件貼出來吧。 web.xml
<?xml version="1.0" encoding="ISO-8859-1"?><web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <display-name>SwaggerDemo</display-name> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring/application-config.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/mvc-config.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping></web-app>

application-config.xml
<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> </beans>

mvc-config.xml
<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <mvc:annotation-driven /> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/view/"/> <property name="suffix" value=".jsp"/> </bean></beans>

這樣配置到后面配置Swagger會出現無法自動注入的問題，后面再說，以上為工具自動生成的代碼。
2.添加Swagger-Spring MVC包、JSON和jackson pom.xml文件中 properties標簽里面添加jackson版本號
<version.jackson>2.4.4</version.jackson>

dependencies標簽中添加
<dependency> <groupId>com.mangofactory</groupId> <artifactId>swagger-springmvc</artifactId> <version>0.9.5</version> </dependency> <dependency> <groupId>net.sf.json-lib</groupId> <artifactId>json-lib</artifactId> <version>2.4</version> <classifier>jdk15</classifier> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-annotations</artifactId> <version> ${version.jackson}</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>$ {version.jackson}</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-core</artifactId> <version>${version.jackson}</version> </dependency>

3.下面是重點，Swagger所有API文檔都在這里存儲，添加Swagger配置類創建一個配置類MySwaggerConfig，添加私有成員SpringSwaggerConfig，set方法使用@Autowired注解自動注入，使用@Bean注解添加SwaggerSpringMvcPlugin，并使用自定義的ApiInfo，SwaggerConfig類需要添加@Configuration以及@EnableSwagger
package com.edu.xk;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import org.springframework.web.servlet.config.annotation.EnableWebMvc;import com.mangofactory.swagger.configuration.SpringSwaggerConfig;import com.mangofactory.swagger.models.dto.ApiInfo;import com.mangofactory.swagger.plugin.EnableSwagger;import com.mangofactory.swagger.plugin.SwaggerSpringMvcPlugin;@Configuration@EnableSwagger@EnableWebMvcpublic class MySwaggerConfig { private SpringSwaggerConfig springSwaggerConfig; /** * Required to autowire SpringSwaggerConfig / @Autowired public void setSpringSwaggerConfig(SpringSwaggerConfig springSwaggerConfig) { this.springSwaggerConfig = springSwaggerConfig; } /* * Every SwaggerSpringMvcPlugin bean is picked up by the swagger-mvc * framework - allowing for multiple swagger groups i.e. same code base * multiple swagger resource listings. / @Bean public SwaggerSpringMvcPlugin customImplementation() { // 暫時不用過濾 /return new SwaggerSpringMvcPlugin(this.springSwaggerConfig).apiInfo(apiInfo()).includePatterns(".pet.");*/ return new SwaggerSpringMvcPlugin(this.springSwaggerConfig).apiInfo(apiInfo()); } private ApiInfo apiInfo() { ApiInfo apiInfo = new ApiInfo( "My Apps API Title", "My Apps API Description", "My Apps API terms of service", "My Apps API Contact Email", "My Apps API Licence Type", "My Apps API License URL" ); return apiInfo; }}

官方原話： The @EnableSwagger annotation, in this example, enables swagger-springmvc out of the box. The generated swagger json Resource Listing is available at /api-docs 4.添加Controller:WebServiceForCSS，Swagger文檔在此處添加
package com.edu.xk.webservice;import javax.servlet.http.HttpServletRequest;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestMethod;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.ResponseBody;import com.edu.xk.model.User;import com.wordnik.swagger.annotations.ApiOperation;import com.wordnik.swagger.annotations.ApiParam;import net.sf.json.JSONObject;/** * @moudle: WebServiceForCSS * @version:v1.0 * @Description: TODO * @author: xukai * @date: 2016年12月1日下午5:37:30 * */@Controllerpublic class WebServiceForCSS { @ResponseBody @RequestMapping(value = "getUserById", method = RequestMethod.GET, produces = {"application/json; charset=utf-8","application/xml"}) @ApiOperation(value = "通過ID查詢USER信息", httpMethod = "GET", notes = "暫無") public String getUserById( @ApiParam(required = true, name = "id", value = "ID") @RequestParam(value = "id") String id,HttpServletRequest request) { User user = new User(); user.setId(id); user.setName("測試人員"); user.setAge(25); JSONObject object = JSONObject.fromObject(user); return object.toString(); }}

5.配置文件修改 context加載的時候需要配置的文件，此處配置文件為application-config.xml
<mvc:annotation-driven /> <context:component-scan base-package="com.edu"/> <bean class="com.edu.xk.configer.SwaggerConfig"/>

6.下載Swagger UI組件去官網下載Zip包，或者在github上下載也可以，需要將dist文件夾下的所有文件的復制到webapp目錄下。
7.修改Project Properties 將jdk1.5換成最新的本地的jdk,對應的Java complier也改為對應的，還有maven包依賴也需要添加，不然啟動的時候會找不到ContextLoader.class。
8.添加攔截器，不然無法訪問.html后綴文件，在web.xml中添加
<servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.jpg</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.png</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.gif</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.ico</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.js</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.css</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.html</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.xls</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.doc</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.json</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.eot</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.svg</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.ttf</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>.woff</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>*.woff2</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.html</welcome-file> <welcome-file>index.htm</welcome-file> <welcome-file>index.jsp</welcome-file> <welcome-file>default.html</welcome-file> <welcome-file>default.htm</welcome-file> <welcome-file>default.jsp</welcome-file> </welcome-file-list>

運行項目，可以看到效果圖： [圖片上傳中。。。（5）]可以看到，現在效果還是和官網上一樣的。改為自己的API文檔可以通過修改index.html中的url = "http://petstore.swagger.io/v2/swagger.json";
或者直接修改訪問的地址欄為：http://localhost:8080/SwaggerDemo/api-docs
原理分析
SpringMVC+Swagger其實就是在系統加載的時候，Swagger配置類去掃描所有添加注釋的接口，并且儲存起來通過下面地址進行訪問，返回JSON數據，在前端界面顯示出來 [圖片上傳中。。。（6）] 這里我在網上看到一個漢化的版本（原效果），下載了他工程，將他生成demo.json放入的我的工程中的webapp目錄下，下面是效果圖 [圖片上傳中。。。（7）]
遇到的問題
問題1：下載maven的jar包中途失敗，工程會出錯maven missing 解決方法：選中Project->右鍵maven->update project->選中Force update 如果此時依然有 missing的jar，按照 buildpath 提示的 jar包missing 路徑，去 maven 本地倉庫中對應位置（jar包后面有路徑），刪掉該 jar 包的 xxx.lastUpdated 文件，之后，再重新執行項目右鍵maven->update project
問題2：缺失jackson包會導致出現異常java.lang.NoClassDefFoundError: com/fasterxml/jackson/databind/ObjectMapper)
問題3：java.lang.ClassNotFoundException: org.springframework.web.util.Log4jConfigListen，因為工程沒有引入maven中的jar包，解決辦法：選中工程右鍵->Properties->Deployment Assembly->add->Java Build Path Entries->Maven Dependencies->OK
問題4：org.springframework.beans.factory.BeanCreationException，出現這個異常是因為SpringSwaggerConfig的私有成員RequestMappingHandlerMapping造成的，將<mvc:annotation-driven />
放入到web.xml的context-param標簽對應的配置文件application-config.xml中，完美解決，官網解釋該標簽作用為： Required so swagger-springmvc can access spring’s RequestMappingHandlerMapping 。
org.springframework.beans.factory.NoSuchBeanDefinitionException: Noqualifying bean of type[org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping]found for dependency [collection oforg.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping]:expected at least 1 bean which qualifies as autowire candidate forthis dependency. Dependency annotations:{@org.springframework.beans.factory.annotation.Autowired(required=true)}

Swagger UI開發幫助

Swagger Editor

反正順路，順便的Editor也寫完，Editor個人感覺就是一個文檔編輯器，感覺SosoApi還是好些。試著在Swagger官網下載了一個Swagger Editor跑著玩了玩.下載swagger-editor.zip，解壓到Tomcat的webapps文件夾中，來看一下效果圖 [圖片上傳中。。。（8）]Swagger UI結合Swagger Editor更好用，但是在線編輯那個太卡了，備份一個本地的，以備不時只需。Swagger UI
關于Swagger UI官方解釋是這樣的：The Swagger UI is an open source project to visually render documentation for a Swagger defined API directly from the API’s Swagger specifcation 官網地址下面是官方的效果圖：

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

Java SpringMVC+Swagger UI生成可視圖的API文檔（詳細圖解）

Java SpringMVC+Swagger UI生成可視圖的API文檔（詳細圖解）

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美 国产 综合 欧美 视频

Java SpringMVC+Swagger UI生成可視圖的API文檔（詳細圖解）

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频