add template for Retrofit and Gson

bin/all-petstore.sh

@@ -27,6 +27,7 @@ cd $APP_DIR
 ./bin/qt5-petstore.sh
 ./bin/php-petstore.sh
 ./bin/python-petstore.sh
+./bin/retrofit-petstore.sh
 ./bin/ruby-petstore.sh
 ./bin/objc-petstore.sh
 ./bin/scala-petstore.sh

bin/retrofit-petstore.sh

@@ -0,0 +1,31 @@
+#!/bin/sh
+
+SCRIPT="$0"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+executable="./modules/swagger-codegen-cli/target/swagger-codegen-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="$@ generate -t modules/swagger-codegen/src/main/resources/retrofit -i modules/swagger-codegen/src/test/resources/2_0/petstore.json -l retrofit -o samples/client/petstore/retrofit"
+
+java $JAVA_OPTS -jar $executable $ags

modules/swagger-codegen/src/main/java/com/wordnik/swagger/codegen/CodegenOperation.java

@@ -7,7 +7,7 @@ import java.util.*;
 public class CodegenOperation {
   public Boolean hasConsumes, hasProduces, hasParams, returnTypeIsPrimitive,
     returnSimpleType, subresourceOperation, isMapContainer, isListContainer,
-    hasMore = Boolean.TRUE;
+    hasMore = Boolean.TRUE, isMultipart;
   public String path, operationId, returnType, httpMethod, returnBaseType,
     returnContainer, summary, notes, baseName, defaultResponse;
 

modules/swagger-codegen/src/main/java/com/wordnik/swagger/codegen/languages/RetrofitClientCodegen.java

@@ -0,0 +1,190 @@
+package com.wordnik.swagger.codegen.languages;
+
+import com.wordnik.swagger.codegen.*;
+import com.wordnik.swagger.models.Operation;
+import com.wordnik.swagger.models.properties.*;
+
+import java.util.*;
+import java.io.File;
+
+public class RetrofitClientCodegen extends DefaultCodegen implements CodegenConfig {
+  protected String invokerPackage = "io.swagger.client";
+  protected String groupId = "io.swagger";
+  protected String artifactId = "swagger-java-client";
+  protected String artifactVersion = "1.0.0";
+  protected String sourceFolder = "src/main/java";
+
+  public CodegenType getTag() {
+    return CodegenType.CLIENT;
+  }
+
+  public String getName() {
+    return "retrofit";
+  }
+
+  public String getHelp() {
+    return "Generates a Retrofit client library.";
+  }
+
+  public RetrofitClientCodegen() {
+    super();
+    outputFolder = "generated-code/java";
+    modelTemplateFiles.put("model.mustache", ".java");
+    apiTemplateFiles.put("api.mustache", ".java");
+    templateDir = "retrofit";
+    apiPackage = "io.swagger.client.api";
+    modelPackage = "io.swagger.client.model";
+
+    reservedWords = new HashSet<String> (
+      Arrays.asList(
+        "abstract", "continue", "for", "new", "switch", "assert", 
+        "default", "if", "package", "synchronized", "boolean", "do", "goto", "private", 
+        "this", "break", "double", "implements", "protected", "throw", "byte", "else", 
+        "import", "public", "throws", "case", "enum", "instanceof", "return", "transient", 
+        "catch", "extends", "int", "short", "try", "char", "final", "interface", "static", 
+        "void", "class", "finally", "long", "strictfp", "volatile", "const", "float", 
+        "native", "super", "while")
+    );
+
+    additionalProperties.put("invokerPackage", invokerPackage);
+    additionalProperties.put("groupId", groupId);
+    additionalProperties.put("artifactId", artifactId);
+    additionalProperties.put("artifactVersion", artifactVersion);
+
+    supportingFiles.add(new SupportingFile("pom.mustache", "", "pom.xml"));
+    supportingFiles.add(new SupportingFile("service.mustache", 
+      (sourceFolder + File.separator + invokerPackage).replace(".", java.io.File.separator), "ServiceGenerator.java"));
+
+    languageSpecificPrimitives = new HashSet<String>(
+      Arrays.asList(
+        "String",
+        "boolean",
+        "Boolean",
+        "Double",
+        "Integer",
+        "Long",
+        "Float",
+        "Object")
+      );
+    instantiationTypes.put("array", "ArrayList");
+    instantiationTypes.put("map", "HashMap");
+  }
+
+  @Override
+  public String escapeReservedWord(String name) {
+    return "_" + name;
+  }
+
+  @Override
+  public String apiFileFolder() {
+    return outputFolder + "/" + sourceFolder + "/" + apiPackage().replace('.', File.separatorChar);
+  }
+
+  public String modelFileFolder() {
+    return outputFolder + "/" + sourceFolder + "/" + modelPackage().replace('.', File.separatorChar);
+  }
+
+  @Override
+  public String toVarName(String name) {
+    // replace - with _ e.g. created-at => created_at
+    name = name.replaceAll("-", "_");
+
+    // if it's all uppper case, do nothing
+    if (name.matches("^[A-Z_]*$"))
+      return name;
+
+    // camelize (lower first character) the variable name
+    // pet_id => petId
+    name = camelize(name, true);
+
+    // for reserved word or word starting with number, append _
+    if(reservedWords.contains(name) || name.matches("^\\d.*"))
+      name = escapeReservedWord(name);
+
+    return name;
+  }
+
+  @Override
+  public String toParamName(String name) {
+    // should be the same as variable name
+    return toVarName(name);
+  }
+
+  @Override
+  public String toModelName(String name) {
+    // model name cannot use reserved keyword, e.g. return
+    if(reservedWords.contains(name))
+      throw new RuntimeException(name + " (reserved word) cannot be used as a model name");
+
+    // camelize the model name
+    // phone_number => PhoneNumber
+    return camelize(name);
+  }
+
+  @Override
+  public String toModelFilename(String name) {
+    // should be the same as the model name
+    return toModelName(name);
+  }
+
+
+  @Override
+  public String getTypeDeclaration(Property p) {
+    if(p instanceof ArrayProperty) {
+      ArrayProperty ap = (ArrayProperty) p;
+      Property inner = ap.getItems();
+      return getSwaggerType(p) + "<" + getTypeDeclaration(inner) + ">";
+    }
+    else if (p instanceof MapProperty) {
+      MapProperty mp = (MapProperty) p;
+      Property inner = mp.getAdditionalProperties();
+
+      return getSwaggerType(p) + "<String, " + getTypeDeclaration(inner) + ">";
+    }
+    return super.getTypeDeclaration(p);
+  }
+
+  @Override
+  public String getSwaggerType(Property p) {
+    String swaggerType = super.getSwaggerType(p);
+    String type = null;
+    if(typeMapping.containsKey(swaggerType)) {
+      type = typeMapping.get(swaggerType);
+      if(languageSpecificPrimitives.contains(type))
+        return toModelName(type);
+    }
+    else
+      type = swaggerType;
+    return toModelName(type);
+  }
+
+  @Override
+  public String toOperationId(String operationId) {
+    // method name cannot use reserved keyword, e.g. return
+    if(reservedWords.contains(operationId))
+      throw new RuntimeException(operationId + " (reserved word) cannot be used as method name");
+
+    return camelize(operationId, true);
+  }
+
+  public Map<String, Object> postProcessOperations(Map<String, Object> objs) {
+    Map<String, Object> operations = (Map<String, Object>)objs.get("operations");
+    if(operations != null) {
+      List<CodegenOperation> ops = (List<CodegenOperation>) operations.get("operation");
+      for(CodegenOperation operation : ops) {
+        if (operation.hasConsumes == Boolean.TRUE) {
+          Map<String, String> firstType = operation.consumes.get(0);
+          if (firstType != null) {
+            if ("multipart/form-data".equals(firstType.get("mediaType"))) {
+              operation.isMultipart = Boolean.TRUE;
+            }
+          }
+        }
+        if(operation.returnType == null) {
+          operation.returnType = "Void";        
+        }
+      }
+    }
+    return objs;
+  }
+}

modules/swagger-codegen/src/main/resources/META-INF/services/com.wordnik.swagger.codegen.CodegenConfig

@@ -10,6 +10,7 @@ com.wordnik.swagger.codegen.languages.PhpClientCodegen
 com.wordnik.swagger.codegen.languages.PythonClientCodegen
 com.wordnik.swagger.codegen.languages.Python3ClientCodegen
 com.wordnik.swagger.codegen.languages.Qt5CPPGenerator
+com.wordnik.swagger.codegen.languages.RetrofitClientCodegen
 com.wordnik.swagger.codegen.languages.RubyClientCodegen
 com.wordnik.swagger.codegen.languages.ScalaClientCodegen
 com.wordnik.swagger.codegen.languages.ScalatraServerCodegen

modules/swagger-codegen/src/main/resources/retrofit/api.mustache

@@ -0,0 +1,29 @@
+package {{package}};
+
+import {{modelPackage}}.*;
+
+import retrofit.http.*;
+import retrofit.mime.*;
+import java.util.*;
+
+{{#imports}}import {{import}};
+{{/imports}}
+
+{{#operations}}
+public interface {{classname}} {
+  {{#operation}}
+  /**
+   * {{summary}}
+   * {{notes}}
+{{#allParams}}   * @param {{paramName}} {{description}}
+{{/allParams}}   * @return {{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}void{{/returnType}}
+   */
+  {{#formParams}}{{#-first}}
+  {{#isMultipart}}@Multipart{{/isMultipart}}{{^isMultipart}}@FormUrlEncoded{{/isMultipart}}{{/-first}}{{/formParams}}
+  @{{httpMethod}}("{{path}}")  
+  {{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}Object{{/returnType}} {{nickname}}({{^allParams}});{{/allParams}}
+    {{#allParams}}{{>queryParams}}{{>pathParams}}{{>headerParams}}{{>bodyParams}}{{>formParams}}{{#hasMore}},{{/hasMore}}{{^hasMore}}
+  );{{/hasMore}}{{/allParams}}  
+  {{/operation}}
+}
+{{/operations}}

modules/swagger-codegen/src/main/resources/retrofit/bodyParams.mustache

@@ -0,0 +1 @@
+{{#isBodyParam}}@Body {{{dataType}}} {{paramName}}{{/isBodyParam}}

modules/swagger-codegen/src/main/resources/retrofit/formParams.mustache

@@ -0,0 +1 @@
+{{#isFormParam}}{{#notFile}}{{#isMultipart}}@Part{{/isMultipart}}{{^isMultipart}}@Field{{/isMultipart}}("{{paramName}}") {{{dataType}}} {{paramName}}{{/notFile}}{{#isFile}}{{#isMultipart}}@Part{{/isMultipart}}{{^isMultipart}}@Field{{/isMultipart}}("{{paramName}}") TypedFile {{paramName}}{{/isFile}}{{/isFormParam}}

modules/swagger-codegen/src/main/resources/retrofit/headerParams.mustache

@@ -0,0 +1 @@
+{{#isHeaderParam}}@Header("{{baseName}}") {{{dataType}}} {{paramName}}{{/isHeaderParam}}

modules/swagger-codegen/src/main/resources/retrofit/model.mustache

@@ -0,0 +1,50 @@
+package {{package}};
+
+{{#imports}}import {{import}};
+{{/imports}}
+
+import com.wordnik.swagger.annotations.*;
+import com.google.gson.annotations.SerializedName;
+{{#models}}
+
+{{#model}}{{#description}}
+/**
+ * {{description}}
+ **/{{/description}}
+@ApiModel(description = "{{{description}}}")
+public class {{classname}} {{#parent}}extends {{{parent}}}{{/parent}} {
+    {{#vars}}{{#isEnum}}
+    public enum {{datatypeWithEnum}} {
+        {{#allowableValues}}{{#values}} {{.}}, {{/values}}{{/allowableValues}}
+    };{{/isEnum}}
+
+    /**{{#description}}
+     * {{{description}}}{{/description}}{{#minimum}}
+     * minimum: {{minimum}}{{/minimum}}{{#maximum}}
+     * maximum: {{maximum}}{{/maximum}}
+     **/
+    @ApiModelProperty({{#required}}required = {{required}}, {{/required}}value = "{{{description}}}")  
+    @SerializedName("{{baseName}}"){{#isEnum}}    
+    private {{{datatypeWithEnum}}} {{name}} = {{{defaultValue}}};{{/isEnum}}{{^isEnum}}
+    private {{{datatype}}} {{name}} = {{{defaultValue}}};{{/isEnum}}{{/vars}}
+
+    {{#vars}}    
+    public {{{datatypeWithEnum}}} {{getter}}() {
+        return {{name}};
+    }
+    public void {{setter}}({{{datatypeWithEnum}}} {{name}}) {
+        this.{{name}} = {{name}};
+    }
+    {{/vars}}
+    @Override
+    public String toString()  {
+        StringBuilder sb = new StringBuilder();
+        sb.append("class {{classname}} {\n");
+        {{#parent}}sb.append("  " + super.toString()).append("\n");{{/parent}}
+        {{#vars}}sb.append("  {{name}}: ").append({{name}}).append("\n");
+        {{/vars}}sb.append("}\n");
+        return sb.toString();
+    }
+}
+{{/model}}
+{{/models}}

modules/swagger-codegen/src/main/resources/retrofit/pathParams.mustache

@@ -0,0 +1 @@
+{{#isPathParam}}@Path("{{baseName}}") {{{dataType}}} {{paramName}}{{/isPathParam}}

modules/swagger-codegen/src/main/resources/retrofit/pom.mustache

@@ -0,0 +1,143 @@
+<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/maven-v4_0_0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>{{groupId}}</groupId>
+  <artifactId>{{artifactId}}</artifactId>
+  <packaging>jar</packaging>
+  <name>{{artifactId}}</name>
+  <version>{{artifactVersion}}</version>
+  <scm>
+    <connection>scm:git:git@github.com:wordnik/swagger-mustache.git</connection>
+    <developerConnection>scm:git:git@github.com:wordnik/swagger-codegen.git</developerConnection>
+    <url>https://github.com/wordnik/swagger-codegen</url>
+  </scm>
+  <prerequisites>
+    <maven>2.2.0</maven>
+  </prerequisites>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <version>2.12</version>
+        <configuration>
+          <systemProperties>
+            <property>
+              <name>loggerPath</name>
+              <value>conf/log4j.properties</value>
+            </property>
+          </systemProperties>
+          <argLine>-Xms512m -Xmx1500m</argLine>
+          <parallel>methods</parallel>
+          <forkMode>pertest</forkMode>
+        </configuration>
+      </plugin>
+      <plugin>
+        <artifactId>maven-dependency-plugin</artifactId>
+        <executions>
+          <execution>
+            <phase>package</phase>
+            <goals>
+              <goal>copy-dependencies</goal>
+            </goals>
+            <configuration>
+              <outputDirectory>${project.build.directory}/lib</outputDirectory>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+
+      <!-- attach test jar -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <version>2.2</version>
+        <executions>
+          <execution>
+            <goals>
+              <goal>jar</goal>
+              <goal>test-jar</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+        </configuration>
+      </plugin>
+
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>build-helper-maven-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>add_sources</id>
+            <phase>generate-sources</phase>
+            <goals>
+              <goal>add-source</goal>
+            </goals>
+            <configuration>
+              <sources>
+                <source>src/main/java</source>
+              </sources>
+            </configuration>
+          </execution>
+          <execution>
+            <id>add_test_sources</id>
+            <phase>generate-test-sources</phase>
+            <goals>
+              <goal>add-test-source</goal>
+            </goals>
+            <configuration>
+              <sources>
+                <source>src/test/java</source>
+              </sources>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>2.3.2</version>
+        <configuration>
+          <source>1.6</source>
+          <target>1.6</target>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+  <dependencies>
+    <dependency>
+      <groupId>com.wordnik</groupId>
+      <artifactId>swagger-annotations</artifactId>
+      <version>${swagger-annotations-version}</version>
+    </dependency>
+    <dependency>
+      <groupId>com.google.code.gson</groupId>
+      <artifactId>gson</artifactId>
+      <version>${gson-version}</version>
+      <scope>compile</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.squareup.retrofit</groupId>
+      <artifactId>retrofit</artifactId>
+      <version>${retrofit-version}</version>
+      <scope>compile</scope>
+    </dependency>
+
+    <!-- test dependencies -->
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>${junit-version}</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+  <properties>
+    <swagger-annotations-version>1.5.3-M1</swagger-annotations-version>
+    <gson-version>2.3.1</gson-version>
+    <retrofit-version>1.9.0</retrofit-version>
+    <maven-plugin-version>1.0.0</maven-plugin-version>
+    <junit-version>4.12</junit-version>
+  </properties>
+</project>

modules/swagger-codegen/src/main/resources/retrofit/queryParams.mustache

@@ -0,0 +1 @@
+{{#isQueryParam}}@Query("{{baseName}}") {{{dataType}}} {{paramName}}{{/isQueryParam}}

modules/swagger-codegen/src/main/resources/retrofit/service.mustache

@@ -0,0 +1,23 @@
+package {{invokerPackage}};
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import retrofit.RestAdapter;
+import retrofit.converter.GsonConverter;
+
+public class ServiceGenerator {
+  // No need to instantiate this class.
+  private ServiceGenerator() { }
+
+  public static <S> S createService(Class<S> serviceClass) {
+    Gson gson = new GsonBuilder()
+        .setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ")
+        .create();
+    RestAdapter adapter = new RestAdapter.Builder()
+        .setEndpoint("{{basePath}}")
+        .setConverter(new GsonConverter(gson))
+        .build();
+
+    return adapter.create(serviceClass);
+  }
+}

pom.xml

@@ -350,6 +350,18 @@
         <module>samples/client/petstore/ruby</module>
       </modules>
     </profile>
+    <profile>
+      <id>retrofit-client</id>
+      <activation>
+        <property>
+          <name>env</name>
+          <value>java</value>
+        </property>
+      </activation>
+      <modules>
+        <module>samples/client/petstore/retrofit</module>
+      </modules>
+    </profile>
     <profile>
       <id>spring-mvc</id>
       <activation>

samples/client/petstore/android-java/src/main/java/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest package="io.swagger.client">
+    <application />
+</manifest>

samples/client/petstore/retrofit/pom.xml

@@ -0,0 +1,143 @@
+<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/maven-v4_0_0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>io.swagger</groupId>
+  <artifactId>swagger-java-client</artifactId>
+  <packaging>jar</packaging>
+  <name>swagger-java-client</name>
+  <version>1.0.0</version>
+  <scm>
+    <connection>scm:git:git@github.com:wordnik/swagger-mustache.git</connection>
+    <developerConnection>scm:git:git@github.com:wordnik/swagger-codegen.git</developerConnection>
+    <url>https://github.com/wordnik/swagger-codegen</url>
+  </scm>
+  <prerequisites>
+    <maven>2.2.0</maven>
+  </prerequisites>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <version>2.12</version>
+        <configuration>
+          <systemProperties>
+            <property>
+              <name>loggerPath</name>
+              <value>conf/log4j.properties</value>
+            </property>
+          </systemProperties>
+          <argLine>-Xms512m -Xmx1500m</argLine>
+          <parallel>methods</parallel>
+          <forkMode>pertest</forkMode>
+        </configuration>
+      </plugin>
+      <plugin>
+        <artifactId>maven-dependency-plugin</artifactId>
+        <executions>
+          <execution>
+            <phase>package</phase>
+            <goals>
+              <goal>copy-dependencies</goal>
+            </goals>
+            <configuration>
+              <outputDirectory>${project.build.directory}/lib</outputDirectory>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+
+      <!-- attach test jar -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <version>2.2</version>
+        <executions>
+          <execution>
+            <goals>
+              <goal>jar</goal>
+              <goal>test-jar</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+        </configuration>
+      </plugin>
+
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>build-helper-maven-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>add_sources</id>
+            <phase>generate-sources</phase>
+            <goals>
+              <goal>add-source</goal>
+            </goals>
+            <configuration>
+              <sources>
+                <source>src/main/java</source>
+              </sources>
+            </configuration>
+          </execution>
+          <execution>
+            <id>add_test_sources</id>
+            <phase>generate-test-sources</phase>
+            <goals>
+              <goal>add-test-source</goal>
+            </goals>
+            <configuration>
+              <sources>
+                <source>src/test/java</source>
+              </sources>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>2.3.2</version>
+        <configuration>
+          <source>1.6</source>
+          <target>1.6</target>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+  <dependencies>
+    <dependency>
+      <groupId>com.wordnik</groupId>
+      <artifactId>swagger-annotations</artifactId>
+      <version>${swagger-annotations-version}</version>
+    </dependency>
+    <dependency>
+      <groupId>com.google.code.gson</groupId>
+      <artifactId>gson</artifactId>
+      <version>${gson-version}</version>
+      <scope>compile</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.squareup.retrofit</groupId>
+      <artifactId>retrofit</artifactId>
+      <version>${retrofit-version}</version>
+      <scope>compile</scope>
+    </dependency>
+
+    <!-- test dependencies -->
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>${junit-version}</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+  <properties>
+    <swagger-annotations-version>1.5.3-M1</swagger-annotations-version>
+    <gson-version>2.3.1</gson-version>
+    <retrofit-version>1.9.0</retrofit-version>
+    <maven-plugin-version>1.0.0</maven-plugin-version>
+    <junit-version>4.12</junit-version>
+  </properties>
+</project>

samples/client/petstore/retrofit/src/main/java/io/swagger/client/ServiceGenerator.java

@@ -0,0 +1,23 @@
+package io.swagger.client;
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import retrofit.RestAdapter;
+import retrofit.converter.GsonConverter;
+
+public class ServiceGenerator {
+  // No need to instantiate this class.
+  private ServiceGenerator() { }
+
+  public static <S> S createService(Class<S> serviceClass) {
+    Gson gson = new GsonBuilder()
+        .setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ")
+        .create();
+    RestAdapter adapter = new RestAdapter.Builder()
+        .setEndpoint("http://petstore.swagger.io/v2")
+        .setConverter(new GsonConverter(gson))
+        .build();
+
+    return adapter.create(serviceClass);
+  }
+}

samples/client/petstore/retrofit/src/main/java/io/swagger/client/api/PetApi.java

@@ -0,0 +1,117 @@
+package io.swagger.client.api;
+
+import io.swagger.client.model.*;
+
+import retrofit.http.*;
+import retrofit.mime.*;
+import java.util.*;
+
+import io.swagger.client.model.Pet;
+import java.io.File;
+
+public interface PetApi {
+  
+  /**
+   * Update an existing pet
+   * 
+   * @param body Pet object that needs to be added to the store
+   * @return Void
+   */
+  
+  @PUT("/pet")  
+  Void updatePet(
+    @Body Pet body
+  );  
+  
+  /**
+   * Add a new pet to the store
+   * 
+   * @param body Pet object that needs to be added to the store
+   * @return Void
+   */
+  
+  @POST("/pet")  
+  Void addPet(
+    @Body Pet body
+  );  
+  
+  /**
+   * Finds Pets by status
+   * Multiple status values can be provided with comma seperated strings
+   * @param status Status values that need to be considered for filter
+   * @return List<Pet>
+   */
+  
+  @GET("/pet/findByStatus")  
+  List<Pet> findPetsByStatus(
+    @Query("status") List<String> status
+  );  
+  
+  /**
+   * Finds Pets by tags
+   * Muliple tags can be provided with comma seperated strings. Use tag1, tag2, tag3 for testing.
+   * @param tags Tags to filter by
+   * @return List<Pet>
+   */
+  
+  @GET("/pet/findByTags")  
+  List<Pet> findPetsByTags(
+    @Query("tags") List<String> tags
+  );  
+  
+  /**
+   * Find pet by ID
+   * Returns a pet when ID &lt; 10.  ID &gt; 10 or nonintegers will simulate API error conditions
+   * @param petId ID of pet that needs to be fetched
+   * @return Pet
+   */
+  
+  @GET("/pet/{petId}")  
+  Pet getPetById(
+    @Path("petId") Long petId
+  );  
+  
+  /**
+   * Updates a pet in the store with form data
+   * 
+   * @param petId ID of pet that needs to be updated
+   * @param name Updated name of the pet
+   * @param status Updated status of the pet
+   * @return Void
+   */
+  
+  @FormUrlEncoded
+  @POST("/pet/{petId}")  
+  Void updatePetWithForm(
+    @Path("petId") String petId,@Field("name") String name,@Field("status") String status
+  );  
+  
+  /**
+   * Deletes a pet
+   * 
+   * @param apiKey 
+   * @param petId Pet id to delete
+   * @return Void
+   */
+  
+  @DELETE("/pet/{petId}")  
+  Void deletePet(
+    @Header("api_key") String apiKey,@Path("petId") Long petId
+  );  
+  
+  /**
+   * uploads an image
+   * 
+   * @param petId ID of pet to update
+   * @param additionalMetadata Additional data to pass to server
+   * @param file file to upload
+   * @return Void
+   */
+  
+  @Multipart
+  @POST("/pet/{petId}/uploadImage")  
+  Void uploadFile(
+    @Path("petId") Long petId,@Part("additionalMetadata") String additionalMetadata,@Part("file") TypedFile file
+  );  
+  
+}

samples/client/petstore/retrofit/src/main/java/io/swagger/client/api/StoreApi.java

@@ -0,0 +1,60 @@
+package io.swagger.client.api;
+
+import io.swagger.client.model.*;
+
+import retrofit.http.*;
+import retrofit.mime.*;
+import java.util.*;
+
+import java.util.Map;
+import io.swagger.client.model.Order;
+
+public interface StoreApi {
+  
+  /**
+   * Returns pet inventories by status
+   * Returns a map of status codes to quantities
+   * @return Map<String, Integer>
+   */
+  
+  @GET("/store/inventory")  
+  Map<String, Integer> getInventory();
+      
+  
+  /**
+   * Place an order for a pet
+   * 
+   * @param body order placed for purchasing the pet
+   * @return Order
+   */
+  
+  @POST("/store/order")  
+  Order placeOrder(
+    @Body Order body
+  );  
+  
+  /**
+   * Find purchase order by ID
+   * For valid response try integer IDs with value &lt;= 5 or &gt; 10. Other values will generated exceptions
+   * @param orderId ID of pet that needs to be fetched
+   * @return Order
+   */
+  
+  @GET("/store/order/{orderId}")  
+  Order getOrderById(
+    @Path("orderId") String orderId
+  );  
+  
+  /**
+   * Delete purchase order by ID
+   * For valid response try integer IDs with value &lt; 1000. Anything above 1000 or nonintegers will generate API errors
+   * @param orderId ID of the order that needs to be deleted
+   * @return Void
+   */
+  
+  @DELETE("/store/order/{orderId}")  
+  Void deleteOrder(
+    @Path("orderId") String orderId
+  );  
+  
+}

samples/client/petstore/retrofit/src/main/java/io/swagger/client/api/UserApi.java

@@ -0,0 +1,110 @@
+package io.swagger.client.api;
+
+import io.swagger.client.model.*;
+
+import retrofit.http.*;
+import retrofit.mime.*;
+import java.util.*;
+
+import io.swagger.client.model.User;
+import java.util.*;
+
+public interface UserApi {
+  
+  /**
+   * Create user
+   * This can only be done by the logged in user.
+   * @param body Created user object
+   * @return Void
+   */
+  
+  @POST("/user")  
+  Void createUser(
+    @Body User body
+  );  
+  
+  /**
+   * Creates list of users with given input array
+   * 
+   * @param body List of user object
+   * @return Void
+   */
+  
+  @POST("/user/createWithArray")  
+  Void createUsersWithArrayInput(
+    @Body List<User> body
+  );  
+  
+  /**
+   * Creates list of users with given input array
+   * 
+   * @param body List of user object
+   * @return Void
+   */
+  
+  @POST("/user/createWithList")  
+  Void createUsersWithListInput(
+    @Body List<User> body
+  );  
+  
+  /**
+   * Logs user into the system
+   * 
+   * @param username The user name for login
+   * @param password The password for login in clear text
+   * @return String
+   */
+  
+  @GET("/user/login")  
+  String loginUser(
+    @Query("username") String username,@Query("password") String password
+  );  
+  
+  /**
+   * Logs out current logged in user session
+   * 
+   * @return Void
+   */
+  
+  @GET("/user/logout")  
+  Void logoutUser();
+      
+  
+  /**
+   * Get user by user name
+   * 
+   * @param username The name that needs to be fetched. Use user1 for testing. 
+   * @return User
+   */
+  
+  @GET("/user/{username}")  
+  User getUserByName(
+    @Path("username") String username
+  );  
+  
+  /**
+   * Updated user
+   * This can only be done by the logged in user.
+   * @param username name that need to be deleted
+   * @param body Updated user object
+   * @return Void
+   */
+  
+  @PUT("/user/{username}")  
+  Void updateUser(
+    @Path("username") String username,@Body User body
+  );  
+  
+  /**
+   * Delete user
+   * This can only be done by the logged in user.
+   * @param username The name that needs to be deleted
+   * @return Void
+   */
+  
+  @DELETE("/user/{username}")  
+  Void deleteUser(
+    @Path("username") String username
+  );  
+  
+}

samples/client/petstore/retrofit/src/main/java/io/swagger/client/model/Category.java

@@ -0,0 +1,49 @@
+package io.swagger.client.model;
+
+
+import com.wordnik.swagger.annotations.*;
+import com.google.gson.annotations.SerializedName;
+
+
+@ApiModel(description = "")
+public class Category  {
+    
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("id")
+    private Long id = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("name")
+    private String name = null;
+
+        
+    public Long getId() {
+        return id;
+    }
+    public void setId(Long id) {
+        this.id = id;
+    }
+        
+    public String getName() {
+        return name;
+    }
+    public void setName(String name) {
+        this.name = name;
+    }
+    
+    @Override
+    public String toString()  {
+        StringBuilder sb = new StringBuilder();
+        sb.append("class Category {\n");
+        
+        sb.append("  id: ").append(id).append("\n");
+        sb.append("  name: ").append(name).append("\n");
+        sb.append("}\n");
+        return sb.toString();
+    }
+}

samples/client/petstore/retrofit/src/main/java/io/swagger/client/model/Order.java

@@ -0,0 +1,110 @@
+package io.swagger.client.model;
+
+import java.util.Date;
+
+import com.wordnik.swagger.annotations.*;
+import com.google.gson.annotations.SerializedName;
+
+
+@ApiModel(description = "")
+public class Order  {
+    
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("id")
+    private Long id = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("petId")
+    private Long petId = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("quantity")
+    private Integer quantity = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("shipDate")
+    private Date shipDate = null;
+    public enum StatusEnum {
+         placed,  approved,  delivered, 
+    };
+
+    /**
+     * Order Status
+     **/
+    @ApiModelProperty(value = "Order Status")  
+    @SerializedName("status")    
+    private StatusEnum status = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("complete")
+    private Boolean complete = null;
+
+        
+    public Long getId() {
+        return id;
+    }
+    public void setId(Long id) {
+        this.id = id;
+    }
+        
+    public Long getPetId() {
+        return petId;
+    }
+    public void setPetId(Long petId) {
+        this.petId = petId;
+    }
+        
+    public Integer getQuantity() {
+        return quantity;
+    }
+    public void setQuantity(Integer quantity) {
+        this.quantity = quantity;
+    }
+        
+    public Date getShipDate() {
+        return shipDate;
+    }
+    public void setShipDate(Date shipDate) {
+        this.shipDate = shipDate;
+    }
+        
+    public StatusEnum getStatus() {
+        return status;
+    }
+    public void setStatus(StatusEnum status) {
+        this.status = status;
+    }
+        
+    public Boolean getComplete() {
+        return complete;
+    }
+    public void setComplete(Boolean complete) {
+        this.complete = complete;
+    }
+    
+    @Override
+    public String toString()  {
+        StringBuilder sb = new StringBuilder();
+        sb.append("class Order {\n");
+        
+        sb.append("  id: ").append(id).append("\n");
+        sb.append("  petId: ").append(petId).append("\n");
+        sb.append("  quantity: ").append(quantity).append("\n");
+        sb.append("  shipDate: ").append(shipDate).append("\n");
+        sb.append("  status: ").append(status).append("\n");
+        sb.append("  complete: ").append(complete).append("\n");
+        sb.append("}\n");
+        return sb.toString();
+    }
+}

samples/client/petstore/retrofit/src/main/java/io/swagger/client/model/Pet.java

@@ -0,0 +1,112 @@
+package io.swagger.client.model;
+
+import io.swagger.client.model.Category;
+import java.util.*;
+import io.swagger.client.model.Tag;
+
+import com.wordnik.swagger.annotations.*;
+import com.google.gson.annotations.SerializedName;
+
+
+@ApiModel(description = "")
+public class Pet  {
+    
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("id")
+    private Long id = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("category")
+    private Category category = null;
+
+    /**
+     **/
+    @ApiModelProperty(required = true, value = "")  
+    @SerializedName("name")
+    private String name = null;
+
+    /**
+     **/
+    @ApiModelProperty(required = true, value = "")  
+    @SerializedName("photoUrls")
+    private List<String> photoUrls = new ArrayList<String>() ;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("tags")
+    private List<Tag> tags = new ArrayList<Tag>() ;
+    public enum StatusEnum {
+         available,  pending,  sold, 
+    };
+
+    /**
+     * pet status in the store
+     **/
+    @ApiModelProperty(value = "pet status in the store")  
+    @SerializedName("status")    
+    private StatusEnum status = null;
+
+        
+    public Long getId() {
+        return id;
+    }
+    public void setId(Long id) {
+        this.id = id;
+    }
+        
+    public Category getCategory() {
+        return category;
+    }
+    public void setCategory(Category category) {
+        this.category = category;
+    }
+        
+    public String getName() {
+        return name;
+    }
+    public void setName(String name) {
+        this.name = name;
+    }
+        
+    public List<String> getPhotoUrls() {
+        return photoUrls;
+    }
+    public void setPhotoUrls(List<String> photoUrls) {
+        this.photoUrls = photoUrls;
+    }
+        
+    public List<Tag> getTags() {
+        return tags;
+    }
+    public void setTags(List<Tag> tags) {
+        this.tags = tags;
+    }
+        
+    public StatusEnum getStatus() {
+        return status;
+    }
+    public void setStatus(StatusEnum status) {
+        this.status = status;
+    }
+    
+    @Override
+    public String toString()  {
+        StringBuilder sb = new StringBuilder();
+        sb.append("class Pet {\n");
+        
+        sb.append("  id: ").append(id).append("\n");
+        sb.append("  category: ").append(category).append("\n");
+        sb.append("  name: ").append(name).append("\n");
+        sb.append("  photoUrls: ").append(photoUrls).append("\n");
+        sb.append("  tags: ").append(tags).append("\n");
+        sb.append("  status: ").append(status).append("\n");
+        sb.append("}\n");
+        return sb.toString();
+    }
+}

samples/client/petstore/retrofit/src/main/java/io/swagger/client/model/Tag.java

@@ -0,0 +1,49 @@
+package io.swagger.client.model;
+
+
+import com.wordnik.swagger.annotations.*;
+import com.google.gson.annotations.SerializedName;
+
+
+@ApiModel(description = "")
+public class Tag  {
+    
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("id")
+    private Long id = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("name")
+    private String name = null;
+
+        
+    public Long getId() {
+        return id;
+    }
+    public void setId(Long id) {
+        this.id = id;
+    }
+        
+    public String getName() {
+        return name;
+    }
+    public void setName(String name) {
+        this.name = name;
+    }
+    
+    @Override
+    public String toString()  {
+        StringBuilder sb = new StringBuilder();
+        sb.append("class Tag {\n");
+        
+        sb.append("  id: ").append(id).append("\n");
+        sb.append("  name: ").append(name).append("\n");
+        sb.append("}\n");
+        return sb.toString();
+    }
+}

samples/client/petstore/retrofit/src/main/java/io/swagger/client/model/User.java

@@ -0,0 +1,134 @@
+package io.swagger.client.model;
+
+
+import com.wordnik.swagger.annotations.*;
+import com.google.gson.annotations.SerializedName;
+
+
+@ApiModel(description = "")
+public class User  {
+    
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("id")
+    private Long id = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("username")
+    private String username = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("firstName")
+    private String firstName = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("lastName")
+    private String lastName = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("email")
+    private String email = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("password")
+    private String password = null;
+
+    /**
+     **/
+    @ApiModelProperty(value = "")  
+    @SerializedName("phone")
+    private String phone = null;
+
+    /**
+     * User Status
+     **/
+    @ApiModelProperty(value = "User Status")  
+    @SerializedName("userStatus")
+    private Integer userStatus = null;
+
+        
+    public Long getId() {
+        return id;
+    }
+    public void setId(Long id) {
+        this.id = id;
+    }
+        
+    public String getUsername() {
+        return username;
+    }
+    public void setUsername(String username) {
+        this.username = username;
+    }
+        
+    public String getFirstName() {
+        return firstName;
+    }
+    public void setFirstName(String firstName) {
+        this.firstName = firstName;
+    }
+        
+    public String getLastName() {
+        return lastName;
+    }
+    public void setLastName(String lastName) {
+        this.lastName = lastName;
+    }
+        
+    public String getEmail() {
+        return email;
+    }
+    public void setEmail(String email) {
+        this.email = email;
+    }
+        
+    public String getPassword() {
+        return password;
+    }
+    public void setPassword(String password) {
+        this.password = password;
+    }
+        
+    public String getPhone() {
+        return phone;
+    }
+    public void setPhone(String phone) {
+        this.phone = phone;
+    }
+        
+    public Integer getUserStatus() {
+        return userStatus;
+    }
+    public void setUserStatus(Integer userStatus) {
+        this.userStatus = userStatus;
+    }
+    
+    @Override
+    public String toString()  {
+        StringBuilder sb = new StringBuilder();
+        sb.append("class User {\n");
+        
+        sb.append("  id: ").append(id).append("\n");
+        sb.append("  username: ").append(username).append("\n");
+        sb.append("  firstName: ").append(firstName).append("\n");
+        sb.append("  lastName: ").append(lastName).append("\n");
+        sb.append("  email: ").append(email).append("\n");
+        sb.append("  password: ").append(password).append("\n");
+        sb.append("  phone: ").append(phone).append("\n");
+        sb.append("  userStatus: ").append(userStatus).append("\n");
+        sb.append("}\n");
+        return sb.toString();
+    }
+}

samples/client/petstore/retrofit/src/test/java/io/swagger/petstore/test/PetApiTest.java

@@ -0,0 +1,158 @@
+package io.swagger.petstore.test;
+
+import io.swagger.client.ServiceGenerator;
+import io.swagger.client.api.*;
+import io.swagger.client.model.*;
+
+import retrofit.RetrofitError;
+import retrofit.mime.TypedFile;
+
+import java.util.*;
+import java.io.*;
+
+import static org.junit.Assert.*;
+import org.junit.*;
+
+public class PetApiTest {
+  PetApi api = null;
+
+  @Before
+  public void setup() {
+    api = ServiceGenerator.createService(PetApi.class);
+  }
+
+  @Test
+  public void testCreateAndGetPet() throws Exception {
+    Pet pet = createRandomPet();
+    api.addPet(pet);
+
+    Pet fetched = api.getPetById(pet.getId());
+    assertNotNull(fetched);
+    assertEquals(pet.getId(), fetched.getId());
+    assertNotNull(fetched.getCategory());
+    assertEquals(fetched.getCategory().getName(), pet.getCategory().getName());
+  }
+
+  @Test
+  public void testUpdatePet() throws Exception {
+    Pet pet = createRandomPet();
+    pet.setName("programmer");
+
+    api.updatePet(pet);
+
+    Pet fetched = api.getPetById(pet.getId());
+    assertNotNull(fetched);
+    assertEquals(pet.getId(), fetched.getId());
+    assertNotNull(fetched.getCategory());
+    assertEquals(fetched.getCategory().getName(), pet.getCategory().getName());
+  }
+
+  @Test
+  public void testFindPetsByStatus() throws Exception {
+    Pet pet = createRandomPet();
+    pet.setName("programmer");
+    pet.setStatus(Pet.StatusEnum.available);
+
+    api.updatePet(pet);
+
+    List<Pet> pets = api.findPetsByStatus(Arrays.asList(new String[]{"available"}));
+    assertNotNull(pets);
+
+    boolean found = false;
+    for(Pet fetched : pets) {
+      if(fetched.getId().equals(pet.getId())) {
+        found = true;
+        break;
+      }
+    }
+
+    assertTrue(found);
+  }
+
+  @Test
+  public void testFindPetsByTags() throws Exception {
+    Pet pet = createRandomPet();
+    pet.setName("monster");
+    pet.setStatus(Pet.StatusEnum.available);
+
+    List<Tag> tags = new ArrayList<Tag>();
+    Tag tag1 = new Tag();
+    tag1.setName("friendly");
+    tags.add(tag1);
+    pet.setTags(tags);
+
+    api.updatePet(pet);
+
+    List<Pet> pets = api.findPetsByTags(Arrays.asList(new String[]{"friendly"}));
+    assertNotNull(pets);
+
+    boolean found = false;
+    for(Pet fetched : pets) {
+      if(fetched.getId().equals(pet.getId())) {
+        found = true;
+        break;
+      }
+    }
+    assertTrue(found);
+  }
+
+  @Test
+  public void testUpdatePetWithForm() throws Exception {
+    Pet pet = createRandomPet();
+    pet.setName("frank");
+    api.addPet(pet);
+
+    Pet fetched = api.getPetById(pet.getId());
+    
+    api.updatePetWithForm(String.valueOf(fetched.getId()), "furt", null);
+    Pet updated = api.getPetById(fetched.getId());
+
+    assertEquals(updated.getName(), fetched.getName());
+  }
+
+  @Test
+  public void testDeletePet() throws Exception {
+    Pet pet = createRandomPet();
+    api.addPet(pet);
+
+    Pet fetched = api.getPetById(pet.getId());
+    api.deletePet(null, fetched.getId());
+
+    try {
+      fetched = api.getPetById(fetched.getId());
+      fail("expected an error");
+    }
+    catch (RetrofitError e) {
+      assertEquals(404, e.getResponse().getStatus());
+    }
+  }
+
+  @Test
+  public void testUploadFile() throws Exception {
+    Pet pet = createRandomPet();
+    api.addPet(pet);
+
+    File file = new File("hello.txt");
+    BufferedWriter writer = new BufferedWriter(new FileWriter(file));
+    writer.write("Hello world!");
+    writer.close();
+
+    api.uploadFile(pet.getId(), "a test file", new TypedFile("text/plain", file));
+  }
+
+  private Pet createRandomPet() {
+    Pet pet = new Pet();
+    pet.setId(System.currentTimeMillis());
+    pet.setName("gorilla");
+
+    Category category = new Category();
+    category.setName("really-happy");
+
+    pet.setCategory(category);
+    pet.setStatus(Pet.StatusEnum.available);
+    List<String> photos = Arrays.asList(new String[]{"http://foo.bar.com/1", "http://foo.bar.com/2"});
+    pet.setPhotoUrls(photos);
+
+    return pet;
+  }
+}

samples/client/petstore/retrofit/src/test/java/io/swagger/petstore/test/StoreApiTest.java

@@ -0,0 +1,70 @@
+package io.swagger.petstore.test;
+
+import io.swagger.client.ServiceGenerator;
+import io.swagger.client.api.*;
+import io.swagger.client.model.*;
+
+import retrofit.RetrofitError;
+
+import java.util.*;
+import java.io.*;
+
+import static org.junit.Assert.*;
+import org.junit.*;
+
+public class StoreApiTest {
+  StoreApi api = null;
+
+  @Before
+  public void setup() {
+    api = ServiceGenerator.createService(StoreApi.class);
+  }
+
+  @Test
+  public void testGetInventory() throws Exception {
+    Map<String, Integer> inventory = api.getInventory();
+    assertTrue(inventory.keySet().size() > 0);
+  }
+
+  @Test
+  public void testPlaceOrder() throws Exception {
+    Order order = createOrder();
+    api.placeOrder(order);
+
+    Order fetched = api.getOrderById(String.valueOf(order.getId()));
+    assertEquals(order.getId(), fetched.getId());
+    assertEquals(order.getPetId(), fetched.getPetId());
+    assertEquals(order.getQuantity(), fetched.getQuantity());
+  }
+
+  @Test
+  public void testDeleteOrder() throws Exception {
+    Order order = createOrder();
+    api.placeOrder(order);
+
+    Order fetched = api.getOrderById(String.valueOf(order.getId()));
+    assertEquals(fetched.getId(), order.getId());
+
+    api.deleteOrder(String.valueOf(order.getId()));
+
+    try {
+      api.getOrderById(String.valueOf(order.getId()));
+      // fail("expected an error");
+    }
+    catch (RetrofitError e) {
+      // ok
+    }
+  }
+
+  private Order createOrder() {
+    Order order = new Order();
+    order.setId(new Long(System.currentTimeMillis()));
+    order.setPetId(new Long(200));
+    order.setQuantity(new Integer(13));
+    order.setShipDate(new java.util.Date());
+    order.setStatus(Order.StatusEnum.placed);
+    order.setComplete(true);
+
+    return order;
+  }
+}

samples/client/petstore/retrofit/src/test/java/io/swagger/petstore/test/UserApiTest.java

@@ -0,0 +1,84 @@
+package io.swagger.petstore.test;
+
+import io.swagger.client.ServiceGenerator;
+import io.swagger.client.api.*;
+import io.swagger.client.model.*;
+
+import java.util.*;
+import java.io.*;
+
+import static org.junit.Assert.*;
+import org.junit.*;
+
+public class UserApiTest {
+  UserApi api = null;
+
+  @Before
+  public void setup() {
+    api = ServiceGenerator.createService(UserApi.class);
+  }
+
+  @Test
+  public void testCreateUser() throws Exception {
+    User user = createUser();
+
+    api.createUser(user);
+
+    User fetched = api.getUserByName(user.getUsername());
+    assertEquals(user.getId(), fetched.getId());
+  }
+
+  @Test
+  public void testCreateUsersWithArray() throws Exception {
+    User user1 = createUser();
+    user1.setUsername("abc123");
+    User user2 = createUser();
+    user2.setUsername("123abc");
+
+    api.createUsersWithArrayInput(Arrays.asList(new User[]{user1, user2}));
+
+    User fetched = api.getUserByName(user1.getUsername());
+    assertEquals(user1.getId(), fetched.getId());
+  }
+
+  @Test
+  public void testCreateUsersWithList() throws Exception {
+    User user1 = createUser();
+    user1.setUsername("abc123");
+    User user2 = createUser();
+    user2.setUsername("123abc");
+
+    api.createUsersWithListInput(Arrays.asList(new User[]{user1, user2}));
+
+    User fetched = api.getUserByName(user1.getUsername());
+    assertEquals(user1.getId(), fetched.getId());
+  }
+
+  @Test
+  public void testLoginUser() throws Exception {
+    User user = createUser();
+    api.createUser(user);
+
+    String token = api.loginUser(user.getUsername(), user.getPassword());
+    assertTrue(token.startsWith("logged in user session:"));
+  }
+
+  @Test
+  public void logoutUser() throws Exception {
+    api.logoutUser();
+  }
+
+  private User createUser() {
+    User user = new User();
+    user.setId(System.currentTimeMillis());
+    user.setUsername("fred");
+    user.setFirstName("Fred");
+    user.setLastName("Meyer");
+    user.setEmail("fred@fredmeyer.com");
+    user.setPassword("xxXXxx");
+    user.setPhone("408-867-5309");
+    user.setUserStatus(123);
+
+    return user;
+  }
+}