XX Installation

 

XX Framework

 

The XX framework is distributed as a J2EE War file. The file contains the binary, source, and dependency libs.
The XX framework is contained in the XX.jar file in the WEB-INF/lib directory. Additional direct and indirect dependencies are also contained in that directory. Optional XML and XSL files are provided in the WEB-INF/xml directory. The optional files are necessary to the the CRUD capabilities of the framework.

 

Guestbook Demo

The demo is distributed as a J2EE War file. The file contains the binary, source, sample database,and dependency libs.

  1. Make sure a servlet container and database server are available and installed. The demo was developed using Tomcat 4.1 and Mysql 4.
  2. To install, auto deploy the war to your servlet container, or unpack the directory structure and configure the application.
  3. Modify the "xmlpath" environment variable (<env-entry>) in the application's web.xml files. This path should point to the WEB-INF/xml directory of the application.
  4. Modify the hibernate configuration information to match the database server you are using. The hibernate configuration file is located at WEB-INF/classes/org/xxframework/website/entity. At a minimum, the following variables may need to be changed. -connection.url
    -connection.username
    -connection.password
    -connection.driver_class
  5. Create the database structure using the included guestbook.sql ddl. For Mysql, use the restore functionality.
  6. Assigned the appropriate database permissions to the user name specified in the hibernate configuration file.
  7. Start up the server and load the application home page at http://localhost:8080/guestbook/Home

 

 

 

Pet Store Demo

The demo is distributed as a J2EE War file. The file contains the binary, source, sample database,and dependency libs.

  1. Make sure a servlet container and database server are available and installed. The demo was developed using Tomcat 4.1 and Mysql 4.
  2. To install, auto deploy the war to your servlet container, or unpack the directory structure and configure the application.
  3. Modify the "xmlpath" environment variable (<env-entry>) in the application's web.xml files. This path should point to the WEB-INF/xml directory of the application.
  4. Modify the hibernate configuration information to match the database server you are using. The hibernate configuration file is located at WEB-INF/classes/org/xxframework/website/entity. At a minimum, the following variables may need to be changed.
    -connection.url
    -connection.username
    -connection.password
    -connection.driver_class
  5. Create the database structure using the included petstore.sql ddl. For Mysql, use the restore functionality.
  6. Assigned the appropriate database permissions to the user name specified in the hibernate configuration file.
  7. Start up the server and load the application home page at
    http://localhost:8080/petstore/home

 

Required Java libraries

 

XX Foundation Requirements

Library

Version

File

XX Framework Library

1.1

xx.jar

Xalan

2.4.0 or equivalent

xalan.jar

Xerces

2.4.0 or equivalent

xercesImpl.jar

dom4j

1.4 or equivalent

Dom4j-1.4.jar

xml-apis.jar

 

xml-apis.jar

 

XX Automation Requirements

Library Version File

Castor

1.0.1 or equivalent

castor-1.0.1-xml.jar

Hibernate
Library files

See below

2.1.7 (note: Hibernate 3.X is not currently supported).

MySQL

Required for Mysql connection in sample application database

mysql-connector-Java-3.1.10-bin.jar

 

The following files are part of the Hibernate distribution

ant-1.5.3.jar

ant-optional-1.5.3.jar

c3p0-0.8.4.5.jar

cglib-full-2.0.2.jar

commons-collections-2.1.1.jar

commons-dbcp-1.2.1.jar

commons-lang-1.0.1.jar

commons-logging-1.0.4.jar

commons-pool-1.2.jar

concurrent-1.3.3.jar

connector.jar

dom4j-1.4.jar

ehcache-0.9.jar

jaas.jar

jboss-cache.jar

jboss-common.jar

jboss-jmx.jar

jboss-system.jar

jcs-1.0-dev.jar

jdbc2_0-stdext.jar

jgroups-2.2.7.jar

jta.jar

junit-3.8.1.jar

log4j-1.2.8.jar

odmg-3.0.jar

oscache-2.0.jar

proxool-0.8.3.jar

swarmcache-1.0rc2.jar

xalan-2.4.0.jar

xerces-2.4.0.jar

xml-apis.jar

 

 

XSL Libraries

The following are not absoute requirements for using the framework but comprise commonly used functions that can be included in the application's XSL templates.


Includes.xsl

XX framework XSL Library file

makes use of the following XSL libraries.

 
lists.castor.xml Optional (Castor mapping file for XX Automation select lists)
reply.xsl Error message XSL Template
xx_getresults.xsl XSL to display record detail.Should be elaborated for production usage.
xx_listresults.xsl XSL to display record list.Should be elaborated for production usage.

cmp.xsl

XSLT Standard Library*

date-time.xsl

XSLT Standard Library*

example.xsl

XSLT Standard Library*

HelloWorld.xsl

XSLT Standard Library*

markup.xsl

XSLT Standard Library*

math.xsl

XSLT Standard Library*

node.xsl

XSLT Standard Library*

stdlib.xsl

XSLT Standard Library*

string.xsl

XSLT Standard Library*

svg.xsl

XSLT Standard Library*

uri.xsl

XSLT Standard Library*

 * see http://sourceforge.net/projects/xsltsl

 

 

Tested Environments

Tested Database Platforms

 

Tested Application Servers: