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]
