src/org/ibex/classgen/Type.java

   1 package org.ibex.classgen;
   2
   3 import java.util.StringTokenizer;
   4 import java.util.Hashtable;
   5
   6 public abstract class Type implements CGConst {
   7
   8     private static Hashtable instances = new Hashtable();  // this has to appear at the top of the file
   9
  10     // Public API //////////////////////////////////////////////////////////////////////////////
  11
  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");
  21
  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");
  28
  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];
  31
  32     /**
  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
  35      */
  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);
  41     }
  42
  43     public final String  toString() { return super.toString(); }
  44     public abstract String debugToString();
  45
  46     public final String  getDescriptor() { return descriptor; }
  47
  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); }
  50
  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; }
  58
  59     // Protected/Private //////////////////////////////////////////////////////////////////////////////
  60
  61     protected final String descriptor;
  62
  63     protected Type(String descriptor) {
  64         this.descriptor = descriptor;
  65         instances.put(descriptor, this);
  66     }
  67
  68     public static class Primitive extends Type {
  69         private String humanReadable;
  70         Primitive(String descriptor, String humanReadable) {
  71             super(descriptor);
  72             this.humanReadable = humanReadable;
  73         }
  74         public String debugToString() { return humanReadable; }
  75         public boolean     isPrimitive() { return true; }
  76     }
  77
  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; }
  83     }
  84
  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)); }
  92     }
  93
  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);
 106         }
 107         private static String _initHelper(String s) {
 108             if (!s.startsWith("L") || !s.endsWith(";")) s = "L" + s.replace('.', '/') + ";";
 109             return s;
 110         }
 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();
 115             return a;
 116         }
 117
 118         public Field field(String name, Type type) { return new Field(name, type); }
 119         public abstract class Body extends HasFlags {
 120         }
 121
 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); }
 124
 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()];
 136             int i;
 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");
 143                 }
 144                 argsBuf[i] = Type.fromDescriptor(argsDesc.substring(0,p+1));
 145                 argsDesc = argsDesc.substring(p+1);
 146             }
 147             Type args[] = new Type[i];
 148             System.arraycopy(argsBuf,0,args,0,i);
 149             return method(name, Type.fromDescriptor(retDesc), args);
 150         }
 151
 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();
 159         }
 160
 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 String debugToString() { return getDeclaringClass().debugToString()+"."+name+"["+type.debugToString()+"]"; }
 167             public class Body extends HasFlags {
 168                 public final int flags;
 169                 public Body(int flags) {
 170                     if ((flags & ~VALID_FIELD_FLAGS) != 0) throw new IllegalArgumentException("invalid flags");
 171                     this.flags = flags;
 172                 }
 173                 public int getFlags() { return flags; }
 174                 public Field getField() { return Field.this; }
 175             }
 176         }
 177
 178         public class Method extends Member {
 179             final Type[] argTypes;
 180             public final Type   returnType;
 181             public Type getReturnType()   { return returnType; }
 182             public int  getNumArgs()      { return argTypes.length; }
 183             public Type getArgType(int i) { return argTypes[i]; }
 184             public Type[] getArgTypes()   {
 185                 Type[] ret = new Type[argTypes.length];
 186                 System.arraycopy(argTypes, 0, ret, 0, ret.length);
 187                 return ret;
 188             }
 189             public boolean isConstructor() { return getName().equals("<init>"); }
 190             public boolean isClassInitializer() { return getName().equals("<clinit>"); }
 191             public String debugToString() {
 192                 StringBuffer sb = new StringBuffer();
 193                 if (name.equals("<clinit>")) sb.append("static ");
 194                 else {
 195                     if (name.equals("<init>"))
 196                         sb.append(Class.this.getShortName());
 197                     else
 198                         sb.append(returnType.debugToString()).append(".").append(name);
 199                     sb.append("(");
 200                     for(int i=0; i<argTypes.length; i++)
 201                         sb.append((i==0?"":", ")+argTypes[i].debugToString());
 202                     sb.append(") ");
 203                 }
 204                 return sb.toString();
 205             }
 206             private Method(String name, Type returnType, Type[] argTypes) {
 207                 super(name);
 208                 this.argTypes = argTypes;
 209                 this.returnType = returnType;
 210             }
 211             //public Method.Body getBody(Context cx) { }
 212             public String getTypeDescriptor() {
 213                 StringBuffer sb = new StringBuffer(argTypes.length*4);
 214                 sb.append("(");
 215                 for(int i=0;i<argTypes.length;i++) sb.append(argTypes[i].getDescriptor());
 216                 sb.append(")");
 217                 sb.append(returnType.getDescriptor());
 218                 return sb.toString();
 219             }
 220             public abstract class Body extends HasFlags {
 221                 public abstract java.util.Hashtable getThrownExceptions();
 222                 public abstract void debugBodyToString(StringBuffer sb);
 223                 public void debugToString(StringBuffer sb, String constructorName) {
 224                     int flags = getFlags();
 225                     sb.append("  ").append(ClassFile.flagsToString(flags,false));
 226                     sb.append(Method.this.debugToString());
 227                     java.util.Hashtable thrownExceptions = getThrownExceptions();
 228                     if (thrownExceptions.size() > 0) {
 229                         sb.append("throws");
 230                         for(java.util.Enumeration e = thrownExceptions.keys();e.hasMoreElements();)
 231                             sb.append(" ").append(((Type.Class)e.nextElement()).debugToString()).append(",");
 232                         sb.setLength(sb.length()-1);
 233                         sb.append(" ");
 234                     }
 235                     if ((flags & (NATIVE|ABSTRACT))==0) {
 236                         sb.append("{\n");
 237                         debugBodyToString(sb);
 238                         sb.append("  }\n");
 239                     } else {
 240                         sb.append(";");
 241                     }
 242                 }
 243             }
 244         }
 245     }
 246
 247     // FEATURE: This probably isn't the best place for these
 248     static String methodTypeDescriptor(Type[] argTypes, Type returnType) {
 249         StringBuffer sb = new StringBuffer(argTypes.length*4);
 250         sb.append("(");
 251         for(int i=0;i<argTypes.length;i++) sb.append(argTypes[i].getDescriptor());
 252         sb.append(")");
 253         sb.append(returnType.getDescriptor());
 254         return sb.toString();
 255     }
 256
 257 }