/gce2retrofit

Google Cloud Endpoint (GCE) to Retrofit

Primary LanguageJavaApache License 2.0Apache-2.0

gce2retrofit

Generates Retrofit interfaces and related models from Google Cloud Endpoint (GCE) discovery files.

Usage

Configuaration files

Put the configuration files for each GCE server in a directory under src/main/gce2retrofit.

discovery.json (required)

The discovery doc from GCE. e.g. https://2-dot-test-pont.appspot.com/_ah/api/discovery/v1/apis/helloworld/v1/rest

methods.csv (optional)

Valid values are sync, async and reactive. If omitted, both synchronous and asynchronous interfaces will be generated.

classmap.tsv (optional)

Map fields with the specified names to the specified types.

Code will be generated in build/generated/source/gce2retrofit/

See sample-java/src/main/gce2retrofit/helloworld for an example.

Gradle plugin

Apply the plugin in your build.gradle:

buildscript {
  repositories {
    jcenter()
    maven {
      url 'http://oss.sonatype.org/content/repositories/snapshots/'
    }
  }
  dependencies {
    classpath 'com.sqisland:gce2retrofit:1.1.0-SNAPSHOT'
  }
}

apply plugin: 'com.sqisland.gce2retrofit'

Upgrade guide

Version 1.1.0

Primitives have been replaced by Objects e.g. Integer instead of int. Please go through your code and make sure that you check for null before using the value of any Boolean, Integer, Float and Double.

Contributing

Please see CONTRIBUTING.md.