| 1 | | | <body> |
| 2 | | | <section> |
| 3 | | | <title>Tracing Injector Utilities</title> |
| 4 | | | <para> |
| 5 | | | To generate tracing output for debugging purposes the |
| 6 | | | java jdk 1.4 (JSR47) convenience methods for tracing are |
| 7 | | | used |
| 8 | | | (<a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Logger.html#entering(java.lang.String,%20java.lang.String)">entering</a>, |
| 9 | | | <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Logger.html#exiting(java.lang.String,%20java.lang.String)">exiting</a> |
| 10 | | | and |
| 11 | | | <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Logger.html#throwing(java.lang.String,%20java.lang.String,%20java.lang.Throwable)">throwing</a>). |
| 12 | | | To avoid that these same code must be added to each method that |
| 13 | | | should be subject of tracing this code is injected |
| 14 | | | as an aspect after the compilation on byte code level. |
| 15 | | | </para> |
| 16 | | | <para> |
| 17 | | | There is a ANT target that triggers the byte code injection. |
| 18 | | | <apidoc name="tracing"> |
| 19 | | | <class name="org.jcoderz.commons.tracing.TracingInjectorTask"/> |
| 20 | | | </apidoc> |
| 21 | | | </para> |
| 22 | | | <para> |
| 23 | | | If the instance is encapsulated by an public interface it is also possible to |
| 24 | | | use a dynamic proxy to get the tracing logging. This is supported by the |
| 25 | | | TracingProxy utility class. |
| 26 | | | </para> |
| 27 | | | </section> |
| 28 | | | </body> |