001: /*
002: $Id: MethodCallExpression.java 4287 2006-12-01 13:00:13Z blackdrag $
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
008: that the following conditions are met:
009:
010: 1. Redistributions of source code must retain copyright
011: statements and notices. Redistributions must also contain a
012: copy of this document.
013:
014: 2. Redistributions in binary form must reproduce the
015: above copyright notice, this list of conditions and the
016: following disclaimer in the documentation and/or other
017: materials provided with the distribution.
018:
019: 3. The name "groovy" must not be used to endorse or promote
020: products derived from this Software without prior written
021: permission of The Codehaus. For written permission,
022: please contact info@codehaus.org.
023:
024: 4. Products derived from this Software may not be called "groovy"
025: nor may "groovy" appear in their names without prior written
026: permission of The Codehaus. "groovy" is a registered
027: trademark of The Codehaus.
028:
029: 5. Due credit should be given to The Codehaus -
030: http://groovy.codehaus.org/
031:
032: THIS SOFTWARE IS PROVIDED BY THE CODEHAUS AND CONTRIBUTORS
033: ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
034: NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
035: FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
036: THE CODEHAUS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
037: INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
038: (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
039: SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
040: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
041: STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
042: ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
043: OF THE POSSIBILITY OF SUCH DAMAGE.
044:
045: */
046: package org.codehaus.groovy.ast.expr;
047:
048: import groovy.lang.MetaMethod;
049:
050: import org.codehaus.groovy.ast.ClassHelper;
051: import org.codehaus.groovy.ast.GroovyCodeVisitor;
052:
053: /**
054: * A method call on an object or class
055: *
056: * @author <a href="mailto:james@coredevelopers.net">James Strachan</a>
057: * @version $Revision: 4287 $
058: */
059: public class MethodCallExpression extends Expression {
060:
061: private Expression objectExpression;
062: private Expression method;
063: private Expression arguments;
064: private boolean spreadSafe = false;
065: private boolean safe = false;
066: private boolean implicitThis;
067:
068: public static Expression NO_ARGUMENTS = new TupleExpression();
069:
070: public MetaMethod getMetaMethod() {
071: return metaMethod;
072: }
073:
074: private MetaMethod metaMethod = null;
075:
076: public MethodCallExpression(Expression objectExpression,
077: String method, Expression arguments) {
078: this (objectExpression, new ConstantExpression(method),
079: arguments);
080: }
081:
082: public MethodCallExpression(Expression objectExpression,
083: Expression method, Expression arguments) {
084: this .objectExpression = objectExpression;
085: this .method = method;
086: this .arguments = arguments;
087: //TODO: set correct type here
088: // if setting type and a methodcall is the last expresssion in a method,
089: // then the method will return null if the method itself is not void too!
090: // (in bytecode after call: aconst_null, areturn)
091: this .setType(ClassHelper.DYNAMIC_TYPE);
092: this .setImplicitThis(true);
093: }
094:
095: public void visit(GroovyCodeVisitor visitor) {
096: visitor.visitMethodCallExpression(this );
097: }
098:
099: public Expression transformExpression(
100: ExpressionTransformer transformer) {
101: MethodCallExpression answer = new MethodCallExpression(
102: transformer.transform(objectExpression), transformer
103: .transform(method), transformer
104: .transform(arguments));
105: answer.setSafe(safe);
106: answer.setSourcePosition(this );
107: return answer;
108: }
109:
110: public Expression getArguments() {
111: return arguments;
112: }
113:
114: public Expression getMethod() {
115: return method;
116: }
117:
118: /**
119: * This method returns the method name as String if it is no dynamic
120: * calculated method name, but an constant.
121: */
122: public String getMethodAsString() {
123: if (!(method instanceof ConstantExpression))
124: return null;
125: ConstantExpression constant = (ConstantExpression) method;
126: return constant.getText();
127: }
128:
129: public Expression getObjectExpression() {
130: return objectExpression;
131: }
132:
133: public String getText() {
134: return objectExpression.getText() + "." + method.getText()
135: + arguments.getText();
136: }
137:
138: /**
139: * @return is this a safe method call, i.e. if true then if the source object is null
140: * then this method call will return null rather than throwing a null pointer exception
141: */
142: public boolean isSafe() {
143: return safe;
144: }
145:
146: public void setSafe(boolean safe) {
147: this .safe = safe;
148: }
149:
150: public boolean isSpreadSafe() {
151: return spreadSafe;
152: }
153:
154: public void setSpreadSafe(boolean value) {
155: spreadSafe = value;
156: }
157:
158: /**
159: * @return true if no object expression was specified otherwise if
160: * some expression was specified for the object on which to evaluate
161: * the method then return false
162: */
163: public boolean isImplicitThis() {
164: return implicitThis;
165: }
166:
167: public void setImplicitThis(boolean implicitThis) {
168: this .implicitThis = implicitThis;
169: }
170:
171: public String toString() {
172: return super .toString() + "[object: " + objectExpression
173: + " method: " + method + " arguments: " + arguments
174: + "]";
175: }
176:
177: public void setMethod(MetaMethod mmeth) {
178: this.metaMethod = mmeth;
179: super.setType(ClassHelper.make(mmeth.getReturnType()));
180: }
181: }
|