org.perfectjpattern.core.api.structural.proxy
Interface IProxy<S>

Type Parameters:

S - Subject element type

All Superinterfaces:

InvocationHandler, ISurrogate<S>

All Known Implementing Classes:

AbstractProxy, ImageProxy, SynchronizedProxy

public interface IProxy<S>
extends ISurrogate<S>

Proxy Design Pattern: Provide a surrogate or placeholder for another object to control access to it. (Gamma et al, Design Patterns)

Responsibility Abstract definition of the "Proxy":

• maintains a reference that lets the proxy access the real subject. Proxy may refer to a Subject if the RealSubject and Subject interfaces are the same.
• provides an interface identical to Subject's so that a proxy can be substituted for for the real subject.
• controls access to the real subject and may be responsible for creating and deleting it.
• other responsibilites depend on the kind of proxy:
  • remote proxies are responsible for encoding a request and its arguments and for sending the encoded request to the real subject in a different address space.
  • virtual proxies may cache additional information about the real subject so that they can postpone accessing it. For example, the ImageProxy from the Motivation caches the real images's extent.
  • protection proxies check that the caller has the access permissions required to perform a request.

Version:

$Revision: 1.0 $ $Date: Nov 25, 2007 3:06:58 PM $

Author:

Giovanni Azua

Method Summary

S	getRealSubject() Returns the actual wrapped Subject instance
S	getSubject() Returns the Proxy wrapper instance

Methods inherited from interface org.perfectjpattern.core.api.structural.ISurrogate

getComponent

Methods inherited from interface java.lang.reflect.InvocationHandler

invoke

Method Detail

getSubject

S getSubject()

Returns the Proxy wrapper instance

Returns:

Proxy wrapper instance

getRealSubject

S getRealSubject()

Returns the actual wrapped Subject instance

Returns:

actual wrapped Subject instance