EQUIP2 WebApp Index

Chris Greenhalgh, 2007-01-29; last updated 2007-10-24

Introduction

This CVS module houses templates, documentation and samples for using EQUIP2 in Web applications based on J2EE & Spring Framework.

The top-level directory (../) contains Java source and JSPs which are generally useful in EQUIP2 web applications, currently:

See build instructions, below.

The samples directory contains:

More documentation

Minimal web application:

Tutorial documents

General/overview documents:
General J2EE/Spring:
EQUIP2:
Application example (includes use of EQUIP2):
... [more to follow]

Source

This CVS module houses templates, documentation and samples for using EQUIP2 in Web applications based on J2EE & Spring Framework.

The top-level directory (../) contains Java source and JSPs which are generally useful in EQUIP2 web applications, currently:

NB: Normally the dependencies should include a pre-built version of these common controllers & jsps (equip2webdb.jar & equip2webdb_jsp.jar) and you can go straight to building a web application.

Getting EQUIP2 WebApp

EQUIP2 webapp is in the EQUIP sourceforge CVS accessible as:

CVSROOT: :pserver:anonymous@equip.cvs.sourceforge.net:/cvsroot/equip
Module: equip2webapp

It is licensed under the (so-called) new or modified BSD Open Source license.

EQUIP2 itself is in the same repository in the module 'equip2'. The dependencies are in the same repository in the module 'dependencies'.

Snapshots should be available from the project download page.

Preparation

Download and install/unpack the dependencies from the dependencies module (see previous section). The default installation expects these to be in the directory ../dependencies/lib (as configured in build.properties).

Alternatively you may assemble the dependencies directly (e.g. if you require more recent versions):

Java SDK 1.5+ and Apache Ant are required. 

In addition you may require Apache Xalan, although in theory the XSL support in Java 1.5+ should be sufficient (but we have had occasional problems).

The documentation and build files currently assume that you are using:

If you want to use another database and/or J2EE container then you will need to make changes as appropriate to build and configuration files.

Building

To compile the common support library:

  1. edit ../build.properties to reflect
    1. the location of the dependencies (dependencies.dir)
    2. if required (i.e. JDK XSL doesn't work) the location of Xalan (xalanhome).
  2. if you are using a different version of the external dependencies (Spring, Hibernate, etc.) then you may need to change the classpath(s) in build.xml, especially classpath_equip2spring
  3. build dist/equip2webdb.jar & dist/equip2webdb_jsp.jar (the JSPs for the web database interface):
    > ant
  4. Copy these into the common dependencies directory (assuming you want to replace whichever version(s) were there). Otherwise you need not have bothered :-)
Now move on to the the minimal and/or tutorial web applications...

Changes

2007-01-29
2007-02-02
2007-02-06
2007-06-12
2007-10-24
2007-10-25