[Springnet-commits] Spring.Net/doc/reference/src aop-aspect-library.xml, 1.9, 1.10

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

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

Modified Files:
	aop-aspect-library.xml 
Log Message:
update docs logging docs for accuracy and additional description of other configurable properties.

Index: aop-aspect-library.xml
===================================================================
RCS file: /cvsroot/springnet/Spring.Net/doc/reference/src/aop-aspect-library.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -d -r1.9 -r1.10
*** aop-aspect-library.xml	11 Oct 2007 17:59:15 -0000	1.9
--- aop-aspect-library.xml	13 Oct 2007 22:34:10 -0000	1.10
***************
*** 468,477 ****
      <classname>SimpleLoggingAdvice</classname> progammatically.</para>
  
!     <programlisting>&lt;object name="exceptionHandlingAdvice" type="Spring.Aspects.Logging.SimpleLoggingAdvice, Spring.Aop"&gt;
    &lt;property name="logUniqueIdentifier" value="true"/&gt;               
    &lt;property name="logExecutionTime"    value="true"/&gt;               
    &lt;property name="logMethodArguments"  value="true"/&gt;
    &lt;property name="Separator"           value=";"/&gt;
!   &lt;property name="LogLevel"            value="LogLevel.Debug"/&gt;
  &lt;/object&gt;</programlisting>
  
--- 468,482 ----
      <classname>SimpleLoggingAdvice</classname> progammatically.</para>
  
!     <programlisting>&lt;object name="loggingAdvice" type="Spring.Aspects.Logging.SimpleLoggingAdvice, Spring.Aop"&gt;
    &lt;property name="logUniqueIdentifier" value="true"/&gt;               
    &lt;property name="logExecutionTime"    value="true"/&gt;               
    &lt;property name="logMethodArguments"  value="true"/&gt;
+ 
    &lt;property name="Separator"           value=";"/&gt;
!   &lt;property name="LogLevel"            value="Info"/&gt;
! 
! 
!   &lt;property name="HideProxyTypeNames"  value="true"/&gt;
!   &lt;property name="UseDynamicLogger"    value="true"/&gt;
  &lt;/object&gt;</programlisting>
  
***************
*** 480,484 ****
      default log level is Common.Logging's LogLevel.Trace.</para>
  
!     <para>You can subclass SimpleLoggingAdvice and override the methods</para>
  
      <itemizedlist>
--- 485,503 ----
      default log level is Common.Logging's LogLevel.Trace.</para>
  
!     <para>You can set the name of the logger with the property
!     <property>LoggerName</property>, for example "DataAccessLayer" for a
!     logging advice that would be applied across the all the classes in the
!     data access layer. That works well when using a 'category' style of
!     logging. If you do not set the <property>LoggerName</property> property,
!     then the type name of the logging advice is used as the logging name.
!     Another approach to logging is to log based on the type of the object
!     being called, the target type. Since often this is a proxy class with a
!     relatively meaningless name, the property
!     <property>HideProxyTypeNames</property> can be set to true to show the
!     true target type and not the proxy type.</para>
! 
!     <para>To futher extend the functionality of the
!     <classname>SimpleLoggingAdvice</classname> you can subclass
!     <classname>SimpleLoggingAdvice</classname> and override the methods</para>
  
      <itemizedlist>
***************
*** 503,507 ****
      <para>The default implementation to calculate a unique identifer is to use
      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
--- 522,534 ----
      <para>The default implementation to calculate a unique identifer is to use
      a Guid. You can alter this behavior by overriding the method
!     <literal>string CreateUniqueIdentifier()</literal>. The
!     <classname>SimpleLoggingAdvice</classname> class inherits from
!     <classname>AbstractLoggingAdvice</classname>, which has the abstract
!     method <literal>object InvokeUnderLog(IMethodInvocation invocation, ILog
!     log)</literal> and you can also override the method <literal>ILog
!     GetLoggerForInvocation(IMethodInvocation invocation)</literal> to
!     customize the logger instance used for logging. Refer to the SDK
!     documentation for more details on subclassing
!     <classname>AbstractLoggingAdvice</classname>.</para>
  
      <para>As an example of the Logging advice's output, adding the advice to
***************
*** 524,527 ****
--- 551,559 ----
      some values in an array, override the method string
      GetMethodArgumentAsString(IMethodInvocation invocation).</para>
+ 
+     <para>The Spring 1.2 release will have an additional logging advice
+     implementation the leverages the Spring Expression Language to further
+     customize the content of the logging messages via simple configuration
+     using similar syntax to the retry and exception handling advice.</para>
    </sect1>