[GitHub] [pulsar] losiu97 commented on a change in pull request #9525: [Doc] Add descriptions for numListenerThreads

[GitBox <gi...@apache.org>]

losiu97 commented on a change in pull request #9525:
URL: https://github.com/apache/pulsar/pull/9525#discussion_r571813417



##########
File path: site2/docs/client-libraries-java.md
##########
@@ -107,7 +107,7 @@ String | `authParams` | String represents parameters for the authentication plug
 long|`operationTimeoutMs`|Operation timeout |30000
 long|`statsIntervalSeconds`|Interval between each stats info<br/><br/>Stats is activated with positive `statsInterval`<br/><br/>Set `statsIntervalSeconds` to 1 second at least |60
 int|`numIoThreads`| The number of threads used for handling connections to brokers | 1 
-int|`numListenerThreads`|The number of threads used for handling message listeners | 1 
+int|`numListenerThreads`|The number of threads used for handling message listeners. The listener thread pool is shared across all the consumers and readers using the "listener" model to get messages. For a given consumer, the listener is always invoked from the same thread to ensure ordering. | 1 

Review comment:
       I would add "If you need multiple threads processing single topic, you should create a subscription with type SHARED and create multiple consumers for such subscription. This will of course not ensure ordering"




----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org