Bagikan melalui

Protokol Pemberitahuan untuk Aplikasi Server

  • Artikel

BITS menggunakan properti BITSServerNotificationType untuk menentukan bagaimana BITS mengirim konten file unggahan ke aplikasi server. Jika properti BITSServerNotificationType diatur ke 1, BITS melewati lokasi file unggahan di header. Jika properti BITSServerNotificationType diatur ke 2, BITS meneruskan konten file unggahan dalam isi permintaan.

Untuk detail tentang cara BITS menangani kesalahan dari aplikasi server, lihat Menangani kesalahan aplikasi server.

Mengirim lokasi file unggahan di header

BITS meneruskan lokasi file unggah dan balas ke aplikasi server di header jika properti BITSServerNotificationType diatur ke 1. Aplikasi server membuka file unggahan, memproses data, lalu menghasilkan file balasan. Secara default, BITS menghapus file unggahan dan balasan dari server setelah menerima respons dari aplikasi server. Agar BITS menyalin file unggahan ke lokasi yang ditentukan oleh nama file jarak jauh dalam pekerjaan, sertakan header BITS-Copy-File-To-Destination dalam respons Anda. Jika Anda tidak menyertakan header dan ingin menyimpan file unggah dan balas, Anda harus menyalin file unggah dan balas ke lokasi baru sebelum merespons. Tabel berikut ini memperlihatkan header permintaan.

Header permintaan Deskripsi
BITS-Original-Request-URL Berisi nama jarak jauh yang ditentukan dalam pekerjaan.
BITS-Request-DataFile-Name Berisi jalur lengkap ke data yang diunggah.
BITS-Response-DataFile-Name Berisi jalur lengkap ke tempat BITS mengharapkan aplikasi server untuk menulis respons.

Tabel berikut ini memperlihatkan header respons.

Header respons Deskripsi
BITS-Static-Response-URL Opsional. Berisi URL absolut (jangan tentukan URL relatif) ke file data statis untuk digunakan sebagai respons. File data statis harus dapat diakses oleh klien BITS. Jika Anda menggunakan header ini, jangan membuat file respons yang ditentukan di header permintaan BITS-Response-DataFile-Name. Perhatikan bahwa BITS tidak menghapus file ini untuk Anda.
BITS-Copy-File-to-Destination Opsional. Secara default, jika properti BITSServerNotificationType diatur ke 1 atau 2, server BITS tidak menyalin file unggahan ke lokasi yang ditentukan oleh nama file jarak jauh dalam pekerjaan. Agar BITS menyalin file ke lokasi yang ditentukan oleh nama file jarak jauh dalam pekerjaan, kirim header respons ini. Anda dapat menentukan nilai apa pun; BITS tidak menggunakan nilai . Perhatikan bahwa folder di jalur file jarak jauh harus ada.

Permintaan berikut menunjukkan BITS yang mengirim lokasi file unggahan ke aplikasi server.

POST https://myserver/myvdir/handle_upload.asp?ACCOUNT=873112 HTTP/1.1
Host: myserver
BITS-Original-Request-URL: https://front-end-server/vdir
BITS-Request-DataFile-Name: c:\physical-path\BITS-Sessions\{5e53c221-f2d6-4bf2-
b994-1dc43ceaca8d}\request
BITS-Response-DataFile-Name: c:\physical-path\BITS-Sessions\{5e53c221-f2d6-4bf2-
b994-1dc43ceaca8d}\response
Content-Length: 0

Berikut ini menunjukkan balasan aplikasi server ke BITS; balasan ditempatkan dalam file yang ditentukan oleh header permintaan BITS-Response-DataFile-Name.

HTTP/1.1 200 - OK
Content-Length: 0

Mengirim file unggahan dalam isi permintaan

BITS mengirimkan file unggahan dalam isi permintaan jika properti BITSServerNotificationType diatur ke 2. Mengirim file unggahan dalam isi permintaan memungkinkan skrip dan aplikasi yang ada bekerja dengan modifikasi minimal. File unggahan dan file balasan masing-masing diteruskan dalam permintaan dan respons. Tabel berikut ini memperlihatkan header permintaan.

Header permintaan Deskripsi
BITS-Original-Request-URL Berisi nama jarak jauh yang ditentukan dalam pekerjaan.

Tabel berikut ini memperlihatkan header respons.

Header respons Deskripsi
BITS-Static-Response-URL Opsional. Berisi URL absolut (jangan tentukan URL relatif) ke file data statis untuk digunakan sebagai respons. File data statis harus dapat diakses oleh klien BITS. Jika Anda menggunakan header ini, jangan sertakan respons dalam aliran. Perhatikan bahwa BITS tidak menghapus file ini untuk Anda.
BITS-Copy-File-to-Destination Opsional. Jika properti BITSServerNotificationType diatur ke 1 atau 2, server BITS tidak menyalin file unggahan ke lokasi yang ditentukan oleh nama file jarak jauh dalam pekerjaan. Agar BITS menyalin file ke lokasi yang ditentukan oleh nama file jarak jauh, kirim header respons ini. Anda dapat menentukan nilai apa pun; BITS tidak menggunakan nilai . Perhatikan bahwa folder di jalur file jarak jauh harus ada.

Permintaan berikut menunjukkan BITS meneruskan file yang diunggah ke aplikasi server dalam isi permintaan.

POST https://myserver/myvdir/handle_upload.asp?ACCOUNT=873112 HTTP/1.1
Host: myserver
BITS-Original-Request-URL: https://front-end-server/vdir
Content-Length: 80000

80000 bytes of upload data goes here

Balasan berikut menunjukkan aplikasi server meneruskan data balasan ke BITS dalam isi respons.

HTTP/1.1 200 - OK
Content-Length: 100

100 bytes of reply data goes here

Menangani kesalahan aplikasi server

Lihat Menangani Kesalahan Aplikasi Server.