nl::Weave::Profiles::BDX_Development

Se llama a este controlador cada vez que se encuentra un error de Weave que no se puede devolver directamente a través de códigos de error al flujo de control definido por la aplicación por el usuario.

Es decir, si se produce un error dentro de otro controlador cuya firma tiene un tipo de datos que se muestra vacío (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 ya se inicialice una BDXTransfer (p.ej., demasiados objetos). En ese caso, Weave registrará ese error y el protocolo se encargará de limpiar cualquier estado necesario que 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, pasados por referencia). Callee (aplicación de usuario) DEBE utilizar el búfer proporcionado, pero, por razones de retrocompatibilidad, puede mostrar su propio búfer. La callee no debe proporcionar más de aLength de bytes. Cuando se muestra, aLength contiene la cantidad real de bytes leídos en el búfer.

Maneja el bloque de datos al que apunta aDataBlock de longitud aLength.

Probablemente, esto implique escribirlo en un archivo y cerrarlo si isLastBlock es verdadero.

Es la devolución de llamada que se invoca cuando el destino acepta un ReceiveInit que se envió previamente.

Te recomendamos aprovechar esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hiciste al iniciarla.

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

Su trabajo es determinar si deseas aceptar la recepción y, de ser así, configurar aXfer->mIsAccepted=true para que el protocolo envíe un mensaje de aceptación al iniciador. El objeto BDXTransfer se inicia según 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 para el manejo de bloques, p.ej., al objeto BDXTransfer. Si se muestra un código de error distinto de kStatus_Success, se supone que la transferencia se rechaza y el protocolo manejará el envío de un mensaje de rechazo con el código.

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

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

Te recomendamos aprovechar esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hiciste al iniciarla.

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

Su trabajo es determinar si deseas aceptar el elemento SendInit y, de ser así, configurar aXfer->mIsAccepted=true para que el protocolo envíe un mensaje de aceptación al iniciador. El objeto BDXTransfer se inicia según 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 para el manejo de bloques, p.ej., al objeto BDXTransfer. Si se devuelve un código de error distinto de WEAVE_NO_ERROR, se supone que se rechaza la transferencia y el protocolo se encarga del envío de un mensaje de rechazo con el código.

Controla los casos en los que finalizó la transferencia.

Controla mensajes de TransferError que recibe o envía BDX.

Nota: Se supone que la transferencia de BDX es potencialmente recuperable (posiblemente temporal, p. ej., fuera de PacketBuffers por el momento). Por lo tanto, la opción de llamar a Shutdown() depende del programador de la aplicación y de las devoluciones de llamada que defina. TODO: verifica esto y concílialo con el texto del documento de BDX, que declara lo siguiente: "[Un TransferError] puede ser enviado en cualquier momento por cualquiera de las partes 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 confirmación de solicitud para TCP) y según la compatibilidad en tiempo de compilación con WRMP.