FilterMappingFilter

The FilterMappingFilter can set up conditional filter chains, which is very useful if path mapping alone is insufficient.

Classname

ch::nevis::isiweb4::filter::mapping::FilterMappingFilter

Library

libMappingFilters.so.1

Configuration

FilterRules

Type: Newline separated list of conditions and filter names
Usage Constraints: required, conditional
Supported pragmas: break

Map a fixed filter chain conditional based on headers, parameters, attributes and environment variables.

Syntax:

Condition:[<SOURCE>]:<VARIABLE>:<expression>
<filter-name>

Samples

Condition:HEADER:Foo:.*anything.*
aFilterName 
Condition:HEADER:Foo:.*other.*
aFilterName anotherFilter

Example

This filter will call LuaFilter2 if the condition doesn't match. If the condition matches, LuaFilter1 will be called. The condition matches if the header "InvokeFilter" begins with Lua.

<filter>
    <filter-name>ConditionalFilterChain</filter-name>
    <filter-class>ch::nevis::isiweb4::filter::mapping::FilterMappingFilter</filter-class>
    <filter-lib>libMappingFilters.so.1</filter-lib>

    <init-param>
        <param-name>FilterRules</param-name>
        <param-value>
            Pragma:break
            Condition:HEADER:InvokeFilter:PCRE/^Lua/
            LuaFilter1
            LuaFilter2
        </param-value>
    </init-param>
</filter>