jaxx.compiler
Class JAXXCompiler

java.lang.Object
  jaxx.compiler.JAXXCompiler

public class JAXXCompiler
extends java.lang.Object

Compiles a given jaxxFile into a javaFile.

Since:

1.0.0

Author:

tchemit

Field Summary

protected java.io.File	baseDir Base directory used for path resolution (normally the directory in which the .jaxx file resides).
protected DataBindingHelper	bindingHelper Binding Util
protected java.lang.StringBuffer	bodyCode Extra code to be added to the class body.
protected java.lang.ClassLoader	classLoader ClassLoader which searches the user-specified class path in addition to the normal class path
protected CompilerConfiguration	defaultConfiguration
protected CompiledObjectDecorator	defaultDecorator default decodator to use if none specified
protected org.w3c.dom.Document	document Parsed XML of src file.
static java.lang.String[]	EMPTY_STRING_ARRAY
protected JAXXEngine	engine engine which references this compiler (can be null if compiler is standalone)
protected java.util.Map<EventHandler,java.lang.String>	eventHandlerMethodNames Map of event handler method names used in compiler
protected java.util.Map<java.lang.String,java.util.Map<ClassDescriptor,java.util.List<EventHandler>>>	eventHandlers Maps objects (expressed in Java code) to event listener classes (e.g.
protected boolean	failed flag to detect if an error occurs while compiling jaxx file
protected DefaultObjectHandler	firstPassClassTagHandler The unique object handler used in first pass
protected boolean	identCssFound Flag to know if jaxx file ident css was found, otherwise add it when CompilerConfiguration.isAutoImportCss() is sets to true at the end of the second compile pass.
protected IDHelper	idHelper to generate ids
protected java.util.Map<CompiledObject,java.lang.String>	ids Maps objects to their ID strings.
protected java.util.Set<java.lang.String>	importedClasses Contains strings of the form "javax.swing.Timer"
protected java.util.Set<java.lang.String>	importedPackages Contains strings of the form "javax.swing."
protected java.lang.StringBuffer	initializer Extra code to be added to the instance initializer.
protected java.util.List<java.lang.Runnable>	initializers A list of Runnables which will be run after the first compilation pass.
static int	INLINE_THRESHOLD Maximum length of an inlinable creation method.
protected java.util.List<Rule>	inlineStyles Contains all attributes defined inline on class tags.
protected JavaFile	javaFile the file to be generated
static java.lang.String	JAXX_INTERNAL_NAMESPACE
static java.lang.String	JAXX_NAMESPACE
protected JAXXCompilerFile	jaxxFile
protected java.lang.StringBuffer	lateInitializer Extra code to be added at the end of the instance initializer.
protected static java.lang.String	lineSeparator Line separator cached value
protected static org.apache.commons.logging.Log	log Logger
protected boolean	mainDeclared true if a main() method has been declared in a script
protected java.util.Map<java.lang.String,CompiledObject>	objects Maps object ID strings to the objects themselves.
protected java.util.Stack<CompiledObject>	openComponents Keeps track of open components (components still having children added).
protected java.lang.String	outputClassName Name of class being compiled.
protected CompiledObject	root Object corresponding to the root tag in the document.
protected ScriptManager	scriptManager script manager
protected java.util.Stack<java.io.File>	sourceFiles Used for error reporting purposes, so we can report the right source file.
protected java.io.File	src jaxx file being compiled.
static boolean	STRICT_CHECKS True to throw exceptions when we encounter unresolvable classes, false to ignore.
protected Stylesheet	stylesheet Combination of all stylesheets registered using registerStylesheet(jaxx.runtime.css.Stylesheet).
protected SymbolTable	symbolTable table of symbols for this compiler
protected java.util.Stack<org.w3c.dom.Element>	tagsBeingCompiled Used for error reporting purposes, so we can report the right line number.

Constructor Summary

JAXXCompiler()

JAXXCompiler(JAXXEngine engine, JAXXCompilerFile jaxxFile, java.util.List<java.lang.String> defaultImports)
Creates a new JAXXCompiler.

Method Summary

void	addDependencyClass(java.lang.String className)
void	addImport(java.lang.String text)
void	addInlineStyle(CompiledObject object, java.lang.String propertyName, boolean dataBinding)
void	addScriptField(FieldDescriptor field)
void	addScriptMethod(MethodDescriptor method)
void	addSimpleField(JavaField javaField)
void	appendBodyCode(java.lang.String code)
void	appendInitializerCode(java.lang.String code)
void	appendLateInitializer(java.lang.String code)
void	applyStylesheets()
java.lang.String	checkJavaCode(java.lang.String javaCode) Verifies that a snippet of Java code parses correctly.
void	checkOverride(CompiledObject object)
boolean	checkReference(org.w3c.dom.Element tag, java.lang.String reference, boolean strict, java.lang.String attribute) Check that a reference exists in symbol table on second compil pass
void	clear()
void	closeComponent(CompiledObject component)
void	compileFirstPass()
void	compileFirstPass(org.w3c.dom.Element tag)
void	compileSecondPass()
void	compileSecondPass(org.w3c.dom.Element tag)
static java.lang.String	escapeJavaString(java.lang.String raw) Escapes a string using standard Java escape sequences, generally in preparation to including it in a string literal in a compiled Java file.
void	finalizeCompiler()
void	generate(JavaFileGenerator generator)
java.lang.String	getAutoId(java.lang.String name)
java.io.File	getBaseDir()
DataBindingHelper	getBindingHelper()
java.lang.StringBuffer	getBodyCode()
static java.lang.String	getCanonicalName(java.lang.Class<?> clazz)
static java.lang.String	getCanonicalName(ClassDescriptor clazz)
static java.lang.String	getCanonicalName(CompiledObject compiled)
java.lang.ClassLoader	getClassLoader() Returns a ClassLoader which searches the user-specified class path in addition to the normal system class path.
CompiledObject	getCompiledObject(java.lang.String id)
CompilerConfiguration	getConfiguration()
JAXXEngine	getEngine()
java.lang.String	getEventHandlerMethodName(EventHandler handler)
java.util.Map<java.lang.String,java.util.Map<ClassDescriptor,java.util.List<EventHandler>>>	getEventHandlers()
java.lang.String[]	getExtraInterfaces()
java.lang.String	getGenericType()
IDHelper	getIdHelper()
java.util.Set<java.lang.String>	getImportedClasses()
java.util.Set<java.lang.String>	getImportedPackages()
java.lang.StringBuffer	getInitializer()
JavaFile	getJavaFile()
JAXXObjectDescriptor	getJAXXObjectDescriptor()
java.lang.StringBuffer	getLateInitializer()
static java.lang.String	getLineSeparator() Returns the system line separator string.
java.util.Iterator<CompiledObject>	getObjectCreationOrder()
java.util.Map<java.lang.String,CompiledObject>	getObjects()
CompiledObject	getOpenComponent()
java.lang.String	getOutputClassName()
CompiledObject	getRootObject()
static javax.xml.parsers.SAXParser	getSAXParser()
FieldDescriptor	getScriptField(java.lang.String fieldName)
FieldDescriptor[]	getScriptFields()
ScriptManager	getScriptManager()
MethodDescriptor	getScriptMethod(java.lang.String methodName)
MethodDescriptor[]	getScriptMethods()
java.util.Stack<java.io.File>	getSourceFiles()
Stylesheet	getStylesheet()
java.lang.String	getSuperGenericType()
SymbolTable	getSymbolTable()
java.lang.String	getUniqueId(java.lang.Object object)
boolean	hasMethod(java.lang.String methodName)
boolean	inlineCreation(CompiledObject object)
boolean	isAbstractClass()
boolean	isFailed()
boolean	isIdentCssFound()
boolean	isMainDeclared()
java.lang.String	loadFile(java.io.File file) Loads the given file and returns its content.
void	openComponent(CompiledObject component)
void	openComponent(CompiledObject component, java.lang.String constraints)
void	openInvisibleComponent(CompiledObject component)
static org.w3c.dom.Document	parseDocument(java.io.InputStream in)
java.lang.String	preprocessScript(java.lang.String script)
void	registerCompiledObject(CompiledObject object)
void	registerEventHandler(EventHandler handler)
void	registerInitializer(java.lang.Runnable r) Registers a Runnable which will be executed after the first compilation pass is complete.
void	registerScript(java.lang.String script)
void	registerScript(java.lang.String script, java.io.File sourceFile)
void	registerStylesheet(Stylesheet stylesheet)
void	registerStyleSheetFile(java.io.File styleFile)
void	reportError(CompilerException ex)
void	reportError(org.w3c.dom.Element tag, java.lang.String error)
void	reportError(org.w3c.dom.Element tag, java.lang.String error, int lineOffset)
void	reportError(int lineNumber, java.lang.String error)
void	reportError(java.lang.String error)
void	reportError(java.lang.String extraMessage, CompilerException ex)
void	reportWarning(org.w3c.dom.Element tag, java.lang.String warning, int lineOffset)
void	reportWarning(java.lang.String warning)
void	runInitializers()
void	setAbstractClass(boolean abstractClass)
void	setClassLoader(java.lang.ClassLoader classLoader)
void	setExtraInterfaces(java.lang.String[] extraInterfaces)
void	setGenericType(java.lang.String genericType)
void	setIdentCssFound(boolean identCssFound)
void	setMainDeclared(boolean mainDeclared)
void	setSuperGenericType(java.lang.String superGenericType)
static java.io.File	URLtoFile(java.lang.String urlString)
static java.io.File	URLtoFile(java.net.URL url)

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static final org.apache.commons.logging.Log log

Logger

STRICT_CHECKS

public static boolean STRICT_CHECKS

True to throw exceptions when we encounter unresolvable classes, false to ignore.

This is currently set to false until JAXX has full support for inner classes (including enumerations), because currently they don't always resolve (but will generally run without error anyway).

JAXX_NAMESPACE

public static final java.lang.String JAXX_NAMESPACE

See Also:

Constant Field Values

JAXX_INTERNAL_NAMESPACE

public static final java.lang.String JAXX_INTERNAL_NAMESPACE

See Also:

Constant Field Values

INLINE_THRESHOLD

public static final int INLINE_THRESHOLD

Maximum length of an inlinable creation method.

See Also:

Constant Field Values

lineSeparator

protected static java.lang.String lineSeparator

Line separator cached value

firstPassClassTagHandler

protected final DefaultObjectHandler firstPassClassTagHandler

The unique object handler used in first pass

failed

protected boolean failed

flag to detect if an error occurs while compiling jaxx file

root

protected CompiledObject root

Object corresponding to the root tag in the document.

importedPackages

protected java.util.Set<java.lang.String> importedPackages

Contains strings of the form "javax.swing."

importedClasses

protected java.util.Set<java.lang.String> importedClasses

Contains strings of the form "javax.swing.Timer"

openComponents

protected java.util.Stack<CompiledObject> openComponents

Keeps track of open components (components still having children added).

idHelper

protected final IDHelper idHelper

to generate ids

bindingHelper

protected final DataBindingHelper bindingHelper

Binding Util

symbolTable

protected SymbolTable symbolTable

table of symbols for this compiler

baseDir

protected java.io.File baseDir

Base directory used for path resolution (normally the directory in which the .jaxx file resides).

src

protected java.io.File src

jaxx file being compiled.

document

protected org.w3c.dom.Document document

Parsed XML of src file.

outputClassName

protected java.lang.String outputClassName

Name of class being compiled.

scriptManager

protected ScriptManager scriptManager

script manager

stylesheet

protected Stylesheet stylesheet

Combination of all stylesheets registered using registerStylesheet(jaxx.runtime.css.Stylesheet).

inlineStyles

protected java.util.List<Rule> inlineStyles

Contains all attributes defined inline on class tags.

eventHandlers

protected java.util.Map<java.lang.String,java.util.Map<ClassDescriptor,java.util.List<EventHandler>>> eventHandlers

Maps objects (expressed in Java code) to event listener classes (e.g. MouseListener) to Lists of EventHandlers. The final list contains all event handlers of a particular type attached to a particular object (again, as represented by a Java expression).

eventHandlerMethodNames

protected java.util.Map<EventHandler,java.lang.String> eventHandlerMethodNames

Map of event handler method names used in compiler

classLoader

protected java.lang.ClassLoader classLoader

ClassLoader which searches the user-specified class path in addition to the normal class path

initializers

protected java.util.List<java.lang.Runnable> initializers

A list of Runnables which will be run after the first compilation pass.

This is primarily used to trigger the creation of CompiledObjects, which cannot be created during the first pass and must be created in document order.

initializer

protected java.lang.StringBuffer initializer

Extra code to be added to the instance initializer.

lateInitializer

protected java.lang.StringBuffer lateInitializer

Extra code to be added at the end of the instance initializer.

bodyCode

protected java.lang.StringBuffer bodyCode

Extra code to be added to the class body.

mainDeclared

protected boolean mainDeclared

true if a main() method has been declared in a script

javaFile

protected JavaFile javaFile

the file to be generated

tagsBeingCompiled

protected java.util.Stack<org.w3c.dom.Element> tagsBeingCompiled

Used for error reporting purposes, so we can report the right line number.

sourceFiles

protected java.util.Stack<java.io.File> sourceFiles

Used for error reporting purposes, so we can report the right source file.

objects

protected java.util.Map<java.lang.String,CompiledObject> objects

Maps object ID strings to the objects themselves.

These are created during the second compilation pass.

ids

protected java.util.Map<CompiledObject,java.lang.String> ids

Maps objects to their ID strings.

These are created during the second compilation pass.

defaultDecorator

protected CompiledObjectDecorator defaultDecorator

default decodator to use if none specified

engine

protected final JAXXEngine engine

engine which references this compiler (can be null if compiler is standalone)

defaultConfiguration

protected final CompilerConfiguration defaultConfiguration

jaxxFile

protected final JAXXCompilerFile jaxxFile

identCssFound

protected boolean identCssFound

Flag to know if jaxx file ident css was found, otherwise add it when CompilerConfiguration.isAutoImportCss() is sets to true at the end of the second compile pass.

Since:

2.0.2

EMPTY_STRING_ARRAY

public static final java.lang.String[] EMPTY_STRING_ARRAY

Constructor Detail

JAXXCompiler

public JAXXCompiler()

JAXXCompiler

public JAXXCompiler(JAXXEngine engine,
                    JAXXCompilerFile jaxxFile,
                    java.util.List<java.lang.String> defaultImports)

Creates a new JAXXCompiler.

Parameters:

engine - engine which use the compiler (could be null if not attach to any engine)

jaxxFile - the file to compile

defaultImports - list of default imports to add to java files

Method Detail

runInitializers

public void runInitializers()

registerInitializer

public void registerInitializer(java.lang.Runnable r)

Registers a Runnable which will be executed after the first compilation pass is complete.

Parameters:

r - runnable to register

compileFirstPass

public void compileFirstPass(org.w3c.dom.Element tag)
                      throws java.io.IOException

Throws:

java.io.IOException

compileSecondPass

public void compileSecondPass(org.w3c.dom.Element tag)
                       throws java.io.IOException

Throws:

java.io.IOException

compileFirstPass

public void compileFirstPass()
                      throws java.io.IOException

Throws:

java.io.IOException

compileSecondPass

public void compileSecondPass()
                       throws java.io.IOException

Throws:

java.io.IOException

openComponent

public void openComponent(CompiledObject component)
                   throws CompilerException

Throws:

CompilerException

openComponent

public void openComponent(CompiledObject component,
                          java.lang.String constraints)
                   throws CompilerException

Throws:

CompilerException

openInvisibleComponent

public void openInvisibleComponent(CompiledObject component)

getOpenComponent

public CompiledObject getOpenComponent()

closeComponent

public void closeComponent(CompiledObject component)

registerCompiledObject

public void registerCompiledObject(CompiledObject object)

getCompiledObject

public CompiledObject getCompiledObject(java.lang.String id)

inlineCreation

public boolean inlineCreation(CompiledObject object)

checkOverride

public void checkOverride(CompiledObject object)
                   throws CompilerException

Throws:

CompilerException

getBindingHelper

public DataBindingHelper getBindingHelper()

registerEventHandler

public void registerEventHandler(EventHandler handler)

getEventHandlerMethodName

public java.lang.String getEventHandlerMethodName(EventHandler handler)

addScriptField

public void addScriptField(FieldDescriptor field)

addScriptMethod

public void addScriptMethod(MethodDescriptor method)

registerScript

public void registerScript(java.lang.String script)
                    throws CompilerException

Throws:

CompilerException

registerScript

public void registerScript(java.lang.String script,
                           java.io.File sourceFile)
                    throws CompilerException

Throws:

CompilerException

preprocessScript

public java.lang.String preprocessScript(java.lang.String script)
                                  throws CompilerException

Throws:

CompilerException

isIdentCssFound

public boolean isIdentCssFound()

registerStyleSheetFile

public void registerStyleSheetFile(java.io.File styleFile)
                            throws java.io.IOException

Throws:

java.io.IOException

applyStylesheets

public void applyStylesheets()

registerStylesheet

public void registerStylesheet(Stylesheet stylesheet)

addInlineStyle

public void addInlineStyle(CompiledObject object,
                           java.lang.String propertyName,
                           boolean dataBinding)

reportWarning

public void reportWarning(java.lang.String warning)

reportWarning

public void reportWarning(org.w3c.dom.Element tag,
                          java.lang.String warning,
                          int lineOffset)

reportError

public void reportError(java.lang.String error)

reportError

public void reportError(CompilerException ex)

reportError

public void reportError(java.lang.String extraMessage,
                        CompilerException ex)

reportError

public void reportError(org.w3c.dom.Element tag,
                        java.lang.String error)

reportError

public void reportError(org.w3c.dom.Element tag,
                        java.lang.String error,
                        int lineOffset)

reportError

public void reportError(int lineNumber,
                        java.lang.String error)

getObjects

public java.util.Map<java.lang.String,CompiledObject> getObjects()

getEventHandlers

public java.util.Map<java.lang.String,java.util.Map<ClassDescriptor,java.util.List<EventHandler>>> getEventHandlers()

getConfiguration

public CompilerConfiguration getConfiguration()

getOutputClassName

public java.lang.String getOutputClassName()

getBaseDir

public java.io.File getBaseDir()

getImportedClasses

public java.util.Set<java.lang.String> getImportedClasses()

getImportedPackages

public java.util.Set<java.lang.String> getImportedPackages()

getObjectCreationOrder

public java.util.Iterator<CompiledObject> getObjectCreationOrder()

getRootObject

public CompiledObject getRootObject()

getSourceFiles

public java.util.Stack<java.io.File> getSourceFiles()

getScriptManager

public ScriptManager getScriptManager()

getSymbolTable

public SymbolTable getSymbolTable()

getStylesheet

public Stylesheet getStylesheet()

getScriptFields

public FieldDescriptor[] getScriptFields()

getScriptField

public FieldDescriptor getScriptField(java.lang.String fieldName)

getScriptMethods

public MethodDescriptor[] getScriptMethods()

getScriptMethod

public MethodDescriptor getScriptMethod(java.lang.String methodName)

isFailed

public boolean isFailed()

getIdHelper

public IDHelper getIdHelper()

getClassLoader

public java.lang.ClassLoader getClassLoader()

Returns a ClassLoader which searches the user-specified class path in addition to the normal system class path.

Returns:

ClassLoader to use while resolving class references

getJAXXObjectDescriptor

public JAXXObjectDescriptor getJAXXObjectDescriptor()

getInitializer

public java.lang.StringBuffer getInitializer()

getLateInitializer

public java.lang.StringBuffer getLateInitializer()

getBodyCode

public java.lang.StringBuffer getBodyCode()

isMainDeclared

public boolean isMainDeclared()

setMainDeclared

public void setMainDeclared(boolean mainDeclared)

appendInitializerCode

public void appendInitializerCode(java.lang.String code)

appendBodyCode

public void appendBodyCode(java.lang.String code)

appendLateInitializer

public void appendLateInitializer(java.lang.String code)

hasMethod

public boolean hasMethod(java.lang.String methodName)

addImport

public void addImport(java.lang.String text)

addDependencyClass

public void addDependencyClass(java.lang.String className)

loadFile

public java.lang.String loadFile(java.io.File file)

Loads the given file and returns its content.

Note: If any errors encounters, then report an error in the compiler and returns an empty string.

Parameters:

file - the file to load

Returns:

the content of the file or empty string if something was wrong

checkJavaCode

public java.lang.String checkJavaCode(java.lang.String javaCode)

Verifies that a snippet of Java code parses correctly.

A warning is generated if the string has enclosing curly braces.

Parameters:

javaCode - the Java code snippet to test

Returns:

a "cooked" version of the string which has enclosing curly braces removed.

Throws:

CompilerException - if the code cannot be parsed

checkReference

public boolean checkReference(org.w3c.dom.Element tag,
                              java.lang.String reference,
                              boolean strict,
                              java.lang.String attribute)

Check that a reference exists in symbol table on second compil pass

Parameters:

tag - the current tag

reference - the required reference

strict - flag to report an error if reference was not found

attribute - (if not null reference the attribute where is defined the reference)

Returns:

true if reference was found, false otherwise and add an error in compiler

getAutoId

public java.lang.String getAutoId(java.lang.String name)

getUniqueId

public java.lang.String getUniqueId(java.lang.Object object)

setExtraInterfaces

public void setExtraInterfaces(java.lang.String[] extraInterfaces)

getExtraInterfaces

public java.lang.String[] getExtraInterfaces()

isAbstractClass

public boolean isAbstractClass()

setAbstractClass

public void setAbstractClass(boolean abstractClass)

getGenericType

public java.lang.String getGenericType()

setGenericType

public void setGenericType(java.lang.String genericType)

getSuperGenericType

public java.lang.String getSuperGenericType()

setSuperGenericType

public void setSuperGenericType(java.lang.String superGenericType)

addSimpleField

public void addSimpleField(JavaField javaField)

getJavaFile

public JavaFile getJavaFile()

finalizeCompiler

public void finalizeCompiler()
                      throws java.lang.Exception

Throws:

java.lang.Exception

generate

public void generate(JavaFileGenerator generator)
              throws java.io.IOException

Throws:

java.io.IOException

getLineSeparator

public static java.lang.String getLineSeparator()

Returns the system line separator string.

Returns:

the string used to separate lines

getCanonicalName

public static java.lang.String getCanonicalName(java.lang.Class<?> clazz)

getCanonicalName

public static java.lang.String getCanonicalName(ClassDescriptor clazz)

getCanonicalName

public static java.lang.String getCanonicalName(CompiledObject compiled)

escapeJavaString

public static java.lang.String escapeJavaString(java.lang.String raw)

Escapes a string using standard Java escape sequences, generally in preparation to including it in a string literal in a compiled Java file.

Parameters:

raw - the raw string to be escape

Returns:

a string in which all 'dangerous' characters have been replaced by equivalent Java escape sequences

URLtoFile

public static java.io.File URLtoFile(java.net.URL url)

URLtoFile

public static java.io.File URLtoFile(java.lang.String urlString)

getSAXParser

public static javax.xml.parsers.SAXParser getSAXParser()

parseDocument

public static org.w3c.dom.Document parseDocument(java.io.InputStream in)
                                          throws java.io.IOException,
                                                 org.xml.sax.SAXException

Throws:

java.io.IOException

org.xml.sax.SAXException

getEngine

public JAXXEngine getEngine()

clear

public void clear()

setIdentCssFound

public void setIdentCssFound(boolean identCssFound)

setClassLoader

public void setClassLoader(java.lang.ClassLoader classLoader)