Menulis layanan web Anda

Panduan ini menunjukkan cara menulis layanan web Java untuk dijalankan di lingkungan standar App Engine. Untuk mempelajari runtime Java dan cara kerjanya lebih lanjut, lihat Lingkungan Runtime Java.

Sebelum memulai

Jika belum:

1. Instal Java Development Kit (JDK) versi terbaru untuk versi runtime App Engine yang akan Anda gunakan.
2. Download dan instal Apache Maven untuk membangun, menjalankan, dan men-deploy aplikasi contoh.

Poin utama

• App Engine memulai aplikasi Anda dengan mengupload aplikasi JAR yang dapat dieksekusi.
• Aplikasi Anda harus memiliki class utama yang memulai server web yang merespons permintaan HTTP pada port yang ditentukan oleh variabel lingkungan PORT, biasanya 8080.
• Anda memerlukan file app.yaml untuk men-deploy layanan ke App Engine.
• Anda dapat menggunakan dependensi dengan mencantumkannya di file pom.xml. Untuk informasi selengkapnya, lihat Menggunakan library Java.

Membuat class utama

Inti layanan web Anda adalah server HTTP. Kode contoh dalam panduan ini menggunakan framework Spring Boot untuk menangani permintaan HTTP, tetapi Anda bebas menggunakan framework web pilihan Anda.

1. Buat project Spring Boot untuk Java yang menggunakan sistem build Maven dan berisi dependensi Spring Web. Untuk memulai, klik link berikut:

   Buka Spring Initializr

2. Di Spring Initializer, klik tombol Generate untuk membuat dan mendownload project Anda.

3. Dalam project yang didownload, ubah class aplikasi untuk menyertakan impor dan kode berikut:

   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @SpringBootApplication
   @RestController
   public class SpringbootApplication {
   
     public static void main(String[] args) {
       SpringApplication.run(SpringbootApplication.class, args);
     }
   
     @GetMapping("/")
     public String hello() {
       return "Hello world!";
     }
   
   }

   Class yang dimodifikasi adalah pengontrol yang memulai server Tomcat tersemat Spring Boot dan merespons permintaan GET di jalur root ('/') dengan teks "Hello world!"

Menjalankan server secara lokal

Untuk menjalankan server secara lokal:

1. Mulai server web lokal menggunakan plugin Spring Boot Maven.

   mvn spring-boot:run
   

2. Di browser web Anda, masukkan alamat berikut:
   http://localhost:8080

Pesan Hello World dari aplikasi contoh akan ditampilkan di halaman. Di jendela terminal, tekan Ctrl+C untuk keluar dari server web.

Membuat file app.yaml

Untuk menentukan setelan aplikasi Anda di lingkungan runtime App Engine:

1. Buat file bernama app.yaml di direktori berikut:
   my-java-service/src/main/appengine/

2. Tambahkan konten berikut ke file:

   Java 17

   runtime: java17
   

   Java 11

   runtime: java11

   File app.yaml juga dapat menentukan setelan jaringan, setelan penskalaan, dan lainnya. Untuk informasi selengkapnya, lihat referensi app.yaml.

Jika menggunakan link Spring Initializr di atas, Anda sekarang seharusnya memiliki struktur file seperti berikut:

• my-java-service/
  • pom.xml
  • src/main/
    • appengine/
      • app.yaml
    • java/com/example/appengine/springboot/
      • SpringbootApplication.java

Langkah berikutnya

Setelah membuat server web Java sederhana yang memproses port yang benar dan menentukan runtime dalam file app.yaml, Anda siap untuk men-deploy layanan di App Engine.