(HttpStatus.OK);
+ }
+
+}
diff --git a/server/spring/src/main/java/io/swagger/api/V1ApiController.java b/server/spring/src/main/java/io/swagger/api/V1ApiController.java
new file mode 100644
index 0000000..8664a39
--- /dev/null
+++ b/server/spring/src/main/java/io/swagger/api/V1ApiController.java
@@ -0,0 +1,14 @@
+package io.swagger.api;
+
+import org.springframework.stereotype.Controller;
+
+import javax.validation.constraints.*;
+import javax.validation.Valid;
+@javax.annotation.Generated(value = "io.swagger.codegen.languages.SpringCodegen", date = "2017-11-09T10:58:41.434+08:00")
+
+@Controller
+public class V1ApiController implements V1Api {
+
+
+
+}
diff --git a/server/spring/src/main/java/io/swagger/configuration/HomeController.java b/server/spring/src/main/java/io/swagger/configuration/HomeController.java
new file mode 100644
index 0000000..f832809
--- /dev/null
+++ b/server/spring/src/main/java/io/swagger/configuration/HomeController.java
@@ -0,0 +1,16 @@
+package io.swagger.configuration;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+/**
+ * Home redirection to swagger api documentation
+ */
+@Controller
+public class HomeController {
+ @RequestMapping(value = "/")
+ public String index() {
+ System.out.println("swagger-ui.html");
+ return "redirect:swagger-ui.html";
+ }
+}
diff --git a/server/spring/src/main/java/io/swagger/configuration/SwaggerDocumentationConfig.java b/server/spring/src/main/java/io/swagger/configuration/SwaggerDocumentationConfig.java
new file mode 100644
index 0000000..196d0b9
--- /dev/null
+++ b/server/spring/src/main/java/io/swagger/configuration/SwaggerDocumentationConfig.java
@@ -0,0 +1,41 @@
+package io.swagger.configuration;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import springfox.documentation.builders.ApiInfoBuilder;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.service.ApiInfo;
+import springfox.documentation.service.Contact;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.plugins.Docket;
+
+@javax.annotation.Generated(value = "io.swagger.codegen.languages.SpringCodegen", date = "2017-11-09T10:58:41.434+08:00")
+
+@Configuration
+public class SwaggerDocumentationConfig {
+
+ ApiInfo apiInfo() {
+ return new ApiInfoBuilder()
+ .title("Swagger Demo")
+ .description("Swagger的简单示例, 包括swagger-codegen, swagger2markup 和 asciidoctor.")
+ .license("Apache License")
+ .licenseUrl("http://www.apache.org/licenses/LICENSE-2.0.html")
+ .termsOfServiceUrl("http://www.google.com")
+ .version("v1")
+ .contact(new Contact("","", "damon.q@iv66.net"))
+ .build();
+ }
+
+ @Bean
+ public Docket customImplementation(){
+ return new Docket(DocumentationType.SWAGGER_2)
+ .select()
+ .apis(RequestHandlerSelectors.basePackage("io.swagger.api"))
+ .build()
+ .directModelSubstitute(java.time.LocalDate.class, java.sql.Date.class)
+ .directModelSubstitute(java.time.OffsetDateTime.class, java.util.Date.class)
+ .apiInfo(apiInfo());
+ }
+
+}
diff --git a/server/spring/src/main/java/io/swagger/model/Book.java b/server/spring/src/main/java/io/swagger/model/Book.java
new file mode 100644
index 0000000..f122e71
--- /dev/null
+++ b/server/spring/src/main/java/io/swagger/model/Book.java
@@ -0,0 +1,154 @@
+package io.swagger.model;
+
+import java.util.Objects;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import javax.validation.Valid;
+import javax.validation.constraints.*;
+
+/**
+ * Book
+ */
+@javax.annotation.Generated(value = "io.swagger.codegen.languages.SpringCodegen", date = "2017-11-09T10:58:41.434+08:00")
+
+public class Book {
+ @JsonProperty("author")
+ private String author = null;
+
+ @JsonProperty("categoryId")
+ private Integer categoryId = null;
+
+ @JsonProperty("id")
+ private Integer id = null;
+
+ @JsonProperty("name")
+ private String name = null;
+
+ public Book author(String author) {
+ this.author = author;
+ return this;
+ }
+
+ /**
+ * 作者
+ * @return author
+ **/
+ @ApiModelProperty(value = "作者")
+
+
+ public String getAuthor() {
+ return author;
+ }
+
+ public void setAuthor(String author) {
+ this.author = author;
+ }
+
+ public Book categoryId(Integer categoryId) {
+ this.categoryId = categoryId;
+ return this;
+ }
+
+ /**
+ * Get categoryId
+ * @return categoryId
+ **/
+ @ApiModelProperty(value = "")
+
+
+ public Integer getCategoryId() {
+ return categoryId;
+ }
+
+ public void setCategoryId(Integer categoryId) {
+ this.categoryId = categoryId;
+ }
+
+ public Book id(Integer id) {
+ this.id = id;
+ return this;
+ }
+
+ /**
+ * Get id
+ * @return id
+ **/
+ @ApiModelProperty(value = "")
+
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public Book name(String name) {
+ this.name = name;
+ return this;
+ }
+
+ /**
+ * 书名
+ * @return name
+ **/
+ @ApiModelProperty(value = "书名")
+
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+
+ @Override
+ public boolean equals(java.lang.Object o) {
+ if (this == o) {
+ return true;
+ }
+ if (o == null || getClass() != o.getClass()) {
+ return false;
+ }
+ Book book = (Book) o;
+ return Objects.equals(this.author, book.author) &&
+ Objects.equals(this.categoryId, book.categoryId) &&
+ Objects.equals(this.id, book.id) &&
+ Objects.equals(this.name, book.name);
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(author, categoryId, id, name);
+ }
+
+ @Override
+ public String toString() {
+ StringBuilder sb = new StringBuilder();
+ sb.append("class Book {\n");
+
+ sb.append(" author: ").append(toIndentedString(author)).append("\n");
+ sb.append(" categoryId: ").append(toIndentedString(categoryId)).append("\n");
+ sb.append(" id: ").append(toIndentedString(id)).append("\n");
+ sb.append(" name: ").append(toIndentedString(name)).append("\n");
+ sb.append("}");
+ return sb.toString();
+ }
+
+ /**
+ * Convert the given object to string with each line indented by 4 spaces
+ * (except the first line).
+ */
+ private String toIndentedString(java.lang.Object o) {
+ if (o == null) {
+ return "null";
+ }
+ return o.toString().replace("\n", "\n ");
+ }
+}
+
diff --git a/server/spring/src/main/java/io/swagger/model/Category.java b/server/spring/src/main/java/io/swagger/model/Category.java
new file mode 100644
index 0000000..151c6ca
--- /dev/null
+++ b/server/spring/src/main/java/io/swagger/model/Category.java
@@ -0,0 +1,104 @@
+package io.swagger.model;
+
+import java.util.Objects;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import javax.validation.Valid;
+import javax.validation.constraints.*;
+
+/**
+ * Category
+ */
+@javax.annotation.Generated(value = "io.swagger.codegen.languages.SpringCodegen", date = "2017-11-09T10:58:41.434+08:00")
+
+public class Category {
+ @JsonProperty("id")
+ private Integer id = null;
+
+ @JsonProperty("name")
+ private String name = null;
+
+ public Category id(Integer id) {
+ this.id = id;
+ return this;
+ }
+
+ /**
+ * Get id
+ * @return id
+ **/
+ @ApiModelProperty(value = "")
+
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public Category name(String name) {
+ this.name = name;
+ return this;
+ }
+
+ /**
+ * Get name
+ * @return name
+ **/
+ @ApiModelProperty(value = "")
+
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+
+ @Override
+ public boolean equals(java.lang.Object o) {
+ if (this == o) {
+ return true;
+ }
+ if (o == null || getClass() != o.getClass()) {
+ return false;
+ }
+ Category category = (Category) o;
+ return Objects.equals(this.id, category.id) &&
+ Objects.equals(this.name, category.name);
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(id, name);
+ }
+
+ @Override
+ public String toString() {
+ StringBuilder sb = new StringBuilder();
+ sb.append("class Category {\n");
+
+ sb.append(" id: ").append(toIndentedString(id)).append("\n");
+ sb.append(" name: ").append(toIndentedString(name)).append("\n");
+ sb.append("}");
+ return sb.toString();
+ }
+
+ /**
+ * Convert the given object to string with each line indented by 4 spaces
+ * (except the first line).
+ */
+ private String toIndentedString(java.lang.Object o) {
+ if (o == null) {
+ return "null";
+ }
+ return o.toString().replace("\n", "\n ");
+ }
+}
+
diff --git a/server/spring/src/main/resources/application.properties b/server/spring/src/main/resources/application.properties
new file mode 100644
index 0000000..12f1987
--- /dev/null
+++ b/server/spring/src/main/resources/application.properties
@@ -0,0 +1,5 @@
+springfox.documentation.swagger.v2.path=/api-docs
+server.contextPath=
+server.port=8080
+spring.jackson.date-format=io.swagger.RFC3339DateFormat
+spring.jackson.serialization.WRITE_DATES_AS_TIMESTAMPS=false
\ No newline at end of file
diff --git a/swagger-server/bin/generate-client-html-config.json b/swagger-server/bin/generate-client-html-config.json
new file mode 100644
index 0000000..58febd9
--- /dev/null
+++ b/swagger-server/bin/generate-client-html-config.json
@@ -0,0 +1,5 @@
+{
+ "groupId": "com.example",
+ "artifactId": "swagger-client-java",
+ "artifactVersion": "1.0.0"
+}
diff --git a/swagger-server/bin/generate-client-java-config.json b/swagger-server/bin/generate-client-java-config.json
new file mode 100644
index 0000000..f1ee5d9
--- /dev/null
+++ b/swagger-server/bin/generate-client-java-config.json
@@ -0,0 +1,8 @@
+{
+ "groupId": "com.example",
+ "artifactId": "swagger-client-java",
+ "artifactVersion": "1.0.0",
+ "library": "okhttp-gson",
+ "java8": true,
+ "dateLibrary": "java8"
+}
diff --git a/swagger-server/bin/generate-server-jaxrs-resteasy-config.json b/swagger-server/bin/generate-server-jaxrs-resteasy-config.json
new file mode 100644
index 0000000..a9a377e
--- /dev/null
+++ b/swagger-server/bin/generate-server-jaxrs-resteasy-config.json
@@ -0,0 +1,7 @@
+{
+ "groupId": "com.example",
+ "artifactId": "swagger-client-java",
+ "artifactVersion": "1.0.0",
+ "java8": true,
+ "dateLibrary": "java8"
+}
diff --git a/swagger-server/bin/generate-server-spring-config.json b/swagger-server/bin/generate-server-spring-config.json
new file mode 100644
index 0000000..bb1ae05
--- /dev/null
+++ b/swagger-server/bin/generate-server-spring-config.json
@@ -0,0 +1,8 @@
+{
+ "groupId": "com.example",
+ "artifactId": "swagger-client-java",
+ "artifactVersion": "1.0.0",
+ "library": "spring-boot",
+ "java8": true,
+ "dateLibrary": "java8"
+}
diff --git a/swagger-server/bin/install.sh b/swagger-server/bin/install.sh
new file mode 100644
index 0000000..4b4fc50
--- /dev/null
+++ b/swagger-server/bin/install.sh
@@ -0,0 +1,47 @@
+#!/bin/bash
+
+pwd=$(cd `dirname $0`; pwd);cd $pwd
+CLIENT_HOME=$pwd/../../client
+SERVER_HOME=$pwd/../../server
+ASCII_HOME=$pwd/../../asciidoc
+DOC_HOME=$pwd/../../docs
+
+echo "generated client source folder: $CLIENT_HOME"
+echo "generated server source folder: $SERVER_HOME"
+
+# do clean
+rm -rf $CLIENT_HOME $SERVER_HOME $ASCII_HOME $DOC_HOME
+
+# clients
+java -jar swagger-codegen-cli.jar generate \
+ -i $pwd/../src/main/resources/swagger.yml \
+ -l java \
+ -c generate-client-java-config.json \
+ -o $CLIENT_HOME/java
+
+java -jar swagger-codegen-cli.jar generate \
+ -i $pwd/../src/main/resources/swagger.yml \
+ -l go \
+ -o $CLIENT_HOME/go
+
+java -jar swagger-codegen-cli.jar generate \
+ -i $pwd/../src/main/resources/swagger.yml \
+ -l html2 \
+ -c generate-client-html-config.json \
+ -o $CLIENT_HOME/html2
+
+# servers
+java -jar swagger-codegen-cli.jar generate \
+ -i $pwd/../src/main/resources/swagger.yml \
+ -l spring \
+ -c generate-server-spring-config.json \
+ -o $SERVER_HOME/spring
+
+java -jar swagger-codegen-cli.jar generate \
+ -i $pwd/../src/main/resources/swagger.yml \
+ -l jaxrs-resteasy \
+ -c generate-server-jaxrs-resteasy-config.json \
+ -o $SERVER_HOME/jaxrs-resteasy
+
+cd $pwd/../..
+mvn clean install
diff --git a/swagger-server/bin/swagger-codegen-cli.jar b/swagger-server/bin/swagger-codegen-cli.jar
new file mode 100644
index 0000000..ef3cedb
Binary files /dev/null and b/swagger-server/bin/swagger-codegen-cli.jar differ
diff --git a/swagger-server/pom.xml b/swagger-server/pom.xml
new file mode 100644
index 0000000..7da2f4f
--- /dev/null
+++ b/swagger-server/pom.xml
@@ -0,0 +1,214 @@
+
+
+ 4.0.0
+
+ swagger-server
+ 1.0.0
+ jar
+
+ swagger-server
+ Demo project for Spring Boot
+
+
+ com.example
+ swagger-example
+ 1.0.0
+ ../
+
+
+
+ UTF-8
+ UTF-8
+ 1.8
+
+ 2.7.0
+ 1.3.3
+ 1.5.6
+ 1.5.0-alpha.16
+
+ ${project.basedir}/src/main/resources/swagger.yml
+ ${project.basedir}/../asciidoc/
+ ${project.basedir}/../docs
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-web
+
+
+
+ io.springfox
+ springfox-swagger2
+ ${springfox-swagger2.version}
+
+
+ io.springfox
+ springfox-swagger-ui
+ ${springfox-swagger2.version}
+
+
+
+ org.springframework.boot
+ spring-boot-starter-actuator
+
+
+
+ org.springframework.boot
+ spring-boot-starter-test
+ test
+
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-maven-plugin
+
+
+
+ io.github.swagger2markup
+ swagger2markup-maven-plugin
+ ${swagger2markup-maven-plugin.version}
+
+ ${swagger.input}
+ ${generated.asciidoc.directory}/swagger-example
+
+ ASCIIDOC
+
+
+
+
+ generate-resources
+
+ convertSwagger2markup
+
+
+
+
+
+ org.asciidoctor
+ asciidoctor-maven-plugin
+ ${asciidoctor-maven-plugin.version}
+
+
+ org.asciidoctor
+ asciidoctorj-pdf
+ ${asciidoctorj-pdf.version}
+
+
+
+ ${generated.asciidoc.directory}
+ true
+ coderay
+ book
+
+ ${project.build.sourceDirectory}
+ http://example.org
+ ${project.version}
+ left
+ 3
+ true
+ ${project.version}
+ ${maven.build.timestamp}
+ google.com
+
+
+
+
+ output-html
+ generate-resources
+
+ process-asciidoc
+
+
+ ${asciidoctor.output.directory}
+ html5
+
+ ./images
+ left
+ font
+ true
+
+ -
+ true
+
+
+
+
+
+
+
+
+
diff --git a/swagger-server/src/main/java/com/example/server/SwaggerServerApplication.java b/swagger-server/src/main/java/com/example/server/SwaggerServerApplication.java
new file mode 100644
index 0000000..c663746
--- /dev/null
+++ b/swagger-server/src/main/java/com/example/server/SwaggerServerApplication.java
@@ -0,0 +1,12 @@
+package com.example.server;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class SwaggerServerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(SwaggerServerApplication.class, args);
+ }
+}
diff --git a/swagger-server/src/main/java/com/example/server/api/BookApi.java b/swagger-server/src/main/java/com/example/server/api/BookApi.java
new file mode 100644
index 0000000..a011618
--- /dev/null
+++ b/swagger-server/src/main/java/com/example/server/api/BookApi.java
@@ -0,0 +1,48 @@
+package com.example.server.api;
+
+import com.example.server.model.Book;
+import com.example.server.service.BookService;
+import io.swagger.annotations.ApiOperation;
+import java.util.List;
+import java.util.Random;
+import javax.websocket.server.PathParam;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * Created by Damon.Q on 2017/10/27.
+ */
+@RestController
+@RequestMapping("/v1/book")
+public class BookApi {
+
+ private final BookService bookService;
+
+ @Autowired
+ public BookApi(BookService bookService) {
+ this.bookService = bookService;
+ }
+
+ @GetMapping("/{id}")
+ @ApiOperation(value = "根据ID获取书籍")
+ public Book getBookById(@PathVariable("id") Integer id) {
+ return bookService.getById(id);
+ }
+
+ @GetMapping("/getByCategoryId")
+ @ApiOperation(value = "根据分类获取书籍")
+ public List getBooksByCategory(@RequestParam("id") Integer id) {
+ return bookService.getByCategoryId(id);
+ }
+
+ @PostMapping("/update")
+ @ApiOperation(value = "更新书籍")
+ public boolean update(@PathParam("id") Integer id) {
+ return new Random().nextBoolean();
+ }
+}
diff --git a/swagger-server/src/main/java/com/example/server/api/CategoryApi.java b/swagger-server/src/main/java/com/example/server/api/CategoryApi.java
new file mode 100644
index 0000000..f762148
--- /dev/null
+++ b/swagger-server/src/main/java/com/example/server/api/CategoryApi.java
@@ -0,0 +1,38 @@
+package com.example.server.api;
+
+import com.example.server.model.Category;
+import com.example.server.service.CategoryService;
+import io.swagger.annotations.ApiOperation;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * Created by Damon.Q on 2017/10/27.
+ */
+@RestController
+@RequestMapping("/v1/category")
+public class CategoryApi {
+
+ private final CategoryService categoryService;
+
+ @Autowired
+ public CategoryApi(CategoryService categoryService) {
+ this.categoryService = categoryService;
+ }
+
+ @GetMapping("/")
+ @ApiOperation(value = "获取全部分类")
+ public List getAll() {
+ return categoryService.getAll();
+ }
+
+ @GetMapping("/{id}")
+ @ApiOperation(value = "根据ID获取分类")
+ public Category get(@PathVariable("id") Integer id) {
+ return categoryService.get(id);
+ }
+}
diff --git a/swagger-server/src/main/java/com/example/server/config/SwaggerConfig.java b/swagger-server/src/main/java/com/example/server/config/SwaggerConfig.java
new file mode 100644
index 0000000..e47f572
--- /dev/null
+++ b/swagger-server/src/main/java/com/example/server/config/SwaggerConfig.java
@@ -0,0 +1,94 @@
+package com.example.server.config;
+
+import com.google.common.collect.Lists;
+import com.google.common.collect.Sets;
+import java.util.List;
+import org.springframework.boot.web.servlet.FilterRegistrationBean;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.cors.CorsConfiguration;
+import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
+import org.springframework.web.filter.CorsFilter;
+import springfox.documentation.builders.ApiInfoBuilder;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.service.ApiInfo;
+import springfox.documentation.service.ApiKey;
+import springfox.documentation.service.AuthorizationScope;
+import springfox.documentation.service.Contact;
+import springfox.documentation.service.SecurityReference;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spi.service.contexts.SecurityContext;
+import springfox.documentation.spring.web.plugins.Docket;
+import springfox.documentation.swagger2.annotations.EnableSwagger2;
+
+/**
+ * Created by Damon.Q on 2017/10/27.
+ */
+@Configuration
+@EnableSwagger2
+public class SwaggerConfig {
+
+ @Bean
+ public Docket api() {
+ return new Docket(DocumentationType.SWAGGER_2)
+ .select()
+ .apis(RequestHandlerSelectors.any())
+ .paths(PathSelectors.regex("/v1/.*"))
+ .build()
+ .host("localhost:8080")
+ .protocols(Sets.newHashSet("http", "https"))
+ .securitySchemes(Lists.newArrayList(new ApiKey("api_key", "api_key", "header")))
+ .securityContexts(Lists.newArrayList(securityContext()))
+ .apiInfo(apiInfo())
+ //.useDefaultResponseMessages(false)
+ //.globalResponseMessage(RequestMethod.GET, Lists.newArrayList(
+ // new ResponseMessageBuilder()
+ // .code(500)
+ // .message("500 message")
+ // .responseModel(new ModelRef("Error"))
+ // .build(),
+ // new ResponseMessageBuilder()
+ // .code(403)
+ // .message("Forbidden!")
+ // .build()))
+ ;
+ }
+
+ @Bean
+ public FilterRegistrationBean corsFilter() {
+ UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
+ CorsConfiguration config = new CorsConfiguration();
+ config.setAllowCredentials(true);
+ config.setAllowedOrigins(Lists.newArrayList("*"));
+ config.setAllowedHeaders(Lists.newArrayList("*"));
+ config.setAllowedMethods(Lists.newArrayList("*"));
+ source.registerCorsConfiguration("/**", config);
+ FilterRegistrationBean bean = new FilterRegistrationBean(new CorsFilter(source));
+ bean.setOrder(0);
+ return bean;
+ }
+
+ private SecurityContext securityContext() {
+ return SecurityContext.builder()
+ .securityReferences(defaultAuth())
+ .forPaths(PathSelectors.regex("/v1/book/.*"))
+ .build();
+ }
+
+ private List defaultAuth() {
+ return Lists.newArrayList(new SecurityReference("api_key", new AuthorizationScope[0]));
+ }
+
+ private ApiInfo apiInfo() {
+ return new ApiInfoBuilder()
+ .title("Swagger Demo")
+ .description("Swagger的简单示例, 包括swagger-codegen, swagger2markup 和 asciidoctor.")
+ .termsOfServiceUrl("http://www.apache.org/licenses/LICENSE-2.0.html")
+ .contact(new Contact("Damon", "http://www.google.com", "damon.q@iv66.net"))
+ .license("Apache License")
+ .licenseUrl("http://www.apache.org/licenses/LICENSE-2.0.html")
+ .version("v1")
+ .build();
+ }
+}
diff --git a/swagger-server/src/main/java/com/example/server/model/Book.java b/swagger-server/src/main/java/com/example/server/model/Book.java
new file mode 100644
index 0000000..9bf1f82
--- /dev/null
+++ b/swagger-server/src/main/java/com/example/server/model/Book.java
@@ -0,0 +1,57 @@
+package com.example.server.model;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+
+/**
+ * Created by Damon.Q on 2017/10/27.
+ */
+@ApiModel
+public class Book {
+
+ private int id;
+ private int categoryId;
+ @ApiModelProperty("书名")
+ private String name;
+ @ApiModelProperty("作者")
+ private String author;
+
+ public Book(int id, int categoryId, String name, String author) {
+ this.id = id;
+ this.categoryId = categoryId;
+ this.name = name;
+ this.author = author;
+ }
+
+ public int getId() {
+ return id;
+ }
+
+ public void setId(int id) {
+ this.id = id;
+ }
+
+ public int getCategoryId() {
+ return categoryId;
+ }
+
+ public void setCategoryId(int categoryId) {
+ this.categoryId = categoryId;
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+ public String getAuthor() {
+ return author;
+ }
+
+ public void setAuthor(String author) {
+ this.author = author;
+ }
+}
diff --git a/swagger-server/src/main/java/com/example/server/model/Category.java b/swagger-server/src/main/java/com/example/server/model/Category.java
new file mode 100644
index 0000000..f1441e9
--- /dev/null
+++ b/swagger-server/src/main/java/com/example/server/model/Category.java
@@ -0,0 +1,31 @@
+package com.example.server.model;
+
+/**
+ *
Created by Damon.Q on 2017/10/27.
+ */
+public class Category {
+
+ private int id;
+ private String name;
+
+ public Category(int id, String name) {
+ this.id = id;
+ this.name = name;
+ }
+
+ public int getId() {
+ return id;
+ }
+
+ public void setId(int id) {
+ this.id = id;
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+}
diff --git a/swagger-server/src/main/java/com/example/server/service/BookService.java b/swagger-server/src/main/java/com/example/server/service/BookService.java
new file mode 100644
index 0000000..eee399a
--- /dev/null
+++ b/swagger-server/src/main/java/com/example/server/service/BookService.java
@@ -0,0 +1,29 @@
+package com.example.server.service;
+
+import com.example.server.model.Book;
+import com.google.common.collect.Lists;
+import java.util.List;
+import java.util.stream.Collectors;
+import org.springframework.stereotype.Service;
+
+/**
+ *
Created by Damon.Q on 2017/10/27.
+ */
+@Service
+public class BookService {
+
+ private static final List BOOKS = Lists.newArrayList(
+ new Book(1, 1, "Clean Code", "Martin"),
+ new Book(2, 1, "Effective Java", "Joshua Bloch"),
+ new Book(3, 2, "挪威的森林", "村上春树")
+ );
+ private static final Book NOT_EXIST = new Book(-1, -1, "NOT EXIST", "NO AUTHOR");
+
+ public Book getById(int id) {
+ return BOOKS.stream().filter(b -> id == b.getId()).findAny().orElse(NOT_EXIST);
+ }
+
+ public List getByCategoryId(Integer categoryId) {
+ return BOOKS.stream().filter(b -> categoryId == b.getCategoryId()).collect(Collectors.toList());
+ }
+}
diff --git a/swagger-server/src/main/java/com/example/server/service/CategoryService.java b/swagger-server/src/main/java/com/example/server/service/CategoryService.java
new file mode 100644
index 0000000..5710d17
--- /dev/null
+++ b/swagger-server/src/main/java/com/example/server/service/CategoryService.java
@@ -0,0 +1,28 @@
+package com.example.server.service;
+
+import com.example.server.model.Category;
+import com.google.common.collect.Lists;
+import java.util.List;
+import org.springframework.stereotype.Service;
+
+/**
+ * Created by Damon.Q on 2017/10/27.
+ */
+@Service
+public class CategoryService {
+
+ private static final List CATEGORIES = Lists.newArrayList(
+ new Category(1, "技术"),
+ new Category(2, "文学")
+ );
+
+ private static final Category NOT_EXIST = new Category(-1, "NOT EXIST");
+
+ public List getAll() {
+ return CATEGORIES;
+ }
+
+ public Category get(Integer id) {
+ return CATEGORIES.stream().filter(c -> id == c.getId()).findAny().orElse(NOT_EXIST);
+ }
+}
diff --git a/swagger-server/src/main/resources/application.yml b/swagger-server/src/main/resources/application.yml
new file mode 100644
index 0000000..4dee154
--- /dev/null
+++ b/swagger-server/src/main/resources/application.yml
@@ -0,0 +1 @@
+debug: false
diff --git a/swagger-server/src/main/resources/openapi3.0.0.yml b/swagger-server/src/main/resources/openapi3.0.0.yml
new file mode 100644
index 0000000..924aa26
--- /dev/null
+++ b/swagger-server/src/main/resources/openapi3.0.0.yml
@@ -0,0 +1,26 @@
+openapi: 3.0.0
+info:
+ title: Sample API
+ description: Optional multiline or single-line description in [CommonMark](http://commonmark.org/help/) or HTML.
+ version: 0.1.9
+
+servers:
+ - url: http://api.example.com/v1
+ description: Optional server description, e.g. Main (production) server
+ - url: http://staging-api.example.com
+ description: Optional server description, e.g. Internal staging server for testing
+
+paths:
+ /users:
+ get:
+ summary: Returns a list of users.
+ description: Optional extended description in CommonMark or HTML.
+ responses:
+ '200': # status code
+ description: A JSON array of user names
+ content:
+ application/json:
+ schema:
+ type: array
+ items:
+ type: string
\ No newline at end of file
diff --git a/swagger-server/src/main/resources/swagger.yml b/swagger-server/src/main/resources/swagger.yml
new file mode 100644
index 0000000..444e1d6
--- /dev/null
+++ b/swagger-server/src/main/resources/swagger.yml
@@ -0,0 +1,199 @@
+swagger: '2.0'
+info:
+ description: 'Swagger的简单示例, 包括swagger-codegen, swagger2markup 和 asciidoctor.'
+ version: v1
+ title: Swagger Demo
+ termsOfService: 'http://www.apache.org/licenses/LICENSE-2.0.html'
+ contact:
+ name: Damon
+ url: 'http://www.google.com'
+ email: damon.q@iv66.net
+ license:
+ name: Apache License
+ url: 'http://www.apache.org/licenses/LICENSE-2.0.html'
+host: 'localhost:8080'
+basePath: /
+tags:
+ - name: category-api
+ description: Category Api
+ - name: book-api
+ description: Book Api
+schemes:
+ - http
+ - https
+paths:
+ /v1/book/getByCategoryId:
+ get:
+ tags:
+ - book-api
+ summary: 根据分类获取书籍
+ operationId: getBooksByCategoryUsingGET
+ consumes:
+ - application/json
+ produces:
+ - '*/*'
+ parameters:
+ - name: id
+ in: query
+ description: id
+ required: true
+ type: integer
+ format: int32
+ responses:
+ '200':
+ description: OK
+ schema:
+ type: array
+ items:
+ $ref: '#/definitions/Book'
+ '401':
+ description: Unauthorized
+ '403':
+ description: Forbidden
+ '404':
+ description: Not Found
+ security:
+ - api_key: []
+ /v1/book/update:
+ post:
+ tags:
+ - book-api
+ summary: 更新书籍
+ operationId: updateUsingPOST
+ consumes:
+ - application/json
+ produces:
+ - '*/*'
+ parameters:
+ - in: body
+ name: id
+ description: id
+ required: false
+ schema:
+ type: integer
+ format: int32
+ responses:
+ '200':
+ description: OK
+ schema:
+ type: boolean
+ '201':
+ description: Created
+ '401':
+ description: Unauthorized
+ '403':
+ description: Forbidden
+ '404':
+ description: Not Found
+ security:
+ - api_key: []
+ '/v1/book/{id}':
+ get:
+ tags:
+ - book-api
+ summary: 根据ID获取书籍
+ operationId: getBookByIdUsingGET
+ consumes:
+ - application/json
+ produces:
+ - '*/*'
+ parameters:
+ - name: id
+ in: path
+ description: id
+ required: true
+ type: integer
+ format: int32
+ responses:
+ '200':
+ description: OK
+ schema:
+ $ref: '#/definitions/Book'
+ '401':
+ description: Unauthorized
+ '403':
+ description: Forbidden
+ '404':
+ description: Not Found
+ security:
+ - api_key: []
+ /v1/category/:
+ get:
+ tags:
+ - category-api
+ summary: 获取全部分类
+ operationId: getAllUsingGET
+ consumes:
+ - application/json
+ produces:
+ - '*/*'
+ responses:
+ '200':
+ description: OK
+ schema:
+ type: array
+ items:
+ $ref: '#/definitions/Category'
+ '401':
+ description: Unauthorized
+ '403':
+ description: Forbidden
+ '404':
+ description: Not Found
+ '/v1/category/{id}':
+ get:
+ tags:
+ - category-api
+ summary: 根据ID获取分类
+ operationId: getUsingGET
+ consumes:
+ - application/json
+ produces:
+ - '*/*'
+ parameters:
+ - name: id
+ in: path
+ description: id
+ required: true
+ type: integer
+ format: int32
+ responses:
+ '200':
+ description: OK
+ schema:
+ $ref: '#/definitions/Category'
+ '401':
+ description: Unauthorized
+ '403':
+ description: Forbidden
+ '404':
+ description: Not Found
+securityDefinitions:
+ api_key:
+ type: apiKey
+ name: api_key
+ in: header
+definitions:
+ Book:
+ type: object
+ properties:
+ author:
+ type: string
+ description: 作者
+ categoryId:
+ type: integer
+ format: int32
+ id:
+ type: integer
+ format: int32
+ name:
+ type: string
+ description: 书名
+ Category:
+ type: object
+ properties:
+ id:
+ type: integer
+ format: int32
+ name:
+ type: string
diff --git a/swagger-server/src/test/java/com/example/server/SwaggerServerApplicationTests.java b/swagger-server/src/test/java/com/example/server/SwaggerServerApplicationTests.java
new file mode 100644
index 0000000..585db9d
--- /dev/null
+++ b/swagger-server/src/test/java/com/example/server/SwaggerServerApplicationTests.java
@@ -0,0 +1,22 @@
+package com.example.server;
+
+import com.example.server.api.BookApi;
+import org.assertj.core.api.Assertions;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.junit4.SpringRunner;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest
+public class SwaggerServerApplicationTests {
+
+ @Autowired
+ private BookApi bookApi;
+
+ @Test
+ public void contextLoads() throws Exception {
+ Assertions.assertThat(bookApi).isNotNull();
+ }
+}
diff --git a/swagger-server/src/test/java/com/example/server/api/BookApiMockTest.java b/swagger-server/src/test/java/com/example/server/api/BookApiMockTest.java
new file mode 100644
index 0000000..649080c
--- /dev/null
+++ b/swagger-server/src/test/java/com/example/server/api/BookApiMockTest.java
@@ -0,0 +1,97 @@
+package com.example.server.api;
+
+import static org.hamcrest.Matchers.hasSize;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.isOneOf;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+import com.example.server.model.Book;
+import com.example.server.service.BookService;
+import com.google.common.collect.Lists;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.test.mock.mockito.MockBean;
+import org.springframework.http.MediaType;
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.test.web.servlet.MockMvc;
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
+
+/**
+ * Created by Damon on 2017/10/20.
+ */
+@RunWith(SpringRunner.class)
+@WebMvcTest(BookApi.class)
+public class BookApiMockTest {
+
+ @Autowired
+ private MockMvc mockMvc;
+
+ @MockBean
+ private BookService bookService;
+
+ @Test
+ public void getShouldReturnSpecifiedBook() throws Exception {
+ when(bookService.getById(1)).thenReturn(new Book(1, 1, "Clean Code", "Martin"));
+ mockMvc.perform(MockMvcRequestBuilders.get("/v1/book/1").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(jsonPath("$.id", is(1)));
+ }
+
+ @Test
+ public void getByInvalidIdShouldReturnDefault() throws Exception {
+ when(bookService.getById(5)).thenReturn(new Book(-1, -1, "NOT EXIST", "NO AUTHOR"));
+ mockMvc.perform(MockMvcRequestBuilders.get("/v1/book/5").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(jsonPath("$.id", is(-1)));
+ }
+
+ @Test
+ public void getByCategoryIdShouldReturnBooksOfThisCategory() throws Exception {
+ when(bookService.getByCategoryId(1)).thenReturn(Lists.newArrayList(
+ new Book(1, 1, "Clean Code", "Martin"),
+ new Book(2, 1, "Effective Java", "Joshua Bloch"),
+ new Book(3, 2, "挪威的森林", "村上春树")
+ ));
+ mockMvc.perform(MockMvcRequestBuilders
+ .get("/v1/book/getByCategoryId").param("id", "1").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(jsonPath("$", hasSize(3)));
+ }
+
+ @Test
+ public void getByInvalidCategoryIdShouldReturnEmpty() throws Exception {
+ when(bookService.getByCategoryId(1)).thenReturn(Lists.newArrayList(
+ new Book(1, 1, "Clean Code", "Martin"),
+ new Book(2, 1, "Effective Java", "Joshua Bloch"),
+ new Book(3, 2, "挪威的森林", "村上春树")
+ ));
+ mockMvc.perform(MockMvcRequestBuilders
+ .get("/v1/book/getByCategoryId").param("id", "2").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(jsonPath("$", hasSize(0)));
+ }
+
+ @Test
+ public void updateShouldReturnBoolean() throws Exception {
+ mockMvc.perform(MockMvcRequestBuilders
+ .post("/v1/book/update").param("id", "1").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(content().string(isOneOf("true", "false")));
+ }
+}
diff --git a/swagger-server/src/test/java/com/example/server/api/CategoryApiMockTest.java b/swagger-server/src/test/java/com/example/server/api/CategoryApiMockTest.java
new file mode 100644
index 0000000..060823a
--- /dev/null
+++ b/swagger-server/src/test/java/com/example/server/api/CategoryApiMockTest.java
@@ -0,0 +1,82 @@
+package com.example.server.api;
+
+import static org.hamcrest.Matchers.hasSize;
+import static org.hamcrest.Matchers.is;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+import com.example.server.model.Category;
+import com.example.server.service.CategoryService;
+import com.google.common.collect.Lists;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.test.mock.mockito.MockBean;
+import org.springframework.http.MediaType;
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.test.web.servlet.MockMvc;
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
+
+/**
+ *
Created by Damon on 2017/10/20.
+ */
+@RunWith(SpringRunner.class)
+@WebMvcTest(CategoryApi.class)
+public class CategoryApiMockTest {
+
+ @Autowired
+ private MockMvc mockMvc;
+
+ @MockBean
+ private CategoryService categoryService;
+
+ @Test
+ public void getAllShouldReturnAllCategories() throws Exception {
+ when(categoryService.getAll()).thenReturn(Lists.newArrayList(
+ new Category(1, "技术"),
+ new Category(2, "文学")
+ ));
+ mockMvc.perform(MockMvcRequestBuilders.get("/v1/category/").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(jsonPath("$", hasSize(2)));
+ }
+
+ @Test
+ public void getAllShouldReturnEmpty() throws Exception {
+ when(categoryService.getAll()).thenReturn(Lists.newArrayList());
+ mockMvc.perform(MockMvcRequestBuilders.get("/v1/category/").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(jsonPath("$", hasSize(0)));
+ }
+
+
+ @Test
+ public void getShouldReturnSpecifiedCategory() throws Exception {
+ when(categoryService.get(1)).thenReturn(new Category(1, "技术"));
+ mockMvc.perform(MockMvcRequestBuilders
+ .get("/v1/category/1").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(jsonPath("$.id", is(1)));
+ }
+
+ @Test
+ public void getByInvalidIdShouldReturnDefault() throws Exception {
+ when(categoryService.get(5)).thenReturn(new Category(-1, "NOT EXIST"));
+ mockMvc.perform(MockMvcRequestBuilders
+ .get("/v1/category/5").accept(MediaType.ALL))
+ .andDo(print())
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8_VALUE))
+ .andExpect(jsonPath("$.id", is(-1)));
+ }
+}