Name: endpoints-framework-maven-plugin
Owner: Google Cloud Platform
Description: null
Created: 2016-09-27 23:16:55.0
Updated: 2018-01-22 18:47:42.0
Pushed: 2018-05-04 15:01:53.0
Homepage: null
Size: 143
Language: Java
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
This Maven plugin provides goals and configurations to build Endpoints Framework projects.
Maven is required to build the plugin. To download Maven, follow the instructions.
The remaining dependencies are specified in the pom.xml file and should be automatically downloaded when the plugin is built.
In your Maven App Engine Java app, add the following plugin to your pom.xml:
gin>
roupId>com.google.cloud.tools</groupId>
rtifactId>endpoints-framework-maven-plugin</artifactId>
ersion>1.0.2</version>
ugin>
All goals are prefixed with endpoints-framework
The plugin exposes the following server side goals
clientLibs
- generate client librariesdiscoveryDocs
- generate discovery docsopenApiDocs
- generate Open API docsThe plugin exposes the following parameters for configuring server side goals
discoveryDocDir
- The output directory of discovery documentsclientLibDir
- The output directory of client librariesopenApiDocDir
- The output directory of Open API documentsserviceClasses
- List of service classes (optional), this can be inferred from web.xmlwebappDir
- Location of webapp directoryhostname
- To set the hostname of the root url for Open API docs, discovery docs, and client libs (ex: hostname = myapp.appspot.com
will result in a default root url of https://myapp.appspot.com/_ah/api
)basePath
- To set the base path of the root url for Open API docs, discovery docs and client libs (ex: basePath = /_ah/api
will result in a default root url of https://myapp.appspot.com/_ah/api
)Make sure your web.xml is configured to expose your endpoints correctly.
No configuration parameters are required to run with default values
compile endpoints-framework:clientLibs
compile endpoints-framework:discoveryDocs
The plugin exposes the following client side goals
generateSrc
The plugin exposes the following parameters for client side goals
generatedSrcDir
- The output directory of generated endpoints sourcediscoveryDocs
- List of discovery docs to generate source fromClient consuming endpoints using the client plugin need to configure the location of source discovery documents and for best results configure the generateSrc task in the default generate sources phase.
gin>
roupId>com.google.cloud.tools</groupId>
rtifactId>endpoints-framework-maven-plugin</artifactId>
.
onfiguration>
<discoveryDocs>
<discoveryDoc>src/endpoints/myApi-v1-rest.discovery</discoveryDoc>
</discoveryDocs>
configuration>
xecutions>
<execution>
<phase>generate-sources</phase>
<goals>
<goal>generateSrc</goal>
</goals>
</execution>
executions>
ugin>
Users will also need to include the google api client library for their generated source to compile
endency>
roupId>com.google.api-client</groupId>
rtifactId>google-api-client</artifactId>
ersion>xx.yy.zz</version>
pendency>
Running compile should automatically include generated sources from discovery documents
compile