PRODUCTS AND SERVICES INDUSTRIES SUPPORT PARTNERS COMMUNITIES ABOUT
  Coherence FAQ
  How does the Coherence*Web Installer instrument my Java EE application?
Added by Rob Misek, last edited by Tom Pfaeffle on Aug 14, 2008  (view change)

Labels

 

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

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.