Jay Eckles
Menu
Home
Research
Tutorials
CGI Calendar
JERSS
  -Introduction
  -What is RSS
  -Installing
  -Using
  -Sources
  -Examples
  -History
Contact
About Jay

 

Search

JERSS Project Documentation

Installing the JERSS servlet

Before you attempt to install the JERSS servlet, make sure that you have installed and properly configured any J2EE compliant application server. Examples of such app servers include BEA WebLogic, iPlanet, Allaire JRun, or the free Jakarta-Tomcat from Apache. The application server need only provide support for the servlet 1.0 API, not necessarily support for JavaServer Pages.

Next, you need to download a couple of files:

  • JERSS.zip
    this archive includes the following files:
    • RSSViewerServlet.class and .java
    • com/exploringxml/rss/RSSChannel.class and .java
    • com/exploringxml/xml/JSArray.class and .java
    • com/exploringxml/xml/Node.class and .java
    • com/exploringxml/xml/Xparse.class, Xparse$Frag.class, and Xparse.java
    • rss.js

You'll need to decompress this archive (which was created with WinZip). Move the RSSViewerServlet.class file to wherever class files are supposed to go according to your application server. Move the com directory to the place where package class files are supposed to reside according to your application server. If you already have a com directory in that location, move the contents of the JERSS com directory into your existing com directory. Move the rss.js file to the location where you store included Javascript source files on your web server; some people have a common directory for included source files (I use a directory called js). If you don't have a standard place for storing included Javascript source files, just store it in the root of your web directory. If other steps are required by your application server to deploy a servlet, perform those steps now.

That's pretty much it. Java servlets are cross-platform compatible, so you don't have to recompile them. However, since the software is distributed under the GPL, I do make the source available with the distribution. If you think it's beneficial for you to recompile the java source, feel free to do so. You're also free to modify the source. If you do, let me know; I'd love to know what improvements you make!

If you have any questions or would like to contact me for any reason, please email me at j.eckles@computer.org.