n/a
weblogic-rdbms-jar
XML stanza
n/a
The root level element of a Weblogic RDBMS CMP deployment descriptor.
weblogic-cmp-rdbms-jar.xml
The root level element of a Weblogic RDBMS CMP deployment descriptor. The deployment descriptor contains deployment information for one or more entity beans, and an optional set of relations.
jbosscmp-jdbc
jbosscmp-jdbc.xml
n/a
weblogic-rdbms-bean
XML stanza
n/a
The root level element of a Weblogic RDBMS CMP deployment descriptor.
weblogic-rdbms-jar
weblogic-cmp-rdbms-jar.xml
This element represents a single entity bean that is managed by the WebLogic RDBMS CMP persistence type.
entity
jbosscmp-jdbc.xml
n/a
ejb-name
Valid name of an EJB.
n/a
Must match the ejb-name of the cmp entity bean defined in the ejb-jar.xml.
weblogic-rdbms-bean
weblogic-cmp-rdbms-jar.xml
The name of the bean. The contents of this element must match the ejb-name element of a cmp entity bean contained in the ejb-jar.xml descriptor file.
ejb-name
jbosscmp-jdbc.xml
n/a
data-source-name
Valid name of the data source used for all data base connectivity for this bean.
n/a
Must be defined as a standard WebLogic Server JDBC data source for database connectivity. See Programming WebLogic JDBC for more information.
weblogic-rdbms-bean
weblogic-cmp-rdbms-jar.xml
The data-source-name that specifies the JDBC data source name to be used for all database connectivity for this bean.
datasource
jbosscmp-jdbc.xml
datasource-mapping
jbosscmp-jdbc.xml
n/a
table-name
Valid, fully qualified SQL name of the source table in the database.
n/a
table-name must be set in all cases.
weblogic-rdbms-bean
weblogic-rdbms-relation
weblogic-cmp-rdbms-jar.xml
The fully qualified SQL name of the source table in the database. Note that this needs to be set in all cases. The user defined for the data source for this bean must have read and write privileges on this table, though not necessarily schema modification privileges.
table-name
jbosscmp-jdbc.xml
n/a
field-map
Valid name
n/a
Field mapped to the column in the database must correspond to a cmp field in the bean.
weblogic-rdbms-bean
weblogic-cmp-rdbms-jar.xml
The name of the mapped field for a particular column in a database that corresponds to a cmp field in the bean instance.
cmp-field
jbosscmp-jdbc.xml
n/a
cmp-field
Valid name
n/a
Field is case sensitive and must match the name of the field in the bean
field-map
field-group
weblogic-cmp-rdbms-jar.xml
This name specifies the mapped field in the bean instance which should be populated with information from the database.
field-name
jbosscmp-jdbc.xml
n/a
dbms-column
Valid name
n/a
dbms-column is case maintaining, although not all database are case sensitive.
field-map
weblogic-cmp-rdbms-jar.xml
The name of the database column to which the field should be mapped.
column-name
jbosscmp-jdbc.xml
n/a
field-group
Valid name
A special group named default is used for finders and relationships that have no group specified.
The default group contains all of a bean's cmp-fields, but none of its cmr-fields.
weblogic-rdbms-bean
weblogic-rdbms-relation
weblogic-cmp-rdbms-jar.xml
The field-group element represents a subset of the cmp and cmr-fields of a bean. Related fields in a bean can be put into groups that are faulted into memory together as a unit. A group can be associated with a finder or relationship, so that when a bean is loaded as the result of executing a finder or following a relationship, only the fields specified in the group are loaded. A field may belong to multiple groups. In this case, the getXXX method for the field faults in the first group that contains the field.
load-group
jbosscmp-jdbc.xml
n/a
group-name
Valid name
n/a
n/a
field-group
finder-query
weblogic-cmp-rdbms-jar.xml
The group-name element specifies the name of a field group.
load-group-name
jbosscmp-jdbc.xml
n/a
cmr-field
Valid name
n/a
The field referenced in cmr-field must have a matching cmr-field entry in the ejb-jar.xml.
field-group
weblogic-cmp-rdbms-jar.xml
The cmr-field element specifies the name of a cmr-field.
field-name
jbosscmp-jdbc.xml
n/a
weblogic-rdbms-relation
XML stanza
n/a
Represents a single relationship.
weblogic-rdbms-jar
weblogic-cmp-rdbms-jar.xml
This element represents a single relationship that is managed by the WebLogic RDBMS CMP persistence type.
ejb-relation
jbosscmp-jdbc.xml
n/a
relation-name
Valid name
n/a
Must match the ejb-relation-name of an ejb-relation in the associated ejb-jar.xml descriptor file.
weblogic-rdbms-relation
weblogic-cmp-rdbms-jar.xml
The relation-name element specifies the name of a relation.
ejb-relation-name
jbosscmp-jdbc.xml
n/a
weblogic-relationship-role
Valid name
n/a
The mapping of a role to a table is specified in the associated weblogic-rdbms-bean and ejb-relation elements.
weblogic-rdbms-relation
weblogic-cmp-rdbms-jar.xml
The weblogic-relationship-role element is used to express a mapping from a foreign key to a primary key. Only one mapping is specified for one-to-one relationships when the relationship is local. However, with a many-to-many relationship, you must specify two mappings Multiple column mappings are specified for a single role, if the key is complex. No column-map is specified if the role is just specifying a group-name.
ejb-relationship-role
jbosscmp-jdbc.xml
n/a
relationship-role-name
Valid name
n/a
The name mustmatch the ejb-relationship-role-name of an ejb-relationship-role in the associated ejb-jar.xml descriptor file.
weblogic-relationship-role
weblogic-cmp-rdbms-jar.xml
The relationship-role-name element specifies the name of a relationship role.
ejb-relationship-role-name
jbosscmp-jdbc.xml
n/a
column-map
n/a
n/a
The key-column element is not specified, if the foreign-key-column refers to a remote bean.
weblogic-relationship-role
weblogic-cmp-rdbms-jar.xml
This element represents the mapping of a foreign key column in one table in the database to a corresponding primary key. The two columns may or may not be in the same table. The tables to which the column belong are implicit from the context in which the column-map element appears in the deployment descriptor.
key-field
jbosscmp-jdbc.xml
n/a
foreign-key-column
Valid name
n/a
Must correspond to a column of a foreign key.
column-map
weblogic-cmp-rdbms-jar.xml
The foreign-key-column element represents a column of a foreign key in the database.
column-name
jbosscmp-jdbc.xml
n/a
key-column
Valid name
n/a
Must correspond to a column of a primary key.
column-map
weblogic-cmp-rdbms-jar.xml
The key-column element represents a column of a primary key in the database.
field-name
jbosscmp-jdbc.xml
n/a
create-default-dbms-tables
True
False
False
Use this element only for convenience during the development and prototyping phases. This is because the Table Schema in the DBMS CREATE statement used will be the container's best approximation of the definition. A production environment most likely, will require a more precise schema definition.
weblogic-rdbms-jar
weblogic-cmp-rdbms-jar.xml
The create-default-dbms-table element turns on or off a feature that automatically creates a default table based on the descriptions in the deployment files and the bean class. When set to False, this feature is turned off and table will not automatically be generated. When set to True, this feature is turned on and the table is automatically created. If TABLE CREATION fails, a Table Not Found error is thrown and the table must be created by hand.
create-table
jbosscmp-jdbc.xml
remove-table
jbosscmp-jdbc.xml