Update of /cvsroot/xdoclet/xdoclet/modules/bea/src/META-INF
In directory
sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv3106/modules/bea/src/META-INF
Modified Files:
xtags.xml
Log Message:
support for the verify-columns and optimistic-column elements added. Thanks to
Enno Runne for patches. (XDT-1335)
Index: xtags.xml
===================================================================
RCS file: /cvsroot/xdoclet/xdoclet/modules/bea/src/META-INF/xtags.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -r1.16 -r1.17
*** xtags.xml 11 Apr 2005 21:03:47 -0000 1.16
--- xtags.xml 11 Apr 2005 21:21:15 -0000 1.17
***************
*** 256,259 ****
--- 256,315 ----
</condition>
</parameter>
+ <parameter type="text">
+ <name>verify-columns</name>
+ <usage-description>
+ The verify-columns element is used to specify the columns in a
table
+ that should be checked for validity when optimistic concurrency is
+ used. Legal values are 'Read', 'Modified', 'Version', and
'Timestamp'.
+ Columns are checked at the end of a transaction, before
committing, to
+ make sure that no other transaction has modified the column's
data.
+ When 'Read' is specified, all of the columns in the table that
have
+ been read during the transaction are checked. When 'Modified' is
+ specified, only the columns that have been updated by the current
+ transaction are checked.
+
+ The 'Version' and 'Timestamp' options are used to specify that a
+ version or timestamp (pseudo)column exists in the table and that
this
+ column is used to implement optimistic concurrency. The EJB
container
+ will automatically increment the version or timestamp column when
a
+ row in the table is updated. The name of the version (or
timestamp)
+ column is specified using the optimistic-column element. It is
not
+ necessary to map this column to a cmp field, unless desired.
+
+ If a bean is mapped to multiple tables, checking is only
performed on
+ the tables that are updated during the transaction. The
verify-columns
+ elements for each table don't need to have the same value.
+ </usage-description>
+ <mandatory>false</mandatory>
+ <condition-description>Entity beans</condition-description>
+ <condition type="type">
+ <condition-parameter>javax.ejb.EntityBean</condition-parameter>
+ </condition>
+ <option-sets>
+ <option-set>
+ <options>
+ <option>Read,</option>
+ <option>Modified</option>
+ <option>Version,Timestamp</option>
+ <option>Timestamp</option>
+ </options>
+ </option-set>
+ </option-sets>
+ </parameter>
+ <parameter type="text">
+ <name>optimistic-column</name>
+ <usage-description>
+ The optimistic-column element is used to denote a database column
that
+ contains a version or timestamp value used to implement optimistic
+ concurrency. This element is case maintaining, though not all
+ databases are case sensitive. The value of this element is
ignored
+ unless verify-columns has a value of 'Version' or 'Timestamp.
+ </usage-description>
+ <mandatory>false</mandatory>
+ <condition-description>Entity beans</condition-description>
+ <condition type="type">
+ <condition-parameter>javax.ejb.EntityBean</condition-parameter>
+ </condition>
+ </parameter>
</tag>
<tag>
-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
_______________________________________________
xdoclet-devel mailing list
xdoclet-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
