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