org.apache.mina.core.filterchain
Interface IoFilterChain

All Known Implementing Classes:
DefaultIoFilterChain

public interface IoFilterChain

A container of IoFilters that forwards IoHandler events to the consisting filters and terminal IoHandler sequentially. Every IoSession has its own IoFilterChain (1-to-1 relationship).

Author:
Apache MINA Project

Nested Class Summary
static interface IoFilterChain.Entry
          Represents a name-filter pair that an IoFilterChain contains.
 
Method Summary
 void addAfter(java.lang.String baseName, java.lang.String name, IoFilter filter)
          Adds the specified filter with the specified name just after the filter whose name is baseName in this chain.
 void addBefore(java.lang.String baseName, java.lang.String name, IoFilter filter)
          Adds the specified filter with the specified name just before the filter whose name is baseName in this chain.
 void addFirst(java.lang.String name, IoFilter filter)
          Adds the specified filter with the specified name at the beginning of this chain.
 void addLast(java.lang.String name, IoFilter filter)
          Adds the specified filter with the specified name at the end of this chain.
 void clear()
          Removes all filters added to this chain.
 boolean contains(java.lang.Class<? extends IoFilter> filterType)
          Returns true if this chain contains an IoFilter of the specified filterType.
 boolean contains(IoFilter filter)
          Returns true if this chain contains the specified filter.
 boolean contains(java.lang.String name)
          Returns true if this chain contains an IoFilter with the specified name.
 void fireExceptionCaught(java.lang.Throwable cause)
          Fires a IoHandler.exceptionCaught(IoSession, Throwable) event.
 void fireFilterClose()
          Fires a IoSession.close() event.
 void fireFilterWrite(WriteRequest writeRequest)
          Fires a IoSession.write(Object) event.
 void fireMessageReceived(java.lang.Object message)
          Fires a fireMessageReceived(Object) event.
 void fireMessageSent(WriteRequest request)
          Fires a IoHandler.sessionOpened(IoSession) event.
 void fireSessionClosed()
          Fires a IoHandler.sessionClosed(IoSession) event.
 void fireSessionCreated()
          Fires a IoHandler.sessionCreated(IoSession) event.
 void fireSessionIdle(IdleStatus status)
          Fires a IoHandler.sessionIdle(IoSession, IdleStatus) event.
 void fireSessionOpened()
          Fires a IoHandler.sessionOpened(IoSession) event.
 IoFilter get(java.lang.Class<? extends IoFilter> filterType)
          Returns the IoFilter with the specified filterType in this chain.
 IoFilter get(java.lang.String name)
          Returns the IoFilter with the specified name in this chain.
 java.util.List<IoFilterChain.Entry> getAll()
          Returns the list of all IoFilterChain.Entrys this chain contains.
 java.util.List<IoFilterChain.Entry> getAllReversed()
          Returns the reversed list of all IoFilterChain.Entrys this chain contains.
 IoFilterChain.Entry getEntry(java.lang.Class<? extends IoFilter> filterType)
          Returns the IoFilterChain.Entry with the specified filterType in this chain.
 IoFilterChain.Entry getEntry(IoFilter filter)
          Returns the IoFilterChain.Entry with the specified filter in this chain.
 IoFilterChain.Entry getEntry(java.lang.String name)
          Returns the IoFilterChain.Entry with the specified name in this chain.
 IoFilter.NextFilter getNextFilter(java.lang.Class<? extends IoFilter> filterType)
          Returns the IoFilter.NextFilter of the specified filterType in this chain.
 IoFilter.NextFilter getNextFilter(IoFilter filter)
          Returns the IoFilter.NextFilter of the specified IoFilter in this chain.
 IoFilter.NextFilter getNextFilter(java.lang.String name)
          Returns the IoFilter.NextFilter of the IoFilter with the specified name in this chain.
 IoSession getSession()
          Returns the parent IoSession of this chain.
 IoFilter remove(java.lang.Class<? extends IoFilter> filterType)
          Replace the filter of the specified type with the specified new filter.
 void remove(IoFilter filter)
          Replace the filter with the specified name with the specified new filter.
 IoFilter remove(java.lang.String name)
          Removes the filter with the specified name from this chain.
 IoFilter replace(java.lang.Class<? extends IoFilter> oldFilterType, IoFilter newFilter)
          Replace the filter of the specified type with the specified new filter.
 void replace(IoFilter oldFilter, IoFilter newFilter)
          Replace the filter with the specified name with the specified new filter.
 IoFilter replace(java.lang.String name, IoFilter newFilter)
          Replace the filter with the specified name with the specified new filter.
 

Method Detail

getSession

IoSession getSession()
Returns the parent IoSession of this chain.

Returns:
IoSession

getEntry

IoFilterChain.Entry getEntry(java.lang.String name)
Returns the IoFilterChain.Entry with the specified name in this chain.

Returns:
null if there's no such name in this chain

getEntry

IoFilterChain.Entry getEntry(IoFilter filter)
Returns the IoFilterChain.Entry with the specified filter in this chain.

Returns:
null if there's no such filter in this chain

getEntry

IoFilterChain.Entry getEntry(java.lang.Class<? extends IoFilter> filterType)
Returns the IoFilterChain.Entry with the specified filterType in this chain. If there's more than one filter with the specified type, the first match will be chosen.

Returns:
null if there's no such name in this chain

get

IoFilter get(java.lang.String name)
Returns the IoFilter with the specified name in this chain.

Returns:
null if there's no such name in this chain

get

IoFilter get(java.lang.Class<? extends IoFilter> filterType)
Returns the IoFilter with the specified filterType in this chain. If there's more than one filter with the specified type, the first match will be chosen.

Returns:
null if there's no such name in this chain

getNextFilter

IoFilter.NextFilter getNextFilter(java.lang.String name)
Returns the IoFilter.NextFilter of the IoFilter with the specified name in this chain.

Returns:
null if there's no such name in this chain

getNextFilter

IoFilter.NextFilter getNextFilter(IoFilter filter)
Returns the IoFilter.NextFilter of the specified IoFilter in this chain.

Returns:
null if there's no such name in this chain

getNextFilter

IoFilter.NextFilter getNextFilter(java.lang.Class<? extends IoFilter> filterType)
Returns the IoFilter.NextFilter of the specified filterType in this chain. If there's more than one filter with the specified type, the first match will be chosen.

Returns:
null if there's no such name in this chain

getAll

java.util.List<IoFilterChain.Entry> getAll()
Returns the list of all IoFilterChain.Entrys this chain contains.


getAllReversed

java.util.List<IoFilterChain.Entry> getAllReversed()
Returns the reversed list of all IoFilterChain.Entrys this chain contains.


contains

boolean contains(java.lang.String name)
Returns true if this chain contains an IoFilter with the specified name.


contains

boolean contains(IoFilter filter)
Returns true if this chain contains the specified filter.


contains

boolean contains(java.lang.Class<? extends IoFilter> filterType)
Returns true if this chain contains an IoFilter of the specified filterType.


addFirst

void addFirst(java.lang.String name,
              IoFilter filter)
Adds the specified filter with the specified name at the beginning of this chain.

Throws:
IoFilterLifeCycleException - if IoFilter.onPostAdd(IoFilterChain, String, NextFilter) or IoFilter.init() throws an exception.

addLast

void addLast(java.lang.String name,
             IoFilter filter)
Adds the specified filter with the specified name at the end of this chain.

Throws:
IoFilterLifeCycleException - if IoFilter.onPostAdd(IoFilterChain, String, NextFilter) or IoFilter.init() throws an exception.

addBefore

void addBefore(java.lang.String baseName,
               java.lang.String name,
               IoFilter filter)
Adds the specified filter with the specified name just before the filter whose name is baseName in this chain.

Throws:
IoFilterLifeCycleException - if IoFilter.onPostAdd(IoFilterChain, String, NextFilter) or IoFilter.init() throws an exception.

addAfter

void addAfter(java.lang.String baseName,
              java.lang.String name,
              IoFilter filter)
Adds the specified filter with the specified name just after the filter whose name is baseName in this chain.

Throws:
IoFilterLifeCycleException - if IoFilter.onPostAdd(IoFilterChain, String, NextFilter) or IoFilter.init() throws an exception.

replace

IoFilter replace(java.lang.String name,
                 IoFilter newFilter)
Replace the filter with the specified name with the specified new filter.

Returns:
the old filter
Throws:
java.lang.IllegalArgumentException - if there's no such filter

replace

void replace(IoFilter oldFilter,
             IoFilter newFilter)
Replace the filter with the specified name with the specified new filter.

Throws:
java.lang.IllegalArgumentException - if there's no such filter

replace

IoFilter replace(java.lang.Class<? extends IoFilter> oldFilterType,
                 IoFilter newFilter)
Replace the filter of the specified type with the specified new filter. If there's more than one filter with the specified type, the first match will be replaced.

Throws:
java.lang.IllegalArgumentException - if there's no such filter

remove

IoFilter remove(java.lang.String name)
Removes the filter with the specified name from this chain.

Throws:
IoFilterLifeCycleException - if IoFilter.onPostRemove(IoFilterChain, String, NextFilter) or IoFilter.destroy() throws an exception.

remove

void remove(IoFilter filter)
Replace the filter with the specified name with the specified new filter.

Throws:
java.lang.IllegalArgumentException - if there's no such filter

remove

IoFilter remove(java.lang.Class<? extends IoFilter> filterType)
Replace the filter of the specified type with the specified new filter. If there's more than one filter with the specified type, the first match will be replaced.

Throws:
java.lang.IllegalArgumentException - if there's no such filter

clear

void clear()
           throws java.lang.Exception
Removes all filters added to this chain.

Throws:
java.lang.Exception - if IoFilter.onPostRemove(IoFilterChain, String, NextFilter) thrown an exception.

fireSessionCreated

void fireSessionCreated()
Fires a IoHandler.sessionCreated(IoSession) event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.


fireSessionOpened

void fireSessionOpened()
Fires a IoHandler.sessionOpened(IoSession) event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.


fireSessionClosed

void fireSessionClosed()
Fires a IoHandler.sessionClosed(IoSession) event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.


fireSessionIdle

void fireSessionIdle(IdleStatus status)
Fires a IoHandler.sessionIdle(IoSession, IdleStatus) event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.


fireMessageReceived

void fireMessageReceived(java.lang.Object message)
Fires a fireMessageReceived(Object) event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.


fireMessageSent

void fireMessageSent(WriteRequest request)
Fires a IoHandler.sessionOpened(IoSession) event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.


fireExceptionCaught

void fireExceptionCaught(java.lang.Throwable cause)
Fires a IoHandler.exceptionCaught(IoSession, Throwable) event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.


fireFilterWrite

void fireFilterWrite(WriteRequest writeRequest)
Fires a IoSession.write(Object) event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.


fireFilterClose

void fireFilterClose()
Fires a IoSession.close() event. Most users don't need to call this method at all. Please use this method only when you implement a new transport or fire a virtual event.