Mengembangkan aplikasi Java Service Fabric dengan Visual Studio Code

Ekstensi Service Fabric Reliable Services untuk VS Code memudahkan untuk membangun aplikasi Java Service Fabric di sistem operasi Windows, Linux, dan macOS.

Artikel ini memperlihatkan kepada Anda cara membangun, menyebarkan, dan men-debug aplikasi Java Service Fabric menggunakan Visual Studio Code.

Penting

Aplikasi Service Fabric Java dapat dikembangkan pada komputer Windows, tetapi hanya dapat disebarkan ke kluster Azure Linux. Debugging aplikasi Java tidak didukung di Windows.

Prasyarat

Artikel ini mengasumsikan bahwa Anda telah menginstal VISUAL Code, ekstensi Service Fabric Reliable Services untuk VISUAL Code, dan dependensi apa pun yang diperlukan untuk lingkungan pengembangan Anda. Untuk mempelajari selengkapnya, lihat Memulai.

Unduh contoh

Artikel ini menggunakan aplikasi Voting di repositori GitHub sampel panduan cepat aplikasi Service Fabric Java.

Untuk mengkloning repositori ke komputer pengembangan Anda, jalankan perintah berikut dari jendela terminal (jendela perintah di Windows):

git clone https://github.com/Azure-Samples/service-fabric-java-quickstart.git

Buka aplikasi di Visual Studio Code

Buka Visual Studio Code. Klik ikon Explorer di Bilah Aktivitas dan klik Buka Folder, atau klik File -> Buka Folder. Navigasi ke direktori ./service-fabric-java-quickstart/Voting di folder tempat Anda mengkloning repositori lalu klik OK. Ruang kerja harus berisi file yang sama yang ditunjukkan pada cuplikan layar di bawah ini.

Aplikasi Java Voting di Ruang Kerja

Membangun aplikasi

  1. Tekan (Ctrl + Shift + p) untuk membuka Palet Perintah di Visual Studio Code.

  2. Cari dan pilih perintah Service Fabric: Build Application . Hasil build dikirim ke terminal terintegrasi.

    Perintah Aplikasi Build di Visual Studio Code

Menyebarkan aplikasi ke kluster lokal

Setelah membuat aplikasi, Anda dapat menyebarkannya ke kluster lokal.

Penting

Menyebarkan aplikasi Java ke kluster lokal tidak didukung pada komputer Windows.

  1. Dari Palet Perintah, pilih perintah Service Fabric: Sebarkan Aplikasi (Localhost). Output proses penginstalan dikirim ke terminal terintegrasi.

    Sebarkan Perintah Aplikasi di Visual Studio Code

  2. Setelah penyebaran selesai, luncurkan browser dan buka Service Fabric Explorer: http://localhost:19080/Explorer. Anda akan melihat bahwa aplikasi sedang berjalan. Ini mungkin memakan waktu, jadi bersabarlah.

    Aplikasi Pemungutan Suara di Service Fabric Explorer

  3. Setelah Anda memverifikasi bahwa aplikasi sedang berjalan, luncurkan browser dan buka halaman ini: http://localhost:8080. Ini adalah front-end web aplikasi. Anda dapat menambahkan item dan mengkliknya untuk memilih.

    Aplikasi Pemungutan Suara di Browser

  4. Untuk menghapus aplikasi dari kluster, pilih perintah Service Fabric: Hapus Aplikasi dari Palet Perintah. Output dari proses penghapusan instalasi dikirim ke terminal terintegrasi. Anda dapat menggunakan Service Fabric Explorer untuk memverifikasi bahwa aplikasi telah dihapus dari kluster lokal.

Melakukan debug pada aplikasi

Saat men-debug aplikasi di VISUAL Code, aplikasi harus berjalan pada kluster lokal. Titik henti kemudian dapat ditambahkan ke kode.

Penting

Debugging aplikasi Java tidak didukung pada komputer Windows.

Untuk menyiapkan VotingDataService dan aplikasi Voting untuk debugging, selesaikan langkah-langkah berikut:

  1. Perbarui file Voting/VotingApplication/VotingDataServicePkg/Code/entryPoint.sh . Komentari perintah pada baris 6 (gunakan '#') dan tambahkan perintah berikut ke bagian bawah file:

    java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -jar VotingDataService.jar
    
  2. Perbarui file Voting/VotingApplication/ApplicationManifest.xml . Atur atribut MinReplicaSetSize dan TargetReplicaSetSize ke "1" di elemen StatefulService :

          <StatefulService MinReplicaSetSize="1" ServiceTypeName="VotingDataServiceType" TargetReplicaSetSize="1">
    
  3. Klik ikon Debug di Bilah Aktivitas untuk membuka tampilan debugger di Visual Studio Code. Klik ikon roda gigi di bagian atas tampilan debugger dan pilih Java dari menu lingkungan dropdown. File launch.json terbuka.

    Ikon Debug di Ruang Kerja Visual Studio Code

  4. Dalam file launch.json, atur nilai port dalam konfigurasi bernama Debug (Lampirkan) ke 8001. Simpan file tersebut.

    Konfigurasi Debug untuk launch.json

  5. Sebarkan aplikasi ke kluster lokal dengan menggunakan perintah Service Fabric: Sebarkan Aplikasi (Localhost). Verifikasi bahwa aplikasi berjalan di Service Fabric Explorer. Aplikasi Anda sekarang siap untuk di-debug.

Untuk mengatur titik henti, selesaikan langkah-langkah berikut:

  1. Di Explorer, buka file /Voting/VotingDataService/src/statefulservice/VotingDataService.java . Atur titik henti pada baris pertama kode di try blok dalam addItem metode (baris 80).

    Mengatur titik henti di Layanan Data Pemungutan Suara

    Penting

    Pastikan Anda mengatur titik henti pada baris kode yang dapat dieksekusi. Misalnya, debugger akan melewatkan titik henti yang diatur pada deklarasi metode, try pernyataan, atau catch pernyataan.

  2. Untuk mulai debugging, klik ikon Debug di Bilah Aktivitas, pilih konfigurasi Debug (Lampirkan) dari Menu Debug, dan klik tombol jalankan (panah hijau).

    Konfigurasi Debug (Lampiran)

  3. Di browser web, buka http://localhost:8080. Ketik item baru dalam kotak teks dan klik + Tambahkan. Titik henti harus tercapai. Anda dapat menggunakan toolbar Debug di bagian atas Visual Studio Code untuk melanjutkan eksekusi, melangkahi baris, melangkah ke metode, atau keluar dari metode saat ini.

    Titik henti hit

  4. Untuk mengakhiri sesi penelusuran kesalahan, klik ikon plug pada toolbar Debug di bagian atas Visual Studio Code.

    Putuskan sambungan dari debugger

  5. Setelah selesai men-debug, Anda dapat menggunakan perintah Service Fabric: Hapus Aplikasi untuk menghapus aplikasi Voting dari kluster lokal Anda.

Langkah berikutnya