El complemento de Gradle para Endpoints Framework proporciona tareas y configuraciones para compilar y conectar Endpoints Framework con proyectos de App Engine. Este complemento brinda asistencia al servidor y al cliente. El complemento del servidor genera documentos de descubrimiento y especificaciones de OpenAPI desde un proyecto de Java de Endpoints Framework anotado y bibliotecas cliente. El complemento del lado del cliente genera bibliotecas cliente cuando hay un documento de descubrimiento disponible.
Dependencia del complemento
Agrega la dependencia del complemento de Gradle para Endpoints Framework mediante el fragmento siguiente a tu build.gradle
. El fragmento siguiente recupera la dependencia de Maven Central:
Complemento del servidor
Agrega el complemento de Gradle para Endpoints Framework del lado del servidor mediante el fragmento siguiente a tu build.gradle
:
Configura el servidor en tu build.gradle
con el cierre endpointsServer
:
Propiedades y tareas del lado del servidor
Las siguientes tareas se exponen únicamente en el servidor.
endpointsClientLibs
Esta tarea genera bibliotecas cliente de Endpoints basadas en clases de servicios.
Puedes usar las propiedades que aparecen a continuación:
Propiedad | Descripción |
---|---|
serviceClasses |
Lista de clases de servicios (clases de Endpoints), esta se puede deducir de `web.xml`. |
clientLibDir |
Directorio de salida para bibliotecas cliente generadas. |
hostname |
Para configurar la URL raíz de las bibliotecas cliente generadas. Por ejemplo, si usas `hostname = myapp.appspot.com`, la URL raíz predeterminada será https://myapp.appspot.com/_ah/api` |
endpointsDiscoveryDocs
Esta tarea genera documentos de descubrimiento basados en clases de servicios.
Puedes usar las propiedades que aparecen a continuación:
Propiedad | Descripción |
---|---|
serviceClasses |
Lista de clases de servicios (clases de Endpoints), esta se puede deducir de `web.xml`. |
hostname |
Para configurar la URL raíz del documento de descubrimiento generado. Por ejemplo, si usas `hostname = myapp.appspot.com`, la URL raíz predeterminada será https://myapp.appspot.com/_ah/api` |
endpointsOpenApiDocs
Esta tarea genera documentos de OpenAPI basados en clases de servicios.
Puedes usar las propiedades que aparecen a continuación:
Propiedad | Descripción |
---|---|
serviceClasses |
Lista de clases de servicios (clases de Endpoints), esta se puede deducir de `web.xml`. |
hostname |
Para configurar la URL raíz del documento de OpenAPI generado. Por ejemplo, si usas `hostname = myapp.appspot.com`, la URL `host` será `https://myapp.appspot.com` y `basePath` como `/_ah/api`. |
Complemento del lado del cliente
Si quieres agregar el complemento de Gradle para Endpoints Framework del lado del cliente mediante el uso de lo siguiente en tu build.gradle
, sigue estos pasos:
apply plugin: 'com.google.cloud.tools.endpoints-framework-client'
Configura el servidor en tu build.gradle
con el cierre endpointsClient
:
endpointsClient {
// client-side properties
}
Propiedades del lado del cliente
El complemento del lado del cliente no expone tareas como el complemento del lado del servidor. La aplicación del complemento del cliente generará fuentes de acuerdo con las siguientes propiedades de configuración.
Propiedad | Descripción |
---|---|
discoveryDocs |
Una lista de documentos de descubrimiento para usar cuando se generan fuentes. |
¿Qué sigue?
- Explora el código del complemento y también informa problemas en GitHub.