nl::Weave::Profiles::BDX_Development

Ten moduł obsługi jest wywoływany za każdym razem, gdy wystąpi błąd Weave, którego nie można zwrócić bezpośrednio za pomocą kodów błędów do zdefiniowanego przez użytkownika procesu sterowania.

Oznacza to, że jeśli wystąpi błąd w innym module obsługi, którego podpis ma zwrot typu „void” (np. w odpowiedzi na przychodzącą wiadomość Weave, czy nawet wysłany przez protokół), ten moduł obsługi zostanie wywołany, aby użytkownik mógł określić, czy transfer można przywrócić i kontynuować, czy powinien wywołać funkcję Disabledown(). Przed zainicjowaniem funkcji BDXTransfer może wystąpić błąd (np. zbyt wiele przydzielonych obiektów transferu). W takim przypadku taki błąd zostanie zarejestrowany przez Weave, a protokół będzie usuwał przydzielony niezbędny stan.

Get a block of data to be transmitted.

Element wywołujący podaje miejsce buforowania (bufor i długość bufora przekazywane przez odwołanie). Wywołana (aplikacja użytkownika) POWINNA używać podanego bufora, ale ze względu na zgodność wsteczną może zwrócić własny bufor. Odbiorca nie może podać więcej niż aLength bajtów. Zwrócony ciąg aLength zawiera rzeczywistą liczbę bajtów odczytanych do bufora.

Obsługa bloku danych wskazywanego przez element aDataBlock o długości aLength.

Prawdopodobnie spowoduje to zapisanie go w pliku i zamknięcie tego pliku, jeśli zasada isLastBlock ma wartość true (prawda).

Wywołanie zwrotne jest wywoływane, gdy wysłane wcześniej dane ReceiveInit zostaną zaakceptowane przez miejsce docelowe.

Możesz skorzystać z tej możliwości, aby otworzyć pliki lub przydzielić zasoby do przeniesienia, jeśli nie zostało to zrobione podczas jego inicjowania.

Wywołanie zwrotne jest wywoływane w przypadku otrzymania komunikatu ReceiveInit.

Jego zadaniem jest określenie, czy chcesz zaakceptować odbieranie, a jeśli tak, ustaw parametr aXfer->mIsAccepted=true, tak aby protokół wysyłał wiadomość o zaakceptowaniu do inicjatora. Obiekt BDXTransfer inicjuje działanie z użyciem ustawień domyślnych. W tym miejscu możesz dołączyć dowolny stan aplikacji (otwarte uchwyty plików itp.) do aXfer->mAppState. Dołącz też niezbędne moduły obsługi, np. do obiektu BDXTransfer. Jeśli zostanie zwrócony kod błędu inny niż kStatus_Success, przyjmuje się, że przesyłanie zostało odrzucone, a protokół obsługuje wysyłanie wiadomości o odrzuceniu z kodem.

Wywoływana, jeśli jedna z poprzednich wiadomości Init została odrzucona przez miejsce docelowe.

Wywołanie zwrotne jest wywoływane, gdy poprzednio wysłany sygnał SendInit został zaakceptowany przez miejsce docelowe.

Możesz skorzystać z tej możliwości, aby otworzyć pliki lub przydzielić zasoby do przeniesienia, jeśli nie zostało to zrobione podczas jego inicjowania.

Wywołanie zwrotne jest wywoływane w przypadku otrzymania wiadomości SendInit.

Jego zadaniem jest określenie, czy chcesz zaakceptować SendInit, a jeśli tak, ustaw parametr aXfer->mIsAccepted=true, tak aby protokół wysyłał komunikat o zaakceptowaniu do inicjatora. Obiekt BDXTransfer inicjuje działanie z użyciem ustawień domyślnych. W tym miejscu możesz dołączyć dowolny stan aplikacji (otwarte uchwyty plików itp.) do aXfer->mAppState. Dołącz też niezbędne moduły obsługi, np. do obiektu BDXTransfer. Jeśli zostanie zwrócony kod błędu inny niż WEAVE_NO_ERROR, przyjmuje się, że przesyłanie zostało odrzucone, a protokół obsługuje wysyłanie wiadomości o odrzuceniu z tym kodem.

Zajmij się zgłoszeniami, w których przypadku przenoszenie zostało zakończone.

Obsługuj wiadomości z komunikatem TransferError odebrane lub wysłane przez BDX.

Uwaga: zakłada się, że transfer BDX da się odzyskać (prawdopodobnie tymczasowo, np. z bufora PacketBuffers), więc możliwość wywołania funkcji Disabledown() pozostawia programiście aplikacji i zdefiniowanym przez niego wywołaniem zwrotnym. DO ZROBIENIA: zweryfikuj to i uzgodnij je z sformułowaniem w dokumencie BDX, w którym stwierdza się: „[Błąd transferu] Może zostać wysłany w dowolnym momencie przez dowolną ze stron, aby przedwcześnie zakończenia zbiorczego przesyłania danych.

GetBDXAckFlag zwraca odpowiednią flagę dla pola RequestAck w zależności od połączenia w ramach giełdy (brak potwierdzenia żądania w przypadku TCP) oraz na podstawie obsługi czasu kompilacji przez WRMP.