svn commit: r1583812 - in /isis/site/trunk/content: components/objectstores/jdo/transaction-management.md documentation.md

[da...@apache.org]

Author: danhaywood
Date: Tue Apr  1 22:35:33 2014
New Revision: 1583812

URL: http://svn.apache.org/r1583812
Log:
isis xactn mgmt page

Added:
    isis/site/trunk/content/components/objectstores/jdo/transaction-management.md
Modified:
    isis/site/trunk/content/documentation.md

Added: isis/site/trunk/content/components/objectstores/jdo/transaction-management.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/components/objectstores/jdo/transaction-management.md?rev=1583812&view=auto
==============================================================================
--- isis/site/trunk/content/components/objectstores/jdo/transaction-management.md (added)
+++ isis/site/trunk/content/components/objectstores/jdo/transaction-management.md Tue Apr  1 22:35:33 2014
@@ -0,0 +1,9 @@
+Title: Transaction Management
+
+In Isis, every action invocation (in fact, every interaction) is automatically wrapped in a transaction, and any repository query automatically does a flush.
+
+What that means is that there's no need to explicitly start or commit transactions in Isis; this will be done for you.  Indeed, if you do try to manage transactions (eg by reaching into the JDO PersistenceManager exposed by the [IsisJdoSupport service](services/isisjdosupport-service.html), then you are likely to confuse Isis and get a stack trace for your trouble.
+
+On a related note, if you want to abort Isis' transaction, this can be done by throwing `RecoverableException` (or any subclass, eg `ApplicationException`).  The transaction will be aborted, and the exception message will be displayed to the user.
+
+If you throw any other exception (ie not a subclass of `RecoverableException`), then the users will see an error page (if Wicket viewer) or a 500 (if Restful Objects viewer).

Modified: isis/site/trunk/content/documentation.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/documentation.md?rev=1583812&r1=1583811&r2=1583812&view=diff
==============================================================================
--- isis/site/trunk/content/documentation.md (original)
+++ isis/site/trunk/content/documentation.md Tue Apr  1 22:35:33 2014
@@ -539,16 +539,22 @@ Other
 {col-md-4
 
 
-####  <a name="jdo-objectstore-jdo-mapping-hints">JDO mapping hints</a>
+####  <a name="jdo-objectstore-jdo-mapping-hints">JDO hints</a>
 <p class="display:none"/>
 
+Mapping:
+
 * [Mapping Mandatory and Optional Properties](components/objectstores/jdo/mapping-mandatory-and-optional-properties.html)
 * [Mapping JODA Dates](components/objectstores/jdo/mapping-joda-dates.html)
 * [Mapping BigDecimals](components/objectstores/jdo/mapping-bigdecimals.html)
 * [Mapping Blobs](components/objectstores/jdo/mapping-blobs.html)
-* [Lazy Loading](components/objectstores/jdo/lazy-loading.html)
 * [Managed 1:m bidirectional relationships](components/objectstores/jdo/managed-1-to-m-relationships.html)
 
+Other:
+
+* [Lazy Loading](components/objectstores/jdo/lazy-loading.html)
+* [Transaction Management](components/objectstores/jdo/transaction-management.html)
+
   
 }