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:
- 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.
- 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:
- Create a backup of the original Java EE application so that it can be restored during the uninstall process.
- 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.
- 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.
- 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.
- 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.
- 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:
- Replace the instrumented Java EE application with the backup of the original version created in step (1) of the install process.