org.glassfish.pfl.objectweb.asm.xml

Class ASMContentHandler

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.glassfish.pfl.objectweb.asm.xml.ASMContentHandler

All Implemented Interfaces:

Opcodes, ContentHandler, DTDHandler, EntityResolver, ErrorHandler

public class ASMContentHandler
extends org.xml.sax.helpers.DefaultHandler
implements Opcodes

A ContentHandler that transforms XML document into Java class file. This class can be feeded by any kind of SAX 2.0 event producers, e.g. XML parser, XSLT or XPath engines, or custom code.

Author:

Eugene Kuleshov

See Also:

org.objectweb.asm.xml.SAXClassAdapter, org.objectweb.asm.xml.Processor

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	ASMContentHandler.Rule Rule

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	computeMax true if the maximum stack size and number of local variables must be automatically computed.
protected ClassWriter	cw Current instance of the ClassWriter used to write class bytecode.
protected Map	labels Map of the active Label instances for current method.
protected OutputStream	os Output stream to write result bytecode.

Fields inherited from interface org.glassfish.pfl.objectweb.asm.Opcodes

AALOAD, AASTORE, ACC_ABSTRACT, ACC_ANNOTATION, ACC_BRIDGE, ACC_DEPRECATED, ACC_ENUM, ACC_FINAL, ACC_INTERFACE, ACC_NATIVE, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_SYNTHETIC, ACC_TRANSIENT, ACC_VARARGS, ACC_VOLATILE, ACONST_NULL, ALOAD, ANEWARRAY, ARETURN, ARRAYLENGTH, ASTORE, ATHROW, BALOAD, BASTORE, BIPUSH, CALOAD, CASTORE, CHECKCAST, D2F, D2I, D2L, DADD, DALOAD, DASTORE, DCMPG, DCMPL, DCONST_0, DCONST_1, DDIV, DLOAD, DMUL, DNEG, DOUBLE, DREM, DRETURN, DSTORE, DSUB, DUP, DUP_X1, DUP_X2, DUP2, DUP2_X1, DUP2_X2, F_APPEND, F_CHOP, F_FULL, F_NEW, F_SAME, F_SAME1, F2D, F2I, F2L, FADD, FALOAD, FASTORE, FCMPG, FCMPL, FCONST_0, FCONST_1, FCONST_2, FDIV, FLOAD, FLOAT, FMUL, FNEG, FREM, FRETURN, FSTORE, FSUB, GETFIELD, GETSTATIC, GOTO, I2B, I2C, I2D, I2F, I2L, I2S, IADD, IALOAD, IAND, IASTORE, ICONST_0, ICONST_1, ICONST_2, ICONST_3, ICONST_4, ICONST_5, ICONST_M1, IDIV, IF_ACMPEQ, IF_ACMPNE, IF_ICMPEQ, IF_ICMPGE, IF_ICMPGT, IF_ICMPLE, IF_ICMPLT, IF_ICMPNE, IFEQ, IFGE, IFGT, IFLE, IFLT, IFNE, IFNONNULL, IFNULL, IINC, ILOAD, IMUL, INEG, INSTANCEOF, INTEGER, INVOKEDYNAMIC, INVOKEDYNAMIC_OWNER, INVOKEINTERFACE, INVOKESPECIAL, INVOKESTATIC, INVOKEVIRTUAL, IOR, IREM, IRETURN, ISHL, ISHR, ISTORE, ISUB, IUSHR, IXOR, JSR, L2D, L2F, L2I, LADD, LALOAD, LAND, LASTORE, LCMP, LCONST_0, LCONST_1, LDC, LDIV, LLOAD, LMUL, LNEG, LONG, LOOKUPSWITCH, LOR, LREM, LRETURN, LSHL, LSHR, LSTORE, LSUB, LUSHR, LXOR, MONITORENTER, MONITOREXIT, MULTIANEWARRAY, NEW, NEWARRAY, NOP, NULL, POP, POP2, PUTFIELD, PUTSTATIC, RET, RETURN, SALOAD, SASTORE, SIPUSH, SWAP, T_BOOLEAN, T_BYTE, T_CHAR, T_DOUBLE, T_FLOAT, T_INT, T_LONG, T_SHORT, TABLESWITCH, TOP, UNINITIALIZED_THIS, V1_1, V1_2, V1_3, V1_4, V1_5, V1_6, V1_7

Constructor Summary

Constructors

Constructor and Description
ASMContentHandler(OutputStream os, boolean computeMax) Constructs a new ASMContentHandler object.

Method Summary

Methods

Modifier and Type	Method and Description
void	endDocument() Process notification of the end of a document and write generated bytecode into output stream.
void	endElement(String ns, String lName, String qName) Process notification of the end of an XML element being reached.
void	startElement(String ns, String lName, String qName, Attributes list) Process notification of the start of an XML element being reached.
byte[]	toByteArray() Returns the bytecode of the class that was build with underneath class writer.

Methods inherited from class org.xml.sax.helpers.DefaultHandler

characters, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

computeMax

protected boolean computeMax

true if the maximum stack size and number of local variables must be automatically computed.

os

protected OutputStream os

Output stream to write result bytecode.

cw

protected ClassWriter cw

Current instance of the ClassWriter used to write class bytecode.

labels

protected Map labels

Map of the active Label instances for current method.

Constructor Detail

ASMContentHandler

public ASMContentHandler(OutputStream os,
                 boolean computeMax)

Constructs a new ASMContentHandler object.

Parameters:

os - output stream to write generated class.

computeMax - true if the maximum stack size and the maximum number of local variables must be automatically computed. This value is passed to ClassWriter instance.

Method Detail

toByteArray

public byte[] toByteArray()

Returns the bytecode of the class that was build with underneath class writer.

Returns:

the bytecode of the class that was build with underneath class writer or null if there are no classwriter created.

startElement

public final void startElement(String ns,
                String lName,
                String qName,
                Attributes list)
                        throws SAXException

Process notification of the start of an XML element being reached.

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Parameters:

ns - - The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

lName - - The local name (without prefix), or the empty string if Namespace processing is not being performed.

qName - - The qualified name (with prefix), or the empty string if qualified names are not available.

list - - The attributes attached to the element. If there are no attributes, it shall be an empty Attributes object.

Throws:

SAXException - if a parsing error is to be reported

endElement

public final void endElement(String ns,
              String lName,
              String qName)
                      throws SAXException

Process notification of the end of an XML element being reached.

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Parameters:

ns - - The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

lName - - The local name (without prefix), or the empty string if Namespace processing is not being performed.

qName - - The qualified XML 1.0 name (with prefix), or the empty string if qualified names are not available.

Throws:

SAXException - if a parsing error is to be reported

endDocument

public final void endDocument()
                       throws SAXException

Process notification of the end of a document and write generated bytecode into output stream.

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class org.xml.sax.helpers.DefaultHandler

Throws:

SAXException - if parsing or writing error is to be reported.