Alur Kerja dan Jenis Aktivitas Pendaftaran - AWS Flow Framework untuk Java

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

Alur Kerja dan Jenis Aktivitas Pendaftaran

Amazon SWF membutuhkan aktivitas dan alur kerja jenis untuk didaftarkan sebelum mereka dapat digunakan. Kerangka kerja secara otomatis mendaftarkan alur kerja dan aktivitas dalam implementasi yang Anda tambahkan ke pekerja. Kerangka kerja ini mencari jenis yang mengimplementasikan alur kerja dan aktivitas dan daftarkan mereka dengan Amazon SWF. Secara default, kerangka kerja menggunakan definisi antarmuka untuk menyimpulkan pilihan pendaftaran untuk alur kerja dan jenis aktivitas. Semua antarmuka alur kerja yang diperlukan untuk memiliki anotasi @WorkflowRegistrationOptions atau anotasi @SkipRegistration. Pekerja alur kerja mendaftarkan semua jenis alur kerja yang dikonfigurasi dengan yang memiliki anotasi @WorkflowRegistrationOptions. Demikian pula, setiap metode aktivitas diperlukan untuk dijelaskan dengan baik anotasi @ActivityRegistrationOptions atau anotasi @SkipRegistration atau salah satu anotasi ini harus ada di antarmuka @Activities. Pekerja aktivitas mendaftarkan semua jenis aktivitas yang dikonfigurasi dengan anotasi @ActivityRegistrationOptions yang berlaku. Pendaftaran dilakukan secara otomatis ketika Anda memulai salah satu pekerja. Alur kerja dan jenis aktivitas yang memiliki anotasi @SkipRegistration tidak terdaftar. @ActivityRegistrationOptions , dan anotasi @SkipRegistration telah menimpa semantik dan yang paling spesifik diterapkan pada jenis aktivitas.

Perhatikan bahwa Amazon SWF tidak mengizinkan Anda untuk mendaftar ulang atau memodifikasi jenis setelah telah terdaftar. Kerangka kerja akan mencoba untuk mendaftarkan semua jenis, tetapi jika jenis sudah terdaftar maka tidak akan terdaftar ulang dan tidak ada kesalahan yang akan dilaporkan.

Jika Anda perlu memodifikasi pengaturan terdaftar, Anda harus mendaftarkan versi baru dari jenis ini. Anda juga dapat mengganti pengaturan terdaftar saat memulai eksekusi baru atau saat memanggil aktivitas yang menggunakan klien yang dihasilkan.

Pendaftaran memerlukan nama jenis dan beberapa pilihan pendaftaran lain. Implementasi default menentukan ini sebagai berikut:

Nama dan Versi Jenis Alur Kerja

Kerangka kerja menentukan nama jenis alur kerja dari antarmuka alur kerja. Bentuk nama jenis alur kerja default adalah {prefiks}{nama}. The {prefiks} diatur ke nama antarmuka @Workflow diikuti oleh '.' dan {nama} diatur ke nama metode @Execute. Nama default dari jenis alur kerja dalam contoh sebelumnya adalah MyWorkflow.startMyWF. Anda dapat mengganti nama default menggunakan parameter nama metode @Execute. Nama default dari jenis alur kerja dalam contoh adalah startMyWF. Nama tidak harus string kosong. Perhatikan bahwa ketika Anda mengganti nama menggunakan @Execute, kerangka kerja tidak secara otomatis menambahkan prefiks untuk itu. Anda bebas untuk menggunakan skema penamaan Anda sendiri.

Versi alur kerja ditentukan menggunakan parameter version anotasi @Execute. Tidak ada default untuk version dan harus ditentukan secara eksplisit; versionadalah bentuk string gratis, dan Anda bebas untuk menggunakan skema versioning Anda sendiri.

Nama Sinyal

Nama sinyal dapat ditentukan dengan menggunakan parameter nama anotasi @Signal. Jika tidak ditentukan, itu adalah default untuk nama metode sinyal.

Nama dan Versi Jenis Aktivitas

Kerangka kerja menentukan nama jenis aktivitas dari antarmuka aktivitas. Bentuk nama jenis aktivitas default adalah {prefiks}{nama}. The {prefiks} diatur ke nama antarmuka @Activities diikuti oleh '.' dan {nama} diatur ke nama metode. Default {prefiks} dapat diganti dalam anotasi @Activities pada antarmuka aktivitas. Anda juga dapat menentukan nama jenis aktivitas menggunakan anotasi @Activity pada metode aktivitas. Perhatikan bahwa ketika Anda mengganti nama menggunakan @Activity, kerangka kerja tidak akan secara otomatis menambahkan prefiks untuk itu. Anda bebas untuk pengguna skema penamaan Anda sendiri.

Versi aktivitas ditentukan menggunakan parameter versi anotasi @Activities. Versi ini digunakan sebagai default untuk semua kegiatan didefinisikan dalam antarmuka dan dapat diganti secara per-aktivitas menggunakan anotasi @Activity.

Daftar Tugas Default

Daftar tugas default dapat dikonfigurasi menggunakan @WorkflowRegistrationOptions dan anotasi @ActivityRegistrationOptions dan mengatur parameter defaultTaskList. Secara default, nilainya diatur ke USE_WORKER_TASK_LIST. Ini adalah nilai khusus yang menginstruksikan kerangka kerja untuk menggunakan daftar tugas yang dikonfigurasi pada objek pekerja yang digunakan untuk mendaftar jenis aktivitas atau alur kerja. Anda juga dapat memilih untuk tidak mendaftarkan daftar tugas default dengan mengatur daftar tugas default ke NO_DEFAULT_TASK_LIST menggunakan anotasi ini. Ini dapat digunakan dalam kasus-kasus di mana Anda ingin meminta bahwa daftar tugas ditentukan pada waktu aktif. Jika tidak ada daftar tugas default telah terdaftar, maka Anda harus menentukan daftar tugas saat memulai alur kerja atau memanggil metode aktivitas menggunakan StartWorkflowOptions dan parameter ActivitySchedulingOptions pada kelebihan metode masing-masing klien yang dihasilkan.

Pilihan Pendaftaran lainnya

Semua opsi pendaftaran alur kerja dan jenis aktivitas yang diizinkan oleh API Amazon SWF dapat ditentukan melalui kerangka kerja.

Untuk daftar lengkap opsi pendaftaran alur kerja, lihat berikut ini:

Untuk daftar lengkap opsi pendaftaran aktivitas, lihat berikut ini:

Jika Anda ingin memiliki kontrol penuh atas pendaftaran jenis, lihat Ekstensibilitas Pekerja.