IPlaybackControl Antarmuka

Definisi

Ruang nama:

System.EnterpriseServices

Rakitan:

System.EnterpriseServices.dll

Fungsi dalam Komponen antrean dalam penanganan abnormal kesalahan pemutaran sisi server dan kegagalan sisi klien dari mekanisme pengiriman Antrean Pesan.

public interface class IPlaybackControl

[System.Runtime.InteropServices.Guid("51372AFD-CAE7-11CF-BE81-00AA00A2FA25")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IPlaybackControl

[<System.Runtime.InteropServices.Guid("51372AFD-CAE7-11CF-BE81-00AA00A2FA25")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type IPlaybackControl = interface

Public Interface IPlaybackControl

Atribut

GuidAttribute InterfaceTypeAttribute

Keterangan

Kelas pengecualian yang ditentukan untuk komponen dalam katalog COM+ mengimplementasikan keduanya IPlaybackControl dan antarmuka untuk kelas asli. Implementasi metode antarmuka kelas asli digunakan untuk melakukan penanganan pengecualian untuk metode yang gagal di kelas itu sendiri. Mereka akan dipanggil setelah FinalClientRetry atau FinalServerRetry untuk memproses pengecualian untuk metode yang awalnya dipanggil.

Pemutar Komponen Yang Diantrekan memanggil metode IPlaybackControl untuk menginformasikan objek penanganan pengecualian bahwa pesan akan ditempatkan pada antrean akhir saat istirahat atau surat mati. Pemutar Komponen yang Diantrekan kemudian memanggil metode yang sama dalam objek penanganan pengecualian yang telah gagal dalam panggilan metode asli. Objek penanganan pengecualian dapat mengimplementasikan alternatif, misalnya, dengan mengumpulkan informasi diagnosis masalah atau menghasilkan objek atau pesan yang memberi tahu klien tentang masalah tersebut. Jika aplikasi tidak mengimplementasikan IPlaybackControl, pesan racun ditempatkan pada antrean akhir saat antrean Queued Components Player habis semua percobaan ulang.

Pesan racun adalah pesan yang tidak dapat diproses karena alasan tertentu, mungkin karena masalah dengan server atau sistem antrean. Transaksi digulung balik, dan pesan racun masuk ke bagian atas antrean. Ketika pesan di-dequeued lagi, kondisi yang sama terjadi. Pesan ini dapat terus mengulang tanpa batas waktu sampai sesuatu dilakukan untuk memperbaiki masalah. Layanan Komponen Yang Diantrekan menangani pesan racun dengan menggunakan serangkaian percobaan ulang. Setelah beberapa percobaan ulang yang gagal, pesan dipindahkan ke antrean istirahat akhir. Pesan racun tetap berada dalam antrean yang tersisa hingga dipindahkan secara manual dengan menggunakan alat Pemindah Pesan Komponen Yang Diantrekan.

Situasi pesan racun juga dapat diselesaikan secara terprogram, menggunakan FinalServerRetry metode , yang memberi tahu penulis komponen sisi server bahwa semua upaya untuk memutar kembali aktivasi yang ditangguhkan telah gagal.

Jika Anda menemukan pesan racun, Anda mungkin dapat menyelesaikan penyebab mendasar masalah dengan cepat. Misalnya, jika server offline karena alasan tertentu, Anda dapat membuat server kembali online. Jika Anda tidak dapat menyelesaikan masalah dengan cepat, Anda dapat secara otomatis menghasilkan transaksi lain yang memberi tahu pemohon bahwa transaksi tidak terjadi. Pemohon kemudian dapat melakukan transaksi kompensasi yang membalikkan efek transaksi yang telah dilakukan.

Metode

FinalClientRetry()	Menginformasikan komponen penanganan pengecualian sisi klien bahwa semua Antrean Pesan mencoba mengirimkan pesan ke server ditolak, dan pesan berakhir di antrean Xact Dead Letter sisi klien.
FinalServerRetry()	Menginformasikan implementasi kelas pengecualian sisi server bahwa semua upaya untuk memutar kembali aktivasi yang ditangguhkan ke server telah gagal, dan pesan akan dipindahkan ke antrean istirahat terakhirnya.