2008-08-08 02:37:18 +02:00
|
|
|
/*
|
2008-08-08 03:27:24 +02:00
|
|
|
* JBoss, Home of Professional Open Source
|
2008-08-08 02:37:18 +02:00
|
|
|
*
|
2008-08-08 03:27:24 +02:00
|
|
|
* Copyright 2008, Red Hat Middleware LLC, and individual contributors
|
|
|
|
* by the @author tags. See the COPYRIGHT.txt in the distribution for a
|
|
|
|
* full listing of individual contributors.
|
2008-08-08 02:37:18 +02:00
|
|
|
*
|
2008-08-08 03:27:24 +02:00
|
|
|
* This is free software; you can redistribute it and/or modify it
|
|
|
|
* under the terms of the GNU Lesser General Public License as
|
|
|
|
* published by the Free Software Foundation; either version 2.1 of
|
|
|
|
* the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This software is distributed in the hope that it will be useful,
|
2008-08-08 02:37:18 +02:00
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
2008-08-08 03:27:24 +02:00
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
2008-08-08 02:37:18 +02:00
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
2008-08-08 03:27:24 +02:00
|
|
|
* License along with this software; if not, write to the Free
|
|
|
|
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
|
|
|
|
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
|
2008-08-08 02:37:18 +02:00
|
|
|
*/
|
2008-08-08 03:40:10 +02:00
|
|
|
package org.jboss.netty.channel;
|
2008-08-08 02:37:18 +02:00
|
|
|
|
|
|
|
import java.util.Map;
|
|
|
|
|
2008-09-01 17:19:34 +02:00
|
|
|
import org.jboss.netty.handler.ssl.SslHandler;
|
|
|
|
|
2008-08-08 02:37:18 +02:00
|
|
|
|
|
|
|
/**
|
2008-09-01 17:19:34 +02:00
|
|
|
* A chain of {@link ChannelHandler}s which handles a {@link ChannelEvent}.
|
|
|
|
* Every {@link Channel} has its own pipeline instance. You can add one or
|
|
|
|
* more {@link ChannelHandler}s to the pipeline to receive I/O events
|
|
|
|
* (e.g. read) and to request I/O operations (e.g. write and close).
|
|
|
|
*
|
|
|
|
* <h3>Thread safety</h3>
|
|
|
|
* <p>
|
|
|
|
* You can also add or remove a {@link ChannelHandler} at any time because a
|
|
|
|
* {@link ChannelPipeline} is thread safe. For example, you can insert a
|
|
|
|
* {@link SslHandler} when a sensitive information is about to be exchanged,
|
|
|
|
* and remove it after the exchange.
|
|
|
|
*
|
|
|
|
* <h3>How an event flows in a pipeline</h3>
|
|
|
|
* <p>
|
|
|
|
* The following diagram describes how events flows up and down in a
|
|
|
|
* {@link ChannelPipeline} typically:
|
|
|
|
*
|
|
|
|
* <pre>
|
|
|
|
* I/O Request
|
|
|
|
* via Channel
|
|
|
|
* |
|
|
|
|
* +-----------------------------------------+----------------+
|
|
|
|
* | ChannelPipeline | |
|
|
|
|
* | \|/ |
|
|
|
|
* | +----------------------+ +-----------+------------+ |
|
|
|
|
* | | Upstream Handler N | | Downstream Handler 1 | |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | /|\ | |
|
|
|
|
* | | \|/ |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | | Upstream Handler N-1 | | Downstream Handler 2 | |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | /|\ | |
|
|
|
|
* | | \|/ |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | | Upstream Handler N-2 | | Downstream Handler 3 | |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | . . |
|
|
|
|
* | . . |
|
|
|
|
* | /|\ | |
|
|
|
|
* | | \|/ |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | | Upstream Handler 3 | | Downstream Handler M-2 | |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | /|\ | |
|
|
|
|
* | | \|/ |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | | Upstream Handler 2 | | Downstream Handler M-1 | |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | /|\ | |
|
|
|
|
* | | \|/ |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | | Upstream Handler 1 | | Downstream Handler M | |
|
|
|
|
* | +----------+-----------+ +-----------+------------+ |
|
|
|
|
* | /|\ | |
|
|
|
|
* +--------------+--------------------------+----------------+
|
|
|
|
* | \|/
|
|
|
|
* +--------------+--------------------------+----------------+
|
|
|
|
* | I/O Threads (Transport Implementation) |
|
|
|
|
* +----------------------------------------------------------+
|
|
|
|
* </pre>
|
2008-08-08 02:37:18 +02:00
|
|
|
*
|
2008-08-08 03:27:24 +02:00
|
|
|
* @author The Netty Project (netty-dev@lists.jboss.org)
|
|
|
|
* @author Trustin Lee (tlee@redhat.com)
|
2008-08-08 02:37:18 +02:00
|
|
|
*
|
|
|
|
* @version $Rev$, $Date$
|
|
|
|
*
|
|
|
|
* @apiviz.landmark
|
2008-08-08 03:40:10 +02:00
|
|
|
* @apiviz.composedOf org.jboss.netty.channel.ChannelHandlerContext
|
|
|
|
* @apiviz.owns org.jboss.netty.channel.ChannelHandler
|
|
|
|
* @apiviz.uses org.jboss.netty.channel.ChannelSink - - sends events downstream
|
2008-08-08 02:37:18 +02:00
|
|
|
*/
|
|
|
|
public interface ChannelPipeline {
|
|
|
|
void addFirst (String name, ChannelHandler handler);
|
|
|
|
void addLast (String name, ChannelHandler handler);
|
|
|
|
void addBefore(String baseName, String name, ChannelHandler handler);
|
|
|
|
void addAfter (String baseName, String name, ChannelHandler handler);
|
|
|
|
|
|
|
|
void remove(ChannelHandler handler);
|
|
|
|
ChannelHandler remove(String name);
|
|
|
|
<T extends ChannelHandler> T remove(Class<T> handlerType);
|
|
|
|
ChannelHandler removeFirst();
|
|
|
|
ChannelHandler removeLast();
|
|
|
|
|
|
|
|
void replace(ChannelHandler oldHandler, String newName, ChannelHandler newHandler);
|
|
|
|
ChannelHandler replace(String oldName, String newName, ChannelHandler newHandler);
|
|
|
|
<T extends ChannelHandler> T replace(Class<T> oldHandlerType, String newName, ChannelHandler newHandler);
|
|
|
|
|
|
|
|
ChannelHandler getFirst();
|
|
|
|
ChannelHandler getLast();
|
|
|
|
|
|
|
|
ChannelHandler get(String name);
|
|
|
|
<T extends ChannelHandler> T get(Class<T> handlerType);
|
|
|
|
|
|
|
|
ChannelHandlerContext getContext(ChannelHandler handler);
|
|
|
|
ChannelHandlerContext getContext(String name);
|
|
|
|
ChannelHandlerContext getContext(Class<? extends ChannelHandler> handlerType);
|
|
|
|
|
|
|
|
void sendUpstream(ChannelEvent e);
|
|
|
|
void sendDownstream(ChannelEvent e);
|
|
|
|
|
|
|
|
Channel getChannel();
|
|
|
|
ChannelSink getSink();
|
|
|
|
void attach(Channel channel, ChannelSink sink);
|
|
|
|
|
|
|
|
Map<String, ChannelHandler> toMap();
|
|
|
|
}
|