nl::Weave::Profiles::BDX_Development

Trình xử lý này được gọi bất cứ khi nào gặp lỗi Weave mà không thể trả về trực tiếp thông qua mã lỗi gửi đến luồng điều khiển do ứng dụng người dùng xác định.

Nghĩa là, nếu xảy ra lỗi trong một trình xử lý khác có chữ ký không thuộc loại trả về (ví dụ: để phản hồi một thông báo Weave gửi đến hoặc thậm chí được gửi bởi giao thức), trình xử lý này sẽ được gọi để người dùng có thể xác định xem có thể khôi phục và tiếp tục quá trình chuyển hay không hoặc liệu họ nên gọi Shutdown(). Xin lưu ý rằng có thể xảy ra lỗi trước khi khởi chạy BDXTransfer (ví dụ: đã có quá nhiều đối tượng chuyển được phân bổ). Trong trường hợp như vậy, Weave sẽ ghi lại lỗi nêu trên và giao thức này sẽ xử lý việc dọn dẹp mọi trạng thái cần thiết đã phân bổ.

Get a block of data to be transmitted.

Phương thức gọi cung cấp không gian lưu vào bộ đệm (vùng đệm và thời lượng vùng đệm, được truyền vào bằng tham chiếu). Callee (ứng dụng của người dùng) NÊN sử dụng bộ đệm được cung cấp, nhưng vì lý do tương thích ngược, có thể trả về bộ đệm riêng. Hàm được gọi không được cung cấp nhiều hơn aLength byte. Khi trả về, aLength chứa số byte thực tế được đọc vào vùng đệm.

Xử lý khối dữ liệu được trỏ đến bằng aDataBlock có độ dài aLength.

Có thể trường hợp này sẽ liên quan đến việc ghi dữ liệu vào một tệp và đóng tệp đã nói nếu isLastBlock là true.

Lệnh gọi lại được gọi khi đích đến chấp nhận một ReceiveInit đã gửi trước đó.

Bạn nên tận dụng cơ hội này để mở tệp hoặc phân bổ tài nguyên cho quá trình chuyển nếu bạn chưa làm vậy khi bắt đầu quá trình chuyển.

Lệnh gọi lại được gọi khi nhận được thông báo ReceiveInit.

Nhiệm vụ của nó là xác định xem bạn có muốn chấp nhận Nhận hay không và nếu có, hãy đặt aXfer->mIsAccept=true để giao thức gửi thông báo chấp nhận đến trình khởi tạo. Đối tượng BDXTransfer được khởi tạo theo chế độ cài đặt mặc định. Đây là nơi phù hợp để đính kèm mọi trạng thái dành riêng cho ứng dụng (mở tay cầm tệp, v.v.) vào aXfer->mAppState. Bạn cũng nên đính kèm các trình xử lý cần thiết, ví dụ: xử lý khối sang đối tượng BDXTransfer tại thời điểm này. Nếu hệ thống trả về một mã lỗi không phải kStatus_Success, thì yêu cầu chuyển sẽ được coi là bị từ chối và giao thức sẽ xử lý việc gửi một thông báo từ chối có chứa mã đó.

Được gọi nếu một trong các thông báo Init trước đó bị đích đến từ chối.

Lệnh gọi lại được gọi khi đích đến chấp nhận một SendInit đã gửi trước đó.

Bạn nên tận dụng cơ hội này để mở tệp hoặc phân bổ tài nguyên cho quá trình chuyển nếu bạn chưa làm vậy khi bắt đầu quá trình chuyển.

Lệnh gọi lại được gọi khi nhận được thông báo SendInit.

Nhiệm vụ của nó là xác định xem bạn có muốn chấp nhận SendInit hay không và nếu có, hãy thiết lập aXfer->mIsAllow=true để giao thức gửi thông báo chấp nhận đến trình khởi tạo. Đối tượng BDXTransfer được khởi tạo theo chế độ cài đặt mặc định. Đây là nơi phù hợp để đính kèm mọi trạng thái dành riêng cho ứng dụng (mở tay cầm tệp, v.v.) vào aXfer->mAppState. Bạn cũng nên đính kèm các trình xử lý cần thiết, ví dụ: xử lý khối sang đối tượng BDXTransfer tại thời điểm này. Nếu một mã lỗi không phải WEAVE_NO_ERROR được trả về, thì yêu cầu chuyển được coi là bị từ chối và giao thức sẽ xử lý việc gửi thông báo từ chối có chứa mã này.

Xử lý các trường hợp quá trình chuyển hoàn tất.

Xử lý thông báo TransferError do BDX nhận hoặc gửi.

Lưu ý:Quá trình chuyển BDX được cho là có thể khôi phục được (có thể là tạm thời, ví dụ: thoát khỏi PacketBuffers tại thời điểm này) và do đó tuỳ chọn gọi Shutdown() sẽ thuộc về lập trình viên ứng dụng và các lệnh gọi lại mà họ xác định. VIỆC CẦN LÀM: xác minh và đối chiếu nội dung với ngôn ngữ trong tài liệu BDX, trong đó có nêu: "[Lỗi chuyển] Có thể được một trong hai bên gửi bất cứ lúc nào đến sớm kết thúc chuyển dữ liệu hàng loạt".

GetBDXAckflag trả về cờ thích hợp cho trường RequestAck tuỳ thuộc vào kết nối của ngữ cảnh trao đổi (không có xác nhận yêu cầu cho TCP) và dựa trên khả năng hỗ trợ thời gian biên dịch cho WRMP.