org.objectweb.asm.xml
Class ASMContentHandler

java.lang.Object
  org.xml.sax.helpers.DefaultHandler
      org.objectweb.asm.xml.ASMContentHandler

All Implemented Interfaces:

Opcodes, org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.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:

SAXClassAdapter, Processor

Nested Class Summary

private class	ASMContentHandler.AnnotationDefaultRule
private class	ASMContentHandler.AnnotationParameterRule
private class	ASMContentHandler.AnnotationRule
private class	ASMContentHandler.AnnotationValueAnnotationRule
private class	ASMContentHandler.AnnotationValueArrayRule
private class	ASMContentHandler.AnnotationValueEnumRule
private class	ASMContentHandler.AnnotationValueRule
private class	ASMContentHandler.ClassRule ClassRule
private class	ASMContentHandler.ExceptionRule ExceptionRule
private class	ASMContentHandler.ExceptionsRule ExceptionsRule
private class	ASMContentHandler.FieldRule FieldRule
private class	ASMContentHandler.FrameRule FrameRule
private class	ASMContentHandler.FrameTypeRule
private class	ASMContentHandler.InnerClassRule InnerClassRule
private class	ASMContentHandler.InterfaceRule InterfaceRule
private class	ASMContentHandler.InterfacesRule InterfacesRule
private class	ASMContentHandler.LabelRule LabelRule
private class	ASMContentHandler.LineNumberRule LineNumberRule
private class	ASMContentHandler.LocalVarRule LocalVarRule
private class	ASMContentHandler.LookupSwitchLabelRule LookupSwitchLabelRule
private class	ASMContentHandler.LookupSwitchRule LookupSwitchRule
private class	ASMContentHandler.MaxRule MaxRule
private class	ASMContentHandler.MethodRule MethodRule
private static class	ASMContentHandler.Opcode Opcode
private static interface	ASMContentHandler.OpcodeGroup
private class	ASMContentHandler.OpcodesRule OpcodesRule
private class	ASMContentHandler.OuterClassRule OuterClassRule
protected class	ASMContentHandler.Rule Rule
private static class	ASMContentHandler.RuleSet
private class	ASMContentHandler.SourceRule
private class	ASMContentHandler.TableSwitchLabelRule TableSwitchLabelRule
private class	ASMContentHandler.TableSwitchRule TableSwitchRule
private class	ASMContentHandler.TryCatchRule TryCatchRule

Field Summary

private static java.lang.String	BASE
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 java.util.Map	labels Map of the active Label instances for current method.
private java.lang.String	match Complete name of the current element.
(package private) static java.util.Map	OPCODES Map of the opcode names to opcode and opcode group
protected java.io.OutputStream	os Output stream to write result bytecode.
private ASMContentHandler.RuleSet	RULES
private java.util.List	stack Stack of the intermediate processing contexts.
private static java.util.Map	TYPES

Fields inherited from interface org.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

ASMContentHandler(java.io.OutputStream os, boolean computeMax)
Constructs a new ASMContentHandler object.

Method Summary

private static void	addOpcode(java.lang.String operStr, int oper, int group)
void	endDocument() Process notification of the end of a document and write generated bytecode into output stream.
void	endElement(java.lang.String ns, java.lang.String lName, java.lang.String qName) Process notification of the end of an XML element being reached.
(package private) java.lang.Object	peek() Return the top object on the stack without removing it.
(package private) java.lang.Object	pop() Pop the top object off of the stack, and return it.
(package private) void	push(java.lang.Object object) Push a new object onto the top of the object stack.
void	startElement(java.lang.String ns, java.lang.String lName, java.lang.String qName, org.xml.sax.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

stack

private final java.util.List stack

Stack of the intermediate processing contexts.

match

private java.lang.String match

Complete name of the current element.

computeMax

protected boolean computeMax

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

os

protected java.io.OutputStream os

Output stream to write result bytecode.

cw

protected ClassWriter cw

Current instance of the ClassWriter used to write class bytecode.

labels

protected java.util.Map labels

Map of the active Label instances for current method.

BASE

private static final java.lang.String BASE

See Also:

Constant Field Values

RULES

private final ASMContentHandler.RuleSet RULES

OPCODES

static final java.util.Map OPCODES

Map of the opcode names to opcode and opcode group

TYPES

private static final java.util.Map TYPES

Constructor Detail

ASMContentHandler

public ASMContentHandler(java.io.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

addOpcode

private static void addOpcode(java.lang.String operStr,
                              int oper,
                              int group)

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(java.lang.String ns,
                               java.lang.String lName,
                               java.lang.String qName,
                               org.xml.sax.Attributes list)
                        throws org.xml.sax.SAXException

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

Specified by:

startElement in interface org.xml.sax.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:

org.xml.sax.SAXException - if a parsing error is to be reported

endElement

public final void endElement(java.lang.String ns,
                             java.lang.String lName,
                             java.lang.String qName)
                      throws org.xml.sax.SAXException

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

Specified by:

endElement in interface org.xml.sax.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:

org.xml.sax.SAXException - if a parsing error is to be reported

endDocument

public final void endDocument()
                       throws org.xml.sax.SAXException

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

Specified by:

endDocument in interface org.xml.sax.ContentHandler

Overrides:

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

Throws:

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

peek

final java.lang.Object peek()

Return the top object on the stack without removing it. If there are no objects on the stack, return null.

Returns:

the top object on the stack without removing it.

pop

final java.lang.Object pop()

Pop the top object off of the stack, and return it. If there are no objects on the stack, return null.

Returns:

the top object off of the stack.

push

final void push(java.lang.Object object)

Push a new object onto the top of the object stack.

Parameters:

object - The new object