Protocollo di notifica per le applicazioni server
BITS usa la proprietà BITSServerNotificationType per determinare come BITS invia il contenuto del file di caricamento all'applicazione server. Se la proprietà BITSServerNotificationType è impostata su 1, BITS passa il percorso del file di caricamento in un'intestazione. Se la proprietà BITSServerNotificationType è impostata su 2, BITS passa il contenuto del file di caricamento nel corpo della richiesta.
Per informazioni dettagliate su come BITS gestisce gli errori dall'applicazione server, vedere Gestione degli errori dell'applicazione server.
Invio del percorso del file di caricamento in un'intestazione
BITS passa il percorso dei file di caricamento e risposta all'applicazione server nelle intestazioni se la proprietà BITSServerNotificationType è impostata su 1. L'applicazione server apre il file di caricamento, elabora i dati e quindi genera il file di risposta. Per impostazione predefinita, BITS rimuove i file di caricamento e risposta dal server dopo che riceve la risposta dall'applicazione server. Per fare in modo che BITS copia il file di caricamento nel percorso specificato dal nome del file remoto nel processo, includere l'intestazione BITS-Copy-File-To-Destination nella risposta. Se non si include l'intestazione e si desidera salvare i file di caricamento e risposta, è necessario copiare i file di caricamento e risposta in un nuovo percorso prima di rispondere. Nella tabella seguente vengono illustrate le intestazioni della richiesta.
| Intestazione della richiesta | Descrizione |
|---|---|
| BITS-Original-Request-URL | Contiene il nome remoto specificato nel processo. |
| BITS-Request-DataFile-Name | Contiene il percorso completo dei dati caricati. |
| BITS-Response-DataFile-Name | Contiene il percorso completo in cui BITS prevede che l'applicazione server scriva la risposta. |
La tabella seguente illustra le intestazioni di risposta.
| Intestazione risposta | Descrizione |
|---|---|
| BITS-Static-Response-URL | Facoltativo. Contiene l'URL assoluto (non specificare un URL relativo) in un file di dati statico da usare come risposta. Il file di dati statico deve essere accessibile dal client BITS. Se si usa questa intestazione, non creare il file di risposta specificato nell'intestazione della richiesta BITS-Response-DataFile-Name. Si noti che BITS non elimina questo file per l'utente. |
| BITS-Copy-File-To-Destination | Facoltativo. Per impostazione predefinita, se la proprietà BITSServerNotificationType è impostata su 1 o 2, il server BITS non copia il file di caricamento nel percorso specificato dal nome del file remoto nel processo. Per fare in modo che BITS copia il file nel percorso specificato dal nome del file remoto nel processo, inviare questa intestazione di risposta. È possibile specificare qualsiasi valore; BITS non usa il valore . Si noti che le cartelle nel percorso del file remoto devono esistere. |
La richiesta seguente mostra BITS che invia il percorso del file di caricamento all'applicazione 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
Di seguito viene illustrata la risposta dell'applicazione server a BITS; la risposta viene inserita nel file specificato dall'intestazione della richiesta BITS-Response-DataFile-Name.
HTTP/1.1 200 - OK
Content-Length: 0
Invio del file di caricamento nel corpo della richiesta
BITS invia il file di caricamento nel corpo della richiesta se la proprietà BITSServerNotificationType è impostata su 2. L'invio del file di caricamento nel corpo della richiesta consente alle applicazioni e agli script esistenti di funzionare con modifiche minime. Il file di caricamento e il file di risposta vengono passati rispettivamente nella richiesta e nella risposta. Nella tabella seguente viene illustrata l'intestazione della richiesta.
| Intestazione della richiesta | Descrizione |
|---|---|
| BITS-Original-Request-URL | Contiene il nome remoto specificato nel processo. |
La tabella seguente illustra le intestazioni di risposta.
| Intestazione risposta | Descrizione |
|---|---|
| BITS-Static-Response-URL | Facoltativo. Contiene l'URL assoluto (non specificare un URL relativo) in un file di dati statico da usare come risposta. Il file di dati statico deve essere accessibile dal client BITS. Se si usa questa intestazione, non includere la risposta nel flusso. Si noti che BITS non elimina questo file per l'utente. |
| BITS-Copy-File-To-Destination | Facoltativo. Se la proprietà BITSServerNotificationType è impostata su 1 o 2, il server BITS non copia il file di caricamento nel percorso specificato dal nome file remoto nel processo. Per avere BITS copiare il file nel percorso specificato dal nome del file remoto, inviare questa intestazione di risposta. È possibile specificare qualsiasi valore; BITS non usa il valore . Si noti che le cartelle nel percorso del file remoto devono esistere. |
La richiesta seguente mostra BITS passando il file caricato all'applicazione server nel corpo della richiesta.
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
La risposta seguente mostra l'applicazione server che passa i dati di risposta a BITS nel corpo della risposta.
HTTP/1.1 200 - OK
Content-Length: 100
100 bytes of reply data goes here
Gestione degli errori delle applicazioni server
Vedere Gestione degli errori delle applicazioni server.