1. pom.xml
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.dalong.springboot</groupId>
<artifactId>sw</artifactId>
<version>0.0.1-SNAPSHOT</version> <properties> <!-- jdk版本号，angel在这里使用1.8，大家修改为大家本地配置的jdk版本号即可 -->
<java.version>1.8</java.version>
</properties> <parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.3.3.RELEASE</version>
</parent> <dependencies> <!-- spring boot web支持：mvc,aop... -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency> <!-- Swagger -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.2.2</version>
</dependency> <dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.2.2</version>
</dependency> <dependency>
<groupId>org.json</groupId>
<artifactId>json</artifactId>
</dependency>
</dependencies> <build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
2. 启用注解
@SpringBootApplication
@EnableSwagger2
public class startApp { @Bean
public Filter characterEncodingFilter() {
CharacterEncodingFilter characterEncodingFilter =new CharacterEncodingFilter();
characterEncodingFilter.setEncoding("UTF-8");
characterEncodingFilter.setForceEncoding(true);
return characterEncodingFilter;
}
public static void main(String[] args) { SpringApplication.run(startApp.class, args); } }
3. controller 使用APi 注解说明
@RestController
public class firstController { @RequestMapping(value = "/hello")
@ApiOperation(value = "add user",httpMethod ="POST", response = User.class,notes = "get user info")
public User hello(@ApiParam(required = true,name = "paramData",value = "user json data") @RequestBody User user){ return user;
}
@RequestMapping("/app")
@ApiOperation(value = "获取用户信息",httpMethod ="GET", response = User.class,notes = "获取用户信息")
public User userinfo(){ User user=new User(); user.setAge(33);
user.setName("dalong"); return user;
}
}
4. 测试页面：
