Apache Struts API Documentation: Class ActionConfigMatcher

Apache Struts API

previous page next page

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.struts.config Class ActionConfigMatcher

java.lang.Object
  |
  +--org.apache.struts.config.ActionConfigMatcher

All Implemented Interfaces:: java.io.Serializable

public class ActionConfigMatcher
extends java.lang.Object
implements java.io.Serializable

Matches paths against pre-compiled wildcard expressions pulled from action configs. It uses the wildcard matcher from the Apache Cocoon project.

Since:: Struts 1.2
See Also:: Serialized Form

Inner Class Summary
`private class`	`ActionConfigMatcher.Mapping` Stores a compiled wildcard pattern and the ActionConfig it came from.

Field Summary
`private java.util.List`	`compiledPaths` The compiled paths and their associated ActionConfig's
`private static org.apache.commons.logging.Log`	`log` The logging instance
`private static WildcardHelper`	`wildcard` Handles all wildcard pattern matching.

Constructor Summary
`ActionConfigMatcher(ActionConfig[] configs)` Finds and precompiles the wildcard patterns from the ActionConfig "path" attributes.

Method Summary
`protected ActionConfig`	`convertActionConfig(java.lang.String path, ActionConfig orig, java.util.Map vars)` Clones the ActionConfig and its children, replacing various properties with the values of the wildcard-matched strings.
`protected java.lang.String`	`convertParam(java.lang.String val, java.util.Map vars)` Inserts into a value wildcard-matched strings where specified.
`ActionConfig`	`match(java.lang.String path)` Matches the path against the compiled wildcard patterns.

Methods inherited from class java.lang.Object

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

Field Detail

log

private static final org.apache.commons.logging.Log log

The logging instance

wildcard

private static final WildcardHelper wildcard

Handles all wildcard pattern matching.

compiledPaths

private java.util.List compiledPaths

The compiled paths and their associated ActionConfig's

Constructor Detail

ActionConfigMatcher

public ActionConfigMatcher(ActionConfig[] configs)

Finds and precompiles the wildcard patterns from the ActionConfig "path" attributes. ActionConfig's will be evaluated in the order they exist in the Struts config file. Only paths that actually contain a wildcard will be compiled.

Parameters:: configs - An array of ActionConfig's to process

Method Detail

match

public ActionConfig match(java.lang.String path)

Matches the path against the compiled wildcard patterns.

Parameters:: path - The portion of the request URI for selecting a config.
Returns:: The action config if matched, else null

convertActionConfig

protected ActionConfig convertActionConfig(java.lang.String path,
                                           ActionConfig orig,
                                           java.util.Map vars)

Clones the ActionConfig and its children, replacing various properties with the values of the wildcard-matched strings.

Parameters:: path - The requested path; orig - The original ActionConfig; vars - A Map of wildcard-matched strings
Returns:: A cloned ActionConfig with appropriate properties replaced with wildcard-matched values

convertParam

protected java.lang.String convertParam(java.lang.String val,
                                        java.util.Map vars)

Inserts into a value wildcard-matched strings where specified.

Parameters:: val - The value to convert; vars - A Map of wildcard-matched strings
Returns:: The new value