nl :: Tejido:: Perfiles: BDX_Desarrollo

Este controlador se llama 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 del usuario.

Es decir, si ocurre un error dentro de otro controlador cuya firma tiene el tipo de retorno nulo (por ejemplo, en respuesta a un mensaje Weave entrante 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 deben llamar a Shutdown (). Tenga en cuenta que es posible que se produzca un error antes de que un BDXTransfer es inicializado (por ejemplo, ya demasiados objetos de transferencia asignados). En tal caso, Weave registrará dicho error y el protocolo se encargará de limpiar cualquier estado necesario que haya asignado.

Get a block of data to be transmitted.

La persona que llama proporciona el espacio de almacenamiento en búfer (búfer y longitud del búfer, pasados ​​por referencia). Callee (aplicación de usuario) DEBE usar el búfer provisto, pero por razones de compatibilidad con versiones anteriores, puede devolver su propio búfer. Destinatario de la llamada no debe ofrecer más que el aLength de bytes. En cambio, aLength contiene el número real de bytes leídos en el buffer.

Maneja el bloque de datos apuntado por un DataBlock de longitud aLength.

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

Devolución de llamada invoca cuando un enviado previamente ReceiveInit es aceptada por el destino.

Es posible que desee aprovechar esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hizo al iniciarla.

Devolución de llamada invoca cuando se recibe una ReceiveInit mensaje.

Su trabajo es determinar si desea aceptar la recepción y, de ser así, establecer aXfer-> mIsAccepted = true para que el protocolo envíe un mensaje de aceptación al iniciador. El BDXTransfer objeto se inició a los valores predeterminados. Este es un buen lugar para adjuntar cualquier estado específico de la aplicación (identificadores de archivos abiertos, etc.) a aXfer-> mAppState. También debe adjuntar los controladores necesarios para el manejo por ejemplo, bloque a la BDXTransfer objeto en este punto. Si se devuelve un código de error que no sea kStatus_Success, se asume que la transferencia es rechazada y el protocolo se encargará de enviar un mensaje de rechazo con el código.

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

Devolución de llamada invoca cuando un enviado previamente SendInit es aceptada por el destino.

Es posible que desee aprovechar esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hizo al iniciarla.

Devolución de llamada invoca cuando se recibe una SendInit mensaje.

Su función es determinar si desea aceptar la SendInit y, si es así, establecer aXfer-> mIsAccepted = true para que el protocolo enviará un mensaje de aceptación al iniciador. El BDXTransfer objeto se inició a los valores predeterminados. Este es un buen lugar para adjuntar cualquier estado específico de la aplicación (identificadores de archivos abiertos, etc.) a aXfer-> mAppState. También debe adjuntar los controladores necesarios para el manejo por ejemplo, bloque a la BDXTransfer objeto en este punto. Si se devuelve un código de error que no sea WEAVE_NO_ERROR, se asume que la transferencia es rechazada y el protocolo se encargará de enviar un mensaje de rechazo con el código.

Manejar los casos donde la transferencia está terminada.

Manija TransferError mensajes recibidos o enviados por BDX.

Nota: La transferencia BDX se presume que es potencialmente recuperable (por ejemplo, posiblemente temporal de PacketBuffers por el momento) y por lo tanto la opción de llamar apagado () se deja al programador de la aplicación y las devoluciones de llamada que definen. TODO: verificar esto y conciliarlo con el idioma en el documento BDX, que dice: "[Un TransferError] Puede ser enviado en cualquier momento por cualquiera de las partes para finalizar prematuramente la transferencia masiva de datos".

GetBDXAckFlag devuelve el indicador apropiado para el campo RequestAck dependiendo de la conexión del contexto de intercambio (sin solicitud de confirmación para TCP) y según el tiempo de compilación compatible con WRMP.