updated online version, added tag example

This commit is contained in:
Tony Tam 2015-02-23 23:23:37 -08:00
parent c82dfa3a64
commit e5c70d5961
2 changed files with 13 additions and 7 deletions

View File

@ -10,7 +10,7 @@
<artifactId>swagger-generator</artifactId>
<packaging>war</packaging>
<name>swagger-generator</name>
<version>1.0.0</version>
<version>2.1.3-M1-SNAPSHOT</version>
<build>
<sourceDirectory>src/main/java</sourceDirectory>
<plugins>
@ -232,7 +232,7 @@
<zip-version>1.3.2</zip-version>
<jetty-version>9.0.7.v20131107</jetty-version>
<jersey2-version>2.4.1</jersey2-version>
<swagger-core-version>1.5.1-M1</swagger-core-version>
<swagger-core-version>1.5.2-M1</swagger-core-version>
<scala-maven-plugin-version>3.1.5</scala-maven-plugin-version>
<scala-version>2.10.0</scala-version>

View File

@ -36,7 +36,8 @@ public class SwaggerResource {
@Path("/download/{fileId}")
@Produces({"application/zip"})
@ApiOperation(value = "Downloads a pre-generated file",
response = String.class)
response = String.class,
tags = {@Tag(value = "clients"), @Tag(value = "servers")})
public Response downloadFile(@PathParam("fileId") String fileId) throws Exception {
Generated g = fileMap.get(fileId);
System.out.println("looking for fileId " + fileId);
@ -59,7 +60,9 @@ public class SwaggerResource {
@Path("/clients/{language}")
@Produces({"application/zip", "application/json"})
@ApiOperation(
value = "Generates a client library based on the config")
value = "Generates a client library based on the config",
response = ResponseCode.class,
tags = {@Tag(value = "clients", description = "client operations")})
public Response generateClient(
@ApiParam(value = "The target language for the client library", allowableValues = "android,java,php,objc,docs", required = true) @PathParam("language") String language,
@ApiParam(value = "Configuration for building the client library", required = true) GeneratorInput opts) throws Exception {
@ -85,7 +88,8 @@ public class SwaggerResource {
@Path("/clients")
@ApiOperation(value = "Gets languages supported by the client generator",
response = String.class,
responseContainer = "List")
responseContainer = "List",
tags = {@Tag(value = "clients", description = "client operations")})
public Response clientOptions() {
String[] languages = new String[clients.size()];
languages = clients.toArray(languages);
@ -96,7 +100,8 @@ public class SwaggerResource {
@Path("/servers")
@ApiOperation(value = "Gets languages supported by the server generator",
response = String.class,
responseContainer = "List")
responseContainer = "List",
tags = {@Tag(value = "servers", description = "server operations")})
public Response serverOptions() {
String[] languages = new String[servers.size()];
languages = servers.toArray(languages);
@ -106,7 +111,8 @@ public class SwaggerResource {
@POST
@Path("/servers/{framework}")
@ApiOperation(value = "Generates a server library for the supplied server framework",
notes = "The model representing this is not accurate, it needs to contain a consolidated JSON structure")
response = ResponseCode.class,
tags = {@Tag(value = "servers", description = "server operations")})
public Response generateServerForLanguage(
@ApiParam(value = "framework", allowableValues = "jaxrs,nodejs", required = true) @PathParam("framework") String framework,
@ApiParam(value = "parameters", required = true) GeneratorInput opts)