* Updated the Javadoc of MessageEvent

* Improved how getRemoteAddress() works in DownstreamMessageEvent and UpstreamMessageEvent

src/main/java/org/jboss/netty/channel/DownstreamMessageEvent.java

@@ -77,7 +77,11 @@ public class DownstreamMessageEvent implements MessageEvent {
     }
 
     public SocketAddress getRemoteAddress() {
-        return remoteAddress;
+        if (remoteAddress != null) {
+            return remoteAddress;
+        } else {
+            return getChannel().getRemoteAddress();
+        }
     }
 
     @Override

src/main/java/org/jboss/netty/channel/MessageEvent.java

@@ -45,10 +45,7 @@ public interface MessageEvent extends ChannelEvent {
     Object getMessage();
 
     /**
-     * Returns the remote address.
+     * Returns the remote address of the message.
-     *
-     * @return the remote address.  {@code null} if the remote address is
-     *         same with the default remote address returned by {@link Channel#getRemoteAddress()}.
      */
     SocketAddress getRemoteAddress();
 }

src/main/java/org/jboss/netty/channel/UpstreamMessageEvent.java

@@ -57,12 +57,7 @@ public class UpstreamMessageEvent implements MessageEvent {
         }
         this.channel = channel;
         this.message = message;
-
+        this.remoteAddress = remoteAddress;
-        if (remoteAddress != null) {
-            this.remoteAddress = remoteAddress;
-        } else {
-            this.remoteAddress = channel.getRemoteAddress();
-        }
     }
 
     public Channel getChannel() {
@@ -78,13 +73,16 @@ public class UpstreamMessageEvent implements MessageEvent {
     }
 
     public SocketAddress getRemoteAddress() {
-        return remoteAddress;
+        if (remoteAddress != null) {
+            return remoteAddress;
+        } else {
+            return getChannel().getRemoteAddress();
+        }
     }
 
     @Override
     public String toString() {
-        // It's safe to use identity comparison in this case.
+        if (getRemoteAddress() == null) {
-        if (getRemoteAddress() == getChannel().getRemoteAddress()) {
             return getChannel().toString() + " RECEIVED: " +
                    StringUtil.stripControlCharacters(getMessage());
         } else {