Variabel Adapter
Ada sejumlah variabel yang perlu ditangani adaptor kustom apa pun. Nilai yang ditetapkan ke variabel ini memengaruhi logika kustom yang diterapkan adaptor. Properti konfigurasi khusus transportasi atau khusus aplikasi juga dapat membantu mendukung solusi Anda. Tabel berikut mencantumkan variabel umum ini. Anda harus memutuskan apakah Anda ingin mendukung masing-masing di adaptor kustom Anda.
Untuk setiap opsi, adaptor Anda harus mengimplementasikan antarmuka tertentu. Mengikuti tabel adalah daftar opsi variabel dengan tautan ke informasi selengkapnya tentang menulis kode adaptor untuk mendukung keputusan desain Anda.
| Variabel adapter | Deskripsi |
|---|---|
| Arah komunikasi | Menerima. Adaptor penerima mendengarkan alamat khusus protokol untuk pesan masuk. Ketika pesan diterima, adaptor penerima menyerahkan pesan ke Mesin Olahpesan, yang meneruskan pesan melalui alur penerima untuk akhirnya disimpan ke database MessageBox. Mengirim. Ketika Mesin Olahpesan perlu mengirim pesan ke titik akhir tertentu, mesin tersebut meneruskannya ke alur pengiriman. Adaptor kirim menerima pesan dari alur kirim dan mengirimkannya ke port pengiriman. |
| Hosting adaptor | Sedang dalam proses. Adaptor dalam proses dibuat dan dihosting dalam proses layanan BizTalk, BTSNTSvc.exe. Jika host adalah 64-bit, proses diberi nama BTSNTSvc64.exe. Untuk kesederhanaan, kami tidak akan menyebutkan proses 64-bit lagi di bagian ini. Ini berarti bahwa BizTalk Server membuat dan mengelola masa pakai adaptor, menginisialisasinya dengan proksi transportasi, melayani permintaan adaptor, dan menghentikan adaptor saat pematian layanan. Untuk adaptor dalam proses, BizTalk Server juga mengirimkan informasi konfigurasi ke adaptor pada durasi, termasuk handler, port pengiriman, dan konfigurasi lokasi penerimaan. Selain itu, aspek konfigurasi seperti jendela layanan ditangani oleh Mesin Olahpesan sehingga adaptor tidak perlu memastikan bahwa lokasi penerima atau port kirim berada di luar jendela layanan. Perhatikan bahwa semua adaptor pengiriman adalah adaptor dalam proses dan harus berjalan dalam proses BTSNTSvc.exe. Terpisah. Adaptor dibuat dalam host terisolasi yang bukan bagian dari runtime BizTalk Server. Contoh adaptor terisolasi adalah adaptor penerima HTTP, yang berjalan di ruang proses Internet Information Services (IIS). Model proses IIS singgah sehingga IIS mengelola masa pakai aplikasi ASP.NET dan ekstensi ISAPI. Ketika BizTalk Server tidak dapat mengelola masa pakai adaptor, adaptor disebut sebagai adaptor terisolasi. Karena BizTalk Server tidak mengelola instansiasi adaptor yang terisolasi, adaptor harus membuat proksi transportasinya sendiri dan mendaftarkan dirinya dengan proksi transportasi tersebut. Perhatikan bahwa arsitektur BizTalk Server menghilangkan komunikasi antarproses yang tidak perlu. Karena adaptor terisolasi dan tumpukan BizTalk berada dalam proses yang sama, tidak ada komunikasi antarproses ketika adaptor memanggil Mesin Olahpesan. Satu-satunya komunikasi antarprosces adalah antara Mesin Olahpesan dan database, yang tidak dapat ditolak. Aplikasi COM+ tidak dapat menghosting pengiriman adaptor yang ditulis dalam kode yang tidak dikelola. |
| Pola pertukaran pesan | Satu arah. Pesan masuk atau keluar. Request-Response (dua arah). Adaptor respons permintaan selalu menerima adaptor. Adaptor penerima permintaan menerima pesan permintaan dari klien dan mengirimkan pesan ke BizTalk Server. Setelah BizTalk Server memproses pesan permintaan, BizTalk Server mengirim pesan respons kembali ke adaptor. Adaptor kemudian mengirimkan pesan respons kembali ke klien. Solicit-Response (dua arah). Adaptor solicit-response selalu mengirim adaptor. Adaptor pengiriman respons ajakan mengirim pesan permintaan dari BizTalk Server ke tujuan, menunggu pesan respons, lalu mengirimkan pesan respons kembali ke BizTalk Server. |
| Mengirim pengikatan port | Port Kirim Dinamis dan Lokasi Terima. Variabel URI untuk port kirim atau lokasi terima yang digunakan dalam pengikatan dinamis ditentukan pada durasi. Port Kirim Statis dan Lokasi Terima. Variabel URI untuk port kirim atau lokasi terima bersifat statis dan dikonfigurasi sebelum durasi. |
| Adaptor pengiriman sinkron versus pengiriman asinkron | Adaptor pengiriman sinkron. Saat menjalankan operasi pengiriman, Mesin Olahpesan memblokir utas proksi transportasi hingga mengirim batch pesan dan dikembalikan. Proksi transportasi menangani penghapusan pesan setelah pesan dikirimkan, dicoba ulang, ditangguhkan, atau pemindahan ke operasi berikutnya selesai. Adaptor pengiriman asinkron. Adaptor pengiriman asinkron tidak memblokir utas proksi transportasi, melainkan menggunakan utas terpisah saat melakukan operasi pengiriman. Tidak seperti adaptor sinkron, adaptor ini harus mengimplementasikan semua logika hapus dan coba lagi itu sendiri; proksi transportasi tidak menangani logika. Adaptor yang mengirim pesan asinkron memungkinkan performa BizTalk Server yang lebih baik daripada yang mengirim pesan sinkron. Ini karena utas menghabiskan banyak waktu menunggu operasi masuk atau keluar selesai. Karena Mesin Olahpesan sangat terikat dengan CPU, memblokir utas Mesin Olahpesan menurunkan performa adaptor. Penggunaan transmisi asinkron sangat didorong dan meningkatkan performa. |
| Adaptor penerima asinkron | Semua adaptor penerima tidak sinkron. Ini berarti ketika adaptor mengirimkan pesan baru ke BizTalk Messaging Engine, adaptor tidak menunggu mereka diproses sepenuhnya sebelum kembali. |
| Dukungan transaksional | Adaptor transaksi. Mendukung pengiriman transaksi dan penerimaan pesan. Di sisi kirim, hanya adaptor pengiriman batch asinkron yang mendukung transaksi. Adaptor non-transaksi. Adaptor yang tidak menerima atau mengirim pesan dalam cakupan transaksi eksplisit. Banyak adaptor tidak transaksi karena mengirim ke atau dari sistem, seperti sistem file Windows, yang tidak mendukung transaksi. |
| Adaptor pengiriman yang didukung batch versus adaptor pengiriman batch-unsupported | Adaptor yang didukung batch. Adaptor pengiriman dapat memproses pesan dalam batch operasi. Semua adaptor dapat mengumpulkan semua pesan yang tersedia untuk pengiriman, lalu mengirimkannya ke database MessageBox sekaligus, sehingga mengurangi jumlah pembaruan database yang diperlukan. Dalam beberapa kasus, ini berarti bahwa panjang batch adalah satu. Demikian pula, adaptor kirim mengumpulkan semua pesan yang tersedia untuk dikirim, mengekstraknya, lalu mengirimkannya ke tujuan sekaligus. Secara umum, BizTalk Server memperlakukan batch sebagai unit kerja untuk pembaruan database. Dalam batch yang sama, adaptor dapat mengirimkan pesan satu arah, respons permintaan, dan respons ajakan; menangguhkan pesan; hapus pesan; meminta agar pesan dicoba ulang untuk transmisi; atau meminta agar pesan dipindahkan ke transportasi cadangan. Jika memungkinkan, Anda harus menggunakan transmisi batch. Adaptor kirim dan terima dapat di-batch, tetapi hanya adaptor pengiriman asinkron batch yang mendukung transaksi. Adaptor yang tidak didukung batch. Setiap pesan memerlukan panggilan independen ke server. |
| Adaptor terima yang didukung batch | Semua menerima adaptor mendukung batching. |
| Konfigurasi adaptor waktu desain dinamis versus statis | Waktu Desain Adapter Dinamis. Agar adaptor mendukung konfigurasi waktu desain dinamis, Anda harus mengembangkan antarmuka pengguna (UI) kustom untuk bekerja dengan Wizard Tambahkan Metadata Adapter. Antarmuka ini memungkinkan pengguna untuk memilih skema untuk ditambahkan ke proyek BizTalk dan mengembalikan deskripsi layanannya melalui file Web Services Description Language (WSDL). Adaptor menyediakan UI kustom untuk mendapatkan skema. Saat layanan diimpor melalui Wizard Tambahkan Metadata Adapter, layanan menambahkan jenis port, jenis pesan, dan orkestrasi ke proyek BizTalk selain skema. Untuk informasi selengkapnya, lihat Konfigurasi Adaptor Design-Time Statis. Waktu Desain Adapter Statis. Agar adaptor mendukung konfigurasi waktu desain statis, Anda menerapkan antarmuka standar untuk memungkinkan Wizard Tambahkan Metadata Adapter untuk memilih skema yang akan ditambahkan ke proyek BizTalk. BizTalk Adapter Framework menyediakan UI untuk adaptor. Untuk informasi tentang memodifikasi adaptor file sampel, lihat Konfigurasi Adaptor Design-Time Dinamis. |
| Adaptor transportasi versus adaptor aplikasi | Adaptor transportasi. Adaptor transportasi mendukung protokol tertentu dan tidak menggunakan skema. Dari dua belas adaptor asli, sembilan adalah adaptor transportasi: MSMQ, MQ Series, File, FTP, HTTP, SMTP, POP3, dan SOAP. Adaptor aplikasi. Adaptor aplikasi menggunakan skema data untuk mengirim data ke dalam aplikasi yang ditentukan. Dari adaptor asli, dua adalah adaptor aplikasi: Layanan Windows SharePoint dan SQL. |
Untuk informasi tentang antarmuka mana yang akan diterapkan dalam kode adaptor kustom Anda, gunakan tautan dalam tabel berikut untuk jenis adaptor yang Anda rencanakan untuk dibuat. Dalam beberapa kasus, Anda harus menggabungkan antarmuka yang tercantum untuk memenuhi satu persyaratan dengan antarmuka yang tercantum di halaman terpisah untuk memenuhi persyaratan lain.
| Variabel | Untuk informasi selengkapnya |
|---|---|
| Mengirim adaptor | Membuat Instansiasi dan Menginisialisasi Adapter Kirim |
| Sinkron | Antarmuka untuk Adaptor Kirim Sinkron |
| Asinkron | Antarmuka untuk Adaptor Pengiriman Asinkron |
| Didukung batch sinkron | Antarmuka untuk Adaptor Pengiriman Batch-Supported Sinkron |
| Didukung batch asinkron | Antarmuka untuk Adaptor Pengiriman Batch-Supported Asinkron |
| Batch asinkron transaksional didukung | Antarmuka untuk Adaptor Pengiriman Batch-Supported Asinkron Transaksional |
| Solicit-response | Antarmuka untuk Adaptor Kirim Solicit-Response |
| Menerima adaptor | Membuat Instansiasi dan Menginisialisasi Adapter Penerima |
| Reguler | Antarmuka untuk Adaptor Penerima In-Process |
| Terpisah | Antarmuka untuk Adaptor Penerima terisolasi |
| Didukung batch | Antarmuka untuk Batch-Supported Receive Adapter |
| Batch transaksi yang didukung | Antarmuka untuk Adaptor Penerima Batch-Supported Transaksi |
| Respons permintaan sinkron | Antarmuka untuk Adaptor Penerima Request-Response Sinkron |
Lihat juga
Mengembangkan Adaptor Kustom
Menggunakan Adapter
Sampel Adapter - Pengembangan