Custom WildFly JBossWeb Valve: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 20: Line 20:


     <valve name="Global Valve"  
     <valve name="Global Valve"  
               module="io.novaordis.playground.jboss.wildfly.global-jbossweb-valve"  
               module="io.novaordis.playground.jboss.jbossweb.global-jbossweb-valve"  
               class-name="io.novaordis.playground.jboss.wildfly.jbossweb.valve.GlobalValve">
               class-name="io.novaordis.playground.jboss.jbossweb.valve.GlobalValve">
         <param param-name="someConfigurationParameter" param-value="some value"/>
         <param param-name="someConfigurationParameter" param-value="some value"/>
     </valve>
     </valve>

Revision as of 00:12, 28 February 2017

Internal

Overview

This article explains how to write and deploy a custom Tomcat valve into WildFly/EAP JBossWeb runtime. For details on how to write and deploy a custom Tomcat valve into a Tomcat container, see

Custom Tomcat Valve

A custom valve can be deployed globally as part of the JBossWeb Engine's request processing pipeline, or embedded with an application, part of the Context's request processing pipeline. If the valve is deployed globally, it must be declared in standalone.xml/domain.xml, as described in "Global Valve" section. If the valve is embedded with the application, it must be declared in jboss-web.xml, as described in "Context Valve" section.

Global Valve

A global valve is declared in standalone.xml as follows:

<subsystem xmlns="urn:jboss:domain:web:2.2" default-virtual-server="default-host" ...>
    <connector .../>

    <virtual-server name="default-host" ...>
       ...
    </virtual-server>

    <valve name="Global Valve" 
               module="io.novaordis.playground.jboss.jbossweb.global-jbossweb-valve" 
               class-name="io.novaordis.playground.jboss.jbossweb.valve.GlobalValve">
        <param param-name="someConfigurationParameter" param-value="some value"/>
    </valve>
</subsystem>

The valve code must be deployed as part of a JBoss module with the following dependencies in its module.xml:

<dependencies>
   <module name="org.slf4j"/>
   <module name="javax.api"/>
   <module name="javax.servlet.api"/>
</dependencies>

Code:

https://github.com/NovaOrdis/playground/tree/master/jboss/jbossweb/global-jbossweb-valve

Context Valve