1 package org.ibex.classgen;
3 import java.util.StringTokenizer;
4 import java.util.Hashtable;
6 public abstract class Type implements CGConst {
8 private static Hashtable instances = new Hashtable(); // this has to appear at the top of the file
10 // Public API //////////////////////////////////////////////////////////////////////////////
12 public static final Type VOID = new Primitive("V", "void");
13 public static final Type INT = new Primitive("I", "int");
14 public static final Type LONG = new Primitive("J", "long");
15 public static final Type BOOLEAN = new Primitive("Z", "boolean");
16 public static final Type DOUBLE = new Primitive("D", "double");
17 public static final Type FLOAT = new Primitive("F", "float");
18 public static final Type BYTE = new Primitive("B", "byte");
19 public static final Type CHAR = new Primitive("C", "char");
20 public static final Type SHORT = new Primitive("S", "short");
22 public static final Type.Class OBJECT = Type.Class.instance("java.lang.Object");
23 public static final Type.Class STRING = Type.Class.instance("java.lang.String");
24 public static final Type.Class STRINGBUFFER = Type.Class.instance("java.lang.StringBuffer");
25 public static final Type.Class INTEGER_OBJECT = Type.Class.instance("java.lang.Integer");
26 public static final Type.Class DOUBLE_OBJECT = Type.Class.instance("java.lang.Double");
27 public static final Type.Class FLOAT_OBJECT = Type.Class.instance("java.lang.Float");
29 /** A zero element Type[] array (can be passed as the "args" param when a method takes no arguments */
30 public static final Type[] NO_ARGS = new Type[0];
33 * A "descriptor" is the classfile-mangled text representation of a type (see JLS section 4.3)
34 * guarantee: there will only be one instance of Type for a given descriptor ==> equals() and == are interchangeable
36 public static Type fromDescriptor(String d) {
37 Type ret = (Type)instances.get(d);
38 if (ret != null) return ret;
39 if (d.startsWith("[")) return new Type.Array(Type.fromDescriptor(d.substring(1)));
40 return new Type.Class(d);
43 public final String toString() { return super.toString(); }
44 public abstract String debugToString();
46 public final String getDescriptor() { return descriptor; }
48 public Type.Array makeArray() { return (Type.Array)Type.fromDescriptor("["+descriptor); }
49 public Type.Array makeArray(int i) { return i==0 ? (Type.Array)this : makeArray().makeArray(i-1); }
51 public Type.Ref asRef() { throw new RuntimeException("attempted to use "+this+" as a Type.Ref, which it is not"); }
52 public Type.Class asClass() { throw new RuntimeException("attempted to use "+this+" as a Type.Class, which it is not"); }
53 public Type.Array asArray() { throw new RuntimeException("attempted to use "+this+" as a Type.Array, which it is not"); }
54 public boolean isPrimitive() { return false; }
55 public boolean isRef() { return false; }
56 public boolean isClass() { return false; }
57 public boolean isArray() { return false; }
59 // Protected/Private //////////////////////////////////////////////////////////////////////////////
61 protected final String descriptor;
63 protected Type(String descriptor) {
64 this.descriptor = descriptor;
65 instances.put(descriptor, this);
68 public static class Primitive extends Type {
69 private String humanReadable;
70 Primitive(String descriptor, String humanReadable) {
72 this.humanReadable = humanReadable;
74 public String debugToString() { return humanReadable; }
75 public boolean isPrimitive() { return true; }
78 public abstract static class Ref extends Type {
79 protected Ref(String descriptor) { super(descriptor); }
80 public abstract String debugToString();
81 public Type.Ref asRef() { return this; }
82 public boolean isRef() { return true; }
85 public static class Array extends Type.Ref {
86 public final Type base;
87 protected Array(Type t) { super("[" + t.getDescriptor()); base = t; }
88 public Type.Array asArray() { return this; }
89 public boolean isArray() { return true; }
90 public String debugToString() { return base.debugToString() + "[]"; }
91 public Type getElementType() { return Type.fromDescriptor(getDescriptor().substring(0, getDescriptor().length()-1)); }
94 public static class Class extends Type.Ref {
95 protected Class(String s) { super(_initHelper(s)); }
96 public Type.Class asClass() { return this; }
97 public boolean isClass() { return true; }
98 public static Type.Class instance(String className) {
99 return (Type.Class)Type.fromDescriptor("L"+className.replace('.', '/')+";"); }
100 //public boolean extendsOrImplements(Type.Class c, Context cx) { }
101 String internalForm() { return descriptor.substring(1, descriptor.length()-1); }
102 public String debugToString() { return internalForm().replace('/','.'); }
103 public String getShortName() {
104 int p = descriptor.lastIndexOf('/');
105 return p == -1 ? descriptor.substring(1,descriptor.length()-1) : descriptor.substring(p+1,descriptor.length()-1);
107 private static String _initHelper(String s) {
108 if (!s.startsWith("L") || !s.endsWith(";")) s = "L" + s.replace('.', '/') + ";";
111 String[] components() {
112 StringTokenizer st = new StringTokenizer(descriptor.substring(1, descriptor.length()-1), "/");
113 String[] a = new String[st.countTokens()];
114 for(int i=0;st.hasMoreTokens();i++) a[i] = st.nextToken();
118 public Field field(String name, Type type) { return new Field(name, type); }
119 public abstract class Body extends HasFlags {
122 public Method method(String name, Type returnType, Type[] argTypes) { return new Method(name, returnType, argTypes); }
123 public Method method(String leftCrap, String rightCrap) { return method(leftCrap+rightCrap); }
125 /** see JVM Spec section 2.10.2 */
126 public Method method(String signature) {
127 // FEATURE: This parser is ugly but it works (and shouldn't be a problem) might want to clean it up though
128 String name = signature.substring(0, signature.indexOf('('));
129 String s = signature.substring(signature.indexOf('('));
130 if(!s.startsWith("(")) throw new IllegalArgumentException("invalid method type descriptor");
131 int p = s.indexOf(')');
132 if(p == -1) throw new IllegalArgumentException("invalid method type descriptor");
133 String argsDesc = s.substring(1,p);
134 String retDesc = s.substring(p+1);
135 Type[] argsBuf = new Type[argsDesc.length()];
137 for(i=0,p=0;argsDesc.length() > 0;i++,p=0) {
138 while(p < argsDesc.length() && argsDesc.charAt(p) == '[') p++;
139 if(p == argsDesc.length()) throw new IllegalArgumentException("invalid method type descriptor");
140 if(argsDesc.charAt(p) == 'L') {
141 p = argsDesc.indexOf(';');
142 if(p == -1) throw new IllegalArgumentException("invalid method type descriptor");
144 argsBuf[i] = Type.fromDescriptor(argsDesc.substring(0,p+1));
145 argsDesc = argsDesc.substring(p+1);
147 Type args[] = new Type[i];
148 System.arraycopy(argsBuf,0,args,0,i);
149 return method(name, Type.fromDescriptor(retDesc), args);
152 public abstract class Member {
153 public final String name;
154 private Member(String name) { this.name = name; }
155 public Type.Class getDeclaringClass() { return Type.Class.this; }
156 public String getName() { return name; }
157 public abstract String getTypeDescriptor();
158 public abstract String debugToString();
161 public class Field extends Member {
162 public final Type type;
163 private Field(String name, Type t) { super(name); this.type = t; }
164 public String getTypeDescriptor() { return type.getDescriptor(); }
165 public Type getType() { return type; }
166 public class Body extends HasFlags {
167 public final int flags;
168 public Body(int flags) { this.flags = flags; }
169 public int getFlags() { return flags; }
171 public String debugToString() { return getDeclaringClass().debugToString()+"."+name+"["+type.debugToString()+"]"; }
174 public class Method extends Member {
175 final Type[] argTypes;
176 public final Type returnType;
177 public Type getReturnType() { return returnType; }
178 public int getNumArgs() { return argTypes.length; }
179 public Type getArgType(int i) { return argTypes[i]; }
180 public Type[] getArgTypes() {
181 Type[] ret = new Type[argTypes.length];
182 System.arraycopy(argTypes, 0, ret, 0, ret.length);
185 public boolean isConstructor() { return getName().equals("<init>"); }
186 public boolean isClassInitializer() { return getName().equals("<clinit>"); }
187 public String debugToString() {
188 StringBuffer sb = new StringBuffer();
189 if (name.equals("<clinit>")) sb.append("static ");
191 if (name.equals("<init>"))
192 sb.append(Class.this.getShortName());
194 sb.append(returnType.debugToString()).append(".").append(name);
196 for(int i=0; i<argTypes.length; i++)
197 sb.append((i==0?"":", ")+argTypes[i].debugToString());
200 return sb.toString();
202 private Method(String name, Type returnType, Type[] argTypes) {
204 this.argTypes = argTypes;
205 this.returnType = returnType;
207 //public Method.Body getBody(Context cx) { }
208 public String getTypeDescriptor() {
209 StringBuffer sb = new StringBuffer(argTypes.length*4);
211 for(int i=0;i<argTypes.length;i++) sb.append(argTypes[i].getDescriptor());
213 sb.append(returnType.getDescriptor());
214 return sb.toString();
216 public abstract class Body extends HasFlags {
217 public abstract java.util.Hashtable getThrownExceptions();
218 public abstract void debugBodyToString(StringBuffer sb);
219 public void debugToString(StringBuffer sb, String constructorName) {
220 int flags = getFlags();
221 sb.append(" ").append(ClassFile.flagsToString(flags,false));
222 sb.append(Method.this.debugToString());
223 java.util.Hashtable thrownExceptions = getThrownExceptions();
224 if (thrownExceptions.size() > 0) {
226 for(java.util.Enumeration e = thrownExceptions.keys();e.hasMoreElements();)
227 sb.append(" ").append(((Type.Class)e.nextElement()).debugToString()).append(",");
228 sb.setLength(sb.length()-1);
231 if ((flags & (NATIVE|ABSTRACT))==0) {
233 debugBodyToString(sb);
243 // FEATURE: This probably isn't the best place for these
244 static String methodTypeDescriptor(Type[] argTypes, Type returnType) {
245 StringBuffer sb = new StringBuffer(argTypes.length*4);
247 for(int i=0;i<argTypes.length;i++) sb.append(argTypes[i].getDescriptor());
249 sb.append(returnType.getDescriptor());
250 return sb.toString();