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
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
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](images/eclipse-install-swf-tools.png)
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:
-
Buat proyek AWS Java.
-
Aktifkan pemrosesan anotasi untuk proyek Anda.
-
Aktifkan dan konfigurasikan AspectJ.
Masing-masing langkah ini sekarang akan dijelaskan secara detail.
Untuk membuat proyek AWS Java
-
Luncurkan Eclipse.
-
Untuk memilih perspektif Java, pilih Window, Open Perspective (Buka Perspektif), Java.
-
Pilih File, New (Baru), AWS Java Project (Proyek Java).
-
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
-
Di Penjelajah Proyek, klik kanan proyek Anda dan pilih Properties (Properti).
-
Di kotak dialog Properties (Properti), navigasikan ke Java Compiler (Penyusun Java) > Annotation Processing (Pemrosesan Anotasi).
-
Centang Aktifkan pengaturan khusus proyek (yang juga harus Aktifkan pemrosesan anotasi, tetapi jika tidak pastikan bahwa opsi ini juga dicentang). Lalu pilih OK.
catatan
Anda perlu membangun kembali proyek Anda setelah mengaktifkan pemrosesan anotasi.
Mengaktifkan dan Mengonfigurasi AspectJ
Selanjutnya, Anda harus mengaktifkan dan mengonfigurasi AspectJ@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.
Topik
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
-
Untuk membuka kotak dialog Preferences (Preferensi), pilih Window, Preferences (Preferensi).
-
Arahkan ke Java > JRE yang Terinstal.
-
Pilih JRE yang sesuai dan pilih Edit.
-
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
Untuk mengonfigurasi AspectJ untuk AWS Flow Framework for Java, tambahkan file aop.xml
ke proyek.
Untuk menambahkan file aop.xml
-
Di direktori src proyek Anda, tambahkan direktori bernama
META-INF
. -
Tambahkan file bernama
aop.xml
hinggaMETA-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
-
Pada menu Help (Bantuan), pilih Install New Software (Instal Perangkat Lunak Baru).
-
Di kotak dialog Available Software (Perangkat Lunak yang Tersedia), masukkan
http://download.eclipse.org/tools/ajdt/
, di mana versi mewakili nomor versi Eclipse Anda. Misalnya, jika Anda menggunakan Eclipse 4.6, Anda akan memasukkan:version
/dev/updatehttp://download.eclipse.org/tools/ajdt/
46
/dev/updatepenting
Pastikan versi AspectJ cocok dengan versi Eclipse Anda, atau penginstalan AspectJ akan gagal.
-
Pilih Add (Tambahkan) untuk menambahkan lokasi. Setelah lokasi ditambahkan, alat developer AspectJ akan terdaftar.
-
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
-
Di Penjelajah Proyek, klik kanan proyek Anda dan pilih Configure (Konfigurasikan) > Convert to AspectJ Project (Konversikan ke Proyek AspectJ).
Pustaka Waktu Aktif AspectJ akan ditambahkan ke proyek Anda.
-
Klik kanan proyek Anda lagi lalu pilih Properties (Properti).
-
Pilih AspectJ Build (Pembuatan AspectJ) lalu pilih tab Aspect Path (Jalur Aspek).
-
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/
, tempat Anda menggantiAWS Version
/libAWS 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 direktorilib
.
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
).