apache/pulsar

[Doc] Description for Producer SendAsync Needs Updating

Open

#23,643 建立於 2024年11月26日

在 GitHub 查看
 (4 留言) (1 反應) (0 負責人)Java (13,697 star) (3,485 fork)batch import
doc-requiredgood first issue

描述

Search before asking

  • I searched in the issues and found nothing similar.

What issue do you find in Pulsar docs?

The description for SendAsync implies that it is a blocking operation, but asynchronous calls should be non-blocking and occur in a background thread.

What is your suggestion?

The SendAsync method in Pulsar is designed to send messages asynchronously, allowing the application to continue processing other tasks without waiting for the send operation to complete. A user-defined callback function is invoked upon the completion of the send operation which can be used to track the success / failure of the send operation.

Any reference?

No response

Are you willing to submit a PR?

  • I'm willing to submit a PR!

貢獻者指南

技術棧
java
領域
documentation
議題類型
documentation
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
1
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
under 1 hour
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
fresh
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
無
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
85
研究方向
Look into the Pulsar Java client documentation files, specifically the description for Producer.SendAsync. Review any existing comments on the issue for additional context. Update the description to clarify that SendAsync is non blocking and executes in a background thread, with a callback for completion.