nl::Weave::Perfis::BDX_Development

Esse gerenciador é chamado sempre que ocorre um erro de Weave que não pode ser retornado diretamente por códigos de erro para o fluxo de controle definido pelo usuário.

Ou seja, se ocorrer um erro em outro gerenciador com uma assinatura que tenha o tipo de retorno vazio (por exemplo, em resposta a uma mensagem do Weave recebida ou até mesmo enviada pelo protocolo), esse gerenciador será chamado para que o usuário possa determinar se a transferência pode ser recuperada e continuar ou se ele precisa chamar Shutdown(). É possível que ocorra um erro antes que um BDXTransfer seja inicializado (por exemplo, muitos objetos de transferência alocados). Nesse caso, o erro será registrado pelo Weave e o protocolo processará a limpeza dos estados necessários alocados.

Get a block of data to be transmitted.

O autor da chamada fornece o espaço do buffer (buffer e tamanho do buffer, passados por referência). O recebedor da chamada (aplicativo do usuário) DEVE usar o buffer fornecido, mas, por motivos de compatibilidade com versões anteriores, pode retornar o próprio buffer. O recebedor da chamada não pode fornecer mais que aLength de bytes. No retorno, aLength contém o número real de bytes lidos no buffer.

Processe o bloco de dados apontado por aDataBlock de comprimento aLength.

Provavelmente, isso envolverá gravá-lo em um arquivo e fechar esse arquivo se isLastBlock for verdadeiro.

Callback invocado quando um ReceiveInit enviado anteriormente é aceito pelo destino.

Talvez você queira usar essa oportunidade para abrir arquivos ou alocar recursos para a transferência, caso não tenha feito isso ao iniciá-la.

Chamada de retorno invocada ao receber uma mensagem ReceiveInit.

A função dele é determinar se você quer aceitar o recebimento e, em caso afirmativo, definir aXfer->mIsAccepted=true para que o protocolo envie uma mensagem de aceitação para o iniciador. O objeto BDXTransfer é iniciado para as configurações padrão. Este é um bom lugar para anexar qualquer estado específico do aplicativo (alças de arquivos abertas etc.) a aXfer->mAppState. Você também precisa anexar os gerenciadores necessários para, por exemplo, o processamento de blocos ao objeto BDXTransfer. Se um código de erro diferente de kStatus_Success for retornado, a transferência será considerada rejeitada e o protocolo processará o envio de uma mensagem de rejeição com o código.

Invocado se uma das mensagens Init anteriores foi rejeitada pelo destino.

Callback invocado quando um SendInit enviado anteriormente é aceito pelo destino.

Talvez você queira usar essa oportunidade para abrir arquivos ou alocar recursos para a transferência, caso não tenha feito isso ao iniciá-la.

Chamada de retorno invocada ao receber uma mensagem SendInit.

A função dele é determinar se você quer aceitar o SendInit e, em caso afirmativo, definir aXfer->mIsAccepted=true para que o protocolo envie uma mensagem de aceitação ao iniciador. O objeto BDXTransfer é iniciado para as configurações padrão. Este é um bom lugar para anexar qualquer estado específico do aplicativo (alças de arquivos abertas etc.) a aXfer->mAppState. Você também precisa anexar os gerenciadores necessários para, por exemplo, o processamento de blocos ao objeto BDXTransfer. Se um código de erro diferente de WEAVE_NO_ERROR for retornado, a transferência será considerada rejeitada e o protocolo tratará o envio de uma mensagem de rejeição com o código.

Processar casos em que a transferência foi concluída

Processar mensagens TransferError recebidas ou enviadas pelo BDX.

Observação: presume-se que a transferência BDX seja potencialmente recuperável (possivelmente temporariamente, como fora dos PackageBuffers) no momento. Portanto, a opção de chamar Shutdown() é deixada para o programador de aplicativos e para os callbacks definidos. TODO: confirmar e reconciliar com a linguagem do documento BDX, que declara: "quoquo;[A TransferError] pode ser enviada a qualquer momento por qualquer uma das partes para encerrar prematuramente a transferência de dados em massa."

GetBDXAckFlag retorna a sinalização apropriada para o campo RequestAck, dependendo da conexão do contexto de troca (sem confirmação de solicitação para TCP) e com base na compatibilidade com tempo de compilação para WRMP.