nl::Weave::Perfiles:BDX_Development

Se llama a este controlador cada vez que se encuentra un error de Weave que no se puede mostrar directamente a través del código de error en el flujo de control definido por la aplicación.

Es decir, si se produce un error dentro de otro controlador cuya firma tiene un tipo de datos anulado (p.ej., en respuesta a un mensaje entrante de Weave o incluso enviado por el protocolo), se llamará a este controlador para que el usuario pueda determinar si la transferencia se puede recuperar y continuar o si debe llamar a Shutdown(). Ten en cuenta que es posible que se produzca un error antes de que se inicialice BDXTransfer (p.ej., demasiados objetos ya asignados). En ese caso, Weave registrará ese error y el protocolo se encargará de limpiar cualquier estado que se haya asignado.

Get a block of data to be transmitted.

El emisor proporciona el espacio de almacenamiento en búfer (búfer y longitud del búfer, que se pasa por referencia). Callee (aplicación del usuario) DEBE usar el búfer provisto, pero por motivos de retrocompatibilidad puede mostrar su propio búfer. Callee no debe proporcionar más que el aLength de bytes. Al mostrar un resultado, aLength contiene la cantidad real de bytes leídos en el búfer.

Controla el bloque de datos al que apunta aDataBlock con una longitud aLength.

Es probable que esto implique escribirlo en un archivo y cerrar dicho archivo si isLastBlock es verdadero.

Es la devolución de llamada invocada cuando el destino acepta una ReceiveInit enviada anteriormente.

Le recomendamos que utilice esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hizo al iniciarla.

Es la devolución de llamada invocada cuando se recibe un mensaje ReceiveInit.

Su trabajo es determinar si desea aceptar la recepción y, de ser así, establecer aXfer->mIsAccept=true para que el protocolo envíe un mensaje de aceptación al iniciador. El objeto BDXTransfer se inicia en la configuración predeterminada. Este es un buen lugar para adjuntar cualquier estado específico de la aplicación (controladores de archivos abiertos, etc.) a axfer->mAppState. En este punto, también debes adjuntar los controladores necesarios, p.ej., el control de bloqueo al objeto BDXTransfer. Si se muestra un código de error distinto de kStatus_Success, se supone que se rechazó la transferencia y que el protocolo se encargará de enviar un mensaje de rechazo con el código.

Se invoca si el destino rechazó uno de los mensajes Init anteriores.

Es la devolución de llamada invocada cuando el destino acepta un SendInit enviado anteriormente.

Le recomendamos que utilice esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hizo al iniciarla.

Es la devolución de llamada invocada cuando se recibe un mensaje SendInit.

Su trabajo es determinar si deseas aceptar SendInit y, de ser así, establecer aXfer->mIsAccept=true para que el protocolo envíe un mensaje de aceptación al iniciador. El objeto BDXTransfer se inicia en la configuración predeterminada. Este es un buen lugar para adjuntar cualquier estado específico de la aplicación (controladores de archivos abiertos, etc.) a axfer->mAppState. En este punto, también debes adjuntar los controladores necesarios, p.ej., el control de bloqueo al objeto BDXTransfer. Si se muestra un código de error distinto de WEAVE_NO_ERROR, se supone que se rechazó la transferencia y que el protocolo se encargará de enviar un mensaje de rechazo con el código.

Maneja casos en los que se completó la transferencia.

Controla los mensajes TransferError recibidos o enviados por BDX.

Nota: Se supone que la transferencia de BDX se puede recuperar (posiblemente, de manera temporal, por fuera de PacketBuffers) por lo que la opción de llamar a Shutdown() queda en manos del programador de la aplicación y de las devoluciones de llamada que definen. ACTIVIDAD: Verifique esto y concilia el mensaje con el lenguaje que se encuentra en el documento de BDX, que declara: "A TransferError" en cualquier momento. Cualquiera de las partes puede enviarlo para finalizar prematuramente la transferencia masiva de datos.

GetBDXAckFlag muestra la marca adecuada para el campo RequestAck según la conexión del contexto de intercambio (sin conexión ack de solicitud para TCP) y según la compatibilidad del tiempo de compilación para WRMP.