Author: dennisl Date: Fri Jan 12 16:36:50 2007 New Revision: 495801 URL: http://svn.apache.org/viewvc?view=rev&rev=495801 Log: Fix the xdoc syntax.
Modified: jakarta/commons/sandbox/proxy/trunk/xdocs/index.xml Modified: jakarta/commons/sandbox/proxy/trunk/xdocs/index.xml URL: http://svn.apache.org/viewvc/jakarta/commons/sandbox/proxy/trunk/xdocs/index.xml?view=diff&rev=495801&r1=495800&r2=495801 ============================================================================== --- jakarta/commons/sandbox/proxy/trunk/xdocs/index.xml (original) +++ jakarta/commons/sandbox/proxy/trunk/xdocs/index.xml Fri Jan 12 16:36:50 2007 @@ -27,6 +27,7 @@ The <em>Proxy</em> design pattern (<a href="http://www.amazon.com/exec/obidos/tg/detail/-/0201633612/qid=1125413337/sr=1-1/ref=sr_1_1/104-0714405-6441551?v=glance&s=books">GoF</a>) allows you to provide "a surrogate or placeholder for another object to control access to it". Proxies can be used in many ways. Some of which are: + </p> <ul> <li><b>Deferred Initialization</b> - the proxy acts as a "stand-in" for the actual implementation allowing it to be instantiated only when absolutely necessary.</li> @@ -36,6 +37,7 @@ <li><b>Performance Monitoring</b> - the proxy can log each method invocation to a performance monitor allowing system administrators to see what parts of the system are potentially bogged down.</li> </ul> + <p> <em>Commons Proxy</em> supports dynamic proxy generation using proxy factories, object providers, invokers, and interceptors. </p> @@ -48,6 +50,7 @@ <a href="http://cglib.sourceforge.net">CGLIB</a>, and <a href="http://www.jboss.org/products/javassist">Javassist</a>. Proxy factories allow you to create three different types of proxy objects: + </p> <ul> <li><b>Delegator Proxies</b> - a proxy that merely delegates each method invocation to an object provided by an <a href="apidocs/org/apache/commons/proxy/ObjectProvider.html">object provider</a>.</li> @@ -57,8 +60,6 @@ <a href="apidocs/org/apache/commons/proxy/Invoker.html">invoker</a> to handle all method invocations.</li> </ul> - - </p> </section> <section name="Object Providers"> <p> @@ -99,22 +100,23 @@ <p> An <a href="apidocs/org/apache/commons/proxy/Invoker.html">invoker</a> handles all method invocations using a single method. <em>Commons Proxy</em> provides a few invoker implementations: + </p> <table border="0"> <tr><td><b>Null</b></td><td>Always returns a null (useful for the "Null Object" pattern)</td></tr> <tr><td><b>Apache XML-RPC</b></td><td>Uses <a href="http://ws.apache.org/xmlrpc/">Apache XML-RPC</a> to fulfill the method invocation</td></tr> <tr><td><b>Invocation Handler Adapter</b></td><td>Adapts the JDK <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/reflect/InvocationHandler.html">InvocationHandler</a> interface to the <em>Commons Proxy</em> <a href="apidocs/org/apache/commons/proxy/Invoker.html">Invoker</a> interface.</td></tr> </table> - </p> </section> <section name="Interceptors"> <p> - <cm>Commons Proxy</cm> allows you to "intercept" a method invocation using <a href="apidocs/org/apache/commons/proxy/Interceptor.html">Interceptors</a>. + <em>Commons Proxy</em> allows you to "intercept" a method invocation using <a href="apidocs/org/apache/commons/proxy/Interceptor.html">Interceptors</a>. Interceptors provide <em>rudimentary</em> aspect-oriented programming support, allowing you to alter the results/effects of a method invocation without actually changing the implementation of the method itself. <em>Commons Proxy</em> provides a few interceptor implementations including: + </p> <table border="0"> <tr><td><b>Executor</b></td><td>Uses an <a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/Executor.html">Executor</a> to execute the method in possibly another thread (only void methods are supported).</td></tr> @@ -126,19 +128,16 @@ <em>Commons Proxy</em> <a href="apidocs/org/apache/commons/proxy/Interceptor.html">Interceptor</a> interface.</td></tr> </table> - </p> </section> </section> <section name="Status"> - <p> <ul> <li>This code is in the commons <i>sandbox</i>.</li> <li>The code is unreleased.</li> <li>Methods and classes can and will appear and disappear without warning.</li> <li>If you like the code and want to push it towards a release, join the mailing list!</li> </ul> - </p> </section> </body> </document> --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]