org.norther.tammi.spray.filter
Class DefaultPipe

java.lang.Object
  org.norther.tammi.core.base.Adaptee
      org.norther.tammi.spray.filter.DefaultFilter
          org.norther.tammi.spray.filter.DefaultPipe

All Implemented Interfaces:

Serializable, NotificationBroadcaster, NotificationEmitter, Filter, Manageable, MBeanDelegate, Pipe

public class DefaultPipe
extends DefaultFilter
implements Pipe

A default implementation of Pipe invoking a series of filters that have been configured to be called in order.

Author:

Ilkka Priha

See Also:

Serialized Form

Field Summary

Fields inherited from class org.norther.tammi.core.base.Adaptee

ADAPTEE_NOTIF_DESCRIPTION, ADAPTEE_NOTIFICATIONS

Fields inherited from interface org.norther.tammi.core.base.MBeanDelegate

ARRAY_TYPE, OBJECT_TYPE, PRIMITIVE_TYPE, STRING_TYPE

Constructor Summary

DefaultPipe()
Constructs a new pipe.

Method Summary

void	addFilterName(int index, ObjectName name) Adds a new filter to the given location.
void	addFilterName(ObjectName name) Adds a new filter to the end of the pipe.
void	clearFilterNames() Clears all filters from the pipe.
void	closeNamedFilter(ObjectName filter) Closes the named filter.
void	closeNamedFilter(ObjectName filter, int index) Closes the indexed filter.
boolean	containsFilterName(ObjectName filter) Checks whether the specified filter is in the pipe.
void	doFilter(ServletRequest request, ServletResponse response, FilterChain chain) Causes the specified request and response to be processed by the filters associated with this pipe, until one of these filters causes the response to be created and returned.
ObjectName	getFilterName(int index) Gets the indexed filter in the pipe.
List	getFilterNames() Gets filters in the pipe.
Filter	getFirstFilter() Gets the first registered filter in the pipe.
Filter	getFirstFilter(Class clazz) Gets the first registered filter of the specified class in the pipe.
Filter	getLastFilter() Gets the last registered filter in the pipe.
Filter	getLastFilter(Class clazz) Gets the last registered filter of the specified class in the pipe.
Filter	getNextFilter(int index) Gets the next registered filter following the given location.
Filter	getNextFilter(int index, Class clazz) Gets the next registered filter of the specified class following the given location.
Filter	getPreviousFilter(int index) Gets the previous registered filter preceding the given location.
Filter	getPreviousFilter(int index, Class clazz) Gets the previous registered filter of the specified class preceding the given location.
boolean	isNamedFilterOpen(ObjectName filter) Checks whether the named filter is open.
boolean	isNamedFilterOpen(ObjectName filter, int index) Checks whether the indexed filter is open.
protected int	locate(ObjectName filter, Object[] list, int start) Locates the specified filter in the filter list from the given location.
int	locateFilter(Class clazz) Locates the first registered filter of the specified class in the pipe.
int	locateFilter(int index, Class clazz) Locates the next registered filter of the specified class following the given location.
int	locateNamedFilter(ObjectName filter) Locates the named filter in the pipe.
int	locateNamedFilter(ObjectName filter, int index) Locates the named filter in the pipe from the given location.
void	openNamedFilter(ObjectName filter) Opens the named filter.
void	openNamedFilter(ObjectName filter, int index) Opens the indexed filter.
Filter	queryFilter(String pattern) Queries for a specified filter in the pipe.
void	removeFilterName(int index) Removes the indexed filter from the pipe.
void	removeFilterName(ObjectName name) Removes the first filter with the specified name from the pipe.
void	setFilterName(int index, ObjectName name) Sets the indexed filter in the pipe.
void	setFilterNames(List names) Sets filters in the pipe.

Methods inherited from class org.norther.tammi.spray.filter.DefaultFilter

destroy, getFilterConfig, getRequestMap, getSessionMap, init

Methods inherited from class org.norther.tammi.core.base.Adaptee

addAdaptee, addNotificationListener, getAttributeSupport, getBroker, getCanonicalName, getDomain, getFactory, getLoader, getLog, getLog, getMBean, getMBeanServer, getNotificationInfo, getObjectName, getRegistrationTime, getSequenceNumber, hasListeners, isRegistered, postmanaged, premanaged, removeNotificationListener, removeNotificationListener, sendNotification, sendNotification, sendNotification, sendNotification, unmanaged, unregister

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.servlet.Filter

destroy, init

Constructor Detail

DefaultPipe

public DefaultPipe()

Constructs a new pipe.

Method Detail

getFilterNames

public List getFilterNames()

Description copied from interface: Pipe

Gets filters in the pipe.

Specified by:

getFilterNames in interface Pipe

Returns:

a list of object names of filters.

setFilterNames

public void setFilterNames(List names)

Description copied from interface: Pipe

Sets filters in the pipe.

Specified by:

setFilterNames in interface Pipe

Parameters:

names - a list of object names of filters.

addFilterName

public void addFilterName(ObjectName name)

Description copied from interface: Pipe

Adds a new filter to the end of the pipe.

Specified by:

addFilterName in interface Pipe

Parameters:

name - the object name of the new filter.

addFilterName

public void addFilterName(int index,
                          ObjectName name)

Description copied from interface: Pipe

Adds a new filter to the given location.

Specified by:

addFilterName in interface Pipe

Parameters:

index - the index of the location.

name - the object name of the new filter.

containsFilterName

public boolean containsFilterName(ObjectName filter)

Description copied from interface: Pipe

Checks whether the specified filter is in the pipe.

Specified by:

containsFilterName in interface Pipe

Parameters:

filter - the object name of the filter.

Returns:

true, if the filter is found.

getFilterName

public ObjectName getFilterName(int index)

Description copied from interface: Pipe

Gets the indexed filter in the pipe.

Specified by:

getFilterName in interface Pipe

Parameters:

index - the index of the location.

Returns:

the object name of the filter.

setFilterName

public void setFilterName(int index,
                          ObjectName name)

Description copied from interface: Pipe

Sets the indexed filter in the pipe.

Specified by:

setFilterName in interface Pipe

Parameters:

index - the index of the location.

name - the object name of the filter.

removeFilterName

public void removeFilterName(ObjectName name)

Description copied from interface: Pipe

Removes the first filter with the specified name from the pipe.

Specified by:

removeFilterName in interface Pipe

Parameters:

name - the object name of the filter.

removeFilterName

public void removeFilterName(int index)

Description copied from interface: Pipe

Removes the indexed filter from the pipe.

Specified by:

removeFilterName in interface Pipe

Parameters:

index - the index of the location.

clearFilterNames

public void clearFilterNames()

Description copied from interface: Pipe

Clears all filters from the pipe.

Specified by:

clearFilterNames in interface Pipe

locateNamedFilter

public int locateNamedFilter(ObjectName filter)

Description copied from interface: Pipe

Locates the named filter in the pipe.

Specified by:

locateNamedFilter in interface Pipe

Parameters:

filter - the object name of the filter.

Returns:

the index of the filter or -1.

locateNamedFilter

public int locateNamedFilter(ObjectName filter,
                             int index)

Description copied from interface: Pipe

Locates the named filter in the pipe from the given location.

Specified by:

locateNamedFilter in interface Pipe

Parameters:

filter - the object name of the filter.

index - the start index of the location.

Returns:

the index of the filter or -1.

locateFilter

public int locateFilter(Class clazz)

Description copied from interface: Pipe

Locates the first registered filter of the specified class in the pipe.

Specified by:

locateFilter in interface Pipe

Parameters:

clazz - the class or interface.

Returns:

the index of the filter or -1.

locateFilter

public int locateFilter(int index,
                        Class clazz)

Description copied from interface: Pipe

Locates the next registered filter of the specified class following the given location. The filter in the given location is included in the search.

Specified by:

locateFilter in interface Pipe

Parameters:

index - the start index of the location.

clazz - the class or interface.

Returns:

the index of the filter or -1.

queryFilter

public Filter queryFilter(String pattern)

Description copied from interface: Pipe

Queries for a specified filter in the pipe.

Specified by:

queryFilter in interface Pipe

Parameters:

pattern - the name pattern.

Returns:

the found filter or null.

getFirstFilter

public Filter getFirstFilter()

Description copied from interface: Pipe

Gets the first registered filter in the pipe.

Specified by:

getFirstFilter in interface Pipe

Returns:

the found filter or null.

getLastFilter

public Filter getLastFilter()

Description copied from interface: Pipe

Gets the last registered filter in the pipe.

Specified by:

getLastFilter in interface Pipe

Returns:

the found filter or null.

getNextFilter

public Filter getNextFilter(int index)

Description copied from interface: Pipe

Gets the next registered filter following the given location. The filter in the given location is included in the search.

Specified by:

getNextFilter in interface Pipe

Parameters:

index - the index of the location.

Returns:

the found filter or null.

getPreviousFilter

public Filter getPreviousFilter(int index)

Description copied from interface: Pipe

Gets the previous registered filter preceding the given location. The filter in the given location is included in the search.

Specified by:

getPreviousFilter in interface Pipe

Parameters:

index - the index the location.

Returns:

the found filter or null.

getFirstFilter

public Filter getFirstFilter(Class clazz)

Description copied from interface: Pipe

Gets the first registered filter of the specified class in the pipe.

Specified by:

getFirstFilter in interface Pipe

Parameters:

clazz - the class or interface.

Returns:

the found filter or null.

getLastFilter

public Filter getLastFilter(Class clazz)

Description copied from interface: Pipe

Gets the last registered filter of the specified class in the pipe.

Specified by:

getLastFilter in interface Pipe

Parameters:

clazz - the class or interface.

Returns:

the found filter or null.

getNextFilter

public Filter getNextFilter(int index,
                            Class clazz)

Description copied from interface: Pipe

Gets the next registered filter of the specified class following the given location. The filter in the given location is included in the search.

Specified by:

getNextFilter in interface Pipe

Parameters:

index - the index of the location.

clazz - the class or interface.

Returns:

the found filter or null.

getPreviousFilter

public Filter getPreviousFilter(int index,
                                Class clazz)

Description copied from interface: Pipe

Gets the previous registered filter of the specified class preceding the given location. The filter in the given location is included in the search.

Specified by:

getPreviousFilter in interface Pipe

Parameters:

index - the index of the location.

clazz - the class or interface.

Returns:

the found filter or null.

isNamedFilterOpen

public boolean isNamedFilterOpen(ObjectName filter)

Description copied from interface: Pipe

Checks whether the named filter is open.

Specified by:

isNamedFilterOpen in interface Pipe

Parameters:

filter - the object name of the filter.

Returns:

true if open, false otherwise.

isNamedFilterOpen

public boolean isNamedFilterOpen(ObjectName filter,
                                 int index)

Description copied from interface: Pipe

Checks whether the indexed filter is open.

Specified by:

isNamedFilterOpen in interface Pipe

Parameters:

filter - the object name of the filter.

index - the start index of the location.

Returns:

true if open, false otherwise.

openNamedFilter

public void openNamedFilter(ObjectName filter)

Description copied from interface: Pipe

Opens the named filter.

Specified by:

openNamedFilter in interface Pipe

Parameters:

filter - the object name of the filter.

closeNamedFilter

public void closeNamedFilter(ObjectName filter)

Description copied from interface: Pipe

Closes the named filter.

Specified by:

closeNamedFilter in interface Pipe

Parameters:

filter - the object name of the filter.

openNamedFilter

public void openNamedFilter(ObjectName filter,
                            int index)

Description copied from interface: Pipe

Opens the indexed filter.

Specified by:

openNamedFilter in interface Pipe

Parameters:

filter - the object name of the filter.

index - the start index of the location.

closeNamedFilter

public void closeNamedFilter(ObjectName filter,
                             int index)

Description copied from interface: Pipe

Closes the indexed filter.

Specified by:

closeNamedFilter in interface Pipe

Parameters:

filter - the object name of the filter.

index - the start index of the location.

doFilter

public void doFilter(ServletRequest request,
                     ServletResponse response,
                     FilterChain chain)
              throws ServletException,
                     IOException

Description copied from interface: Pipe

Causes the specified request and response to be processed by the filters associated with this pipe, until one of these filters causes the response to be created and returned. The implementation must ensure that multiple simultaneous requests (on different threads) can be processed through the same pipe without interfering with each other's filter chain.

Note that changes to the list of filters in the pipe during one request will be effective only for forthcoming requests.

Specified by:

doFilter in interface Filter

Specified by:

doFilter in interface Pipe

Overrides:

doFilter in class DefaultFilter

Parameters:

request - the request to process.

response - the response to return.

chain - the filter chain from preceding pipes.

Throws:

ServletException - for servlet errors.

IOException - for general errors.

locate

protected int locate(ObjectName filter,
                     Object[] list,
                     int start)

Locates the specified filter in the filter list from the given location.

Parameters:

filter - the object name of the filter.

list - the list of filter references.

start - the start index of the location.

Returns:

the index of the filter or -1.

Throws:

IndexOutOfBoundsException - for an incorrect index.