Class Proxy

src/main/java/groovy/util/Proxy.java:32–90

Dynamic groovy proxy for another object. All method invocations get forwarded to actual object, unless the proxy overrides it. See groovy/util/ProxyTest.groovy for usage details.

 * See groovy/util/ProxyTest.groovy for usage details.
 */
public class Proxy extends GroovyObjectSupport {

    private Object adaptee = null;

    /**
     * This method is for convenience.
     * It allows to get around the need for defining dump ctors in subclasses.
     * See unit tests for details.
     */
    public Proxy wrap(Object adaptee){
        setAdaptee(adaptee);
        return this;
    }

    /**
     * Returns the wrapped adaptee.
     *
     * @return the adaptee
     */
    public Object getAdaptee() {
        return adaptee;
    }

    /**
     * Sets the wrapped adaptee.
     *
     * @param adaptee the adaptee to wrap
     */
    public void setAdaptee(Object adaptee) {
        this.adaptee = adaptee;
    }

    /**
     * Invokes a proxy method or forwards the call to the adaptee.
     *
     * @param name the method name
     * @param args the invocation arguments
     * @return the invocation result
     */
    @Override
    public Object invokeMethod(String name, Object args) {
        try {
            return super.invokeMethod(name, args);
        }
        catch (MissingMethodException e) {
            return InvokerHelper.invokeMethod(adaptee, name, args);
        }
    }

    /**
     * Returns an iterator over the adaptee.
     *
     * @return an iterator for the adaptee
     */
    public Iterator iterator() {
        return InvokerHelper.asIterator(adaptee);
    }