org.apache.commons.chain.web.servlet

Class PathInfoMapper

java.lang.Object

org.apache.commons.chain.generic.LookupCommand

org.apache.commons.chain.web.servlet.PathInfoMapper

All Implemented Interfaces:

Command, Filter

public class PathInfoMapper
extends LookupCommand
implements Command

Command that uses the "path info" component of the request URI to select a Command from the appropriate Catalog, and execute it. To use this command, you would typically map an instance of ChainProcessor to a wildcard pattern like "/execute/*" and then arrange that this is the default command to be executed. In such an environment, a request for the context-relative URI "/execute/foo" would cause the "/foo" command to be loaded and executed.

Author:

Craig R. McClanahan

Field Summary

Fields inherited from interface org.apache.commons.chain.Command

CONTINUE_PROCESSING, PROCESSING_COMPLETE

Constructor Summary

Constructors

Constructor and Description
PathInfoMapper()

Method Summary

Modifier and Type	Method and Description
protected Catalog	getCatalog(Context context) Return the Catalog to look up the Command in.
String	getCatalogKey() Deprecated. Use catalogName to specify the name of the catalog in the catalog factory
protected String	getCommandName(Context context) Look up the extra path information for this request, and use it to select an appropriate Command to be executed.
void	setCatalogKey(String catalogKey) Deprecated. Use catalogName to specify the name of the catalog in the catalog factory

Methods inherited from class org.apache.commons.chain.generic.LookupCommand

execute, getCatalogFactory, getCatalogName, getCommand, getName, getNameKey, isIgnoreExecuteResult, isIgnorePostprocessResult, isOptional, postprocess, setCatalogFactory, setCatalogName, setIgnoreExecuteResult, setIgnorePostprocessResult, setName, setNameKey, setOptional

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.commons.chain.Command

execute

Constructor Detail

PathInfoMapper

public PathInfoMapper()

Method Detail

getCatalogKey

public String getCatalogKey()

Deprecated. Use catalogName to specify the name of the catalog in the catalog factory

Return the context key under which our Catalog has been stored.

Returns:

The context key for the Catalog.

setCatalogKey

public void setCatalogKey(String catalogKey)

Deprecated. Use catalogName to specify the name of the catalog in the catalog factory

Set the context key under which our Catalog has been stored.

Parameters:

catalogKey - The new catalog key

getCommandName

protected String getCommandName(Context context)

Look up the extra path information for this request, and use it to select an appropriate Command to be executed.

Overrides:

getCommandName in class LookupCommand

Parameters:

context - Context for the current request

Returns:

The name of the Command instance

Since:

Chain 1.2

getCatalog

protected Catalog getCatalog(Context context)

Return the Catalog to look up the Command in.

Overrides:

getCatalog in class LookupCommand

Parameters:

context - Context for this request

Returns:

The catalog.

Throws:

IllegalArgumentException - if no Catalog can be found

Since:

Chain 1.2