View Javadoc

    1   /*
    2    * $Id: Proxy.java 4098 2006-10-10 16:09:48Z blackdrag $
    3    *
    4    * Copyright 2003 (C) James Strachan and Bob Mcwhirter. All Rights Reserved.
    5    *
    6    * Redistribution and use of this software and associated documentation
    7    * ("Software"), with or without modification, are permitted provided that the
    8    * following conditions are met: 1. Redistributions of source code must retain
    9    * 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          }
    76          catch (MissingMethodException e) {
    77              return InvokerHelper.getMetaClass(adaptee).invokeMethod(adaptee, name, args);
    78          }
    79      }
    80
    81      public Iterator iterator() {
    82          return InvokerHelper.asIterator(adaptee);
    83      }
    84
    85  }