Add warning about entity count limit per connection

In case of too many concurrent creations.

References #464

Author: acogoluegnes

src/docs/asciidoc/api.adoc

@@ -187,18 +187,24 @@ Executors
 ----
 |`maxProducersByConnection`
 |The maximum number of `Producer` instances a single connection can maintain before
-a new connection is open. The value must be between 1 and 255.
-|255
+a new connection is open.
+The value must be between 1 and 256.
+The limit may not be strictly enforced in case of too many concurrent creations.
+|256
 
 |`maxTrackingConsumersByConnection`
 |The maximum number of `Consumer` instances that store their offset a single connection
-can maintain before a new connection is open. The value must be between 1 and 255.
+can maintain before a new connection is open.
+The value must be between 1 and 256.
+The limit may not be strictly enforced in case of too many concurrent creations.
 |50
 
 |`maxConsumersByConnection`
 |The maximum number of `Consumer` instances a single connection can maintain before
-a new connection is open. The value must be between 1 and 255.
-|255
+a new connection is open.
+The value must be between 1 and 256.
+The limit may not be strictly enforced in case of too many concurrent creations.
+|256
 
 |`lazyInitialization`
 |To delay the connection opening until necessary.

src/main/java/com/rabbitmq/stream/EnvironmentBuilder.java

@@ -247,6 +247,8 @@ public interface EnvironmentBuilder {
    *
    * <p>Default is 256, which is the maximum value.
    *
+   * <p>The limit may not be strictly enforced in case of too many concurrent creations.
+   *
    * @param maxProducersByConnection
    * @return this builder instance
    */
@@ -257,6 +259,8 @@ public interface EnvironmentBuilder {
    *
    * <p>Default is 50, which is the maximum value.
    *
+   * <p>The limit may not be strictly enforced in case of too many concurrent creations.
+   *
    * @param maxTrackingConsumersByConnection
    * @return this builder instance
    */
@@ -267,6 +271,8 @@ public interface EnvironmentBuilder {
    *
    * <p>Default is 256, which is the maximum value.
    *
+   * <p>The limit may not be strictly enforced in case of too many concurrent creations.
+   *
    * @param maxConsumersByConnection
    * @return this builder instance
    */