Using EventWeb Servlets

EventWeb was developed with Java servlets in mind. It allows a live data connection to the applications running in a J2EE servlet and/or EJB environment.

It is assumed that the user running EventWeb servlets is familiar with servlets, has an application server running, and understands the details of installing and running servlets in that environment. The main development and test environment for EventWeb servlets is Tomcat version 5.5, but it should be compatible with any servlet engine.

The servlet classes are in lib/eventweb, and the source files are in Source/EvwServ/eventweb. There are also two war files that may save some work deploying the demos. These are in the bin directory.

The Backchannel Tester War File

EvwTest.war bundles up the files needed to run SimpleBcTestSrvc as a servlet. The web files (html, JavaScript, css) needed to run the test are included in the war. (There's only a couple files, so the extra overhead doesn't cost much in the cases where they're not needed.)

On tomcat with the built in http server, this provides everything you need to run the test. (But we don't guarantee this for every configuration.)

The EvwDemos War File

EvwDemos.war bundles up the server side files for the demos, but does not include the web files. This was done because we expect most implementations will server the web files from a separate web server that has hooks to the application server, and we didn't want to include a lot of unneeded files. There is an optional task in the BuildWarFiles.xml build file that will add the web files if you want them. You can run "ant -f BuildWarFiles.xml AddDemosHtml" to add the files.

The EvwDemos.war file works as is on our Linux test system, (Ubuntu 8.04, Tomcat 5.5, Apache 2.2). On our Windows test system, (Windows 2000, Tomcat 4.1, Apache 1.3), we have to fix the file paths in RqstRouterServlet.ini. Other environments are likely to need adjustments as well. However, it should be helpful when deciding how to configure the demos, and you can use it as a starting point for your configuration.

V0.1.1  08/12/09  swt