andreacavalli/netty5
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

More documentation on Channel.write() and connectionless channels

Browse Source
This commit is contained in:
Trustin Lee 2009-07-21 09:12:28 +00:00
parent 8ed89dbd8f
commit ca19f4cdde
1 changed files with 10 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
src/main/java/org/jboss/netty/channel/Channel.java
View File

@ -168,7 +168,11 @@ public interface Channel extends Comparable<Channel>{
SocketAddress getRemoteAddress();
/**
* Sends a message to this channel asynchronously.
* Sends a message to this channel asynchronously. If this channel was
* created by a connectionless transport (e.g. {@link DatagramChannel})
* and is not connected yet, you call {@link #write(Object, SocketAddress)}
* instead. Otherwise, the write request will fail and an
* {@code 'exceptionCaught'} event will be triggered.
*
* @param message the message to write
*
@ -182,7 +186,11 @@ public interface Channel extends Comparable<Channel>{
/**
* Sends a message to this channel asynchronously. It has an additional
* parameter that allows a user to specify where to send the specified
* message instead of this channel's current remote address.
* message instead of this channel's current remote address. If this
* channel was created by a connectionless transport (e.g. {@link DatagramChannel})
* and is not connected yet, you must specify non-null address. Otherwise,
* the write request will fail and an {@code 'exceptionCaught'} will be
* triggered.
*
* @param message the message to write
* @param remoteAddress where to send the specified message.