Package org.apache.catalina.valves.rewrite

Interface RewriteMap

public interface RewriteMap

Interface for user defined lookup/replacement logic that can be defined in a rewrite.config file by a RewriteMap directive. Such a map can then be used by a RewriteRule defined in the same file.

An example rewrite.config file could look like:

 RewriteMap uc example.UpperCaseMap

 RewriteRule ^/(.*)$ ${uc:$1}
 

One parameter can be optionally appended to the RewriteMap directive. This could be used – for example – to specify a name of a file, that contains a lookup table used by the implementation of the map.

Method Summary

Modifier and Type	Method	Description
java.lang.String	lookup(java.lang.String key)	Maps a key to a replacement value. The method is free to return null to indicate, that the default value from the RewriteRule directive should be used.
java.lang.String	setParameters(java.lang.String params)	Optional parameter that can be defined through the RewriteMap directive in the rewrite.config file.

Method Detail

setParameters

java.lang.String setParameters(java.lang.String params)

Optional parameter that can be defined through the RewriteMap directive in the rewrite.config file.

Parameters:

params - the optional parameter

Returns:

value is currently ignored

lookup

java.lang.String lookup(java.lang.String key)

Maps a key to a replacement value.
The method is free to return null to indicate, that the default value from the RewriteRule directive should be used.

Parameters:

key - used by the actual implementation to generate a mapped value

Returns:

mapped value or null