Menu
▾
▴
[Hibernate-commits] Hibernate/doc dtd.aft,1.10,1.11 dtd.html,1.22,1.23 features.aft,1.29,1.30 features.html,1.49,1.50 hibernate-design.jpg,1.1,NONE tutorial.aft,1.81,NONE tutorial.aft-TOC,1.28,NONE tutorial.html,1.81,NONE
Update of /cvsroot/hibernate/Hibernate/doc In directory sc8-pr-cvs1:/tmp/cvs-serv12403 Modified Files: dtd.aft dtd.html features.aft features.html Removed Files: hibernate-design.jpg tutorial.aft tutorial.aft-TOC tutorial.html Log Message: removed obsolete doco Index: dtd.aft =================================================================== RCS file: /cvsroot/hibernate/Hibernate/doc/dtd.aft,v retrieving revision 1.10 retrieving revision 1.11 diff -C2 -d -r1.10 -r1.11 *** dtd.aft 11 Nov 2002 16:04:55 -0000 1.10 --- dtd.aft 20 Nov 2002 14:55:46 -0000 1.11 *************** *** 5,15 **** <?xml version='1.0' encoding='utf-8'?> ! <!-- Hibernate Mapping DTD. ! <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 1.1//EN" "http://hibernate.sourceforge.net/hibernate-mapping-1.1.dtd"> ! An instance of this XML document may contain mappings for an arbitrary number of classes. The class mappings may contain associations to classes --- 5,15 ---- <?xml version='1.0' encoding='utf-8'?> ! <!-- Hibernate Mapping DTD. ! <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 1.1//EN" "http://hibernate.sourceforge.net/hibernate-mapping-1.1.dtd"> ! An instance of this XML document may contain mappings for an arbitrary number of classes. The class mappings may contain associations to classes *************** *** 19,27 **** be referenced by later class and collection mappings in the same document. (They must be declared before they are used.) ! --> ! <!-- The document root. --> ! <!ELEMENT hibernate-mapping ( (map|set|list|bag|array|primitive-array)*, --- 19,27 ---- be referenced by later class and collection mappings in the same document. (They must be declared before they are used.) ! --> ! <!-- The document root. --> ! <!ELEMENT hibernate-mapping ( (map|set|list|bag|array|primitive-array)*, *************** *** 31,37 **** <!ATTLIST hibernate-mapping schema CDATA #IMPLIED> <!-- default: none --> <!ATTLIST hibernate-mapping default-cascade (none|save-update|all) "none"> ! <!-- Root of an entity class hierarchy. Entities have their own tables. --> ! <!ELEMENT class ( jcs-cache?, --- 31,37 ---- <!ATTLIST hibernate-mapping schema CDATA #IMPLIED> <!-- default: none --> <!ATTLIST hibernate-mapping default-cascade (none|save-update|all) "none"> ! <!-- Root of an entity class hierarchy. Entities have their own tables. --> ! <!ELEMENT class ( jcs-cache?, *************** *** 40,60 **** (version|timestamp)?, (property|many-to-one|one-to-one|collection|component|map|set|list|bag|array|primitive-array)*, ! ((subclass*)|(joined-subclass*)), ! cache? )> <!ATTLIST class name CDATA #REQUIRED> ! <!ATTLIST class table CDATA #IMPLIED> <!-- default: unqualified classname --> ! <!ATTLIST class schema CDATA #IMPLIED> <!-- default: none --> ! <!ATTLIST class proxy CDATA #IMPLIED> <!-- default: no proxy interface --> <!ATTLIST class mutable (true|false) "true"> ! <!ATTLIST class persister CDATA #IMPLIED> <!-- default: cirrus.hibernate.persister.EntityPersister --> ! ! <!ATTLIST class discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none --> ! <!-- Declares the id type, column and generation algorithm for an entity class. If a name attribut is given, the id is exposed to the application through the named property of the class. If not, the id is only exposed to the application through Session.getID()--> ! <!ELEMENT id (column?, generator)> <!ATTLIST id name CDATA #IMPLIED> --- 40,59 ---- (version|timestamp)?, (property|many-to-one|one-to-one|collection|component|map|set|list|bag|array|primitive-array)*, ! ((subclass*)|(joined-subclass*)) )> <!ATTLIST class name CDATA #REQUIRED> ! <!ATTLIST class table CDATA #IMPLIED> <!-- default: unqualified classname --> ! <!ATTLIST class schema CDATA #IMPLIED> <!-- default: none --> ! <!ATTLIST class proxy CDATA #IMPLIED> <!-- default: no proxy interface --> ! <!ATTLIST class discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none --> <!ATTLIST class mutable (true|false) "true"> ! <!ATTLIST class polymorphism (implicit|explicit) "implicit"> ! <!ATTLIST class persister CDATA #IMPLIED> ! <!-- Declares the id type, column and generation algorithm for an entity class. If a name attribut is given, the id is exposed to the application through the named property of the class. If not, the id is only exposed to the application through Session.getID()--> ! <!ELEMENT id (column?, generator)> <!ATTLIST id name CDATA #IMPLIED> *************** *** 63,99 **** <!ATTLIST id length CDATA #IMPLIED> <!ATTLIST id unsaved-value CDATA "any"> <!-- any|none|null|"value" --> ! <!-- A composite key may be modelled by a java class with a property for each key column. The class must implement java.io.Serializable and reimplement equals() and hashCode(). --> ! <!ELEMENT composite-id ( (key-property|key-many-to-one)+ )> <!ATTLIST composite-id class CDATA #IMPLIED> <!ATTLIST composite-id name CDATA #IMPLIED> <!ATTLIST composite-id unsaved-value (any|none|null) "any"> <!-- default: any --> ! <!-- Polymorphic data requires a column holding a class discriminator value. This value is not directly exposed to the application. --> ! <!ELEMENT discriminator (column?)> <!ATTLIST discriminator column CDATA #IMPLIED> <!-- default: "class"|none --> <!ATTLIST discriminator type CDATA "string"> <!ATTLIST discriminator length CDATA #IMPLIED> ! <!-- Versioned data requires a column holding a version number. This is exposed to the application through a property of the Java class. --> ! <!ELEMENT version EMPTY> <!ATTLIST version name CDATA #REQUIRED> <!ATTLIST version column CDATA #IMPLIED> <!ATTLIST version type CDATA "integer"> ! <!ELEMENT timestamp EMPTY> <!ATTLIST timestamp name CDATA #REQUIRED> <!ATTLIST timestamp column CDATA #IMPLIED> ! <!-- Subclass declarations are nested beneath the root class declaration to achieve polymorphic persistence. --> ! <!ELEMENT subclass ( (property|many-to-one|one-to-one|collection|component|map|set|list|bag|array|primitive-array)*, --- 62,98 ---- <!ATTLIST id length CDATA #IMPLIED> <!ATTLIST id unsaved-value CDATA "any"> <!-- any|none|null|"value" --> ! <!-- A composite key may be modelled by a java class with a property for each key column. The class must implement java.io.Serializable and reimplement equals() and hashCode(). --> ! <!ELEMENT composite-id ( (key-property|key-many-to-one)+ )> <!ATTLIST composite-id class CDATA #IMPLIED> <!ATTLIST composite-id name CDATA #IMPLIED> <!ATTLIST composite-id unsaved-value (any|none|null) "any"> <!-- default: any --> ! <!-- Polymorphic data requires a column holding a class discriminator value. This value is not directly exposed to the application. --> ! <!ELEMENT discriminator (column?)> <!ATTLIST discriminator column CDATA #IMPLIED> <!-- default: "class"|none --> <!ATTLIST discriminator type CDATA "string"> <!ATTLIST discriminator length CDATA #IMPLIED> ! <!-- Versioned data requires a column holding a version number. This is exposed to the application through a property of the Java class. --> ! <!ELEMENT version EMPTY> <!ATTLIST version name CDATA #REQUIRED> <!ATTLIST version column CDATA #IMPLIED> <!ATTLIST version type CDATA "integer"> ! <!ELEMENT timestamp EMPTY> <!ATTLIST timestamp name CDATA #REQUIRED> <!ATTLIST timestamp column CDATA #IMPLIED> ! <!-- Subclass declarations are nested beneath the root class declaration to achieve polymorphic persistence. --> ! <!ELEMENT subclass ( (property|many-to-one|one-to-one|collection|component|map|set|list|bag|array|primitive-array)*, *************** *** 103,109 **** <!ATTLIST subclass proxy CDATA #IMPLIED> <!-- default: no proxy interface --> <!ATTLIST subclass discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none --> ! <!-- Joined subclasses are used for the normalized table-per-subclass mapping strategy --> ! <!ELEMENT joined-subclass ( key, --- 102,108 ---- <!ATTLIST subclass proxy CDATA #IMPLIED> <!-- default: no proxy interface --> <!ATTLIST subclass discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none --> ! <!-- Joined subclasses are used for the normalized table-per-subclass mapping strategy --> ! <!ELEMENT joined-subclass ( key, *************** *** 115,122 **** <!ATTLIST joined-subclass table CDATA #REQUIRED> <!ATTLIST joined-subclass schema CDATA #IMPLIED> ! <!-- Property of an entity class or component, component-element, composite-id, etc. JavaBeans style properties are mapped to table columns. --> ! <!ELEMENT property (column*)> <!ATTLIST property name CDATA #REQUIRED> --- 114,121 ---- <!ATTLIST joined-subclass table CDATA #REQUIRED> <!ATTLIST joined-subclass schema CDATA #IMPLIED> ! <!-- Property of an entity class or component, component-element, composite-id, etc. JavaBeans style properties are mapped to table columns. --> ! <!ELEMENT property (column*)> <!ATTLIST property name CDATA #REQUIRED> *************** *** 126,133 **** <!ATTLIST property not-null (true|false) "false"> <!ATTLIST property unique (true|false) "false"> ! <!-- Declares an association between two entities (Or from a component, component element, etc. to an entity). --> ! <!ELEMENT many-to-one (column*)> <!ATTLIST many-to-one name CDATA #REQUIRED> --- 125,132 ---- <!ATTLIST property not-null (true|false) "false"> <!ATTLIST property unique (true|false) "false"> ! <!-- Declares an association between two entities (Or from a component, component element, etc. to an entity). --> ! <!ELEMENT many-to-one (column*)> <!ATTLIST many-to-one name CDATA #REQUIRED> *************** *** 138,145 **** <!ATTLIST many-to-one cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST many-to-one outer-join (true|false|auto) "auto"> ! <!-- Declares a one-to-one association between two entities (Or from a component, component element, etc. to an entity). --> ! <!ELEMENT one-to-one EMPTY> <!ATTLIST one-to-one name CDATA #REQUIRED> --- 137,144 ---- <!ATTLIST many-to-one cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST many-to-one outer-join (true|false|auto) "auto"> ! <!-- Declares a one-to-one association between two entities (Or from a component, component element, etc. to an entity). --> ! <!ELEMENT one-to-one EMPTY> <!ATTLIST one-to-one name CDATA #REQUIRED> *************** *** 148,154 **** <!ATTLIST one-to-one outer-join (true|false|auto) "auto"> <!ATTLIST one-to-one constrained (true|false) "false"> ! <!-- A property embedded in a composite identifier or map index (always not-null). --> ! <!ELEMENT key-property (column*)> <!ATTLIST key-property name CDATA #REQUIRED> --- 147,153 ---- <!ATTLIST one-to-one outer-join (true|false|auto) "auto"> <!ATTLIST one-to-one constrained (true|false) "false"> ! <!-- A property embedded in a composite identifier or map index (always not-null). --> ! <!ELEMENT key-property (column*)> <!ATTLIST key-property name CDATA #REQUIRED> *************** *** 156,170 **** <!ATTLIST key-property column CDATA #IMPLIED> <!ATTLIST key-property length CDATA #IMPLIED> ! <!-- A many-to-one association embedded in a composite identifier or map index (always not-null, never cascade). --> ! <!ELEMENT key-many-to-one (column*)> <!ATTLIST key-many-to-one name CDATA #REQUIRED> <!ATTLIST key-many-to-one class CDATA #IMPLIED> <!ATTLIST key-many-to-one column CDATA #IMPLIED> ! <!-- Declared a property that holds instances of a toplevel collection role. --> ! <!ELEMENT collection (column*)> <!ATTLIST collection name CDATA #REQUIRED> --- 155,169 ---- <!ATTLIST key-property column CDATA #IMPLIED> <!ATTLIST key-property length CDATA #IMPLIED> ! <!-- A many-to-one association embedded in a composite identifier or map index (always not-null, never cascade). --> ! <!ELEMENT key-many-to-one (column*)> <!ATTLIST key-many-to-one name CDATA #REQUIRED> <!ATTLIST key-many-to-one class CDATA #IMPLIED> <!ATTLIST key-many-to-one column CDATA #IMPLIED> ! <!-- Declared a property that holds instances of a toplevel collection role. --> ! <!ELEMENT collection (column*)> <!ATTLIST collection name CDATA #REQUIRED> *************** *** 175,179 **** <!ATTLIST collection unique (true|false) "false"> <!ATTLIST collection cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!-- A component is a user-defined class, persisted along with its containing entity to the table of the entity class. JavaBeans style properties of the component are --- 174,178 ---- <!ATTLIST collection unique (true|false) "false"> <!ATTLIST collection cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!-- A component is a user-defined class, persisted along with its containing entity to the table of the entity class. JavaBeans style properties of the component are *************** *** 181,185 **** is mapped to null values in all columns and vice versa. Components do not support shared reference semantics. --> ! <!ELEMENT component ( parent?, --- 180,184 ---- is mapped to null values in all columns and vice versa. Components do not support shared reference semantics. --> ! <!ELEMENT component ( parent?, *************** *** 188,198 **** <!ATTLIST component class CDATA #IMPLIED> <!ATTLIST component name CDATA #REQUIRED> ! <!-- The parent element maps a property of the component class as a pointer back to the owning entity. --> ! <!ELEMENT parent EMPTY> <!ATTLIST parent name CDATA #REQUIRED> ! <!-- Collection roles declared directly beneath the root element have their own key and may be referenced by many collection or subcollection tags. Collection declarations --- 187,197 ---- <!ATTLIST component class CDATA #IMPLIED> <!ATTLIST component name CDATA #REQUIRED> ! <!-- The parent element maps a property of the component class as a pointer back to the owning entity. --> ! <!ELEMENT parent EMPTY> <!ATTLIST parent name CDATA #REQUIRED> ! <!-- Collection roles declared directly beneath the root element have their own key and may be referenced by many collection or subcollection tags. Collection declarations *************** *** 201,207 **** the role may be an arbitrary string. For nested collections, it must be the name of the property containing the collection. ! Note that the cascade attribute is ignored for toplevel collections. --> ! <!ELEMENT map ( jcs-cache?, --- 200,206 ---- the role may be an arbitrary string. For nested collections, it must be the name of the property containing the collection. ! Note that the cascade attribute is ignored for toplevel collections. --> ! <!ELEMENT map ( jcs-cache?, *************** *** 217,221 **** <!ATTLIST map cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST map order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT set ( jcs-cache?, --- 216,220 ---- <!ATTLIST map cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST map order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT set ( jcs-cache?, *************** *** 231,235 **** <!ATTLIST set cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST set order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT bag ( jcs-cache?, --- 230,234 ---- <!ATTLIST set cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST set order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT bag ( jcs-cache?, *************** *** 244,248 **** <!ATTLIST bag cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST bag order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT list ( jcs-cache?, --- 243,247 ---- <!ATTLIST bag cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST bag order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT list ( jcs-cache?, *************** *** 256,260 **** <!ATTLIST list lazy (true|false) "false"> <!ATTLIST list cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!ELEMENT array ( jcs-cache?, --- 255,259 ---- <!ATTLIST list lazy (true|false) "false"> <!ATTLIST list cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!ELEMENT array ( jcs-cache?, *************** *** 268,279 **** <!ATTLIST array element-class CDATA #IMPLIED> <!ATTLIST array cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!ELEMENT primitive-array (jcs-cache?, key, index, element)> <!ATTLIST primitive-array role CDATA #REQUIRED> <!ATTLIST primitive-array table CDATA #IMPLIED> <!-- default: rolename --> <!ATTLIST primitive-array schema CDATA #IMPLIED> <!-- default: none --> ! <!-- Declares the element type of a collection of basic type --> ! <!ELEMENT element (column*)> <!ATTLIST element column CDATA #IMPLIED> --- 267,278 ---- <!ATTLIST array element-class CDATA #IMPLIED> <!ATTLIST array cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!ELEMENT primitive-array (jcs-cache?, key, index, element)> <!ATTLIST primitive-array role CDATA #REQUIRED> <!ATTLIST primitive-array table CDATA #IMPLIED> <!-- default: rolename --> <!ATTLIST primitive-array schema CDATA #IMPLIED> <!-- default: none --> ! <!-- Declares the element type of a collection of basic type --> ! <!ELEMENT element (column*)> <!ATTLIST element column CDATA #IMPLIED> *************** *** 282,297 **** <!ATTLIST element not-null (true|false) "false"> <!ATTLIST element unique (true|false) "false"> ! <!-- One to many association. This tag declares the entity-class element type of a collection and specifies a one-to-many relational model --> ! <!ELEMENT one-to-many EMPTY> <!ATTLIST one-to-many class CDATA #REQUIRED> <!-- No column declaration attributes required in this case. The primary key column of the associated class is already mapped elsewhere.--> ! <!-- Many to many association. This tag declares the entity-class element type of a collection and specifies a many-to-many relational model --> ! <!ELEMENT many-to-many (column*)> <!ATTLIST many-to-many class CDATA #REQUIRED> --- 281,296 ---- <!ATTLIST element not-null (true|false) "false"> <!ATTLIST element unique (true|false) "false"> ! <!-- One to many association. This tag declares the entity-class element type of a collection and specifies a one-to-many relational model --> ! <!ELEMENT one-to-many EMPTY> <!ATTLIST one-to-many class CDATA #REQUIRED> <!-- No column declaration attributes required in this case. The primary key column of the associated class is already mapped elsewhere.--> ! <!-- Many to many association. This tag declares the entity-class element type of a collection and specifies a many-to-many relational model --> ! <!ELEMENT many-to-many (column*)> <!ATTLIST many-to-many class CDATA #REQUIRED> *************** *** 300,307 **** <!ATTLIST many-to-many outer-join (true|false|auto) "auto"> <!-- unique makes no sense here since it would make the association one-to-many --> ! <!-- This tag declares that the element type of a collection is a named toplevel collection role. --> ! <!ELEMENT subcollection (column*)> <!ATTLIST subcollection column CDATA #IMPLIED> --- 299,306 ---- <!ATTLIST many-to-many outer-join (true|false|auto) "auto"> <!-- unique makes no sense here since it would make the association one-to-many --> ! <!-- This tag declares that the element type of a collection is a named toplevel collection role. --> ! <!ELEMENT subcollection (column*)> <!ATTLIST subcollection column CDATA #IMPLIED> *************** *** 310,324 **** <!ATTLIST subcollection not-null (true|false) "false"> <!ATTLIST subcollection unique (true|false) "false"> ! <!-- A composite element allows a collection to hold instances of an arbitrary class, without the requirement of joining to an entity table. Composite elements have component semantics - no shared references and ad hoc null value semantics. Composite elements may not hold nested collections. --> ! <!ELEMENT composite-element ( (property|many-to-one|collection|nested-composite-element)* )> <!ATTLIST composite-element class CDATA #REQUIRED> ! <!ELEMENT nested-composite-element ( (property|many-to-one|collection|nested-composite-element)* --- 309,323 ---- <!ATTLIST subcollection not-null (true|false) "false"> <!ATTLIST subcollection unique (true|false) "false"> ! <!-- A composite element allows a collection to hold instances of an arbitrary class, without the requirement of joining to an entity table. Composite elements have component semantics - no shared references and ad hoc null value semantics. Composite elements may not hold nested collections. --> ! <!ELEMENT composite-element ( (property|many-to-one|collection|nested-composite-element)* )> <!ATTLIST composite-element class CDATA #REQUIRED> ! <!ELEMENT nested-composite-element ( (property|many-to-one|collection|nested-composite-element)* *************** *** 326,374 **** <!ATTLIST nested-composite-element class CDATA #REQUIRED> <!ATTLIST nested-composite-element name CDATA #REQUIRED> ! <!-- Declares the type, column name (and, in the case of toplevel collections, an id generation strategy) for the key of a collection table. These keys are never exposed to the application. For toplevel collections, Hibernate makes no guarantee of key stability of a particular collection instance. --> ! <!ELEMENT key (column*)> <!ATTLIST key column CDATA #IMPLIED> <!ATTLIST key length CDATA #IMPLIED> ! <!ELEMENT generated-key (generator, column*)> <!ATTLIST generated-key column CDATA #IMPLIED> <!ATTLIST generated-key type CDATA #REQUIRED> <!ATTLIST generated-key length CDATA #IMPLIED> ! <!-- Declares the type and column mapping for a collection index (array or list index, or key of a map). --> ! <!ELEMENT index (column*)> <!ATTLIST index column CDATA #IMPLIED> <!ATTLIST index type CDATA #IMPLIED> <!-- required for maps --> <!ATTLIST index length CDATA #IMPLIED> ! <!-- Many to many association mapped to the key of a map. ie. a map keyed on entities. --> ! <!ELEMENT index-many-to-many (column*)> <!ATTLIST index-many-to-many class CDATA #REQUIRED> <!ATTLIST index-many-to-many column CDATA #IMPLIED> ! <!-- Composite index of a map ie. a map keyed on components. --> ! <!ELEMENT composite-index ( (key-property|key-many-to-one)+ )> <!ATTLIST composite-index class CDATA #REQUIRED> ! <!-- Generators generate unique identifiers. The class attribute specifies a Java class implementing an id generation algorithm. --> ! <!ELEMENT generator (param*)> <!ATTLIST generator class CDATA #REQUIRED> <!ELEMENT param (#PCDATA)> ! <!-- The column element is an alternative to column attributes and required for mapping associations to classes with composite ids. --> ! <!ELEMENT column EMPTY> <!ATTLIST column name CDATA #REQUIRED> --- 325,373 ---- <!ATTLIST nested-composite-element class CDATA #REQUIRED> <!ATTLIST nested-composite-element name CDATA #REQUIRED> ! <!-- Declares the type, column name (and, in the case of toplevel collections, an id generation strategy) for the key of a collection table. These keys are never exposed to the application. For toplevel collections, Hibernate makes no guarantee of key stability of a particular collection instance. --> ! <!ELEMENT key (column*)> <!ATTLIST key column CDATA #IMPLIED> <!ATTLIST key length CDATA #IMPLIED> ! <!ELEMENT generated-key (generator, column*)> <!ATTLIST generated-key column CDATA #IMPLIED> <!ATTLIST generated-key type CDATA #REQUIRED> <!ATTLIST generated-key length CDATA #IMPLIED> ! <!-- Declares the type and column mapping for a collection index (array or list index, or key of a map). --> ! <!ELEMENT index (column*)> <!ATTLIST index column CDATA #IMPLIED> <!ATTLIST index type CDATA #IMPLIED> <!-- required for maps --> <!ATTLIST index length CDATA #IMPLIED> ! <!-- Many to many association mapped to the key of a map. ie. a map keyed on entities. --> ! <!ELEMENT index-many-to-many (column*)> <!ATTLIST index-many-to-many class CDATA #REQUIRED> <!ATTLIST index-many-to-many column CDATA #IMPLIED> ! <!-- Composite index of a map ie. a map keyed on components. --> ! <!ELEMENT composite-index ( (key-property|key-many-to-one)+ )> <!ATTLIST composite-index class CDATA #REQUIRED> ! <!-- Generators generate unique identifiers. The class attribute specifies a Java class implementing an id generation algorithm. --> ! <!ELEMENT generator (param*)> <!ATTLIST generator class CDATA #REQUIRED> <!ELEMENT param (#PCDATA)> ! <!-- The column element is an alternative to column attributes and required for mapping associations to classes with composite ids. --> ! <!ELEMENT column EMPTY> <!ATTLIST column name CDATA #REQUIRED> *************** *** 378,390 **** <!ATTLIST column sql-type CDATA #IMPLIED> <!-- override default column type for hibernate type --> <!ATTLIST column index CDATA #IMPLIED> ! <!-- The jcs-cache element enables caching of an entity class. --> <!ELEMENT jcs-cache EMPTY> <!ATTLIST jcs-cache usage (read-only|read-write) #REQUIRED> ! <!-- The query element declares a named Hibernate query string --> ! <!ELEMENT query (#PCDATA)> <!ATTLIST query name CDATA #REQUIRED> ! #---PASS-HTML <A href=http://sourceforge.net/projects/hibernate><IMG src=http://sourceforge.net/sflogo.php?group_id=40712></A> --- 377,389 ---- <!ATTLIST column sql-type CDATA #IMPLIED> <!-- override default column type for hibernate type --> <!ATTLIST column index CDATA #IMPLIED> ! <!-- The jcs-cache element enables caching of an entity class. --> <!ELEMENT jcs-cache EMPTY> <!ATTLIST jcs-cache usage (read-only|read-write) #REQUIRED> ! <!-- The query element declares a named Hibernate query string --> ! <!ELEMENT query (#PCDATA)> <!ATTLIST query name CDATA #REQUIRED> ! #---PASS-HTML <A href=http://sourceforge.net/projects/hibernate><IMG src=http://sourceforge.net/sflogo.php?group_id=40712></A> Index: dtd.html =================================================================== RCS file: /cvsroot/hibernate/Hibernate/doc/dtd.html,v retrieving revision 1.22 retrieving revision 1.23 diff -C2 -d -r1.22 -r1.23 *** dtd.html 11 Nov 2002 16:04:55 -0000 1.22 --- dtd.html 20 Nov 2002 14:55:46 -0000 1.23 *************** *** 19,29 **** <pre> <?xml version='1.0' encoding='utf-8'?> ! <!-- Hibernate Mapping DTD. ! <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 1.1//EN" "http://hibernate.sourceforge.net/hibernate-mapping-1.1.dtd"> ! An instance of this XML document may contain mappings for an arbitrary number of classes. The class mappings may contain associations to classes --- 19,32 ---- <pre> <?xml version='1.0' encoding='utf-8'?> ! </pre> ! <pre> <!-- Hibernate Mapping DTD. ! </pre> ! <pre> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 1.1//EN" "http://hibernate.sourceforge.net/hibernate-mapping-1.1.dtd"> ! </pre> ! <pre> An instance of this XML document may contain mappings for an arbitrary number of classes. The class mappings may contain associations to classes *************** *** 33,41 **** be referenced by later class and collection mappings in the same document. (They must be declared before they are used.) ! --> ! <!-- The document root. --> ! <!ELEMENT hibernate-mapping ( (map|set|list|bag|array|primitive-array)*, --- 36,47 ---- be referenced by later class and collection mappings in the same document. (They must be declared before they are used.) ! </pre> ! <pre> --> ! </pre> ! <pre> <!-- The document root. --> ! </pre> ! <pre> <!ELEMENT hibernate-mapping ( (map|set|list|bag|array|primitive-array)*, *************** *** 45,51 **** <!ATTLIST hibernate-mapping schema CDATA #IMPLIED> <!-- default: none --> <!ATTLIST hibernate-mapping default-cascade (none|save-update|all) "none"> ! <!-- Root of an entity class hierarchy. Entities have their own tables. --> ! <!ELEMENT class ( jcs-cache?, --- 51,59 ---- <!ATTLIST hibernate-mapping schema CDATA #IMPLIED> <!-- default: none --> <!ATTLIST hibernate-mapping default-cascade (none|save-update|all) "none"> ! </pre> ! <pre> <!-- Root of an entity class hierarchy. Entities have their own tables. --> ! </pre> ! <pre> <!ELEMENT class ( jcs-cache?, *************** *** 54,74 **** (version|timestamp)?, (property|many-to-one|one-to-one|collection|component|map|set|list|bag|array|primitive-array)*, ! ((subclass*)|(joined-subclass*)), ! cache? )> <!ATTLIST class name CDATA #REQUIRED> ! <!ATTLIST class table CDATA #IMPLIED> <!-- default: unqualified classname --> ! <!ATTLIST class schema CDATA #IMPLIED> <!-- default: none --> ! <!ATTLIST class proxy CDATA #IMPLIED> <!-- default: no proxy interface --> <!ATTLIST class mutable (true|false) "true"> ! <!ATTLIST class persister CDATA #IMPLIED> <!-- default: cirrus.hibernate.persister.EntityPersister --> ! ! <!ATTLIST class discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none --> ! <!-- Declares the id type, column and generation algorithm for an entity class. If a name attribut is given, the id is exposed to the application through the named property of the class. If not, the id is only exposed to the application through Session.getID()--> ! <!ELEMENT id (column?, generator)> <!ATTLIST id name CDATA #IMPLIED> --- 62,83 ---- (version|timestamp)?, (property|many-to-one|one-to-one|collection|component|map|set|list|bag|array|primitive-array)*, ! ((subclass*)|(joined-subclass*)) )> <!ATTLIST class name CDATA #REQUIRED> ! <!ATTLIST class table CDATA #IMPLIED> <!-- default: unqualified classname --> ! <!ATTLIST class schema CDATA #IMPLIED> <!-- default: none --> ! <!ATTLIST class proxy CDATA #IMPLIED> <!-- default: no proxy interface --> ! <!ATTLIST class discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none --> <!ATTLIST class mutable (true|false) "true"> ! <!ATTLIST class polymorphism (implicit|explicit) "implicit"> ! <!ATTLIST class persister CDATA #IMPLIED> ! </pre> ! <pre> <!-- Declares the id type, column and generation algorithm for an entity class. If a name attribut is given, the id is exposed to the application through the named property of the class. If not, the id is only exposed to the application through Session.getID()--> ! </pre> ! <pre> <!ELEMENT id (column?, generator)> <!ATTLIST id name CDATA #IMPLIED> *************** *** 77,113 **** <!ATTLIST id length CDATA #IMPLIED> <!ATTLIST id unsaved-value CDATA "any"> <!-- any|none|null|"value" --> ! <!-- A composite key may be modelled by a java class with a property for each key column. The class must implement java.io.Serializable and reimplement equals() and hashCode(). --> ! <!ELEMENT composite-id ( (key-property|key-many-to-one)+ )> <!ATTLIST composite-id class CDATA #IMPLIED> <!ATTLIST composite-id name CDATA #IMPLIED> <!ATTLIST composite-id unsaved-value (any|none|null) "any"> <!-- default: any --> ! <!-- Polymorphic data requires a column holding a class discriminator value. This value is not directly exposed to the application. --> ! <!ELEMENT discriminator (column?)> <!ATTLIST discriminator column CDATA #IMPLIED> <!-- default: "class"|none --> <!ATTLIST discriminator type CDATA "string"> <!ATTLIST discriminator length CDATA #IMPLIED> ! <!-- Versioned data requires a column holding a version number. This is exposed to the application through a property of the Java class. --> ! <!ELEMENT version EMPTY> <!ATTLIST version name CDATA #REQUIRED> <!ATTLIST version column CDATA #IMPLIED> <!ATTLIST version type CDATA "integer"> ! <!ELEMENT timestamp EMPTY> <!ATTLIST timestamp name CDATA #REQUIRED> <!ATTLIST timestamp column CDATA #IMPLIED> ! <!-- Subclass declarations are nested beneath the root class declaration to achieve polymorphic persistence. --> ! <!ELEMENT subclass ( (property|many-to-one|one-to-one|collection|component|map|set|list|bag|array|primitive-array)*, --- 86,131 ---- <!ATTLIST id length CDATA #IMPLIED> <!ATTLIST id unsaved-value CDATA "any"> <!-- any|none|null|"value" --> ! </pre> ! <pre> <!-- A composite key may be modelled by a java class with a property for each key column. The class must implement java.io.Serializable and reimplement equals() and hashCode(). --> ! </pre> ! <pre> <!ELEMENT composite-id ( (key-property|key-many-to-one)+ )> <!ATTLIST composite-id class CDATA #IMPLIED> <!ATTLIST composite-id name CDATA #IMPLIED> <!ATTLIST composite-id unsaved-value (any|none|null) "any"> <!-- default: any --> ! </pre> ! <pre> <!-- Polymorphic data requires a column holding a class discriminator value. This value is not directly exposed to the application. --> ! </pre> ! <pre> <!ELEMENT discriminator (column?)> <!ATTLIST discriminator column CDATA #IMPLIED> <!-- default: "class"|none --> <!ATTLIST discriminator type CDATA "string"> <!ATTLIST discriminator length CDATA #IMPLIED> ! </pre> ! <pre> <!-- Versioned data requires a column holding a version number. This is exposed to the application through a property of the Java class. --> ! </pre> ! <pre> <!ELEMENT version EMPTY> <!ATTLIST version name CDATA #REQUIRED> <!ATTLIST version column CDATA #IMPLIED> <!ATTLIST version type CDATA "integer"> ! </pre> ! <pre> <!ELEMENT timestamp EMPTY> <!ATTLIST timestamp name CDATA #REQUIRED> <!ATTLIST timestamp column CDATA #IMPLIED> ! </pre> ! <pre> <!-- Subclass declarations are nested beneath the root class declaration to achieve polymorphic persistence. --> ! </pre> ! <pre> <!ELEMENT subclass ( (property|many-to-one|one-to-one|collection|component|map|set|list|bag|array|primitive-array)*, *************** *** 117,123 **** <!ATTLIST subclass proxy CDATA #IMPLIED> <!-- default: no proxy interface --> <!ATTLIST subclass discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none --> ! <!-- Joined subclasses are used for the normalized table-per-subclass mapping strategy --> ! <!ELEMENT joined-subclass ( key, --- 135,143 ---- <!ATTLIST subclass proxy CDATA #IMPLIED> <!-- default: no proxy interface --> <!ATTLIST subclass discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none --> ! </pre> ! <pre> <!-- Joined subclasses are used for the normalized table-per-subclass mapping strategy --> ! </pre> ! <pre> <!ELEMENT joined-subclass ( key, *************** *** 129,136 **** <!ATTLIST joined-subclass table CDATA #REQUIRED> <!ATTLIST joined-subclass schema CDATA #IMPLIED> ! <!-- Property of an entity class or component, component-element, composite-id, etc. JavaBeans style properties are mapped to table columns. --> ! <!ELEMENT property (column*)> <!ATTLIST property name CDATA #REQUIRED> --- 149,158 ---- <!ATTLIST joined-subclass table CDATA #REQUIRED> <!ATTLIST joined-subclass schema CDATA #IMPLIED> ! </pre> ! <pre> <!-- Property of an entity class or component, component-element, composite-id, etc. JavaBeans style properties are mapped to table columns. --> ! </pre> ! <pre> <!ELEMENT property (column*)> <!ATTLIST property name CDATA #REQUIRED> *************** *** 140,147 **** <!ATTLIST property not-null (true|false) "false"> <!ATTLIST property unique (true|false) "false"> ! <!-- Declares an association between two entities (Or from a component, component element, etc. to an entity). --> ! <!ELEMENT many-to-one (column*)> <!ATTLIST many-to-one name CDATA #REQUIRED> --- 162,171 ---- <!ATTLIST property not-null (true|false) "false"> <!ATTLIST property unique (true|false) "false"> ! </pre> ! <pre> <!-- Declares an association between two entities (Or from a component, component element, etc. to an entity). --> ! </pre> ! <pre> <!ELEMENT many-to-one (column*)> <!ATTLIST many-to-one name CDATA #REQUIRED> *************** *** 152,159 **** <!ATTLIST many-to-one cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST many-to-one outer-join (true|false|auto) "auto"> ! <!-- Declares a one-to-one association between two entities (Or from a component, component element, etc. to an entity). --> ! <!ELEMENT one-to-one EMPTY> <!ATTLIST one-to-one name CDATA #REQUIRED> --- 176,185 ---- <!ATTLIST many-to-one cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST many-to-one outer-join (true|false|auto) "auto"> ! </pre> ! <pre> <!-- Declares a one-to-one association between two entities (Or from a component, component element, etc. to an entity). --> ! </pre> ! <pre> <!ELEMENT one-to-one EMPTY> <!ATTLIST one-to-one name CDATA #REQUIRED> *************** *** 162,168 **** <!ATTLIST one-to-one outer-join (true|false|auto) "auto"> <!ATTLIST one-to-one constrained (true|false) "false"> ! <!-- A property embedded in a composite identifier or map index (always not-null). --> ! <!ELEMENT key-property (column*)> <!ATTLIST key-property name CDATA #REQUIRED> --- 188,196 ---- <!ATTLIST one-to-one outer-join (true|false|auto) "auto"> <!ATTLIST one-to-one constrained (true|false) "false"> ! </pre> ! <pre> <!-- A property embedded in a composite identifier or map index (always not-null). --> ! </pre> ! <pre> <!ELEMENT key-property (column*)> <!ATTLIST key-property name CDATA #REQUIRED> *************** *** 170,184 **** <!ATTLIST key-property column CDATA #IMPLIED> <!ATTLIST key-property length CDATA #IMPLIED> ! <!-- A many-to-one association embedded in a composite identifier or map index (always not-null, never cascade). --> ! <!ELEMENT key-many-to-one (column*)> <!ATTLIST key-many-to-one name CDATA #REQUIRED> <!ATTLIST key-many-to-one class CDATA #IMPLIED> <!ATTLIST key-many-to-one column CDATA #IMPLIED> ! <!-- Declared a property that holds instances of a toplevel collection role. --> ! <!ELEMENT collection (column*)> <!ATTLIST collection name CDATA #REQUIRED> --- 198,216 ---- <!ATTLIST key-property column CDATA #IMPLIED> <!ATTLIST key-property length CDATA #IMPLIED> ! </pre> ! <pre> <!-- A many-to-one association embedded in a composite identifier or map index (always not-null, never cascade). --> ! </pre> ! <pre> <!ELEMENT key-many-to-one (column*)> <!ATTLIST key-many-to-one name CDATA #REQUIRED> <!ATTLIST key-many-to-one class CDATA #IMPLIED> <!ATTLIST key-many-to-one column CDATA #IMPLIED> ! </pre> ! <pre> <!-- Declared a property that holds instances of a toplevel collection role. --> ! </pre> ! <pre> <!ELEMENT collection (column*)> <!ATTLIST collection name CDATA #REQUIRED> *************** *** 189,193 **** <!ATTLIST collection unique (true|false) "false"> <!ATTLIST collection cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!-- A component is a user-defined class, persisted along with its containing entity to the table of the entity class. JavaBeans style properties of the component are --- 221,226 ---- <!ATTLIST collection unique (true|false) "false"> <!ATTLIST collection cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! </pre> ! <pre> <!-- A component is a user-defined class, persisted along with its containing entity to the table of the entity class. JavaBeans style properties of the component are *************** *** 195,199 **** is mapped to null values in all columns and vice versa. Components do not support shared reference semantics. --> ! <!ELEMENT component ( parent?, --- 228,233 ---- is mapped to null values in all columns and vice versa. Components do not support shared reference semantics. --> ! </pre> ! <pre> <!ELEMENT component ( parent?, *************** *** 202,212 **** <!ATTLIST component class CDATA #IMPLIED> <!ATTLIST component name CDATA #REQUIRED> ! <!-- The parent element maps a property of the component class as a pointer back to the owning entity. --> ! <!ELEMENT parent EMPTY> <!ATTLIST parent name CDATA #REQUIRED> ! <!-- Collection roles declared directly beneath the root element have their own key and may be referenced by many collection or subcollection tags. Collection declarations --- 236,249 ---- <!ATTLIST component class CDATA #IMPLIED> <!ATTLIST component name CDATA #REQUIRED> ! </pre> ! <pre> <!-- The parent element maps a property of the component class as a pointer back to the owning entity. --> ! </pre> ! <pre> <!ELEMENT parent EMPTY> <!ATTLIST parent name CDATA #REQUIRED> ! </pre> ! <pre> <!-- Collection roles declared directly beneath the root element have their own key and may be referenced by many collection or subcollection tags. Collection declarations *************** *** 215,221 **** the role may be an arbitrary string. For nested collections, it must be the name of the property containing the collection. ! Note that the cascade attribute is ignored for toplevel collections. --> ! <!ELEMENT map ( jcs-cache?, --- 252,260 ---- the role may be an arbitrary string. For nested collections, it must be the name of the property containing the collection. ! </pre> ! <pre> Note that the cascade attribute is ignored for toplevel collections. --> ! </pre> ! <pre> <!ELEMENT map ( jcs-cache?, *************** *** 231,235 **** <!ATTLIST map cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST map order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT set ( jcs-cache?, --- 270,275 ---- <!ATTLIST map cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST map order-by CDATA #IMPLIED> <!-- default: none --> ! </pre> ! <pre> <!ELEMENT set ( jcs-cache?, *************** *** 245,249 **** <!ATTLIST set cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST set order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT bag ( jcs-cache?, --- 285,290 ---- <!ATTLIST set cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST set order-by CDATA #IMPLIED> <!-- default: none --> ! </pre> ! <pre> <!ELEMENT bag ( jcs-cache?, *************** *** 258,262 **** <!ATTLIST bag cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST bag order-by CDATA #IMPLIED> <!-- default: none --> ! <!ELEMENT list ( jcs-cache?, --- 299,304 ---- <!ATTLIST bag cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> <!ATTLIST bag order-by CDATA #IMPLIED> <!-- default: none --> ! </pre> ! <pre> <!ELEMENT list ( jcs-cache?, *************** *** 270,274 **** <!ATTLIST list lazy (true|false) "false"> <!ATTLIST list cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!ELEMENT array ( jcs-cache?, --- 312,317 ---- <!ATTLIST list lazy (true|false) "false"> <!ATTLIST list cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! </pre> ! <pre> <!ELEMENT array ( jcs-cache?, *************** *** 282,293 **** <!ATTLIST array element-class CDATA #IMPLIED> <!ATTLIST array cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! <!ELEMENT primitive-array (jcs-cache?, key, index, element)> <!ATTLIST primitive-array role CDATA #REQUIRED> <!ATTLIST primitive-array table CDATA #IMPLIED> <!-- default: rolename --> <!ATTLIST primitive-array schema CDATA #IMPLIED> <!-- default: none --> ! <!-- Declares the element type of a collection of basic type --> ! <!ELEMENT element (column*)> <!ATTLIST element column CDATA #IMPLIED> --- 325,339 ---- <!ATTLIST array element-class CDATA #IMPLIED> <!ATTLIST array cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none --> ! </pre> ! <pre> <!ELEMENT primitive-array (jcs-cache?, key, index, element)> <!ATTLIST primitive-array role CDATA #REQUIRED> <!ATTLIST primitive-array table CDATA #IMPLIED> <!-- default: rolename --> <!ATTLIST primitive-array schema CDATA #IMPLIED> <!-- default: none --> ! </pre> ! <pre> <!-- Declares the element type of a collection of basic type --> ! </pre> ! <pre> <!ELEMENT element (column*)> <!ATTLIST element column CDATA #IMPLIED> *************** *** 296,311 **** <!ATTLIST element not-null (true|false) "false"> <!ATTLIST element unique (true|false) "false"> ! <!-- One to many association. This tag declares the entity-class element type of a collection and specifies a one-to-many relational model --> ! <!ELEMENT one-to-many EMPTY> <!ATTLIST one-to-many class CDATA #REQUIRED> <!-- No column declaration attributes required in this case. The primary key column of the associated class is already mapped elsewhere.--> ! <!-- Many to many association. This tag declares the entity-class element type of a collection and specifies a many-to-many relational model --> ! <!ELEMENT many-to-many (column*)> <!ATTLIST many-to-many class CDATA #REQUIRED> --- 342,361 ---- <!ATTLIST element not-null (true|false) "false"> <!ATTLIST element unique (true|false) "false"> ! </pre> ! <pre> <!-- One to many association. This tag declares the entity-class element type of a collection and specifies a one-to-many relational model --> ! </pre> ! <pre> <!ELEMENT one-to-many EMPTY> <!ATTLIST one-to-many class CDATA #REQUIRED> <!-- No column declaration attributes required in this case. The primary key column of the associated class is already mapped elsewhere.--> ! </pre> ! <pre> <!-- Many to many association. This tag declares the entity-class element type of a collection and specifies a many-to-many relational model --> ! </pre> ! <pre> <!ELEMENT many-to-many (column*)> <!ATTLIST many-to-many class CDATA #REQUIRED> *************** *** 314,321 **** <!ATTLIST many-to-many outer-join (true|false|auto) "auto"> <!-- unique makes no sense here since it would make the association one-to-many --> ! <!-- This tag declares that the element type of a collection is a named toplevel collection role. --> ! <!ELEMENT subcollection (column*)> <!ATTLIST subcollection column CDATA #IMPLIED> --- 364,373 ---- <!ATTLIST many-to-many outer-join (true|false|auto) "auto"> <!-- unique makes no sense here since it would make the association one-to-many --> ! </pre> ! <pre> <!-- This tag declares that the element type of a collection is a named toplevel collection role. --> ! </pre> ! <pre> <!ELEMENT subcollection (column*)> <!ATTLIST subcollection column CDATA #IMPLIED> *************** *** 324,338 **** <!ATTLIST subcollection not-null (true|false) "false"> <!ATTLIST subcollection unique (true|false) "false"> ! <!-- A composite element allows a collection to hold instances of an arbitrary class, without the requirement of joining to an entity table. Composite elements have component semantics - no shared references and ad hoc null value semantics. Composite elements may not hold nested collections. --> ! <!ELEMENT composite-element ( (property|many-to-one|collection|nested-composite-element)* )> <!ATTLIST composite-element class CDATA #REQUIRED> ! <!ELEMENT nested-composite-element ( (property|many-to-one|collection|nested-composite-element)* --- 376,393 ---- <!ATTLIST subcollection not-null (true|false) "false"> <!ATTLIST subcollection unique (true|false) "false"> ! </pre> ! <pre> <!-- A composite element allows a collection to hold instances of an arbitrary class, without the requirement of joining to an entity table. Composite elements have component semantics - no shared references and ad hoc null value semantics. Composite elements may not hold nested collections. --> ! </pre> ! <pre> <!ELEMENT composite-element ( (property|many-to-one|collection|nested-composite-element)* )> <!ATTLIST composite-element class CDATA #REQUIRED> ! </pre> ! <pre> <!ELEMENT nested-composite-element ( (property|many-to-one|collection|nested-composite-element)* *************** *** 340,388 **** <!ATTLIST nested-composite-element class CDATA #REQUIRED> <!ATTLIST nested-composite-element name CDATA #REQUIRED> ! <!-- Declares the type, column name (and, in the case of toplevel collections, an id generation strategy) for the key of a collection table. These keys are never exposed to the application. For toplevel collections, Hibernate makes no guarantee of key stability of a particular collection instance. --> ! <!ELEMENT key (column*)> <!ATTLIST key column CDATA #IMPLIED> <!ATTLIST key length CDATA #IMPLIED> ! <!ELEMENT generated-key (generator, column*)> <!ATTLIST generated-key column CDATA #IMPLIED> <!ATTLIST generated-key type CDATA #REQUIRED> <!ATTLIST generated-key length CDATA #IMPLIED> ! <!-- Declares the type and column mapping for a collection index (array or list index, or key of a map). --> ! <!ELEMENT index (column*)> <!ATTLIST index column CDATA #IMPLIED> <!ATTLIST index type CDATA #IMPLIED> <!-- required for maps --> <!ATTLIST index length CDATA #IMPLIED> ! <!-- Many to many association mapped to the key of a map. ie. a map keyed on entities. --> ! <!ELEMENT index-many-to-many (column*)> <!ATTLIST index-many-to-many class CDATA #REQUIRED> <!ATTLIST index-many-to-many column CDATA #IMPLIED> ! <!-- Composite index of a map ie. a map keyed on components. --> ! <!ELEMENT composite-index ( (key-property|key-many-to-one)+ )> <!ATTLIST composite-index class CDATA #REQUIRED> ! <!-- Generators generate unique identifiers. The class attribute specifies a Java class implementing an id generation algorithm. --> ! <!ELEMENT generator (param*)> <!ATTLIST generator class CDATA #REQUIRED> <!ELEMENT param (#PCDATA)> ! <!-- The column element is an alternative to column attributes and required for mapping associations to classes with composite ids. --> ! <!ELEMENT column EMPTY> <!ATTLIST column name CDATA #REQUIRED> --- 395,456 ---- <!ATTLIST nested-composite-element class CDATA #REQUIRED> <!ATTLIST nested-composite-element name CDATA #REQUIRED> ! </pre> ! <pre> <!-- Declares the type, column name (and, in the case of toplevel collections, an id generation strategy) for the key of a collection table. These keys are never exposed to the application. For toplevel collections, Hibernate makes no guarantee of key stability of a particular collection instance. --> ! </pre> ! <pre> <!ELEMENT key (column*)> <!ATTLIST key column CDATA #IMPLIED> <!ATTLIST key length CDATA #IMPLIED> ! </pre> ! <pre> <!ELEMENT generated-key (generator, column*)> <!ATTLIST generated-key column CDATA #IMPLIED> <!ATTLIST generated-key type CDATA #REQUIRED> <!ATTLIST generated-key length CDATA #IMPLIED> ! </pre> ! <pre> <!-- Declares the type and column mapping for a collection index (array or list index, or key of a map). --> ! </pre> ! <pre> <!ELEMENT index (column*)> <!ATTLIST index column CDATA #IMPLIED> <!ATTLIST index type CDATA #IMPLIED> <!-- required for maps --> <!ATTLIST index length CDATA #IMPLIED> ! </pre> ! <pre> <!-- Many to many association mapped to the key of a map. ie. a map keyed on entities. --> ! </pre> ! <pre> <!ELEMENT index-many-to-many (column*)> <!ATTLIST index-many-to-many class CDATA #REQUIRED> <!ATTLIST index-many-to-many column CDATA #IMPLIED> ! </pre> ! <pre> <!-- Composite index of a map ie. a map keyed on components. --> ! </pre> ! <pre> <!ELEMENT composite-index ( (key-property|key-many-to-one)+ )> <!ATTLIST composite-index class CDATA #REQUIRED> ! </pre> ! <pre> <!-- Generators generate unique identifiers. The class attribute specifies a Java class implementing an id generation algorithm. --> ! </pre> ! <pre> <!ELEMENT generator (param*)> <!ATTLIST generator class CDATA #REQUIRED> <!ELEMENT param (#PCDATA)> ! </pre> ! <pre> <!-- The column element is an alternative to column attributes and required for mapping associations to classes with composite ids. --> ! </pre> ! <pre> <!ELEMENT column EMPTY> <!ATTLIST column name CDATA #REQUIRED> *************** *** 392,409 **** <!ATTLIST column sql-type CDATA #IMPLIED> <!-- override default column type for hibernate type --> <!ATTLIST column index CDATA #IMPLIED> ! <!-- The jcs-cache element enables caching of an entity class. --> <!ELEMENT jcs-cache EMPTY> <!ATTLIST jcs-cache usage (read-only|read-write) #REQUIRED> ! <!-- The query element declares a named Hibernate query string --> ! <!ELEMENT query (#PCDATA)> <!ATTLIST query name CDATA #REQUIRED> </pre> ! <p class="Body"> ! ! <A href=http://sourceforge.net/projects/hibernate><IMG src=http://sourceforge.net/sflogo.php?group_id=40712></A></p> ! <!--End Section 1--> <!-- End SectLevel1 --> <br> --- 460,477 ---- <!ATTLIST column sql-type CDATA #IMPLIED> <!-- override default column type for hibernate type --> <!ATTLIST column index CDATA #IMPLIED> ! </pre> ! <pre> <!-- The jcs-cache element enables caching of an entity class. --> <!ELEMENT jcs-cache EMPTY> <!ATTLIST jcs-cache usage (read-only|read-write) #REQUIRED> ! </pre> ! <pre> <!-- The query element declares a named Hibernate query string --> ! </pre> ! <pre> <!ELEMENT query (#PCDATA)> <!ATTLIST query name CDATA #REQUIRED> </pre> ! <A href=http://sourceforge.net/projects/hibernate><IMG src=http://sourceforge.net/sflogo.php?group_id=40712></A><!--End Section 1--> <!-- End SectLevel1 --> <br> Index: features.aft =================================================================== RCS file: /cvsroot/hibernate/Hibernate/doc/features.aft,v retrieving revision 1.29 retrieving revision 1.30 diff -C2 -d -r1.29 -r1.30 *** features.aft 11 Nov 2002 23:57:13 -0000 1.29 --- features.aft 20 Nov 2002 14:55:46 -0000 1.30 *************** *** 14,17 **** --- 14,18 ---- * supports user-defined types * includes built-in support for a rich subset of JDK types including |Currency|, |Locale|, |BigDecimal|, etc. + [Constraint transparency] The application never needs to worry about foreign key constraint violations, even when there are circular references **Object-oriented query language Index: features.html =================================================================== RCS file: /cvsroot/hibernate/Hibernate/doc/features.html,v retrieving revision 1.49 retrieving revision 1.50 diff -C2 -d -r1.49 -r1.50 *** features.html 11 Nov 2002 23:57:13 -0000 1.49 --- features.html 20 Nov 2002 14:55:46 -0000 1.50 *************** *** 31,34 **** --- 31,37 ---- <li> includes built-in support for a rich subset of JDK types including <tt>Currency</tt>, <tt>Locale</tt>, <tt>BigDecimal</tt>, etc.</li> </ul> + <dl> + <dt><strong>Constraint transparency</strong><dd> The application never n... [truncated message content] |
