Appendix C
Working from the Subversion Repository
Credits: this appendix is an adaptation of a document written
and volunteered by JMatter user "pyramid"
C.1 Checking out the code
The JMatter subversion repository is located at http://svn.jmatter.org/.
Checking out the code from the HEAD of the repository:
-
svn checkout http://svn.jmatter.org/jmatter-complet/trunk jmatter-complet
To check out a specific release, look for the specific release tag
name at:
-
http://svn.jmatter.org/jmatter-complet/tags/
Then issue the checkout command, as illustrated by this example:
-
svn checkout http://svn.jmatter.org/jmatter-complet/tags/Release-20060825
jm_20060825release
C.2 Directory Structure, Compiling, Running demo applications
The base directory is divided into two principal sections: the framework
itself (located in directory jmatter) and the demo applications
(located in demo-apps): ContactMgr, MyTunes, Sympster, MovieLib,
and IssueMgr.
To build the framework jar file dist/jmatter.jar, invoke:
-
cd jmatter
ant
To run a demo application, say the ContactMgr demo application:
-
cd demo-apps/ContactMgr
and schema-export
ant run
Every demo application is built and run this way. These instructions
are in accordance with the way any JMatter project is compiled and
run.
All the demo applications should be preconfigured to use a local,
file-based H2 database. If per chance it is not, then simply edit
the file resources/hibernate.properties. This file lists sample
connection information for a variety of databases, including hsql,
H2, postgresql, MySQL, and OracleXE. Uncomment the one you want and
make sure the jdbc url and credentials are valid and you're ready
to go.
To automate the manual step of exporting your schema, add this hibernate
property:
-
hibernate.hbm2ddl.auto=create