Protocolo de notificación para aplicaciones de servidor
BITS usa la propiedad BITSServerNotificationType para determinar cómo BITS envía el contenido del archivo de carga a la aplicación de servidor. Si la propiedad BITSServerNotificationType se establece en 1, BITS pasa la ubicación del archivo de carga en un encabezado. Si la propiedad BITSServerNotificationType se establece en 2, BITS pasa el contenido del archivo de carga en el cuerpo de la solicitud.
Para obtener más información sobre cómo BITS controla los errores de la aplicación de servidor, consulte Control de errores de aplicación de servidor.
Envío de la ubicación del archivo de carga en un encabezado
BITS pasa la ubicación de los archivos de carga y respuesta a la aplicación de servidor en los encabezados si la propiedad BITSServerNotificationType está establecida en 1. La aplicación de servidor abre el archivo de carga, procesa los datos y, a continuación, genera el archivo de respuesta. De forma predeterminada, BITS quita los archivos de carga y respuesta del servidor después de recibir la respuesta de la aplicación de servidor. Para que BITS copie el archivo de carga en la ubicación especificada por el nombre de archivo remoto en el trabajo, incluya el encabezado BITS-Copy-File-To-Destination en la respuesta. Si no incluye el encabezado y desea guardar los archivos de carga y respuesta, debe copiar los archivos de carga y respuesta en una nueva ubicación antes de responder. En la tabla siguiente se muestran los encabezados de solicitud.
| Encabezado de solicitud | Descripción |
|---|---|
| BITS-Original-Request-URL | Contiene el nombre remoto especificado en el trabajo. |
| BITS-Request-DataFile-Name | Contiene la ruta de acceso completa a los datos cargados. |
| BITS-Response-DataFile-Name | Contiene la ruta de acceso completa a donde BITS espera que la aplicación de servidor escriba la respuesta. |
En la tabla siguiente se muestran los encabezados de respuesta.
| Encabezado de respuesta | Descripción |
|---|---|
| BITS-Static-Response-URL | Opcional. Contiene la dirección URL absoluta (no especifica una dirección URL relativa) a un archivo de datos estático que se usará como respuesta. El cliente bits debe tener acceso al archivo de datos estático. Si usa este encabezado, no cree el archivo de respuesta especificado en el encabezado de solicitud BITS-Response-DataFile-Name. Tenga en cuenta que BITS no elimina este archivo por usted. |
| BITS-Copy-File-To-Destination | Opcional. De forma predeterminada, si la propiedad BITSServerNotificationType está establecida en 1 o 2, el servidor BITS no copia el archivo de carga en la ubicación especificada por el nombre de archivo remoto en el trabajo. Para que BITS copie el archivo en la ubicación especificada por el nombre de archivo remoto en el trabajo, envíe este encabezado de respuesta. Puede especificar cualquier valor; BITS no usa el valor . Tenga en cuenta que las carpetas de la ruta de acceso del archivo remoto deben existir. |
La siguiente solicitud muestra BITS que envía la ubicación del archivo de carga a la aplicación de servidor.
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
A continuación se muestra la respuesta de la aplicación de servidor a BITS; la respuesta se coloca en el archivo especificado por el encabezado de solicitud BITS-Response-DataFile-Name.
HTTP/1.1 200 - OK
Content-Length: 0
Envío del archivo de carga en el cuerpo de la solicitud
BITS envía el archivo de carga en el cuerpo de la solicitud si la propiedad BITSServerNotificationType está establecida en 2. El envío del archivo de carga en el cuerpo de la solicitud permite que los scripts y las aplicaciones existentes funcionen con modificaciones mínimas. El archivo de carga y el archivo de respuesta se pasan en la solicitud y respuesta, respectivamente. En la tabla siguiente se muestra el encabezado de solicitud.
| Encabezado de solicitud | Descripción |
|---|---|
| BITS-Original-Request-URL | Contiene el nombre remoto especificado en el trabajo. |
En la tabla siguiente se muestran los encabezados de respuesta.
| Encabezado de respuesta | Descripción |
|---|---|
| BITS-Static-Response-URL | Opcional. Contiene la dirección URL absoluta (no especifica una dirección URL relativa) a un archivo de datos estático que se usará como respuesta. El cliente bits debe tener acceso al archivo de datos estático. Si usa este encabezado, no incluya la respuesta en la secuencia. Tenga en cuenta que BITS no elimina este archivo por usted. |
| BITS-Copy-File-To-Destination | Opcional. Si la propiedad BITSServerNotificationType está establecida en 1 o 2, el servidor BITS no copia el archivo de carga en la ubicación especificada por el nombre de archivo remoto en el trabajo. Para que BITS copie el archivo en la ubicación especificada por el nombre de archivo remoto, envíe este encabezado de respuesta. Puede especificar cualquier valor; BITS no usa el valor . Tenga en cuenta que las carpetas de la ruta de acceso del archivo remoto deben existir. |
La siguiente solicitud muestra que BITS pasa el archivo cargado a la aplicación de servidor en el cuerpo de la solicitud.
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
En la respuesta siguiente se muestra la aplicación de servidor que pasa los datos de respuesta a BITS en el cuerpo de la respuesta.
HTTP/1.1 200 - OK
Content-Length: 100
100 bytes of reply data goes here