From d4aa04aee8f05c8a3e61e2d513b4c85b4c19ea29 Mon Sep 17 00:00:00 2001 From: "David E. Jones" Date: Sun, 26 Jul 2009 17:45:24 +0000 Subject: [PATCH] Added some documentation about the service definition transaction related attributes git-svn-id: https://svn.apache.org/repos/asf/ofbiz/trunk@797962 13f79535-47bb-0310-9956-ffa450edef68 --- framework/service/dtd/services.xsd | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/framework/service/dtd/services.xsd b/framework/service/dtd/services.xsd index 580466d49a..91606c3427 100644 --- a/framework/service/dtd/services.xsd +++ b/framework/service/dtd/services.xsd @@ -86,6 +86,12 @@ under the License. + + + If set to true and there is no transaction already in place the Service Engine will begin one. + If set to false or there is a transaction already in place the Service Engine will do nothing (this also means that if set to false and a transaction is already in place it will do nothing). + + @@ -94,6 +100,13 @@ under the License. + + + If set to true and there is a transaction already in place the Service Engine will suspend that transaction, begin a new one just for this service, commit or rollback the local transaction when the service is complete, and will resume the original transaction. + If set to true and there is no transaction already in place it will just begin a transaction and manage it as would be done for a normal user-transaction=true. + If use-transaction=false this setting is ignored. + + @@ -106,6 +119,8 @@ under the License. Defines the timeout for the transaction, in seconds. Defaults to the value set in the TransactionFactory being used (typically 60 seconds). + This value is only used if this service begins a transaction (either require-new-transaction=true, or use-transaction=true and there is no other transaction already in place). + If use-transaction=false this setting is ignored.