001 /* 002 * $Id: Proxy.java,v 1.5 2005/10/03 18:07:36 tug 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 }