Proxy factories encapsulate all necessary proxying logic away from your code. Switching proxying @@ -59,32 +59,72 @@

- - +

Object providers provide the objects which will be the "target" of a proxy. There are two types of object providers: + +

+ A core object provider provides a core implementation object. Commons Proxy supports + many different implementations including: +

+ + + + + + + + + +

Constant	Always returns a specific object
Bean	Merely instantiates an object of a specified class each time
Cloning	Reflectively calls the public clone() method on a Cloneable object
Hessian	Returns a Hessian-based service object
Burlap	Returns a Burlap-based service object
Apache XML-RPC	Returns an Apache XML-RPC-based service object
JAX-RPC	Returns a JAX-RPC-based service object
Session Bean	Returns a reference to a Session EJB (stateless session beans only)

+ + +

+ A decorating object provider decorates the object returned by another provider. + Commons Proxy provides a few implementations including: +

+ + + + +

Singleton	Calls a nested provider at most once, returning that original value on all subsequent invocations
Cached	Returns an object from a cache (if available). If no object is available in the cache, the nested provider is called
Pooled	Returns an object from a pool, creating new objects using the nested provider

+ + -

Core Object Providers - a provider which provides the core implementation - object.
Decorating Object Providers - a provider which decorates the object returned by - another provider.

- - +

+ An invocation handler handles all + method invocations using a single method. Commons Proxy provides a couple invocation handler implementations: + + + + +
Null A provider which always returns a specific object
Apache XML-RPC Uses Apache XML-RPC to fulfill the method invocation
Cloning A provider which reflectively calls the public clone() method on a Cloneable object
+

+ +

Commons Proxy uses the AOP Alliance API for method interceptor support. Method interceptors provide rudimentary aspect-oriented programming support, allowing you to alter the results/effects of a method invocation without actually - changing the implementation of the method itself. Commons Proxy provides a - filtered - method interceptor implementation allowing you to specify which methods are intercepted using a - method filter. + changing the implementation of the method itself. Commons Proxy provides a few method interceptor + implementations including: + + + + +
Executor Uses an + Executor to execute the method in possibly another thread (only void methods are supported).
Logging Logs all method invocations using the + Jakarta Commons Logging API
Filtered Optionally intercepts a method invocation based on a + method filter

- +

--------------------------------------------------------------------- To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org For additional commands, e-mail: commons-dev-help@jakarta.apache.org

Null	A provider which always returns a specific object
Apache XML-RPC	Uses Apache XML-RPC to fulfill the method invocation
Cloning	A provider which reflectively calls the public clone() method on a Cloneable object

Executor	Uses an + Executor to execute the method in possibly another thread (only void methods are supported).
Logging	Logs all method invocations using the + Jakarta Commons Logging API
Filtered	Optionally intercepts a method invocation based on a + method filter