Make it more clear in the javadocs that you should use *Later methods to

send upstream events from a ChannelDownstreamHandler
This commit is contained in:
Norman Maurer 2012-03-03 19:14:36 +01:00
parent b3606eb57a
commit 66f8de91b1
2 changed files with 10 additions and 0 deletions

View File

@ -56,6 +56,10 @@ package io.netty.channel;
* <p> * <p>
* You will also find various helper methods in {@link Channels} to be useful * You will also find various helper methods in {@link Channels} to be useful
* to generate and send an artificial or manipulated event. * to generate and send an artificial or manipulated event.
* <p>
* <strong>Caution:</strong>
* <p>
* Use the *Later(..) methods of the {@link Channels} class if you want to send an upstream event from a {@link ChannelDownstreamHandler} otherwise you may run into threading issues.
* *
* <h3>State management</h3> * <h3>State management</h3>
* *

View File

@ -49,6 +49,12 @@ import java.net.SocketAddress;
* <strong>super.handleDownstream(ctx, e);</strong> * <strong>super.handleDownstream(ctx, e);</strong>
* } * }
* }</pre> * }</pre>
*
* <p>
* <strong>Caution:</strong>
* <p>
* Use the *Later(..) methods of the {@link Channels} class if you want to send an upstream event from a {@link ChannelDownstreamHandler} otherwise you may run into threading issues.
*
*/ */
public class SimpleChannelDownstreamHandler implements ChannelDownstreamHandler { public class SimpleChannelDownstreamHandler implements ChannelDownstreamHandler {