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 }