You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by de...@apache.org on 2007/01/13 01:36:51 UTC
svn commit: r495801 - /jakarta/commons/sandbox/proxy/trunk/xdocs/index.xml
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: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org