Red Hat Application Server, Manual

Page: 104 / 296

96 Chapter 8. Developing Entity Beans
Thus, for each type of database (and more precisely for each JDBC driver), the corresponding map-
per must be specified in the DataSource. This is the purpose of the
datasource.mapper
prop-
erty of the DataSource properties file. Note that all JOnAS-provided DataSource properties files (in
$JONAS_ROOT/conf
) already contain this property with the correct mapper.
For the JORM database mapper
datasource.mapper
, the possible values are:
• rdb
: generic mapper (JDBC standard driver ...)
• rdb.firebird
: Firebird
• rdb.mckoi
: McKoi DB
• rdb.mysql
: MySQL
•
rdb.oracle8
: Oracle 8 and lesser versions
• rdb.oracle
: Oracle 9
•
rdb.postgres
: PostgreSQL (version 7.2 or greater)
• rdb.sapdb
: SAP DB
• rdb.sqlserver
: MS SQL Server
• rdb.sybase
: Sybase
Contact the JOnAS team (jonas-team@objectweb.org) to obtain a mapper for other databases.
The container code generated at deployment (GenIC or EJB-JAR Ant task) is dependent on this map-
per. It is possible to deploy (generate container code) a bean for several mappers in order to change
the database (that is, the DataSource file) without redeploying the bean. These mappers should be
specified as the mappernames argument of the GenIC command or as the mappernames attribute of
the JOnAS ANT EJB-JAR task. The value is a comma-separated list of mapper names for which the
container classes will be generated. This list of mapper names corresponds to the list of potential
databases upon which you can deploy your Entity Beans. For example, to deploy Entity Beans so that
they can be used on either Oracle or PostgreSQL, run GenIC as:
GenIC -mappernames rdb.oracle,rdb.postgres eb.jar
The following is the same example in an Ant
build.xml
file:
D
target name="deploy"
description="Build and deploy the ejb-jars"
depends="compile
E
D
ejbjar naming="directory"
....
....
D
jonas destdir="${ejbjars.dir}"
jonasroot="${jonas.root}"
orb="${orb}"
jarsuffix=".jar"
secpropag="yes"
keepgenerated="true"
mappernames="${mapper.names}"
additionalargs="${genicargs}"
E
D
/jonas
E
...
...
D
/ejbjar
E
D
/target
E
that have the following in
build.properties
: