01: /*
02: * $Id: Proxy.java 4098 2006-10-10 16:09:48Z blackdrag $
03: *
04: * Copyright 2003 (C) James Strachan and Bob Mcwhirter. All Rights Reserved.
05: *
06: * Redistribution and use of this software and associated documentation
07: * ("Software"), with or without modification, are permitted provided that the
08: * following conditions are met: 1. Redistributions of source code must retain
09: * copyright statements and notices. Redistributions must also contain a copy
10: * of this document. 2. Redistributions in binary form must reproduce the above
11: * copyright notice, this list of conditions and the following disclaimer in
12: * the documentation and/or other materials provided with the distribution. 3.
13: * The name "groovy" must not be used to endorse or promote products derived
14: * from this Software without prior written permission of The Codehaus. For
15: * written permission, please contact info@codehaus.org. 4. Products derived
16: * from this Software may not be called "groovy" nor may "groovy" appear in
17: * their names without prior written permission of The Codehaus. "groovy" is a
18: * registered trademark of The Codehaus. 5. Due credit should be given to The
19: * Codehaus - http://groovy.codehaus.org/
20: *
21: * THIS SOFTWARE IS PROVIDED BY THE CODEHAUS AND CONTRIBUTORS ``AS IS'' AND ANY
22: * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
23: * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
24: * DISCLAIMED. IN NO EVENT SHALL THE CODEHAUS OR ITS CONTRIBUTORS BE LIABLE FOR
25: * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
27: * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
28: * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
31: * DAMAGE.
32: *
33: */
34: package groovy.util;
35:
36: import java.util.Iterator;
37:
38: import groovy.lang.GroovyObjectSupport;
39: import groovy.lang.MissingMethodException;
40: import org.codehaus.groovy.runtime.InvokerHelper;
41:
42: /**
43: * Dynamic groovy proxy for another object. All method
44: * invocations get forwarded to actual object, unless the proxy overrides it.
45: * See groovy/util/ProxyTest.groovy for usage details.
46: *
47: * @author Troy Heninger
48: * @author Dierk Koenig
49: */
50: public class Proxy extends GroovyObjectSupport {
51:
52: private Object adaptee = null;
53:
54: /**
55: * This method is for convenience.
56: * It allows to get around the need for defining dump ctors is subclasses.
57: * See unit tests for details.
58: */
59: public Proxy wrap(Object adaptee) {
60: setAdaptee(adaptee);
61: return this ;
62: }
63:
64: public Object getAdaptee() {
65: return adaptee;
66: }
67:
68: public void setAdaptee(Object adaptee) {
69: this .adaptee = adaptee;
70: }
71:
72: public Object invokeMethod(String name, Object args) {
73: try {
74: return super .invokeMethod(name, args);
75: } catch (MissingMethodException e) {
76: return InvokerHelper.getMetaClass(adaptee).invokeMethod(
77: adaptee, name, args);
78: }
79: }
80:
81: public Iterator iterator() {
82: return InvokerHelper.asIterator(adaptee);
83: }
84:
85: }
|