Update of /cvsroot/springnet/Spring.Net/doc/reference/src
In directory sc8-pr-cvs8.sourceforge.net:/tmp/cvs-serv28150
Modified Files:
ado.xml aop-aspect-library.xml
Log Message:
doc improvements.
Index: ado.xml
===================================================================
RCS file: /cvsroot/springnet/Spring.Net/doc/reference/src/ado.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -d -r1.17 -r1.18
*** ado.xml 3 Oct 2007 14:38:35 -0000 1.17
--- ado.xml 11 Oct 2007 06:02:13 -0000 1.18
***************
*** 877,881 ****
section <link linkend="key-abstractions">key abstractions</link> in the
chapter on transactions for more comprehensive introduction to transaction
! management. </para>
<para>To use local transactions, those with only one transactional
--- 877,881 ----
section <link linkend="key-abstractions">key abstractions</link> in the
chapter on transactions for more comprehensive introduction to transaction
! management.</para>
<para>To use local transactions, those with only one transactional
***************
*** 886,890 ****
<classname>HibernatePlatformTransaction</classname> manager which is
described more in the section on <link linkend="orm-tx-mgmt">ORM
! transaction management</link>. </para>
<para>While it is most common to use Spring's <link
--- 886,890 ----
<classname>HibernatePlatformTransaction</classname> manager which is
described more in the section on <link linkend="orm-tx-mgmt">ORM
! transaction management</link>.</para>
<para>While it is most common to use Spring's <link
***************
*** 1737,1745 ****
implementation of IRowMapper that is used to extract the business
objects is 'registered' with the class and then later retrieved by name
! as a fictional output parameter. You may also register IRowCallback and
! IResultSetExtractor callback interfaces via the AddRowCallback and
! AddResultSetExtractor methods.</para>
! <para></para>
</sect2>
--- 1737,1747 ----
implementation of IRowMapper that is used to extract the business
objects is 'registered' with the class and then later retrieved by name
! as a fictional output parameter. You may also register
! <classname>IRowCallback</classname> and
! <classname>IResultSetExtractor</classname> callback interfaces via the
! AddRowCallback and AddResultSetExtractor methods.</para>
! <para>Return values from stored procedures are contained under the key
! "RETURN_VALUE".</para>
</sect2>
Index: aop-aspect-library.xml
===================================================================
RCS file: /cvsroot/springnet/Spring.Net/doc/reference/src/aop-aspect-library.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** aop-aspect-library.xml 11 Oct 2007 01:29:35 -0000 1.6
--- aop-aspect-library.xml 11 Oct 2007 06:02:13 -0000 1.7
***************
*** 466,470 ****
<para>You declare the logging advice in IoC container with the following
XML fragment. Alternatively, you can use the class
! <classname>SimpleLoggingAdvice</classname> progammatically. </para>
<programlisting><object name="exceptionHandlingAdvice" type="Spring.Aspects.Logging.SimpleLoggingAdvice, Spring.Aop">
--- 466,470 ----
<para>You declare the logging advice in IoC container with the following
XML fragment. Alternatively, you can use the class
! <classname>SimpleLoggingAdvice</classname> progammatically.</para>
<programlisting><object name="exceptionHandlingAdvice" type="Spring.Aspects.Logging.SimpleLoggingAdvice, Spring.Aop">
***************
*** 478,485 ****
<para>The default values for LogUniqueIdentifier, LogExecutionTime, and
LogMethodArguments are false. The default separator value is ", " and the
! default log level is Common.Logging's LogLevel.Trace. </para>
! <para>You can subclass SimpleLoggingAdvice and override the methods
! </para>
<itemizedlist>
--- 478,484 ----
<para>The default values for LogUniqueIdentifier, LogExecutionTime, and
LogMethodArguments are false. The default separator value is ", " and the
! default log level is Common.Logging's LogLevel.Trace.</para>
! <para>You can subclass SimpleLoggingAdvice and override the methods</para>
<itemizedlist>
***************
*** 505,508 ****
--- 504,527 ----
a Guid. You can alter this behavior by overriding the method
<literal>string CreateUniqueIdentifier()</literal>.</para>
+
+ <para>As an example of the Logging advice's output, adding the advice to
+ the method </para>
+
+ <programlisting>public int Bark(string message, int[] luckyNumbers)
+ {
+ return 4;
+ }</programlisting>
+
+ <para>And calling Bark("hello", new int[]{1, 2, 3} ), results in the
+ following output</para>
+
+ <programlisting>Entering Bark, 5d2bad47-62cd-435b-8de7-91f12b7f433e, message=hello; luckyNumbers=System.Int32[]
+
+ Exiting Bark, 5d2bad47-62cd-435b-8de7-91f12b7f433e, 30453.125 ms, return=4</programlisting>
+
+ <para>The method parameters values are obtained using the ToString()
+ method. If you would like to have an alternate implementation, say to view
+ some values in an array, override the method string
+ GetMethodArgumentAsString(IMethodInvocation invocation).</para>
</sect1>
***************
*** 527,531 ****
<para>The meaning is: when an exception that has 'ArithmeticException' in
its classname is thrown, retry the invocaiton up to 3 times and delay for
! 1 second in between each retry event. </para>
<para>You can also provide a SpEL (Spring Expression Language) expression
--- 546,550 ----
<para>The meaning is: when an exception that has 'ArithmeticException' in
its classname is thrown, retry the invocaiton up to 3 times and delay for
! 1 second in between each retry event.</para>
<para>You can also provide a SpEL (Spring Expression Language) expression
***************
*** 553,557 ****
the rate expression is that you can easily specify some exponential retry
rate (a bigger delay for each retry attempt) or call out to a custom
! function developed for this purpose. </para>
<para>When using a SpEL expression for the filter condition or for the
--- 572,576 ----
the rate expression is that you can easily specify some exponential retry
rate (a bigger delay for each retry attempt) or call out to a custom
! function developed for this purpose.</para>
<para>When using a SpEL expression for the filter condition or for the
***************
*** 578,582 ****
</itemizedlist>You declare the advice in IoC container with the
following XML fragment. Alternatively, you can use the
! <classname>RetryAdvice</classname> class progammatically. </para>
<programlisting><object name="exceptionHandlingAdvice" type="Spring.Aspects.RetryAdvice, Spring.Aop">
--- 597,601 ----
</itemizedlist>You declare the advice in IoC container with the
following XML fragment. Alternatively, you can use the
! <classname>RetryAdvice</classname> class progammatically.</para>
<programlisting><object name="exceptionHandlingAdvice" type="Spring.Aspects.RetryAdvice, Spring.Aop">
|