[Doc] Description for Producer SendAsync Needs Updating

[youshibin]

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!

[youshibin]

Looking at the internalSendAsync implementation, it would only be blocking if DisableBlockIfQueueFull is set to false and the queue is full.

[lhotari]

@jasonyunicorn please go ahead with the PR to https://github.com/apache/pulsar-site to update the docs.

[lhotari]

In addition, it could be useful to check the javadoc too. That would be a PR to apache/pulsar repository.

[youshibin]

@lhotari

In addition, it could be useful to check the javadoc too.

I didn't find much in terms of a function description in the javadocs, but maybe this isn't the right place?

However, there is a good description in the Go docs for SendAsync, which I copied.