nl :: Dệt :: Hồ sơ :: 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 cho luồng điều khiển do người dùng-ứng dụng xác định.

Có nghĩa là, nếu lỗi xảy ra trong một trình xử lý khác có chữ ký có kiểu trả về là void (ví dụ: để phản hồi thông báo Weave đế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 liệu quá trình chuyển có thể được khôi phục hay không và tiếp tục hoặc nếu họ nên gọi Shutdown (). Lưu ý rằng có thể xảy ra lỗi trước khi BDXTransfer được khởi tạo (ví dụ: đã có quá nhiều đối tượng truyền được cấp phát). Trong trường hợp như vậy, lỗi đã nói sẽ được Weave ghi lại và giao thức sẽ xử lý dọn dẹp mọi trạng thái cần thiết mà nó đã cấp phát.

Get a block of data to be transmitted.

Người gọi cung cấp không gian đệm (bộ đệm và độ dài của bộ đệm, được truyền vào bằng tham chiếu). Callee (ứng dụng 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 của chính nó. Callee không được cung cấp nhiều hơn aLength của byte. Đổi lại, aLength chứa số byte thực tế được đọc vào bộ đệm.

Xử lý khối dữ liệu được trỏ tới bởi aDataBlock có độ dài aLength.

Có thể điều này sẽ liên quan đến việc ghi nó vào một tệp và đóng tệp đã nói nếu isLastBlock là đúng.

Gọi lại được gọi khi một Đơn vị nhận được gửi trước đó được đích đến chấp nhận.

Bạn có thể muốn sử 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 không làm như vậy khi bắt đầu.

Callback gọi khi nhận được một ReceiveInit nhắn.

Công việc 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-> mIsAccepted = true để giao thức sẽ 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 cài đặt mặc định. Đây là một nơi tốt để đính kèm mọi trạng thái dành riêng cho ứng dụng (mở tệp xử lý, 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ụ như xử lý khối vào đối tượng BDXTransfer tại thời điểm này. Nếu mã lỗi không phải kStatus_Success được trả về, quá trình 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ùng với mã.

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

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

Bạn có thể muốn sử 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 không làm như vậy khi bắt đầu.

Gọi lại được gọi khi nhận được tin nhắn SendInit .

Công việc 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 đặt aXfer-> mIsAccepted = true để giao thức sẽ gửi một 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 cài đặt mặc định. Đây là một nơi tốt để đính kèm mọi trạng thái dành riêng cho ứng dụng (mở tệp xử lý, 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 vào đối tượng BDXTransfer tại thời điểm này. Nếu mã lỗi không phải WEAVE_NO_ERROR được trả về, quá trình 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ùng với mã.

Xử lý các trường hợp đã chuyển xong.

Xử lý các tin nhắn TransferError do BDX nhận hoặc gửi.

Lưu ý: Quá trình truyền BDX được cho là có khả năng khôi phục được (có thể là tạm thời, ví dụ như thoát khỏi PacketBuffers vào lúc này) và do đó tùy chọn gọi Shutdown () được để cho 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 điều này và điều chỉnh nó với ngôn ngữ trong tài liệu BDX, trong đó nêu rõ: "[A TransferError] Có thể được gửi bất kỳ lúc nào bởi một trong hai bên để kết thúc sớm quá trình truyền dữ liệu hàng loạt."

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