The <javaModelGenerator> Element

The <javaModelGenerator> element is used to define properties of the Java model generator. The Java Model Generator builds primary key classes, record classes, and Query by Example classes that match the introspected table. This element is a required child element of the <ibatorContext> element.

Required Attributes

Attribute	Description
targetPackage	This is the package where the generated classes will be placed. In the default generator, the property "enableSubPackages" controls how the actual package is calculated. If true, then the calculated package will be the targetPackage plus sub packages for the table's catalog and schema if they exist. If false (the default) then the calculated package will be exactly what is specified in the targetPackage attribute. Ibator will create folders as required for the generated packages.
targetProject	This is used to specify a target project for the generated objects. When running in the Eclipse environment, this specifies the project and source folder where the objects will be saved. In other environments, this value should be an existing directory on the local file system. Ibator will not create this directory if it does not exist.

Attribute

Description

targetPackage

This is the package where the generated classes will be placed. In the default generator, the property "enableSubPackages" controls how the actual package is calculated. If true, then the calculated package will be the targetPackage plus sub packages for the table's catalog and schema if they exist. If false (the default) then the calculated package will be exactly what is specified in the targetPackage attribute. Ibator will create folders as required for the generated packages.

targetProject

This is used to specify a target project for the generated objects. When running in the Eclipse environment, this specifies the project and source folder where the objects will be saved. In other environments, this value should be an existing directory on the local file system. Ibator will not create this directory if it does not exist.

Optional Attributes

None

Child Elements

<property> (0..N)

Supported Properties

This table lists the properties of the default Java model generators that can be specified with the <property> child element:

Property Name Property Values

enableSubPackages

Property Name	Property Values
enableSubPackages	This property is used to select whether Ibator will generate different Java packages for the objects based on the catalog and schema of the introspected table. For example, suppose a table MYTABLE in schema MYSCHMA. Also suppose that the targetPackage attribute is set to "com.mycompany". If this property is true, the generated objects for the table will be placed in the package "com.mycompany.myschema". If the property is false, the generated objects will be placed in the "com.mycompany" schema. The default value is false.
rootClass	This property can be used to specify a root class for all generated Java model objects. Ibator will specify this value as the super class of the primary key object, if the table has a primary key, or the record object otherwise. This value may be overridden by specifying the `rootClass` property on a Table configuration. Important: If Ibator is able to load the root class, Ibator will not override a property in the root class that exactly matches a property that Ibator would normally generate. An exact match of a property is defined as follows Property name matches exactly Property is of the same type Property has a "getter" method Property has a "setter" method If specified, the value of this property should be a fully qualified class name (like com.mycompany.MyRootClass).
trimStrings	This property is used to select whether Ibator adds code to trim the white space from character fields returned from the database. This can be useful if your database stores data in CHAR fields rather than VARCHAR fields. When true, Ibator will insert code to trim character fields. The default value is false.

This property is used to select whether Ibator will generate different Java packages for the objects based on the catalog and schema of the introspected table.

For example, suppose a table MYTABLE in schema MYSCHMA. Also suppose that the targetPackage attribute is set to "com.mycompany". If this property is true, the generated objects for the table will be placed in the package "com.mycompany.myschema". If the property is false, the generated objects will be placed in the "com.mycompany" schema.

The default value is false.

rootClass

This property can be used to specify a root class for all generated Java model objects. Ibator will specify this value as the super class of the primary key object, if the table has a primary key, or the record object otherwise. This value may be overridden by specifying the rootClass property on a Table configuration.

Important: If Ibator is able to load the root class, Ibator will not override a property in the root class that exactly matches a property that Ibator would normally generate. An exact match of a property is defined as follows

Property name matches exactly
Property is of the same type
Property has a "getter" method
Property has a "setter" method

If specified, the value of this property should be a fully qualified class name (like com.mycompany.MyRootClass).

trimStrings

This property is used to select whether Ibator adds code to trim the white space from character fields returned from the database. This can be useful if your database stores data in CHAR fields rather than VARCHAR fields. When true, Ibator will insert code to trim character fields.

The default value is false.

Example

This element specifies that we always want to place generated classes in the "'test.model" package and that we want to use subpackages based on the table schema and catalog. We also want String columns trimmed.

<javaModelGenerator targetPackage="test.model"
     targetProject="\MyProject\src">
  <property name="enableSubPackages" value="true" />
  <property name="trimStrings" value="true" />
</javaModelGenerator>