Author: arminw
Date: Thu Aug 2 08:45:51 2007
New Revision: 562145
URL: http://svn.apache.org/viewvc?view=rev&rev=562145
Log:
introduce new state-detection attribute, add new auto-update mode 'create'
(OJB-36)
Modified:
db/ojb/branches/OJB_1_0_RELEASE/src/config/repository.dtd
Modified: db/ojb/branches/OJB_1_0_RELEASE/src/config/repository.dtd
URL:
http://svn.apache.org/viewvc/db/ojb/branches/OJB_1_0_RELEASE/src/config/repository.dtd?view=diff&rev=562145&r1=562144&r2=562145
==============================================================================
--- db/ojb/branches/OJB_1_0_RELEASE/src/config/repository.dtd (original)
+++ db/ojb/branches/OJB_1_0_RELEASE/src/config/repository.dtd Thu Aug 2
08:45:51 2007
@@ -21,13 +21,8 @@
-->
<!--
- Apache OJB - ObJectRelationalBridge
-
- Bridging Java objects and relational dabatases
-
- This DTD describes the grammar of the Descriptor repository
-
- Initial author: Thomas Mahler
+ ObJectRelationalBridge - Bridging Java objects and relational dabatases
+ This DTD describes the grammar of the Descriptor repository
-->
<!--
@@ -58,15 +53,16 @@
Note: This does NOT touch the jdbc-level of the connection.
The state-detection attribute is used by API's supporting automatic state
detection
- of persistence capable objects. The attribute indicate whether or not
mapped classes should
- be included in object state detection (automatic detection of changed
object fields).
+ of persistence capable objects (automatic detection of changed object
fields).
+ The attribute indicate whether or not the object state detection is
enabled for
+ all mapped classes. Default is "on".
-->
<!ATTLIST descriptor-repository
version (1.0) #REQUIRED
isolation-level (read-uncommitted | read-committed | repeatable-read |
serializable | optimistic | none) "read-uncommitted"
proxy-prefetching-limit CDATA "50"
- state-detection (true | false) "true"
+ state-detection (on | off | inherit) #IMPLIED
>
<!--
@@ -113,10 +109,6 @@
The jdbc-level attribute is used to specify the Jdbc compliance
level of the used Jdbc driver.
- DEPRECATED! The eager-release attribute was adopt to solve a problem
occured when
- using OJB within JBoss (3.0 <= version < 3.2.2, seems to be fixed in jboss
3.2.2).
- Only use within JBoss.
-
The batch-mode attribute allow to enable JDBC connection batch support
(if supported by used database), 'true' value allows to enable per-session
batch mode, whereas 'false' prohibits it.
@@ -489,8 +481,9 @@
instances when loaded from cache. It's set to false by default.
The state-detection attribute is used by API's supporting automatic
state detection
- of persistence capable objects. The attribute indicate whether or not
this class should
- be included in object state detection (automatic detection of changed
object fields).
+ of persistence capable objects (automatic detection of changed object
fields).
+ The attribute indicate whether or not the object state detection is
enabled for this class
+ or if it's inherited from a higher level entity. Default is "inherit".
The field-class attribute can be used to override the
<code>PersistentField</code>
implementation class.
@@ -510,7 +503,7 @@
factory-class CDATA #IMPLIED
factory-method CDATA #IMPLIED
refresh (true | false) "false"
- state-detection (true | false) "true"
+ state-detection (on | off | inherit) #IMPLIED
field-class CDATA #IMPLIED
>
@@ -623,11 +616,10 @@
refer to a Java attribute of the class, but is used as a unique
identifier only.
- The state-detection attribute is used by API's supporting automatic
state detection
- of persistence capable objects. The attribute indicate whether or not
this field should
- be included in object state detection (automatic detection of changed
object fields).
- If in the <em>state-detection</em> is generally disabled or in the
associated
- class-descriptor, this setting will (normally) be ignored.
+ The state-detection attribute is used by API's supporting automatic state
detection
+ of persistence capable objects (automatic detection of changed object
fields).
+ The attribute indicate whether or not the object state detection is
enabled for this field
+ or if it's inherited from a higher level entity. Default is "inherit".
The field-class attribute can be used to override the
<code>PersistentField</code>
implementation class.
@@ -656,7 +648,7 @@
precision CDATA #IMPLIED
scale CDATA #IMPLIED
access (readonly | readwrite | anonymous) "readwrite"
- state-detection (true | false) "true"
+ state-detection (on | off | inherit) #IMPLIED
field-class CDATA #IMPLIED
>
@@ -727,7 +719,7 @@
This attribute must be set to 'false' if using the OTM or JDO layer.
For ODMG it must be 'none' (since OJB 1.0.2). More info see OJB
documentation.
- The otm-dependent attribute specifies whether the OTM layer
automatically
+ DEPRECATED. The otm-dependent attribute specifies whether the OTM layer
automatically
creates the referred object or deletes it if the reference field is set to
null.
Also otm-dependent references behave as if auto-update and auto-delete
were set to true, but the auto-update and auto-delete attributes themself
@@ -743,7 +735,7 @@
refresh (true | false) "false"
auto-retrieve (true | false) "true"
- auto-update (none | link | object | true | false) "false"
+ auto-update (none | link | object | create | true | false) "false"
auto-delete (none | link | object | true | false) "false"
otm-dependent (true | false) "false"
>
@@ -845,7 +837,7 @@
This attribute must be set to 'false' if using the OTM or JDO layer.
Allowed ODMG settings please see OJB documentation.
- The otm-dependent attribute specifies whether the OTM layer
automatically
+ DEPRECATED. The otm-dependent attribute specifies whether the OTM layer
automatically
creates collection elements that were included into the collectionelements
and deletes collection elements that were excluded from the collection.
Also otm-dependent references behave as if auto-update and auto-delete
@@ -868,7 +860,7 @@
refresh (true | false) "false"
auto-retrieve (true | false) "true"
- auto-update (none | link | object | true | false) "false"
+ auto-update (none | link | object | create | true | false) "false"
auto-delete (none | link | object | true | false) "false"
otm-dependent (true | false) "false"
>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
