How does the Coherence*Web Installer instrument my Java EE application?

This section contains information about the Coherence Web Installer installation process.

Error formatting macro: toc: java.lang.NullPointerException

Inspect

During the inspect process, the Coherence*Web Installer performs the following tasks:

  1. Generate a template coherence-web.xml configuration file that contains basic information about the application and target container along with a set of default Coherence*Web configuration context parameters.
  2. Enumerate the JSPs from each web application in the target Java EE application and add information about each JSP to the coherence-web.xml configuration file.

Install

During the install process, the Coherence*Web Installer performs the following tasks:

  1. Create a backup of the original Java EE application so that it can be restored during the uninstall process.
  2. Add the Coherence*Web configuration context parameters generated in step (1) of the inspect process to the web.xml descriptor of each web application contained in the target Java EE application.
  3. Register a Coherence*Web ServletContextListener in each web.xml descriptor and unregister any application-specific ServletContextListener instances. At runtime, the Coherence*Web ServletContextListener will propagate each ServletContextEvent to each application-specific ServletContextListener.
  4. Register a Coherence*Web ServletContextAttributeListener in each web.xml descriptor and unregister any application-specific ServletContextAttributeListener instances. At runtime, the Coherence*Web ServletContextAttributeListener will propagate each ServletContextAttributeEvent to each application-specific ServletContextAttributeListener.
  5. Wrap each application-specific Servlet declared in each web.xml descriptor with a Coherence*Web SessionServlet. At runtime, each Coherence*Web SessionServlet will delegate to the wrapped Servlet.
  6. Add the following directive to each JSP enumerated in step (2) of the inspect process:<%@ page extends="com.tangosol.coherence.servlet.api22.JspServlet"%>

Uninstall

During the uninstall process, the Coherence*Web Installer performs the following task:

  1. Replace the instrumented Java EE application with the backup of the original version created in step (1) of the install process.