JBoss.org Community Documentation
The jbosscmp-jdbc.xml
descriptor is used to control the behavior of the JBoss engine. This can be done globally through the conf/standardjbosscmp-jdbc.xml
descriptor found in the server configuration file set, or per EJB JAR deployment via a META-INF/jbosscmp-jdbc.xml
descriptor.
The DTD for the jbosscmp-jdbc.xml
descriptor can be found in JBOSS_DIST/docs/dtd/jbosscmp-jdbc_4_0.dtd
. The public doctype for this DTD is:
<!DOCTYPE jbosscmp-jdbc PUBLIC "-//JBoss//DTD JBOSSCMP-JDBC 4.0//EN" "http://www.jboss.org/j2ee/dtd/jbosscmp-jdbc_4_0.dtd">
The top level elements are shown in Figure 12.2, “The jbosscmp-jdbc content model.”.
defaults : The defaults section allows for the specification of default behavior/settings for behavior that controls entity beans. Use of this section simplifies the amount of information needed for the common behaviors found in the entity beans section. See Section 12.12, “Defaults” for the details of the defaults content.
enterprise-beans
: The enterprise-beans
element allows for customization of entity beans defined in the ejb-jar.xml
enterprise-beans
descriptor. This is described in detail in Section 12.3, “Entity Beans”.
relationships
: The relationships
element allows for the customization of tables and the loading behavior of entity relationships. This is described in detail in Section 12.5, “Container Managed Relationships”.
dependent-value-classes
: The dependent-value-classes
element allows for the customization of the mapping of dependent value classes to tables. Dependent value classes are described in detail in Section 12.4.5, “Dependent Value Classes (DVCs)” (DVCs).
type-mappings
: The type-mappings
element defines the Java to SQL type mappings for a database, along with SQL templates, and function mappings. This is described in detail in Section 12.13, “Datasource Customization”.
entity-commands
: The entity-commands
element allows for the definition of the entity creation command instances that know how to create an entity instance in a persistent store. This is described in detail in Section 12.11, “Entity Commands and Primary Key Generation”.
user-type-mappings
: The user-type-mappings
elements defines a mapping of a user types to a column using a mapper class. A mapper is like a mediator. When storing, it takes an instance of the user type and translates it to a column value. When loading, it takes a column value and translates it to an instance of the user type. Details of the user type mappings are described in Section 12.13.4, “User Type Mappings”.
reserved-words
: The reserved-words
element defines one or more reserved words that should be escaped when generating tables. Each reserved word is specified as the content of a word
element.