Polishing

(cherry picked from commit 7e07f3d)

Author: jhoeller

spring-websocket/src/main/java/org/springframework/web/socket/CloseStatus.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,16 +16,14 @@
 
 package org.springframework.web.socket;
 
-import org.eclipse.jetty.websocket.api.StatusCode;
-
 import org.springframework.util.Assert;
 import org.springframework.util.ObjectUtils;
 
 /**
  * Represents a WebSocket close status code and reason. Status codes in the 1xxx range are
  * pre-defined by the protocol. Optionally, a status code may be sent with a reason.
- * <p>
- * See <a href="https://tools.ietf.org/html/rfc6455#section-7.4.1">RFC 6455, Section 7.4.1
+ *
+ * <p>See <a href="https://tools.ietf.org/html/rfc6455#section-7.4.1">RFC 6455, Section 7.4.1
  * "Defined Status Codes"</a>.
  *
  * @author Rossen Stoyanchev
@@ -134,17 +132,16 @@ public final class CloseStatus {
 	 */
 	public static final CloseStatus TLS_HANDSHAKE_FAILURE = new CloseStatus(1015);
 
-
 	/**
 	 * A status code for use within the framework the indicate a session has
 	 * become unreliable (e.g. timed out while sending a message) and extra
 	 * care should be exercised, e.g. avoid sending any further data to the
 	 * client that may be done during normal shutdown.
+	 * @since 4.0.3
 	 */
 	public static final CloseStatus SESSION_NOT_RELIABLE = new CloseStatus(4500);
 
 
-
 	private final int code;
 
 	private final String reason;
@@ -164,39 +161,39 @@ public CloseStatus(int code) {
 	 * @param reason the reason
 	 */
 	public CloseStatus(int code, String reason) {
-		Assert.isTrue((code >= 1000 && code < 5000), "Invalid code");
+		Assert.isTrue((code >= 1000 && code < 5000), "Invalid status code");
 		this.code = code;
 		this.reason = reason;
 	}
 
 
 	/**
-	 * Returns the status code.
+	 * Return the status code.
 	 */
 	public int getCode() {
 		return this.code;
 	}
 
 	/**
-	 * Returns the reason or {@code null}.
+	 * Return the reason, or {@code null} if none.
 	 */
 	public String getReason() {
 		return this.reason;
 	}
 
 	/**
-	 * Crate a new {@link CloseStatus} from this one with the specified reason.
+	 * Create a new {@link CloseStatus} from this one with the specified reason.
 	 * @param reason the reason
-	 * @return a new {@link StatusCode} instance
+	 * @return a new {@link CloseStatus} instance
 	 */
 	public CloseStatus withReason(String reason) {
 		Assert.hasText(reason, "Reason must not be empty");
 		return new CloseStatus(this.code, reason);
 	}
 
-	@Override
-	public int hashCode() {
-		return this.code * 29 + ObjectUtils.nullSafeHashCode(this.reason);
+
+	public boolean equalsCode(CloseStatus other) {
+		return (this.code == other.code);
 	}
 
 	@Override
@@ -211,8 +208,9 @@ public boolean equals(Object other) {
 		return (this.code == otherStatus.code && ObjectUtils.nullSafeEquals(this.reason, otherStatus.reason));
 	}
 
-	public boolean equalsCode(CloseStatus other) {
-		return this.code == other.code;
+	@Override
+	public int hashCode() {
+		return this.code * 29 + ObjectUtils.nullSafeHashCode(this.reason);
 	}
 
 	@Override

spring-websocket/src/main/java/org/springframework/web/socket/messaging/SessionConnectEvent.java

@@ -16,7 +16,6 @@
 
 package org.springframework.web.socket.messaging;
 
-
 import org.springframework.messaging.Message;
 
 /**
@@ -33,7 +32,11 @@
 @SuppressWarnings("serial")
 public class SessionConnectEvent extends AbstractSubProtocolEvent {
 
-
+	/**
+	 * Create a new SessionConnectEvent.
+	 * @param source the component that published the event (never {@code null})
+	 * @param message the connect message
+	 */
 	public SessionConnectEvent(Object source, Message<byte[]> message) {
 		super(source, message);
 	}

spring-websocket/src/main/java/org/springframework/web/socket/messaging/SessionConnectedEvent.java

@@ -16,21 +16,23 @@
 
 package org.springframework.web.socket.messaging;
 
-
 import org.springframework.messaging.Message;
 
 /**
  * A connected event represents the server response to a client's connect request.
- * See {@link org.springframework.web.socket.messaging.SessionConnectEvent
- * SessionConnectEvent}.
+ * See {@link org.springframework.web.socket.messaging.SessionConnectEvent}.
  *
  * @author Rossen Stoyanchev
  * @since 4.0.3
  */
 @SuppressWarnings("serial")
 public class SessionConnectedEvent extends AbstractSubProtocolEvent {
 
-
+	/**
+	 * Create a new SessionConnectedEvent.
+	 * @param source the component that published the event (never {@code null})
+	 * @param message the connected message
+	 */
 	public SessionConnectedEvent(Object source, Message<byte[]> message) {
 		super(source, message);
 	}

spring-websocket/src/main/java/org/springframework/web/socket/messaging/SessionDisconnectEvent.java

@@ -16,7 +16,6 @@
 
 package org.springframework.web.socket.messaging;
 
-
 import org.springframework.messaging.Message;
 import org.springframework.util.Assert;
 import org.springframework.web.socket.CloseStatus;
@@ -26,7 +25,7 @@
  * Protocol (e.g. STOMP) as the WebSocket sub-protocol is closed.
  *
  * <p>Note that this event may be raised more than once for a single session and
- * therefore event consumers should be idempotent and ignore a duplicate event..
+ * therefore event consumers should be idempotent and ignore a duplicate event.
  *
  * @author Rossen Stoyanchev
  * @since 4.0.3
@@ -40,7 +39,11 @@ public class SessionDisconnectEvent extends AbstractSubProtocolEvent {
 
 
 	/**
-	 * Create a new event.
+	 * Create a new SessionDisconnectEvent.
+	 * @param source the component that published the event (never {@code null})
+	 * @param message the message
+	 * @param sessionId the disconnect message
+	 * @param closeStatus the status object
 	 */
 	public SessionDisconnectEvent(Object source, Message<byte[]> message, String sessionId, CloseStatus closeStatus) {
 		super(source, message);
@@ -49,6 +52,7 @@ public SessionDisconnectEvent(Object source, Message<byte[]> message, String ses
 		this.status = closeStatus;
 	}
 
+
 	/**
 	 * Return the session id.
 	 */
@@ -68,4 +72,5 @@ public String toString() {
 		return "SessionDisconnectEvent[sessionId=" + this.sessionId + ", " +
 				(this.status != null ? this.status.toString() : "closeStatus=null") + "]";
 	}
+
 }