對於像我這種web小白，想要整合這個功能又不懂maven走了很多彎路，搜尋了很多資料，結果還是搞不得不清不楚，最後還是被我搞明白了。

1.    首先建立maven專案。new project選到maven，勾選create from archetype,然後在下面的專案列找到

org.apache.maven.archetype:maven-archetype-webapp

然後點next，專案名，包名字，一直next到finsh就可以了，在建立的專案中包含一個pom.xml的配置檔案。如果本地沒有maven的資源庫，idea會馬上進行自動下載，並且會提示問是否自動載入這些資源，我們選enable就可以了。如果沒有選，需要手動完成，則右擊pom.xml，找到maven－>Reimport，就可以重新載入資源。

2.    配置pom.xml

2.1  配置springmvc的資源庫

定義springmvc版本的屬性，方便以後修改版本資訊

<properties>
   <springmvc.version>4.2.5.RELEASE<springmvc.version>
</properties>

新增一對<dependencies>標籤，並且在標籤內部加入

<dependency>
    <groupId>org.springframework</groupId>
   <artifactId>spring-webmvc</artifactId>
    <version>${springmvc.version}</version>
 </dependency>
 <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-orm</artifactId>
    <version>${springmvc.version}</version>
  </dependency>
  <dependency>
     <groupId>org.springframework</groupId>
    <artifactId>spring-test</artifactId>
    <version>${springmvc.version}</version>
     <type>jar</type>
     <scope>test</scope>
</dependency>
<dependency>
     <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
     <version>1.7.12</version>
</dependency>
<dependency>
     <groupId>commons-io</groupId>
     <artifactId>commons-io</artifactId>
     <version>2.0.1</version>
</dependency>
 

當然，如果需要用httprequest這個物件不能少了配置tomcat

<dependency>
   <groupId>org.apache.tomcat</groupId>
   <artifactId>tomcat-servlet-api</artifactId>
    <version>7.0.8</version>
    <scope>provided</scope>
</dependency>

2.2  配置mybatis

<dependency>
     <groupId>org.mybatis</groupId>
     <artifactId>mybatis</artifactId>
     <version>3.3.0</version>
 </dependency>
 <dependency>
     <groupId>org.mybatis</groupId>
     <artifactId>mybatis-spring</artifactId>
     <version>1.3.0</version>
 </dependency>
   
 <dependency>
     <groupId>mysql</groupId>
     <artifactId>mysql-connector-java</artifactId>
     <version>5.1.38</version>
  </dependency>
 

2.3  配置swagger

<dependency>
     <groupId>com.mangofactory</groupId>
     <artifactId>swagger-springmvc</artifactId>
     <version>1.0.1</version>
</dependency>
<dependency>
     <groupId>com.fasterxml.jackson.dataformat</groupId>
     <artifactId>jackson-dataformat-xml</artifactId>
     <version>2.7.4</version>
</dependency>
<dependency>
     <groupId>com.fasterxml.jackson.core</groupId>
     <artifactId>jackson-databind</artifactId>
     <version>2.7.4</version>
</dependency>

還需一個倉庫

<repositories>
    <repository>
     <id>jcenter-release</id>
      <name>jcenter</name>
     <url>http://oss.jfrog.org/artifactory/oss-release-local/</url>
    </repository>
 </repositories>

3 加入Springmvc專案

            加入自己的springmvc專案，注意非java檔案放在src/main/resources目錄下,編譯後文件會在classpath下，還需要調整springmvc，mybatis檔案的引用檔案路徑。

4加入swagger ui資源

            swaggerui 的資源開源在https://github.com/swagger-api/swagger-ui。下載這個庫，把庫中的dist檔案複製到自己專案中webapp目錄下。資料夾名字可以隨意修改，但是這個路徑就是訪問api-docs路徑。在dist的目錄下找到index.html，開啟找到一段程式碼，把下面這個

url ="http://petstore.swagger.io/v2/swagger.json";

替換成

url ="http://localhost:8080/api-docs";

在src中建立一個swagger配置java類

@Configuration
@EnableWebMvc
@EnableSwagger
@ComponentScan("com.myapp.controllers")
public class MySwaggerConfig {
 
  private SpringSwaggerConfig springSwaggerConfig;
 
  @Autowired
  public void setSpringSwaggerConfig(
SpringSwaggerConfig springSwaggerConfig) {
     this.springSwaggerConfig = springSwaggerConfig;
   }
 
  @Bean //Don't forget the @Bean annotation
  public SwaggerSpringMvcPlugin customImplementation(){
     return new SwaggerSpringMvcPlugin(this.springSwaggerConfig)
           .apiInfo(apiInfo())
           .includePatterns(".*pet.*");
   }
 
   private ApiInfo apiInfo() {
     ApiInfo apiInfo = new ApiInfo(
              "My Apps API Title",
              "My Apps APIDescription",
              "My Apps API terms ofservice",
              "My Apps API ContactEmail",
              "My Apps API LicenceType",
              "My Apps API LicenseURL"
       );
     return apiInfo;
    }
}

按照自己的需要它的內容。

然後在springmvc配置檔案中引用這個bean。

<bean class="com.xxxx.xxxx.MySwaggerConfig"/>

並且設定html靜態資源

<mvc:resourcesmapping="*.html" location="/"/>

5 調整controller forswagger

@Controller
@RequestMapping("/admin")
@Api(value = "admin") //寫在contrller的@api註釋是swagger用於將api分組，切記不要用中文，否則無法生成出文檔
public class UserController {
 
   @RequestMapping(value = "/login",method = RequestMethod.POST)
   @ApiOperation(value = "登陸",httpMethod ="POST") //value可以寫中文
   public String login(@ApiIgnore ModelMap modelMap //@apiignore表示忽略這個引數的輸入，當然我們不需要客戶端提交這個值
      , HttpServletRequest request
      , @ApiParam(required = true,value = "使用者名稱")@RequestParam String username
      , @ApiParam(required = true,value = "密碼")@RequestParam String pwd)
        throwsException{
                                    。。。。。。。。程式碼內容
      ｝
｝