4.4. Configure a Web Application to use a Valve
- The valve must be created and included in your application's classpath. This can be done by either including it in the application's WAR file or any module that is added as a dependency. Examples of such modules include a static module installed on the server or a JAR file in the
lib/directory of an EAR archive if the WAR is deployed in an EAR.
- The application must include a
Procedure 4.1. Configure an application for a local valve
Add Valve elementAdd a valve element with the attributes of name and class-name to the application's
jboss-web.xmlfile. Name is a unique identifier for the valve and class-name is the name of the valve class.
<valve name="VALVENAME" class-name="VALVECLASSNAME"> </valve>
Specific ParametersIf the valve has configurable parameters, add a
paramchild element to the valve element for each parameter, specifying the name and value for each.
<param name="PARAMNAME" value = "VALUE" />
Example 4.1. jboss-web.xml valve configuration
<valve name="clientlimiter" class-name="org.jboss.samplevalves.restrictedUserAgentsValve"> <param name="restricteduseragents" value = "^.*MS Web Services Client Protocol.*$" /> </valve>