Release @VERSION@
  

Tapestry is a component based framework for creating sophisticated web applications. It's used with existing application servers, acting as a kind of "super servlet". The Tapestry Project Page contains much more information about what Tapestry is, how to use it and why you can't live without it!

Tapestry is distributed as a single distribution, including source code, compiled frameworks, examples and documentation.

The JARs were compiled on Windows 2000 using Sun's JDK 1.2.2 compiler, however it is easy to rebuild the JARs on different platforms and different compilers (JDK 1.2 and above).

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

 Configuration
 Documentation
 Third Party Jars

.....................................................

Configuration

Tapestry is built using the Ant build tool, version 1.4 or better. You need to download and install Ant before running the Tapestry demonstrations. You will need to download the Ant optional JAR (which includes additional Ant tasks) and place it in your Ant lib folder.

Configuring and running the Virtual Library demo is very easy:

  • Download (if needed) a JDK 1.3 or newer JVM.
  • Download and configure Ant.
  • Download JBoss 2.4.3. JBoss is an open-source application server, used to run the database and Enterprise JavaBeans in the Virtual Library. The Virtual Library can only be auto-configured using the JBoss 2.4.3 distribution. It is not necessary to download the JBoss-Jetty combination; the Tapestry distribution includes Jetty and the other necessary files.
  • Create the file Tapestry/config/build.properties. This file informs Tapestry where JBoss as been installed. The directory contains a template file. Set jboss.dir to the JBoss installation directory, for example C:/JBoss-2.4.3. Note: Use only forward slashes in this file name.
  • Execute the command: ant -emacs configure run-jboss
    This will copy and configure the necessary files in the JBoss installation directory, then run the JBoss server, automatically deploying the Tapestry home page and the Virtual Library demonstration. (The -emacs option changes the Ant output format to be less verbose).

Congradulations! You are now running not only the Virtual Library, but the complete Tapestry home page. You can access it with the URL http://localhost/.

Documentation

Third party JARs

Tapestry requires some third party JARs when it is compiled, as well as at runtime. These files are are included in the distribution.

JAR file Version License Description<
com.mortbay.jetty.jar 3.1.5 Jetty License Jetty HTTP Servlet Server, see http://sourceforge.net/projects/jetty
ejb.jar from jBoss 2.2.2 LGPL EJB 1.1 , copied from the jBoss distribution, which claims to be open source (but neglects to provide a license).

This library is required to compile Tapestry and to compile and run the demos and tutorials.

javax.rmi.jar 1.0.1 Sun Microsystems, Inc. Binary Code License Agreement javax.rmi classes needed to compile for JDK 1.2.2
javax.servlet.jar 2.2 Apache Software License, Version 1.1 Servlet API 2.2 reference implementatio, distributed with Jetty
javax.xml.jaxp.jar 1.1 Sun Binary Code License Java API for XML Processing , distributed with Jetty
jcommon-0.5.6.jar 0.5.6 LGPL Part of JFreeChart, used in the Workbench tutorial.
jfreechart-0.7.4.jar 0.7.4 LGPL Part of JFreeChart, used in the Workbench tutorial.
jndi.jar 1.0.1 Sun Microsystems, Inc. Binary Code License Agreement javax.naming classes needed to compile for JDK 1.2.2
junit.jar 3.7 IBM Public License JUnit Testing Framework, see  www.junit.org
log4j-core.jar 1.1.3 Apache Software License, Version 1.1 Logging Toolkit, logging toolkit used by Tapestry framework classes. More information at the log4j home page.
mckoidb.jar 0.92 beta GPL McKoi SQL Database, Java SQL Database used for the Virtual Library demonstration.
org.apache.crimson.jar 1.1 Sun Binary Code License Sun XML Parser, Distributed with Jetty


.....................................................

Tapestry is an open source project, hosted on the SourceForge and licensed under the GNU Lesser General Public License.

 
  SourceForge Logo
©2000-2002 Howard Lewis Ship. All rights reserved.