Servlet context listener

The Orbeon Forms Servlet Context Listener allows configuring one processor to be called when the Servlet context is initialized, and one to be called when the Servlet context is destroyed. These processors are looked up in the following locations, in this order:

1. properties-local.xml:

   <properties>
       <!-- Other properties-->
       ...
       <!-- Servlet Context Listener properties-->
       <property as="xs:QName" name="oxf.context-initialized-processor.name" value="oxf:pipeline"/>
       <property as="xs:anyURI" name="oxf.context-initialized-processor.input.config" value="oxf:/context/context-initialized.xpl"/>
       <property as="xs:QName" name="oxf.context-destroyed-processor.name" value="oxf:pipeline"/>
       <property as="xs:anyURI" name="oxf.context-destroyed-processor.input.config" value="oxf:/context/context-destroyed.xpl"/>
   </properties>
   

2. Context parameters in web.xml:

   <context-param>
       <param-name>oxf.context-initialized-processor.name</param-name>
       <param-value>{http://www.orbeon.com/oxf/processors}pipeline</param-value>
   </context-param>
   

   <context-param>
       <param-name>oxf.context-initialized-processor.input.config</param-name>
       <param-value>oxf:/context/context-initialized.xpl</param-value>
   </context-param>
   

   <context-param>
       <param-name>oxf.context-destroyed-processor.name</param-name>
       <param-value>{http://www.orbeon.com/oxf/processors}pipeline</param-value>
   </context-param>
   

   <context-param>
       <param-name>oxf.context-destroyed-processor.input.config</param-name>
       <param-value>oxf:/context/context-destroyed.xpl</param-value>
   </context-param>
   

Not every processor can be run from those pipelines, because the execution context is limited. In particular, you can't call processors like the Request generator or the HTTP serializer. You do however have access to the Application context.

For the Orbeon Forms Servlet Context Listener to be called, you need to configure the following listener in your web.xml:

<listener>
    <listener-class>org.orbeon.oxf.webapp.OrbeonServletContextListener</listener-class>
</listener>

The Servlet Context Listener logs its actions at level info. This can be controlled in log4j.xml:

<category name="org.orbeon.oxf.webapp.OrbeonServletContextListener">
    <priority value="info"/>
</category>

Session listener

The Orbeon Forms Session Listener allows configuring one processor to be called when the Session is created, and one to be called when the Session is destroyed. These processors are looked up in the following locations, in this order:

1. properties-local.xml:

   <properties>
       <!-- Other properties-->
       ...
       <!-- Session Listener properties-->
       <property as="xs:QName" name="oxf.session-created-processor.name" value="oxf:pipeline"/>
       <property as="xs:anyURI" name="oxf.session-created-processor.input.config" value="oxf:/context/session-created.xpl"/>
       <property as="xs:QName" name="oxf.session-destroyed-processor.name" value="oxf:pipeline"/>
       <property as="xs:anyURI" name="oxf.session-destroyed-processor.input.config" value="oxf:/context/session-destroyed.xpl"/>
   </properties>
   

2. Context parameters in web.xml:

   <context-param>
       <param-name>oxf.session-created-processor.name</param-name>
       <param-value>oxf:pipeline</param-value>
   </context-param>
   

   <context-param >
       <param-name>oxf.session-created-processor.input.config</param-name>
       <param-value>oxf:/context/session-created.xpl</param-value>
   </context-param>
   

   <context-param>
       <param-name>oxf.session-destroyed-processor.name</param-name>
       <param-value>oxf:pipeline</param-value>
   </context-param>
   

   <context-param>
       <param-name>oxf.session-destroyed-processor.input.config</param-name>
       <param-value>oxf:/context/session-destroyed.xpl</param-value>
   </context-param>
   

Not every processor can be run from those pipelines, because the execution context is limited. In particular, you can't call processors like the Request generator, or any HTTP serializers. You have access to the Application and Session contexts.

For the Orbeon Forms Session Listener to be called, you need to configure the following listener in your web.xml:

<listener>
    <listener-class>org.orbeon.oxf.webapp.OrbeonSessionListener</listener-class>
</listener>

The Session Listener logs its actions at level info. This can be controlled in log4j.xml:

<category name="org.orbeon.oxf.webapp.OrbeonSessionListener">
    <priority value="info"/>
</category>