/*******************************************************************************
* Copyright (c) 2000, 2010 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.wst.jsdt.internal.core;
import java.util.ArrayList;
import java.util.HashMap;
import org.eclipse.wst.jsdt.core.Flags;
import org.eclipse.wst.jsdt.core.IBuffer;
import org.eclipse.wst.jsdt.core.IClassFile;
import org.eclipse.wst.jsdt.core.IJavaScriptUnit;
import org.eclipse.wst.jsdt.core.IJavaScriptElement;
import org.eclipse.wst.jsdt.core.IMember;
import org.eclipse.wst.jsdt.core.IFunction;
import org.eclipse.wst.jsdt.core.ISourceRange;
import org.eclipse.wst.jsdt.core.IType;
import org.eclipse.wst.jsdt.core.ITypeRoot;
import org.eclipse.wst.jsdt.core.JavaScriptModelException;
import org.eclipse.wst.jsdt.core.Signature;
import org.eclipse.wst.jsdt.core.ToolFactory;
import org.eclipse.wst.jsdt.core.WorkingCopyOwner;
import org.eclipse.wst.jsdt.core.compiler.CharOperation;
import org.eclipse.wst.jsdt.core.compiler.IScanner;
import org.eclipse.wst.jsdt.core.compiler.ITerminalSymbols;
import org.eclipse.wst.jsdt.core.compiler.InvalidInputException;
import org.eclipse.wst.jsdt.internal.compiler.impl.Constant;
import org.eclipse.wst.jsdt.internal.compiler.lookup.TypeIds;
import org.eclipse.wst.jsdt.internal.core.util.MementoTokenizer;
/**
* @see IMember
*/
public abstract class Member extends SourceRefElement implements IMember {
protected Member(JavaElement parent) {
super(parent);
}
protected static boolean areSimilarMethods(
String name1, String[] params1,
String name2, String[] params2,
String[] simpleNames1) {
if (name1.equals(name2)) {
int params1Length = params1.length;
if (params1Length == params2.length) {
for (int i = 0; i < params1Length; i++) {
String simpleName1 =
simpleNames1 == null ?
Signature.getSimpleName(Signature.toString(params1[i])) :
simpleNames1[i];
String simpleName2 = Signature.getSimpleName(Signature.toString(params2[i]));
if (!simpleName1.equals(simpleName2)) {
return false;
}
}
return true;
}
}
return false;
}
/**
* Converts a field constant from the compiler's representation
* to the Java Model constant representation (Number or String).
*/
protected static Object convertConstant(Constant constant) {
if (constant == null)
return null;
if (constant == Constant.NotAConstant) {
return null;
}
switch (constant.typeID()) {
case TypeIds.T_boolean :
return constant.booleanValue() ? Boolean.TRUE : Boolean.FALSE;
case TypeIds.T_char :
return new Character(constant.charValue());
case TypeIds.T_double :
return new Double(constant.doubleValue());
case TypeIds.T_float :
return new Float(constant.floatValue());
case TypeIds.T_int :
return new Integer(constant.intValue());
case TypeIds.T_long :
return new Long(constant.longValue());
case TypeIds.T_short :
return new Short(constant.shortValue());
case TypeIds.T_JavaLangString :
return constant.stringValue();
default :
return null;
}
}
/*
* Helper method for SourceType.findMethods and BinaryType.findMethods
*/
public static IFunction[] findMethods(IFunction method, IFunction[] methods) {
String elementName = method.getElementName();
String[] parameters = method.getParameterTypes();
int paramLength = parameters.length;
String[] simpleNames = new String[paramLength];
for (int i = 0; i < paramLength; i++) {
String erasure = parameters[i];
simpleNames[i] = Signature.getSimpleName(Signature.toString(erasure));
}
ArrayList list = new ArrayList();
for (int i = 0, length = methods.length; i < length; i++) {
IFunction existingMethod = methods[i];
if (areSimilarMethods(
elementName,
parameters,
existingMethod.getElementName(),
existingMethod.getParameterTypes(),
simpleNames)) {
list.add(existingMethod);
}
}
int size = list.size();
if (size == 0) {
return null;
} else {
IFunction[] result = new IFunction[size];
list.toArray(result);
return result;
}
}
public String[] getCategories() throws JavaScriptModelException {
IType type = (IType) getAncestor(IJavaScriptElement.TYPE);
if (type == null) return CharOperation.NO_STRINGS;
if (type.isBinary()) {
return CharOperation.NO_STRINGS;
} else {
SourceTypeElementInfo info = (SourceTypeElementInfo) ((SourceType) type).getElementInfo();
HashMap map = info.getCategories();
if (map == null) return CharOperation.NO_STRINGS;
String[] categories = (String[]) map.get(this);
if (categories == null) return CharOperation.NO_STRINGS;
return categories;
}
}
/**
* @see IMember
*/
public IClassFile getClassFile() {
IJavaScriptElement element = getParent();
while (element instanceof IMember) {
element= element.getParent();
}
if (element instanceof IClassFile) {
return (IClassFile) element;
}
return null;
}
/**
* @see IMember
*/
public IType getDeclaringType() {
JavaElement parentElement = (JavaElement)getParent();
if (parentElement.getElementType() == TYPE) {
return (IType) parentElement;
}
return null;
}
/**
* @see IMember
*/
public int getFlags() throws JavaScriptModelException {
MemberElementInfo info = (MemberElementInfo) getElementInfo();
return info.getModifiers();
}
/*
* @see JavaElement
*/
public IJavaScriptElement getHandleFromMemento(String token, MementoTokenizer memento, WorkingCopyOwner workingCopyOwner) {
switch (token.charAt(0)) {
case JEM_COUNT:
return getHandleUpdatingCountFromMemento(memento, workingCopyOwner);
case JEM_TYPE:
String typeName;
if (memento.hasMoreTokens()) {
typeName = memento.nextToken();
char firstChar = typeName.charAt(0);
if (firstChar == JEM_FIELD || firstChar == JEM_INITIALIZER || firstChar == JEM_METHOD || firstChar == JEM_TYPE || firstChar == JEM_COUNT) {
token = typeName;
typeName = ""; //$NON-NLS-1$
} else {
token = null;
}
} else {
typeName = ""; //$NON-NLS-1$
token = null;
}
JavaElement type = (JavaElement)getType(typeName, 1);
if (token == null) {
return type.getHandleFromMemento(memento, workingCopyOwner);
} else {
return type.getHandleFromMemento(token, memento, workingCopyOwner);
}
case JEM_LOCALVARIABLE:
if (!memento.hasMoreTokens()) return this;
String varName = memento.nextToken();
if (!memento.hasMoreTokens()) return this;
memento.nextToken(); // JEM_COUNT
if (!memento.hasMoreTokens()) return this;
int declarationStart = Integer.parseInt(memento.nextToken());
if (!memento.hasMoreTokens()) return this;
memento.nextToken(); // JEM_COUNT
if (!memento.hasMoreTokens()) return this;
int declarationEnd = Integer.parseInt(memento.nextToken());
if (!memento.hasMoreTokens()) return this;
memento.nextToken(); // JEM_COUNT
if (!memento.hasMoreTokens()) return this;
int nameStart = Integer.parseInt(memento.nextToken());
if (!memento.hasMoreTokens()) return this;
memento.nextToken(); // JEM_COUNT
if (!memento.hasMoreTokens()) return this;
int nameEnd = Integer.parseInt(memento.nextToken());
if (!memento.hasMoreTokens()) return this;
memento.nextToken(); // JEM_COUNT
if (!memento.hasMoreTokens()) return this;
String typeSignature = memento.nextToken();
return new LocalVariable(this, varName, declarationStart, declarationEnd, nameStart, nameEnd, typeSignature);
}
return null;
}
/**
* @see JavaElement#getHandleMemento()
*/
protected char getHandleMementoDelimiter() {
return JavaElement.JEM_TYPE;
}
/*
* Returns the outermost context defining a local element. Per construction, it can only be a
* method/field/initializarer member; thus, returns null if this member is already a top-level type or member type.
* e.g for X.js/X/Y/foo()/Z/bar()/T, it will return X.js/X/Y/foo()
*/
public Member getOuterMostLocalContext() {
IJavaScriptElement current = this;
Member lastLocalContext = null;
parentLoop: while (true) {
switch (current.getElementType()) {
case CLASS_FILE:
case JAVASCRIPT_UNIT:
break parentLoop; // done recursing
case TYPE:
// cannot be a local context
break;
case INITIALIZER:
case FIELD:
case METHOD:
// these elements can define local members
lastLocalContext = (Member) current;
break;
}
current = current.getParent();
}
return lastLocalContext;
}
public ISourceRange getJSdocRange() throws JavaScriptModelException {
ISourceRange range= this.getSourceRange();
if (range == null) return null;
IBuffer buf= null;
if (this.isBinary()) {
buf = this.getClassFile().getBuffer();
} else {
IJavaScriptUnit compilationUnit = this.getJavaScriptUnit();
if (!compilationUnit.isConsistent()) {
return null;
}
buf = compilationUnit.getBuffer();
}
final int start= range.getOffset();
final int length= range.getLength();
if (length > 0 && buf.getChar(start) == '/') {
IScanner scanner= ToolFactory.createScanner(true, false, false, false);
scanner.setSource(buf.getText(start, length).toCharArray());
try {
int docOffset= -1;
int docEnd= -1;
int terminal= scanner.getNextToken();
loop: while (true) {
switch(terminal) {
case ITerminalSymbols.TokenNameCOMMENT_JAVADOC :
docOffset= scanner.getCurrentTokenStartPosition();
docEnd= scanner.getCurrentTokenEndPosition() + 1;
terminal= scanner.getNextToken();
break;
case ITerminalSymbols.TokenNameCOMMENT_LINE :
case ITerminalSymbols.TokenNameCOMMENT_BLOCK :
terminal= scanner.getNextToken();
continue loop;
default :
break loop;
}
}
if (docOffset != -1) {
return new SourceRange(docOffset + start, docEnd - docOffset + 1);
}
} catch (InvalidInputException ex) {
// try if there is inherited Javadoc
}
}
return null;
}
/**
* @see IMember
*/
public ISourceRange getNameRange() throws JavaScriptModelException {
MemberElementInfo info= (MemberElementInfo)getElementInfo();
return new SourceRange(info.getNameSourceStart(), info.getNameSourceEnd() - info.getNameSourceStart() + 1);
}
/**
* @see IMember
*/
public IType getType(String typeName, int count) {
if (isBinary()) {
throw new IllegalArgumentException("Not a source member " + toStringWithAncestors()); //$NON-NLS-1$
} else {
SourceType type = new SourceType(this, typeName);
type.occurrenceCount = count;
return type;
}
}
/**
* @see IMember#getTypeRoot()
*/
public ITypeRoot getTypeRoot() {
IJavaScriptElement element = getParent();
while (element instanceof IMember) {
element= element.getParent();
}
return (ITypeRoot) element;
}
/**
* @see IMember
*/
public boolean isBinary() {
if (getClassFile()!=null)
return true;
return false;
}
protected boolean isMainMethod(IFunction method) throws JavaScriptModelException {
if ("main".equals(method.getElementName()) && Signature.SIG_VOID.equals(method.getReturnType())) { //$NON-NLS-1$
int flags= method.getFlags();
if (Flags.isStatic(flags) && Flags.isPublic(flags)) {
String[] paramTypes= method.getParameterTypes();
if (paramTypes.length == 1) {
String typeSignature= Signature.toString(paramTypes[0]);
return "String[]".equals(Signature.getSimpleName(typeSignature)); //$NON-NLS-1$
}
}
}
return false;
}
/**
* @see IJavaScriptElement
*/
public boolean isReadOnly() {
return getClassFile() != null;
}
/**
*/
public String readableName() {
IJavaScriptElement declaringType = getDeclaringType();
if (declaringType != null) {
String declaringName = ((JavaElement) getDeclaringType()).readableName();
StringBuffer buffer = new StringBuffer(declaringName);
buffer.append('.');
buffer.append(this.getElementName());
return buffer.toString();
} else {
return super.readableName();
}
}
/**
* Updates the name range for this element.
*/
protected void updateNameRange(int nameStart, int nameEnd) {
try {
MemberElementInfo info = (MemberElementInfo) getElementInfo();
info.setNameSourceStart(nameStart);
info.setNameSourceEnd(nameEnd);
} catch (JavaScriptModelException npe) {
return;
}
}
}