Add messaging.simp.user package

spring-messaging/src/main/java/org/springframework/messaging/simp/SimpMessagingTemplate.java

@@ -57,7 +57,7 @@ public class SimpMessagingTemplate extends AbstractMessageSendingTemplate<String
 	/**
 	 * Configure the prefix to use for destinations targeting a specific user.
 	 * <p>The default value is "/user/".
-	 * @see org.springframework.messaging.simp.handler.UserDestinationMessageHandler
+	 * @see org.springframework.messaging.simp.user.UserDestinationMessageHandler
 	 */
 	public void setUserDestinationPrefix(String prefix) {
 		Assert.notNull(prefix, "UserDestinationPrefix must not be null");

spring-messaging/src/main/java/org/springframework/messaging/simp/annotation/SendToUser.java

@@ -36,7 +36,7 @@ import org.springframework.messaging.simp.SimpMessageHeaderAccessor;
  * @author Rossen Stoyanchev
  * @since 4.0
  * @see org.springframework.messaging.handler.annotation.SendTo
- * @see org.springframework.messaging.simp.handler.UserDestinationMessageHandler
+ * @see org.springframework.messaging.simp.user.UserDestinationMessageHandler
  */
 @Target(ElementType.METHOD)
 @Retention(RetentionPolicy.RUNTIME)

spring-messaging/src/main/java/org/springframework/messaging/simp/annotation/package-info.java

@@ -1,5 +1,4 @@
 /**
- * Annotations and for handling messages from simple messaging protocols
- * (like STOMP).
+ * Annotations and for handling messages from SImple Messaging Protocols such as STOMP.
  */
 package org.springframework.messaging.simp.annotation;

spring-messaging/src/main/java/org/springframework/messaging/simp/broker/AbstractSubscriptionRegistry.java

@@ -24,6 +24,10 @@ import org.springframework.messaging.simp.SimpMessageType;
 import org.springframework.util.MultiValueMap;
 
 /**
+ * Abstract base class for implementations of {@link SubscriptionRegistry} that
+ * looks up information in messages but delegates to abstract methods for the
+ * actual storage and retrieval.
+ *
  * @author Rossen Stoyanchev
  * @since 4.0
  */

spring-messaging/src/main/java/org/springframework/messaging/simp/broker/DefaultSubscriptionRegistry.java

@@ -31,6 +31,8 @@ import org.springframework.util.LinkedMultiValueMap;
 import org.springframework.util.MultiValueMap;
 
 /**
+ * A default, simple in-memory implementation of {@link SubscriptionRegistry}.
+ *
  * @author Rossen Stoyanchev
  * @since 4.0
  */

spring-messaging/src/main/java/org/springframework/messaging/simp/config/AbstractMessageBrokerConfiguration.java

@@ -30,12 +30,12 @@ import org.springframework.messaging.converter.StringMessageConverter;
 import org.springframework.messaging.simp.SimpMessagingTemplate;
 import org.springframework.messaging.simp.annotation.support.SimpAnnotationMethodMessageHandler;
 import org.springframework.messaging.simp.broker.AbstractBrokerMessageHandler;
-import org.springframework.messaging.simp.handler.DefaultUserDestinationResolver;
-import org.springframework.messaging.simp.handler.DefaultUserSessionRegistry;
+import org.springframework.messaging.simp.user.DefaultUserDestinationResolver;
+import org.springframework.messaging.simp.user.DefaultUserSessionRegistry;
 import org.springframework.messaging.simp.broker.SimpleBrokerMessageHandler;
-import org.springframework.messaging.simp.handler.UserDestinationMessageHandler;
-import org.springframework.messaging.simp.handler.UserDestinationResolver;
-import org.springframework.messaging.simp.handler.UserSessionRegistry;
+import org.springframework.messaging.simp.user.UserDestinationMessageHandler;
+import org.springframework.messaging.simp.user.UserDestinationResolver;
+import org.springframework.messaging.simp.user.UserSessionRegistry;
 import org.springframework.messaging.support.AbstractSubscribableChannel;
 import org.springframework.messaging.support.ExecutorSubscribableChannel;
 import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

spring-messaging/src/main/java/org/springframework/messaging/simp/package-info.java

@@ -1,4 +1,4 @@
 /**
- * Generic support for SImple Messaging Protocols such as STOMP.
+ * Generic support for SImple Messaging Protocols including protocols such as STOMP.
  */
 package org.springframework.messaging.simp;

spring-messaging/src/main/java/org/springframework/messaging/simp/user/DefaultUserDestinationResolver.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package org.springframework.messaging.simp.handler;
+package org.springframework.messaging.simp.user;
 
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;

spring-messaging/src/main/java/org/springframework/messaging/simp/user/DefaultUserSessionRegistry.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package org.springframework.messaging.simp.handler;
+package org.springframework.messaging.simp.user;
 
 import org.springframework.util.Assert;
 

spring-messaging/src/main/java/org/springframework/messaging/simp/user/UserDestinationMessageHandler.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package org.springframework.messaging.simp.handler;
+package org.springframework.messaging.simp.user;
 
 import java.util.Set;
 

spring-messaging/src/main/java/org/springframework/messaging/simp/user/UserDestinationResolver.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package org.springframework.messaging.simp.handler;
+package org.springframework.messaging.simp.user;
 
 import org.springframework.messaging.Message;
 

spring-messaging/src/main/java/org/springframework/messaging/simp/user/UserSessionRegistry.java

@@ -1,4 +1,4 @@
-package org.springframework.messaging.simp.handler;
+package org.springframework.messaging.simp.user;
 
 import java.util.Set;
 

spring-messaging/src/main/java/org/springframework/messaging/simp/user/package-info.java

@@ -0,0 +1,9 @@
+/**
+ * Support for handling messages to "user" destinations (i.e. destinations that are
+ * unique to a user's sessions), primarily translating the destinations and then
+ * forwarding the updated message to the broker.
+ * <p>
+ * Also included is {@link org.springframework.messaging.simp.user.UserSessionRegistry}
+ * for keeping track of connected user sessions.
+ */
+package org.springframework.messaging.simp.user;