[Tm4j-developers] Hibernate/JDBC back-end

[Kal A. <ka...@te...>]

Hi,

I've just checked in the first set of files for a new back-end for TM4J. =
This=20
back-end persists topic map data in an RDBMS using JDBC and an O-R mappin=
g=20
tool called Hibernate [1].

The files checked in consist of the implementation of the basic topic map=
=20
objects and factories. There are some methods of these classes that are n=
ot=20
yet implemented and object deletion is not yet implemented. In addition, =
the=20
indexes and index manager are not yet implemented either.

If you want to play with this back-end, you will need to create a=20
build.properties file (in the top-level TM4J directory) with the followin=
g=20
properties set:


tm4j.jdbc.driver=3D[ full class name of the JDBC driver to use ]
tm4j.jdbc.database=3D[ JDBC connection URL for the database to use ]
tm4j.jdbc.username=3D[ User name for connection to the database ]
tm4j.jdbc.password=3D[ Password for connection to the database ]

The target hibernate.compile compiles the source - the database connectio=
n=20
details are not needed for this step

The target hibernate.install-mappings copies the XML O-R mapping files=20
(*.hbm.xml) to the classes directory so that they can be found by the=20
application at run-time.

The target hibernate.initdb will create the necessary tables and views in=
 the=20
target database. If invoked again on the same database, the existing tabl=
es=20
and views get dropped - so take care!!=20

The target hibernate.test runs a set of unit tests which cover most of wh=
at=20
has been implemented so far. Note that the target hibernate.test always=20
invokes hibernate.initdb (to ensure that the database starts from a clean=
=20
state), so keep the test database separate from any data you care about.

** IMPORTANT MESSAGE **
There are no guaruntees that the database schema will not have to change=20
between now and release 0.8.0, so don't commit any important data to this=
=20
back-end.
** END IMPORTANT MESSAGE **

I have yet to do any perf. or scalability testing on this back-end. If an=
yone=20
would like to do so, I would be very interested to hear the results.

Cheers,

Kal

[1] http://hibernate.sourceforge.net/

--=20
Kal Ahmed, techquila.com
XML and Topic Map Consultancy

e: ka...@te...
p: +44 7968 529531
w: www.techquila.com