import java.util.*;
import java.io.*;
+/** Class generation object representing the whole classfile */
public class ClassGen implements CGConst {
- private Type.Object thisType;
- private Type.Object superType;
- int flags;
- private String sourceFile;
+ private final Type.Object thisType;
+ private final Type.Object superType;
+ private final Type.Object[] interfaces;
+ final int flags;
- private Vector interfaces = new Vector();
- private Vector fields = new Vector();
- private Vector methods = new Vector();
+ private String sourceFile;
+ private final Vector fields = new Vector();
+ private final Vector methods = new Vector();
final CPGen cp;
private final AttrGen attributes;
+ /** @see #ClassGen(Type.Object,Type.Object,int) */
public ClassGen(String name, String superName, int flags) {
this(new Type.Object(name),new Type.Object(superName),flags);
}
-
+
+ /** @see #ClassGen(Type.Object,Type.Object,int,Type.Object[]) */
public ClassGen(Type.Object thisType,Type.Object superType, int flags) {
+ this(thisType,superType,flags,null);
+ }
+
+ /** Creates a new ClassGen object
+ @param thisType The type of the class to generate
+ @param superType The superclass of the generated class (commonly Type.OBJECT)
+ @param flags The access flags for this class (ACC_PUBLIC, ACC_FINAL, ACC_SUPER, ACC_INTERFACE, and ACC_ABSTRACT)
+ */
+ public ClassGen(Type.Object thisType,Type.Object superType, int flags, Type.Object[] interfaces) {
if((flags & ~(ACC_PUBLIC|ACC_FINAL|ACC_SUPER|ACC_INTERFACE|ACC_ABSTRACT)) != 0)
throw new IllegalArgumentException("invalid flags");
this.thisType = thisType;
this.superType = superType;
+ this.interfaces = interfaces;
this.flags = flags;
cp = new CPGen();
attributes = new AttrGen(cp);
}
+ /** Adds a new method to this class
+ @param name The name of the method (not the signature, just the name)
+ @param ret The return type of the method
+ @param args The arguments to the method
+ @param flags The flags for the method
+ (ACC_PUBLIC, ACC_PRIVATE, ACC_PROTECTED, ACC_STATIC, ACC_SYNCHRONIZED, ACC_NATIVE, ACC_ABSTRACT, ACC_STRICT)
+ @return A new MethodGen object for the method
+ @exception IllegalArgumentException if illegal flags are specified
+ @see MethodGen
+ @see CGConst
+ */
public final MethodGen addMethod(String name, Type ret, Type[] args, int flags) {
MethodGen mg = new MethodGen(this,name,ret,args,flags);
methods.addElement(mg);
return mg;
}
+ /** Adds a new field to this class
+ @param name The name of the filed (not the signature, just the name)
+ @param type The type of the field
+ @param flags The flags for the field
+ (ACC_PUBLIC, ACC_PRIVATE, ACC_PROTECTED, ACC_STATIC, ACC_FINAL, ACC_VOLATILE, ACC_TRANSIENT)
+ @return A new FieldGen object for the method
+ @exception IllegalArgumentException if illegal flags are specified
+ @see FieldGen
+ @see CGConst
+ */
public final FieldGen addField(String name, Type type, int flags) {
FieldGen fg = new FieldGen(this,name,type,flags);
fields.addElement(fg);
return fg;
}
+ /** Sets the source value of the SourceFile attribute of this class
+ @param sourceFile The string to be uses as the SourceFile of this class
+ */
public void setSourceFile(String sourceFile) { this.sourceFile = sourceFile; }
- public void dump(String s) throws IOException { dump(new File(s)); }
+ /** Writes the classfile data to the file specifed
+ @see ClassGen#dump(OutputStream)
+ */
+ public void dump(String file) throws IOException { dump(new File(file)); }
+
+ /** Writes the classfile data to the file specified
+ If <i>f</i> is a directory directory components under it are created for the package the class is in (like javac's -d option)
+ @see ClassGen#dump(OutputStream)
+ */
public void dump(File f) throws IOException {
if(f.isDirectory()) {
String[] a = thisType.components();
}
f = new File(f,a[i] + ".class");
}
- dump(new FileOutputStream(f));
+ OutputStream os = new FileOutputStream(f);
+ dump(os);
+ os.close();
}
-
+
+ /** Writes the classfile data to the outputstream specified
+ @param os The stream to write the class to
+ @exception IOException if an IOException occures while writing the class data
+ @exception IllegalStateException if the data for a method is in an inconsistent state (required arguments missing, etc)
+ @exception Exn if the classfile could not be written for any other reason (constant pool full, etc)
+ */
public void dump(OutputStream os) throws IOException {
DataOutputStream dos = new DataOutputStream(new BufferedOutputStream(os));
_dump(dos);
}
private void _dump(DataOutput o) throws IOException {
+ cp.optimize();
+ cp.stable();
+
cp.add(thisType);
cp.add(superType);
- for(int i=0;i<interfaces.size();i++) cp.add((Type.Object)interfaces.elementAt(i));
+ if(interfaces != null) for(int i=0;i<interfaces.length;i++) cp.add(interfaces[i]);
if(sourceFile != null && !attributes.contains("SourceFile")) attributes.add("SourceFile",cp.addUtf8(sourceFile));
-
- cp.stable();
-
+
for(int i=0;i<methods.size();i++) ((MethodGen)methods.elementAt(i)).finish();
for(int i=0;i<fields.size();i++) ((FieldGen)fields.elementAt(i)).finish();
o.writeShort(3); // minor_version
o.writeShort(45); // major_version
- o.writeShort(cp.size()); // constant_pool_count
cp.dump(o); // constant_pool
o.writeShort(flags);
o.writeShort(cp.getIndex(thisType)); // this_class
o.writeShort(cp.getIndex(superType)); // super_class
- o.writeShort(interfaces.size()); // interfaces_count
- for(int i=0;i<interfaces.size();i++) o.writeShort(cp.getIndex(interfaces.elementAt(i))); // interfaces
+ o.writeShort(interfaces==null ? 0 : interfaces.length); // interfaces_count
+ if(interfaces != null) for(int i=0;i<interfaces.length;i++) o.writeShort(cp.getIndex(interfaces[i])); // interfaces
o.writeShort(fields.size()); // fields_count
for(int i=0;i<fields.size();i++) ((FieldGen)fields.elementAt(i)).dump(o); // fields
attributes.dump(o); // attributes
}
+ public ClassGen read(File f) throws ClassReadExn {
+ InputStream is = new FileInputStream(f);
+ ClassGen ret = read(is);
+ is.close();
+ return ret;
+ }
+
+ public ClassGen read(InputStream is) throws ClassReadExn {
+ return new ClassGen(new DataInputStream(new BufferedInputStream(is)));
+ }
+
+ ClassGen(DataInput i) throws ClassReadExn {
+ if(i.readInt() != 0xcadebabe) throw new ClassReadExn("invalid magic");
+ short minor = i.readInt();
+ if(minor != 3) throw new ClassReadExn("invalid minor version: " + minor);
+ if(i.readInt() != 45) throw new ClassReadExn("invalid major version");
+ cp = new CPGen(i);
+ }
+
+ /** Thrown when class generation fails for a reason not under the control of the user
+ (IllegalStateExceptions are thrown in those cases */
public static class Exn extends RuntimeException {
public Exn(String s) { super(s); }
}
+ public static class ClassReadExn extends IOException {
+ public ClassReadExn(String s) { super(s); }
+ }
+
+ /** A class representing a field or method reference. This is used as an argument to the INVOKE*, GET*, and PUT* bytecodes
+ @see MethodRef
+ @see FieldRef
+ @see MethodRef.I
+ @see FieldRef
+ */
public static abstract class FieldOrMethodRef {
Type.Object klass;
String name;
o.write(buf);
} else if(val instanceof CPGen.Ent) {
o.writeInt(2);
- o.writeShort(((CPGen.Ent)val).getIndex());
+ o.writeShort(cp.getIndex((CPGen.Ent)val));
} else {
throw new Error("should never happen");
}
projects / org.ibex.classgen.git / blobdiff