(Please enable word-wrap when viewing this file)

This is the readme for the JIDE Common Layer Open Source Project.

Contents

The contents of the distributions are:

build.properties
build.xml
docs                        the Developer Guide
examples                    examples for JIDE Common Layer (contains only a README file to redirect you to JIDE product demo)
libs                        external jars used by JIDE Common Layer
LICENSE.txt                 the license statement
oss-test-project            the test project based on Maven
pom.xml                     the config file for Maven
properties                  localized properties files
README.txt                  this file
src                         the source code
test                        the test classes  
JIDE Common Layer.iml       the module file for IntelliJ IDEA
JIDE Common Layer.ipr       the JIDE Common Layer project for IntelliJ IDEA

Build

We have migrated our code base from java.net to github, and changed our build method to Maven. We suggest you to build JIDE Common Layer project by Maven too. However the ant way to build the project is still available.

Build using Maven

Assuming you have JDK6+ installed. JDK5 may not work because we used JDK6 only methods in the source code. Please also install Maven from http://maven.apache.org/download.html. After installation you should add a system environment variable M2_HOME which link to where Maven been installed, and add the %M2_HOME%\bin to PATH environment variable as well.

Finally, you come to the JIDE Common Layer directory, use Maven command to compile and package the project. mvn compile compile the source, classes output to directory "target/classes" mvn clean clean previous build mvn package compile the source and package jars to sub directory "target"

Build using Ant

You can use your favorite Java IDE to build this project. But to make it easy, we provided ant script (build.xml) to build the project. You can download ant from http://ant.apache.org/. Once you install it, you can run "ant" or "ant dist"

to build the whole source code and produce the jar file you need for your application.

All available targets in build.xml are:

init clean compile jar javadoc source dist (default)

Configure Your Own POM

If you just want to use JIDE Common Layer in your project which used Maven, you don't need to build the project unless you modified it locally. All you need to do is to add the following dependency to your pom.xml.

You can specify different versions if you want to use that version. You can find all available version numbers at http://search.maven.org by searching jide-oss.