Plugin Gradle Framework Endpoints

Plugin Gradle Endpoints Framework menyediakan tugas dan konfigurasi untuk mem-build dan menghubungkan project Endpoints Framework untuk App Engine. Plugin ini menyediakan dukungan sisi server dan sisi klien. Plugin sisi server membuat dokumen Discovery dan spesifikasi OpenAPI dari project Java Endpoints Framework yang diberi anotasi dan library klien. Plugin sisi klien membuat library klien saat dokumen discovery tersedia.

Dependensi plugin

Tambahkan dependensi plugin Gradle Endpoints Framework menggunakan cuplikan berikut di build.gradle Anda. Cuplikan berikut mengambil dependensi dari Maven Central:

classpath 'com.google.cloud.tools:endpoints-framework-gradle-plugin:1.0.2'

Plugin sisi server

Tambahkan plugin Gradle Endpoints Framework sisi server menggunakan cuplikan berikut di build.gradle Anda:

apply plugin: 'com.google.cloud.tools.endpoints-framework-server'

Tetapkan konfigurasi sisi server di build.gradle Anda dengan penutupan endpointsServer:

endpointsServer {
  // Endpoints Framework Plugin server-side configuration
  hostname = "${projectId}.appspot.com"
}

Tugas dan properti sisi server

Tugas berikut hanya diekspos untuk sisi server.

endpointsClientLibs

Tugas ini membuat library klien endpoint berdasarkan class layanan.

Anda dapat menggunakan properti berikut:

Properti Deskripsi
serviceClasses Daftar class layanan (class endpoint), yang dapat disimpulkan dari `web.xml`.
clientLibDir Direktori output untuk library klien yang dibuat.
hostname Untuk menetapkan URL root untuk library klien yang dibuat. Misalnya, menggunakan `hostname = myapp.appspot.com` akan menghasilkan URL root default `https://myapp.appspot.com/_ah/api`.

endpointsDiscoveryDocs

Tugas ini membuat dokumen discovery berdasarkan class layanan.

Anda dapat menggunakan properti berikut:

Properti Deskripsi
serviceClasses Daftar class layanan (class endpoint), yang dapat disimpulkan dari `web.xml`.
hostname Untuk menetapkan URL root untuk dokumen discovery yang dibuat. Misalnya menggunakan `hostname = myapp.appspot.com` akan menghasilkan URL root default `https://myapp.appspot.com/_ah/api`.

endpointsOpenApiDocs

Tugas ini membuat dokumen OpenAPI berdasarkan class layanan.

Anda dapat menggunakan properti berikut:

Properti Deskripsi
serviceClasses Daftar class layanan (class endpoint), yang dapat disimpulkan dari `web.xml`.
hostname Untuk menetapkan URL root untuk dokumen OpenAPI yang dibuat. Misalnya menggunakan `hostname = myapp.appspot.com` akan menghasilkan URL `host` `https://myapp.appspot.com` dan `basePath` sebagai `/_ah/api`.

Plugin sisi klien

Untuk menambahkan plugin Gradle Endpoints Framework sisi klien menggunakan kode berikut di build.gradle Anda:

apply plugin: 'com.google.cloud.tools.endpoints-framework-client'

Tetapkan konfigurasi sisi server di build.gradle Anda dengan penutupan endpointsClient:

endpointsClient {
  // client-side properties
}

Properti sisi klien

Plugin sisi klien tidak mengekspos tugas seperti plugin sisi server. Menerapkan plugin sisi klien akan menghasilkan sumber sesuai dengan properti konfigurasi berikut.

Properti Deskripsi
discoveryDocs Daftar dokumen discovery yang akan digunakan saat membuat sumber.

Langkah berikutnya

  • Pelajari kode plugin dan laporkan masalah di GitHub.