Menyiapkan AWS Flow Framework for Java - AWS Flow Framework untuk Java
Menginstal MavenMenginstal Eclipse

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menyiapkan AWS Flow Framework for Java

AWS Flow Framework for Java disertakan dengan AWS SDK for Java. Jika Anda belum menyiapkan AWS SDK for Java, kunjungi Memulai di Panduan Developer AWS SDK for Java untuk informasi tentang menginstal dan mengonfigurasi SDK itu sendiri.

Topik ini memberikan informasi tentang langkah-langkah tambahan yang diperlukan untuk menggunakan AWS Flow Framework for Java. Langkah-langkah disediakan untuk Eclipse dan Maven.

Menginstal Maven

Amazon menyediakan alat pembuatan Amazon SWF di Maven Central Repository untuk membantu penyiapan AWS Flow Framework for Java dalam proyek Maven Anda.

Untuk menyiapkan kerangka alur untuk Maven, tambahkan ketergantungan berikut ke file pom.xml proyek Anda:

<dependency>
  <groupId>log4j</groupId>
  <artifactId>log4j</artifactId>
  <version>1.2.17</version>
</dependency>
<dependency>
  <groupId>com.amazonaws</groupId>
  <artifactId>aws-swf-build-tools</artifactId>
  <version>1.0</version>
</dependency>

Alat pembuatan Amazon SWF adalah sumber terbuka—untuk melihat atau mengunduh kode atau membangun alat sendiri, kunjungi repositori di https://github.com/aws/aws-swf-build-tools.

Menginstal Eclipse

Jika Anda menggunakan Eclipse IDE, instal AWS Flow Framework for Java menggunakan file AWS Toolkit for Eclipse.

Menginstal AWS Toolkit for Eclipse

Menginstal Toolkit for Eclipse adalah cara paling sederhana untuk memulai dengan AWS Flow Framework for Java. Untuk menginstal Toolkit for Eclipse, lihat Menyiapkan AWS Toolkit for Eclipse di Panduan Memulai AWS Toolkit for Eclipse.

penting

Pastikan untuk menyertakan kedua AWS SDK for Java dan AWS Simple Workflow Tools saat memilih paket mana yang akan diinstal di kotak dialog Available Software (Perangkat Lunak yang Tersedia) dari Eclipse:

Instal AWS Toolkit for Eclipse termasuk SDK for Java dan Amazon SWF Tools

Jika Anda menginstal semua paket yang tersedia (dengan memilih simpul tingkat atas AWS Toolkit for Eclipse, atau memilih Pilih Semua), kedua paket ini secara otomatis dipilih dan diinstal untuk Anda.

Membuat Proyek AWS Flow Framework for Java

Membuat proyek AWS Flow Framework for Java yang dikonfigurasi dengan benar di Eclipse melibatkan sejumlah langkah:

  1. Buat proyek AWS Java.

  2. Aktifkan pemrosesan anotasi untuk proyek Anda.

  3. Aktifkan dan konfigurasikan AspectJ.

Masing-masing langkah ini sekarang akan dijelaskan secara detail.

Untuk membuat proyek AWS Java

  1. Luncurkan Eclipse.

  2. Untuk memilih perspektif Java, pilih Window, Open Perspective (Buka Perspektif), Java.

  3. Pilih File, New (Baru), AWS Java Project (Proyek Java).

    Membuat proyek AWS Java baru

  4. Gunakan wizard proyek AWS Java untuk membuat proyek baru.

    catatan

    Pertama kali Anda membuat proyek AWS Java dengan Eclipse, SDK for Java akan diunduh dan diinstal secara otomatis saat wizard proyek dimulai.

Setelah membuat proyek AWS Java Anda, aktifkan pemrosesan anotasi untuk proyek tersebut. AWS Flow Framework for Java menyertakan prosesor anotasi yang menghasilkan beberapa kelas kunci berdasarkan kode sumber beranotasi.

Untuk mengaktifkan pemrosesan anotasi

  1. Di Penjelajah Proyek, klik kanan proyek Anda dan pilih Properties (Properti).

  2. Di kotak dialog Properties (Properti), navigasikan ke Java Compiler (Penyusun Java) > Annotation Processing (Pemrosesan Anotasi).

  3. Centang Aktifkan pengaturan khusus proyek (yang juga harus Aktifkan pemrosesan anotasi, tetapi jika tidak pastikan bahwa opsi ini juga dicentang). Lalu pilih OK.

    Mengaktifkan pemrosesan anotasi di Eclipse
    catatan

    Anda perlu membangun kembali proyek Anda setelah mengaktifkan pemrosesan anotasi.

Mengaktifkan dan Mengonfigurasi AspectJ

Selanjutnya, Anda harus mengaktifkan dan mengonfigurasi AspectJ. Anotasi AWS Flow Framework for Java tertentu seperti @Asynchronous membutuhkan AspectJ. Anda tidak perlu menggunakan AspectJ secara langsung, tetapi Anda harus mengaktifkannya dengan penenunan waktu unggah atau penenunan waktu kompilasi.

catatan

Pendekatan yang disarankan adalah menggunakan penenunan waktu unggah.

Prasyarat

Sebelum mengonfigurasi AspectJ, Anda memerlukan versi AspectJ yang cocok dengan versi Java Anda:

  • Jika Anda menggunakan Java 8, unduh rilis terbaru AspectJ 1.8.X.

  • Jika Anda menggunakan Java 7, unduh rilis terbaru AspectJ 1.7.X.

  • Jika Anda menggunakan Java 6, unduh rilis terbaru AspectJ 1.6.X.

Anda dapat mengunduh salah satu dari versi AspectJ ini dari halaman unduhan Eclipse.

Setelah Anda selesai mengunduh AspectJ, jalankan file .jar yang diunduh untuk menginstal AspectJ. Penginstalan AspectJ akan menanyakan di mana Anda ingin menginstal biner, dan pada layar terakhir, akan memberikan langkah-langkah yang disarankan untuk menyelesaikan penginstalan. Ingat lokasi file aspectjweaver.jar; Anda akan membutuhkannya untuk mengonfigurasi AspectJ di Eclipse.

Mengonfigurasi Penenunan Waktu Unggah AspectJ

Untuk mengonfigurasi penenunan waktu unggah AspectJ untuk proyek AWS Flow Framework for Java Anda, pertama-tama tentukan file JAR AspectJ sebagai agen Java, lalu konfigurasikan dengan menambahkan file aop.xml ke proyek Anda.

Untuk menambahkan AspectJ sebagai agen Java

  1. Untuk membuka kotak dialog Preferences (Preferensi), pilih Window, Preferences (Preferensi).

  2. Arahkan ke Java > JRE yang Terinstal.

  3. Pilih JRE yang sesuai dan pilih Edit.

  4. Di kotak argumen VM Default, masukkan jalur ke biner AspectJ yang diinstal. Ini akan menjadi jalur seperti /home/user/aspectj1.7/lib/aspectjweaver.jar, tergantung pada sistem operasi Anda dan pada versi AspectJ yang Anda unduh.

    Di Linux, macOS, atau Unix gunakan:

    -javaagent:/your_path/aspectj/lib/aspectjweaver.jar

    Di Windows, gunakan jalur gaya Windows standar sebagai gantinya:

    -javaagent:C:\your_path\aspectj\lib\aspectjweaver.jar

    Mengaktifkan penenunan waktu unggah AspectJ di Eclipse

Untuk mengonfigurasi AspectJ untuk AWS Flow Framework for Java, tambahkan file aop.xml ke proyek.

Untuk menambahkan file aop.xml

  1. Di direktori src proyek Anda, tambahkan direktori bernama META-INF.

  2. Tambahkan file bernama aop.xml hingga META-INF dengan konten berikut.

    <aspectj>
   <aspects>
      <aspect name="com.amazonaws.services.simpleworkflow.flow.aspectj.AsynchronousAspect"/>
      <aspect name="com.amazonaws.services.simpleworkflow.flow.aspectj.ExponentialRetryAspect"/>
   </aspects>
   <weaver options="-verbose">
     <include within="MySimpleWorkflow.*"/>
   </weaver>
</aspectj>

    Nilai dari <include within=""/> tergantung pada bagaimana Anda memberi nama paket proyek Anda. Contoh di atas mengasumsikan bahwa paket proyek mengikuti pola MySimpleWorkflow.*. Gunakan nilai yang sesuai untuk paket proyek Anda sendiri.

Penenunan Waktu Kompilasi AspectJ

Untuk mengaktifkan dan mengonfigurasi penenunan waktu kompilasi AspectJ, Anda harus terlebih dahulu menginstal alat developer AspectJ untuk Eclipse, yang tersedia dari http://www.eclipse.org/aspectj/downloads.php.

Untuk menginstal Alat Developer AspectJ di Eclipse

  1. Pada menu Help (Bantuan), pilih Install New Software (Instal Perangkat Lunak Baru).

  2. Di kotak dialog Available Software (Perangkat Lunak yang Tersedia), masukkan http://download.eclipse.org/tools/ajdt/version/dev/update, di mana versi mewakili nomor versi Eclipse Anda. Misalnya, jika Anda menggunakan Eclipse 4.6, Anda akan memasukkan: http://download.eclipse.org/tools/ajdt/46/dev/update

    penting

    Pastikan versi AspectJ cocok dengan versi Eclipse Anda, atau penginstalan AspectJ akan gagal.

  3. Pilih Add (Tambahkan) untuk menambahkan lokasi. Setelah lokasi ditambahkan, alat developer AspectJ akan terdaftar.

    Software installation window showing AspectJ Developer Tools options with 9 items selected.

  4. Pilih Select All (Pilih Semua) untuk memilih semua alat developer AspectJ, lalu pilih Next (Selanjutnya) untuk menginstalnya.

    catatan

    Anda harus memulai ulang Eclipse untuk menyelesaikan penginstalan.

Anda kemudian harus mengonfigurasi proyek Anda.

Untuk mengonfigurasi proyek Anda untuk penenunan waktu kompilasi AspectJ

  1. Di Penjelajah Proyek, klik kanan proyek Anda dan pilih Configure (Konfigurasikan) > Convert to AspectJ Project (Konversikan ke Proyek AspectJ).

    Project Explorer context menu showing Configure submenu with Convert to AspectJ Project option.

    Pustaka Waktu Aktif AspectJ akan ditambahkan ke proyek Anda.

  2. Klik kanan proyek Anda lagi lalu pilih Properties (Properti).

  3. Pilih AspectJ Build (Pembuatan AspectJ) lalu pilih tab Aspect Path (Jalur Aspek).

  4. Pilih Add External JARs (Tambahkan JAR Eksternal) dan tambahkan file JAR AWS SDK for Java untuk proyek Anda Jalur Aspek.

    catatan

    AWS Toolkit for Eclipse menginstal file JAR AWS SDK for Java di ruang kerja Anda, di direktori .metadata/.plugins/com.amazonaws.eclipse.core/aws-java-sdk/AWS Version/lib, tempat Anda mengganti AWS Version dengan nomor versi AWS SDK yang diinstal. Jika tidak, Anda dapat menggunakan file JAR yang disertakan dengan penginstalan AWS SDK biasa, yang ada di direktori lib.

Mengatasi masalah dengan AspectJ dan Eclipse

Plug-in AspectJ Eclipse memiliki masalah yang dapat mencegah kode yang dihasilkan tidak dapat dikompilasi. Cara tercepat untuk memaksa kode yang dihasilkan agar dikenali setelah Anda mengkompilasi ulang adalah dengan mengubah urutan direktori sumber yang berisi kode yang dihasilkan pada tab Order and Export (Urutkan dan Ekspor) pada halaman pengaturan Java Build Path (Jalur Pembuatan Java) (misalnya, Anda dapat mengatur default ke apt/java).