001    /*
002     * $Id: Proxy.java,v 1.3 2005/06/04 16:29:13 dierk Exp $
003     * 
004     * Copyright 2003 (C) James Strachan and Bob Mcwhirter. All Rights Reserved.
005     * 
006     * Redistribution and use of this software and associated documentation
007     * ("Software"), with or without modification, are permitted provided that the
008     * following conditions are met: 1. Redistributions of source code must retain
009     * copyright statements and notices. Redistributions must also contain a copy
010     * of this document. 2. Redistributions in binary form must reproduce the above
011     * copyright notice, this list of conditions and the following disclaimer in
012     * the documentation and/or other materials provided with the distribution. 3.
013     * The name "groovy" must not be used to endorse or promote products derived
014     * from this Software without prior written permission of The Codehaus. For
015     * written permission, please contact info@codehaus.org. 4. Products derived
016     * from this Software may not be called "groovy" nor may "groovy" appear in
017     * their names without prior written permission of The Codehaus. "groovy" is a
018     * registered trademark of The Codehaus. 5. Due credit should be given to The
019     * Codehaus - http://groovy.codehaus.org/
020     * 
021     * THIS SOFTWARE IS PROVIDED BY THE CODEHAUS AND CONTRIBUTORS ``AS IS'' AND ANY
022     * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
023     * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
024     * DISCLAIMED. IN NO EVENT SHALL THE CODEHAUS OR ITS CONTRIBUTORS BE LIABLE FOR
025     * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
026     * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
027     * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
028     * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
029     * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
030     * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
031     * DAMAGE.
032     *  
033     */
034    package groovy.util;
035    
036    import groovy.lang.GroovyObjectSupport;
037    import groovy.lang.MissingMethodException;
038    import org.codehaus.groovy.runtime.InvokerHelper;
039    
040    /**
041     * Dynamic groovy proxy for another object.  All method
042     * invocations get forwarded to actual object, unless the proxy overrides it.
043     * See groovy/util/ProxyTest.groovy for usage details.
044     *
045     * @author Troy Heninger
046     * @author Dierk Koenig
047     */
048    public class Proxy extends GroovyObjectSupport {
049    
050        private Object adaptee = null;
051    
052        /**
053         * This method is for convenience.
054         * It allows to get around the need for defining dump ctors is subclasses.
055         * See unit tests for details.
056         */
057        public Proxy wrap(Object adaptee){
058            setAdaptee(adaptee);
059            return this;
060        }
061    
062        public Object getAdaptee() {
063            return adaptee;
064        }
065    
066        public void setAdaptee(Object adaptee) {
067            this.adaptee = adaptee;
068        }
069    
070        public Object invokeMethod(String name, Object args) {
071            try {
072                return super.invokeMethod(name, args);
073            }
074            catch (MissingMethodException e) {
075                return InvokerHelper.getMetaClass(adaptee).invokeMethod(adaptee, name, args);
076            }
077        }
078    
079    }