Class Unparser

java.lang.Object

org.codehaus.janino.Unparser

All Implemented Interfaces:

AutoCloseable

public class Unparser
extends Object
implements AutoCloseable

Unparses (un-compiles) an AST to a Writer. See main(String[]) for a usage example.

Field Summary

Fields

Modifier and Type	Field	Description
private final Visitor.AnnotationVisitor<Void, RuntimeException>	annotationUnparser
private final Visitor.ArrayInitializerOrRvalueVisitor<Void, RuntimeException>	arrayInitializerOrRvalueUnparser
private final Visitor.AtomVisitor<Void, RuntimeException>	atomUnparser
private final Visitor.BlockStatementVisitor<Void, RuntimeException>	blockStatementUnparser
private final Visitor.AbstractCompilationUnitVisitor<Void, RuntimeException>	compilationUnitUnparser
private final Visitor.ElementValueVisitor<Void, RuntimeException>	elementValueUnparser
private final Visitor.FunctionDeclaratorVisitor<Void, RuntimeException>	functionDeclaratorUnparser
private final Visitor.ImportVisitor<Void, RuntimeException>	importUnparser
private final Visitor.LambdaBodyVisitor<Void, RuntimeException>	lambdaBodyUnparser
private final Visitor.LambdaParametersVisitor<Void, RuntimeException>	lambdaParametersUnparser
private static final Set<String>	LEFT_ASSOCIATIVE_OPERATORS
private final Visitor.LvalueVisitor<Void, RuntimeException>	lvalueUnparser
private final Visitor.ModifierVisitor<Void, RuntimeException>	modifierUnparser
private final Visitor.ModuleDirectiveVisitor<Void, RuntimeException>	moduleDirectiveUnparser
private static final Map<String,Integer>	OPERATOR_PRECEDENCE	Maps (pseudo-)operators like "?:" and "x++" to precedences (higher value means higher precedence).
protected final PrintWriter	pw	Where the visit...() methods print their text.
private final Visitor.TryStatementResourceVisitor<Void, RuntimeException>	resourceUnparser
private static final Set<String>	RIGHT_ASSOCIATIVE_OPERATORS
private final Visitor.RvalueVisitor<Void, RuntimeException>	rvalueUnparser
private final Visitor.TypeBodyDeclarationVisitor<Void, RuntimeException>	typeBodyDeclarationUnparser
private final Visitor.TypeDeclarationVisitor<Void, RuntimeException>	typeDeclarationUnparser
private final Visitor.TypeVisitor<Void, RuntimeException>	typeUnparser
private static final Set<String>	UNARY_OPERATORS

Constructor Summary

Constructors

Constructor	Description
Unparser(Writer w)

Method Summary

Modifier and Type	Method	Description
private static boolean	classDeclarationBodyIsEmpty(Java.AbstractClassDeclaration cd)
void	close()	Flushes all generated code.
private static int	comparePrecedence(String operator, Java.Atom operand)	Returns a value < 0 iff the operator has lower precedence than the operand ==; 0 iff the operator has equal precedence than the operand > 0 iff the operator has higher precedence than the operand
void	flush()	Flushes all generated code.
private static int	getOperatorPrecedence(String operator)
private static boolean	isLeftAssociate(String operator)	Returns true iff operator is left associative e.g.
private static boolean	isRightAssociate(String operator)	Returns true iff operator is right associative e.g.
static void	main(String[] args)	Testing of parsing/unparsing.
static void	unparse(Java.AbstractCompilationUnit acu, Writer w)	Unparses the given Java.AbstractCompilationUnit to the given Writer.
private void	unparse(Java.Atom operand, boolean natural)
void	unparseAbstractCompilationUnit(Java.AbstractCompilationUnit cu)
private void	unparseAnnotations(Java.Annotation[] annotations)
private void	unparseAnnotationTypeDeclaration(Java.AnnotationTypeDeclaration atd)
private void	unparseArrayInitializerOrRvalue(Java.ArrayInitializerOrRvalue aiorv)
void	unparseAtom(Java.Atom a)
void	unparseBlock(Java.Block b)	Generates Java code from a Java.Block.
void	unparseBlockStatement(Java.BlockStatement bs)
private void	unparseCatchParameter(Java.CatchParameter cp)
void	unparseClassDeclarationBody(Java.AbstractClassDeclaration cd)	Generates Java code from a Java.AbstractClassDeclaration.
private void	unparseConstructorDeclarator(Java.ConstructorDeclarator cd)
private void	unparseDocComment(Java.DocCommentable dc)
private void	unparseEnumDeclaration(Java.EnumDeclaration ed)
private void	unparseFieldDeclaration(Java.FieldDeclaration fd)
private void	unparseFormalParameter(Java.FunctionDeclarator.FormalParameter fp, boolean hasEllipsis)
private void	unparseFormalParameters(Java.FunctionDeclarator.FormalParameters fps)
private void	unparseFunctionDeclarator(Java.FunctionDeclarator fd)
private void	unparseFunctionDeclaratorRest(Java.FunctionDeclarator fd)
private void	unparseFunctionInvocationArguments(Java.Rvalue[] arguments)
void	unparseImportDeclaration(Java.AbstractCompilationUnit.ImportDeclaration id)
private void	unparseInitializer(Java.Initializer i)
private void	unparseInterfaceDeclaration(Java.InterfaceDeclaration id)
void	unparseLambdaBody(Java.LambdaBody body)
void	unparseLambdaParameters(Java.LambdaParameters lp)
private void	unparseLhs(Java.Atom lhs, String binaryOperator)	Iff the lhs is unnatural for the binaryOperator, encloses the lhs in parentheses.
void	unparseLvalue(Java.Lvalue lv)
private void	unparseMethodDeclarator(Java.MethodDeclarator md)
private void	unparseModifiers(Java.Modifier[] modifiers)
private void	unparseNamedClassDeclaration(Java.NamedClassDeclaration ncd)
private void	unparseResource(Java.TryStatement.Resource r)
private void	unparseResources(Java.TryStatement.Resource[] resources)
private void	unparseRhs(Java.Rvalue rhs, String binaryOperator)	Iff the rhs is unnatural for the binaryOperator, enclose the rhs in parentheses.
void	unparseRvalue(Java.Rvalue rv)
void	unparseStatements(List<? extends Java.BlockStatement> statements)	Generates Java code from a sequence of Java.BlockStatements.
void	unparseType(Java.Type t)
void	unparseTypeDeclaration(Java.TypeDeclaration td)
private void	unparseTypeDeclarationBody(Java.TypeDeclaration td)
private void	unparseTypeParameter(Java.TypeParameter typeParameter)
private void	unparseTypeParameters(Java.TypeParameter[] typeParameters)
private void	unparseUnaryOperation(Java.Rvalue operand, String unaryOperator)	Iff the operand is unnatural for the unaryOperator, encloses the operand in parentheses.
private void	unparseVariableDeclarator(Java.VariableDeclarator vd)
private void	unparseVariableDeclarators(Java.VariableDeclarator[] variableDeclarators)

Methods inherited from class Object

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

Field Details

compilationUnitUnparser

private final Visitor.AbstractCompilationUnitVisitor<Void, RuntimeException> compilationUnitUnparser

moduleDirectiveUnparser

private final Visitor.ModuleDirectiveVisitor<Void, RuntimeException> moduleDirectiveUnparser

importUnparser

private final Visitor.ImportVisitor<Void, RuntimeException> importUnparser

typeDeclarationUnparser

private final Visitor.TypeDeclarationVisitor<Void, RuntimeException> typeDeclarationUnparser

typeBodyDeclarationUnparser

private final Visitor.TypeBodyDeclarationVisitor<Void, RuntimeException> typeBodyDeclarationUnparser

blockStatementUnparser

private final Visitor.BlockStatementVisitor<Void, RuntimeException> blockStatementUnparser

atomUnparser

private final Visitor.AtomVisitor<Void, RuntimeException> atomUnparser

typeUnparser

private final Visitor.TypeVisitor<Void, RuntimeException> typeUnparser

arrayInitializerOrRvalueUnparser

private final Visitor.ArrayInitializerOrRvalueVisitor<Void, RuntimeException> arrayInitializerOrRvalueUnparser

rvalueUnparser

private final Visitor.RvalueVisitor<Void, RuntimeException> rvalueUnparser

lvalueUnparser

private final Visitor.LvalueVisitor<Void, RuntimeException> lvalueUnparser

elementValueUnparser

private final Visitor.ElementValueVisitor<Void, RuntimeException> elementValueUnparser

annotationUnparser

private final Visitor.AnnotationVisitor<Void, RuntimeException> annotationUnparser

modifierUnparser

private final Visitor.ModifierVisitor<Void, RuntimeException> modifierUnparser

lambdaParametersUnparser

private final Visitor.LambdaParametersVisitor<Void, RuntimeException> lambdaParametersUnparser

lambdaBodyUnparser

private final Visitor.LambdaBodyVisitor<Void, RuntimeException> lambdaBodyUnparser

functionDeclaratorUnparser

private final Visitor.FunctionDeclaratorVisitor<Void, RuntimeException> functionDeclaratorUnparser

resourceUnparser

private final Visitor.TryStatementResourceVisitor<Void, RuntimeException> resourceUnparser

pw

protected final PrintWriter pw

Where the visit...() methods print their text. Notice that this PrintWriter does not print to the output directly, but through an AutoIndentWriter.

LEFT_ASSOCIATIVE_OPERATORS

private static final Set<String> LEFT_ASSOCIATIVE_OPERATORS

RIGHT_ASSOCIATIVE_OPERATORS

private static final Set<String> RIGHT_ASSOCIATIVE_OPERATORS

UNARY_OPERATORS

private static final Set<String> UNARY_OPERATORS

OPERATOR_PRECEDENCE

private static final Map<String,Integer> OPERATOR_PRECEDENCE

Maps (pseudo-)operators like "?:" and "x++" to precedences (higher value means higher precedence).

Constructor Details

Unparser

public Unparser(Writer w)

Method Details

unparseInitializer

private void unparseInitializer(Java.Initializer i)

unparseFieldDeclaration

private void unparseFieldDeclaration(Java.FieldDeclaration fd)

unparseResources

private void unparseResources(Java.TryStatement.Resource[] resources)

main

public static void main(String[] args)
                 throws Exception

Testing of parsing/unparsing.

Reads compilation units from the files named on the command line and unparses them to System.out.

Throws:

Exception

unparse

public static void unparse(Java.AbstractCompilationUnit acu,
 Writer w)

Unparses the given Java.AbstractCompilationUnit to the given Writer.

flush

public void flush()

Flushes all generated code.

close

public void close()

Flushes all generated code.

Specified by:

close in interface AutoCloseable

unparseAbstractCompilationUnit

public void unparseAbstractCompilationUnit(Java.AbstractCompilationUnit cu)

Parameters:

cu - The compilation unit to unparse

unparseImportDeclaration

public void unparseImportDeclaration(Java.AbstractCompilationUnit.ImportDeclaration id)

unparseConstructorDeclarator

private void unparseConstructorDeclarator(Java.ConstructorDeclarator cd)

unparseMethodDeclarator

private void unparseMethodDeclarator(Java.MethodDeclarator md)

unparseStatements

public void unparseStatements(List<? extends Java.BlockStatement> statements)

Generates Java code from a sequence of Java.BlockStatements.

unparseVariableDeclarator

private void unparseVariableDeclarator(Java.VariableDeclarator vd)

unparseFormalParameter

private void unparseFormalParameter(Java.FunctionDeclarator.FormalParameter fp,
 boolean hasEllipsis)

unparseCatchParameter

private void unparseCatchParameter(Java.CatchParameter cp)

unparseLambdaParameters

public void unparseLambdaParameters(Java.LambdaParameters lp)

unparseLambdaBody

public void unparseLambdaBody(Java.LambdaBody body)

unparseBlock

public void unparseBlock(Java.Block b)

Generates Java code from a Java.Block.

unparseBlockStatement

public void unparseBlockStatement(Java.BlockStatement bs)

unparseTypeDeclaration

public void unparseTypeDeclaration(Java.TypeDeclaration td)

unparseType

public void unparseType(Java.Type t)

unparseAtom

public void unparseAtom(Java.Atom a)

unparseArrayInitializerOrRvalue

private void unparseArrayInitializerOrRvalue(Java.ArrayInitializerOrRvalue aiorv)

unparseRvalue

public void unparseRvalue(Java.Rvalue rv)

unparseLvalue

public void unparseLvalue(Java.Lvalue lv)

unparseUnaryOperation

private void unparseUnaryOperation(Java.Rvalue operand,
 String unaryOperator)

Iff the operand is unnatural for the unaryOperator, encloses the operand in parentheses. Example: "a+b" is an unnatural operand for unary "!x".

Parameters:

unaryOperator - ++x --x +x -x ~x !x x++ x--

unparseLhs

private void unparseLhs(Java.Atom lhs,
 String binaryOperator)

Iff the lhs is unnatural for the binaryOperator, encloses the lhs in parentheses. Example: "a+b" is an unnatural lhs for operator "*".

Parameters:

binaryOperator - = +=... ?: || invalid input: '&'invalid input: '&' | ^ invalid input: '&' == != invalid input: '<' > invalid input: '<'= >= instanceof invalid input: '<'invalid input: '<' >> >>> + - * / % cast

unparseRhs

private void unparseRhs(Java.Rvalue rhs,
 String binaryOperator)

Iff the rhs is unnatural for the binaryOperator, enclose the rhs in parentheses. Example: "a+b" is an unnatural rhs for operator "*".

unparse

private void unparse(Java.Atom operand,
 boolean natural)

isRightAssociate

private static boolean isRightAssociate(String operator)

Returns true iff operator is right associative e.g. a = b = c evaluates as a = (b = c).

Returns:

Return true iff operator is right associative

isLeftAssociate

private static boolean isLeftAssociate(String operator)

Returns true iff operator is left associative e.g. a - b - c evaluates as (a - b) - c.

comparePrecedence

private static int comparePrecedence(String operator,
 Java.Atom operand)

Returns a value

• < 0 iff the operator has lower precedence than the operand
• ==; 0 iff the operator has equal precedence than the operand
• > 0 iff the operator has higher precedence than the operand

getOperatorPrecedence

private static int getOperatorPrecedence(String operator)

unparseNamedClassDeclaration

private void unparseNamedClassDeclaration(Java.NamedClassDeclaration ncd)

unparseClassDeclarationBody

public void unparseClassDeclarationBody(Java.AbstractClassDeclaration cd)

Generates Java code from a Java.AbstractClassDeclaration.

classDeclarationBodyIsEmpty

private static boolean classDeclarationBodyIsEmpty(Java.AbstractClassDeclaration cd)

Returns:

Whether unparseClassDeclarationBody(Java.AbstractClassDeclaration) will produce no output

unparseInterfaceDeclaration

private void unparseInterfaceDeclaration(Java.InterfaceDeclaration id)

unparseTypeDeclarationBody

private void unparseTypeDeclarationBody(Java.TypeDeclaration td)

unparseFunctionDeclaratorRest

private void unparseFunctionDeclaratorRest(Java.FunctionDeclarator fd)

unparseFormalParameters

private void unparseFormalParameters(Java.FunctionDeclarator.FormalParameters fps)

unparseDocComment

private void unparseDocComment(Java.DocCommentable dc)

unparseAnnotations

private void unparseAnnotations(Java.Annotation[] annotations)

unparseModifiers

private void unparseModifiers(Java.Modifier[] modifiers)

unparseTypeParameters

private void unparseTypeParameters(@Nullable
 Java.TypeParameter[] typeParameters)

unparseTypeParameter

private void unparseTypeParameter(Java.TypeParameter typeParameter)

unparseFunctionInvocationArguments

private void unparseFunctionInvocationArguments(Java.Rvalue[] arguments)

unparseEnumDeclaration

private void unparseEnumDeclaration(Java.EnumDeclaration ed)

unparseAnnotationTypeDeclaration

private void unparseAnnotationTypeDeclaration(Java.AnnotationTypeDeclaration atd)

unparseFunctionDeclarator

private void unparseFunctionDeclarator(Java.FunctionDeclarator fd)

unparseResource

private void unparseResource(Java.TryStatement.Resource r)

unparseVariableDeclarators

private void unparseVariableDeclarators(Java.VariableDeclarator[] variableDeclarators)