org.jsweet.transpiler.extension

Class Java2TypeScriptAdapter

java.lang.Object

org.jsweet.transpiler.extension.PrinterAdapter

org.jsweet.transpiler.extension.Java2TypeScriptAdapter

Direct Known Subclasses:

RemoveJavaDependenciesAdapter

public class Java2TypeScriptAdapter
extends PrinterAdapter

This is an adapter for the TypeScript code generator. It overrides the default adapter's behavior.

Author:

Renaud Pawlak

Field Summary

Fields inherited from class org.jsweet.transpiler.extension.PrinterAdapter

context, logger, typeVariablesToErase

Constructor Summary

Constructors

Constructor and Description
Java2TypeScriptAdapter(JSweetContext context) Creates a root adapter (with no parent).
Java2TypeScriptAdapter(PrinterAdapter parent) Creates a new adapter that will try delegate to the given parent adapter when not implementing its own behavior.

Method Summary

Modifier and Type	Method and Description
protected void	delegateToEmulLayer(String targetClassName, String targetMethodName, InvocationElement invocation)
protected void	delegateToEmulLayer(String targetClassName, VariableAccessElement fieldAccess)
protected void	delegateToEmulLayerStatic(String targetClassName, String targetMethodName, ExtendedElement target)
Set<String>	getErasedTypes()
Java2TypeScriptTranslator	getPrinter() Gets the printer on which rely the adapter (this is not recommended).
String	needsImport(ImportElement importElement, String qualifiedName) Returns the import qualified id if the given import requires an import statement to be printed.
protected void	printCastMethodInvocation(InvocationElement invocation)
protected void	printForEachLoop(com.sun.tools.javac.tree.JCTree.JCEnhancedForLoop loop, String indexVarName)
protected void	printFunctionalInvocation(ExtendedElement target, String functionName, List<ExtendedElement> arguments)
protected PrinterAdapter	printTarget(ExtendedElement target)
boolean	substituteAndPrintType(ExtendedElement enclosingElement, TypeElement type)
boolean	substituteForEachLoop(ForeachLoopElement foreachLoop, boolean targetHasLength, String indexVarName) Substitutes if necessary the given foreach loop.
boolean	substituteIdentifier(IdentifierElement identifierElement) Substitutes the value of an identifier.
boolean	substituteMethodInvocation(MethodInvocationElement invocationElement) Substitutes the value of a method invocation expression.
boolean	substituteNewClass(NewClassElement newClassElement) To override to tune the printing of a new class expression.
boolean	substituteVariableAccess(VariableAccessElement variableAccess) Substitutes the given variable access.

Methods inherited from class org.jsweet.transpiler.extension.PrinterAdapter

adaptDocComment, addAnnotation, addAnnotation, addAnnotationManager, addAnnotationWithValue, addHeader, addTypeMapping, addTypeMapping, addTypeMappings, afterType, endIndent, eraseSuperClass, eraseSuperInterface, findExecutableDeclarationInType, getAnnotationValue, getAnnotationValue, getContext, getFunctionalTypeMappings, getHeader, getMappedType, getModuleImportDescriptor, getParentAdapter, getParentElement, getParentElement, getRootRelativeName, getTranspilerOptions, getTypeMappingTarget, hasAnnotationType, isAmbientDeclaration, isMappedType, isSubstituteSuperTypes, print, print, print, print, printArgList, printIdentifierList, printIndent, println, printMacroName, removeLastChar, removeLastChar, removeLastChars, removeLastIndent, report, report, report, report, setParentAdapter, setPrinter, space, startIndent, substitute, substituteArrayAccess, substituteAssignment, substituteAssignmentWithOperator, substituteBinaryOperator, substituteCaseStatementPattern, substituteInstanceof, substituteUnaryOperator, types, util

Methods inherited from class java.lang.Object

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

Constructor Detail

Java2TypeScriptAdapter

public Java2TypeScriptAdapter(JSweetContext context)

Creates a root adapter (with no parent).

Parameters:

context - the transpilation context

Java2TypeScriptAdapter

public Java2TypeScriptAdapter(PrinterAdapter parent)

Creates a new adapter that will try delegate to the given parent adapter when not implementing its own behavior.

Parameters:

parentAdapter - cannot be null: if no parent you must use the #AbstractPrinterAdapter(JSweetContext) constructor

Method Detail

getPrinter

public Java2TypeScriptTranslator getPrinter()

Description copied from class: PrinterAdapter

Gets the printer on which rely the adapter (this is not recommended).

Accessing the printer with this method allows the user to access the internal javac API directly (com.sun.tools.javac), which is non-standard and may get deprecated in future Java versions. As a consequence, to write sustainable adapters, it is not recommended to use the printer API.

Instead, use the adapter's API directly, which relies on an abstraction of the AST: javax.lang.model and org.jsweet.transpiler.model. If some feature seems to be missing, please contact JSweet.org to help improving this API.

Overrides:

getPrinter in class PrinterAdapter

needsImport

public String needsImport(ImportElement importElement,
                          String qualifiedName)

Description copied from class: PrinterAdapter

Returns the import qualified id if the given import requires an import statement to be printed.

Overrides:

needsImport in class PrinterAdapter

Parameters:

importElement - the given import declaration

qualifiedName - the qualified import id

Returns:

the possibly adapted qualified id or null if the import should be ignored by the printer

substituteMethodInvocation

public boolean substituteMethodInvocation(MethodInvocationElement invocationElement)

Description copied from class: PrinterAdapter

Substitutes the value of a method invocation expression.

Overrides:

substituteMethodInvocation in class PrinterAdapter

Parameters:

invocationElement - the invocation being printed

Returns:

true if substituted

printFunctionalInvocation

protected void printFunctionalInvocation(ExtendedElement target,
                                         String functionName,
                                         List<ExtendedElement> arguments)

printTarget

protected final PrinterAdapter printTarget(ExtendedElement target)

delegateToEmulLayer

protected final void delegateToEmulLayer(String targetClassName,
                                         String targetMethodName,
                                         InvocationElement invocation)

delegateToEmulLayerStatic

protected final void delegateToEmulLayerStatic(String targetClassName,
                                               String targetMethodName,
                                               ExtendedElement target)

printCastMethodInvocation

protected final void printCastMethodInvocation(InvocationElement invocation)

substituteAndPrintType

public boolean substituteAndPrintType(ExtendedElement enclosingElement,
                                      TypeElement type)

Parameters:

enclosingElement - is required for functional (ie dynamic) type mappings

substituteVariableAccess

public boolean substituteVariableAccess(VariableAccessElement variableAccess)

Description copied from class: PrinterAdapter

Substitutes the given variable access.

Overrides:

substituteVariableAccess in class PrinterAdapter

Parameters:

variableAccess - the variable access being printed

Returns:

true if substituted

delegateToEmulLayer

protected final void delegateToEmulLayer(String targetClassName,
                                         VariableAccessElement fieldAccess)

substituteNewClass

public boolean substituteNewClass(NewClassElement newClassElement)

Description copied from class: PrinterAdapter

To override to tune the printing of a new class expression.

Overrides:

substituteNewClass in class PrinterAdapter

Parameters:

newClassElement - the new class expression

Returns:

true if substituted

substituteIdentifier

public boolean substituteIdentifier(IdentifierElement identifierElement)

Description copied from class: PrinterAdapter

Substitutes the value of an identifier.

Overrides:

substituteIdentifier in class PrinterAdapter

Parameters:

identifierElement - the identifier being printed

Returns:

true if substituted

getErasedTypes

public Set<String> getErasedTypes()

Overrides:

getErasedTypes in class PrinterAdapter

printForEachLoop

protected void printForEachLoop(com.sun.tools.javac.tree.JCTree.JCEnhancedForLoop loop,
                                String indexVarName)

substituteForEachLoop

public boolean substituteForEachLoop(ForeachLoopElement foreachLoop,
                                     boolean targetHasLength,
                                     String indexVarName)

Description copied from class: PrinterAdapter

Substitutes if necessary the given foreach loop.

Overrides:

substituteForEachLoop in class PrinterAdapter

Parameters:

foreachLoop - the foreach loop to print

targetHasLength - true if the iterable defines a public length field

indexVarName - a possible (fresh) variable name that can used to iterate