springnet-commits

[Mark P. <mar...@us...>]

Update of /cvsroot/springnet/Spring.Net/doc/reference/src
In directory sc8-pr-cvs8.sourceforge.net:/tmp/cvs-serv32454

Modified Files:
	transaction.xml 
Log Message:
SPRNET-689 - Add more documentation describing ITransactionAttributeSource implementations.

Index: transaction.xml
===================================================================
RCS file: /cvsroot/springnet/Spring.Net/doc/reference/src/transaction.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -C2 -d -r1.27 -r1.28
*** transaction.xml	17 Feb 2008 13:19:51 -0000	1.27
--- transaction.xml	3 Apr 2008 02:36:53 -0000	1.28
***************
*** 816,819 ****
--- 816,860 ----
            <classname>NameMatchTransactionAttributeSource</classname>, or
            <classname>MethodMapTransactionAttributeSource</classname>.</para>
+ 
+           <itemizedlist>
+             <listitem>
+               <para><classname>MatchAlwaysTransactionAttributeSource</classname>
+               is configured with a ITransactionAttribute instance that is
+               applied to all methods. The shorthand string representation,
+               i.e. PROPAGATION_REQUIRED can be used</para>
+             </listitem>
+ 
+             <listitem>
+               <para><classname>AttributesTransactionAttributeSource</classname>
+               : Use a standard. .NET attributes to specify the transactional
+               information. See <literal>TransactionAttribute</literal> class
+               for more information.</para>
+             </listitem>
+ 
+             <listitem>
+               <para><classname>NameMatchTransactionAttributeSource</classname>
+               allows ITransactionAttributes to be matched by method name. The
+               NameMap IDictionary property is used to specify the mapping. For
+               example</para>
+ 
+               <programlisting>&lt;object name="nameMatchTxAttributeSource" type="Spring.Transaction.Interceptor.NameMatchTransactionAttributeSource, Spring.Data"
+       &lt;property name="SomeDictionary"&gt;
+           &lt;dictionary&gt;
+               &lt;entry key="Execute" value="PROPAGATION_REQUIRES_NEW, -ApplicationException"/&gt;
+               &lt;entry key="HandleData" value="PROPAGATION_REQUIRES, -DataHandlerException"/&gt;
+           &lt;/dictionary&gt;
+       &lt;/property&gt;
+ 
+ &lt;/object&gt;</programlisting>
+             </listitem>
+ 
+             <listitem>
+               <para><classname>MethodMapTransactionAttributeSource</classname>
+               : Similar to NameMatchTransactionAttributeSource but specifies
+               fully qualified method names (i.e. type.method, assembly) and
+               wildcards can be used at the start or end of the method name for
+               matching multiple methods.</para>
+             </listitem>
+           </itemizedlist>
          </listitem>