|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK 11g Release 2 (11.1.2.0.0) E17493-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object oracle.javatools.parser.java.v2.SourceFactory
public abstract class SourceFactory
The factory class for SourceElements.
SourceFactory is an abstract class because of the static methods named createSourceFile here because interfaces can't have static methods. Besides the createSourceFile methods, JavaFactory should be treated like an interface.
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface oracle.javatools.parser.java.v2.JavaPreferences |
---|
JavaPreferences.MemberOrder |
Field Summary |
---|
Fields inherited from interface oracle.javatools.parser.java.v2.JavaOperators |
---|
OPT_ADD, OPT_ADDASG, OPT_AND, OPT_ANNOTATION, OPT_ARRAYCONST, OPT_ASG, OPT_base, OPT_BITAND, OPT_BITANDASG, OPT_BITNOT, OPT_BITOR, OPT_BITORASG, OPT_BITXOR, OPT_BITXORASG, OPT_CLASS_LITERAL, OPT_COND, OPT_DEREF, OPT_DIV, OPT_DIVASG, OPT_DOT, OPT_EQ, OPT_GE, OPT_GT, OPT_INSTANCEOF, OPT_invalid, OPT_INVOKE, OPT_LE, OPT_LIST, OPT_LITERAL, OPT_LSH, OPT_LSHASG, OPT_LT, OPT_max, OPT_MINUS, OPT_MINUSASG, OPT_MOD, OPT_MODASG, OPT_MUL, OPT_MULASG, OPT_NEGATIVE, OPT_NESTEXP, OPT_NEWARRAY, OPT_NEWOBJECT, OPT_NOT, OPT_NOTEQ, OPT_OR, OPT_POSITIVE, OPT_POSTDEC, OPT_POSTINC, OPT_precedence, OPT_PREDEC, OPT_PREINC, OPT_QUALIFIED_SUPER, OPT_QUALIFIED_THIS, OPT_RSH, OPT_RSHASG, OPT_SIMPLE_NAME, OPT_tokens, OPT_TYPE, OPT_TYPECAST, OPT_URSH, OPT_URSHASG, OPT_words |
Fields inherited from interface oracle.javatools.parser.java.v2.JavadocTokens |
---|
TAG_AUTHOR, TAG_base, TAG_CODE, TAG_DEPRECATED, TAG_DOCROOT, TAG_EXCEPTION, TAG_HIDDEN, TAG_INHERITDOC, TAG_inline, TAG_LINK, TAG_LINKPLAIN, TAG_LITERAL, TAG_max, TAG_PARAM, TAG_RETURN, TAG_SEE, TAG_SERIAL, TAG_SERIALDATA, TAG_SERIALFIELD, TAG_SINCE, TAG_THROWS, TAG_unknown, TAG_VALUE, TAG_VERSION, TAG_words, TK_DOC_base, TK_DOC_COLON, TK_DOC_COMMA, TK_DOC_DOT, TK_DOC_HASH, TK_DOC_LBRACE, TK_DOC_LINE_START, TK_DOC_LPAREN, TK_DOC_NEWLINE, TK_DOC_RBRACE, TK_DOC_RPAREN, TK_DOC_TEXT, TK_DOC_WHITESPACE |
Constructor Summary | |
---|---|
SourceFactory()
|
Method Summary | |
---|---|
SourceAnnotation |
createAnnotation(java.lang.String name)
Creates an annotation (but not an annotation type). |
abstract SourceAnnotation |
createAnnotation(java.lang.String name,
SourceListExpression arguments)
Creates an annotation (but not an annotation type). |
abstract SourceAnnotationExpression |
createAnnotationExpression(SourceAnnotation a)
Creates an argument list with one argument. |
abstract SourceAnnotation |
createAnnotationFromText(java.lang.String text)
Attempts to create an annotation with the given text. |
SourceListExpression |
createArgumentList()
Creates an argument list with one argument. |
SourceListExpression |
createArgumentList(SourceExpression arg)
Creates an argument list with one argument. |
SourceListExpression |
createArgumentList(SourceExpression[] arguments)
Creates an argument list. |
abstract SourceArrayAccessExpression |
createArrayAccess(SourceExpression lhs,
SourceListExpression dereferences)
Creates an array access. |
abstract SourceListExpression |
createArrayConstant(SourceExpression[] operands)
Creates an array constant. |
abstract SourceAssertStatement |
createAssertStatement(SourceExpression condition,
SourceExpression output)
Creates an assert statement. |
abstract SourceAssignmentExpression |
createAssignment(int code,
SourceExpression lhs,
SourceExpression rhs)
Creates an assignment expression. |
abstract SourceLexicalBlankline |
createBlankline()
Creates a blank line. |
SourceBlock |
createBlock()
Creates an empty code block. |
abstract SourceBlock |
createBlock(SourceElement[] elements)
Creates a code block. |
SourceBlock |
createBlock(java.lang.String text)
See createBlockFromText(java.lang.String) . |
abstract SourceBlockElement |
createBlockElementFromText(java.lang.String text)
Attempts to create a block element (i.e. |
abstract SourceBlock |
createBlockFromText(java.lang.String text)
Attempts to create a block with the given text. |
abstract SourceBlockStatement |
createBlockStatement(SourceBlock block)
Creates a block statement. |
abstract SourceBreakStatement |
createBreakStatement(java.lang.String target)
Creates a break statement. |
abstract SourceCatchClause |
createCatchClause(SourceFormalParameterList parameters,
SourceBlockStatement child)
Creates a catch clause for a try-catch or a try-catch-finally statement. |
SourceCatchClause |
createCatchClause(SourceLocalVariable parameter,
SourceBlockStatement child)
Creates a catch clause for a try-catch or a try-catch-finally statement. |
SourceClass |
createClass(int tyKind,
java.lang.String name)
Creates a plain and simple ol' class. |
SourceClass |
createClass(int tyKind,
java.lang.String name,
SourceSuperclassClause superclassClause,
SourceInterfacesClause interfacesClause,
SourceClassBody body)
Creates a class declaration. |
abstract SourceClass |
createClass(int tyKind,
java.lang.String name,
SourceTypeParameter[] tyParameters,
SourceSuperclassClause superclassClause,
SourceInterfacesClause interfacesClause,
SourceClassBody body)
Creates a class declaration. |
SourceClass |
createClass(java.lang.String text)
See createClassFromText(java.lang.String) . |
SourceClassBody |
createClassBody()
Creates an empty class body. |
SourceClassBody |
createClassBody(SourceMember member)
Creates an empty class body. |
abstract SourceClassBody |
createClassBody(SourceMember[] members)
Creates a class body. |
SourceNewClassExpression |
createClassCreator(SourceExpression lhs,
SourceTypeReference type,
SourceListExpression arguments,
SourceClassBody body)
Deprecated. Use createNewClassExpression(SSSS). |
abstract SourceClass |
createClassFromText(java.lang.String text)
Attempts to create a class with the given text. |
abstract SourceClassInitializer |
createClassInitializer(int modifiers,
SourceBlock block)
Creates a class initializer. |
abstract SourceLexicalComment |
createComment(java.lang.String text)
Creates an ordinary non-javadoc comment. |
SourceMethod |
createConstructor(SourceFormalParameterList parameters,
SourceThrowsClause throwsClause,
SourceBlock block)
Creates a constructor declaration. |
abstract SourceMethod |
createConstructor(SourceTypeParameter[] typeParameters,
SourceFormalParameterList parameters,
SourceThrowsClause throwsClause,
SourceBlock block)
Creates a constructor declaration. |
abstract SourceContinueStatement |
createContinueStatement(java.lang.String target)
Creates a continue statement. |
SourceDocBlockTag |
createDocBlockTag(SourceDocTagName name)
Creates a doc block tag. |
SourceDocBlockTag |
createDocBlockTag(SourceDocTagName name,
SourceDocDescription description)
Creates a doc block tag with no references. |
abstract SourceDocBlockTag |
createDocBlockTag(SourceDocTagName name,
SourceDocReference[] references,
SourceDocDescription description)
Creates a doc block tag with many references. |
SourceDocBlockTag |
createDocBlockTag(SourceDocTagName name,
SourceDocReference reference,
SourceDocDescription description)
Creates a doc block tag with one reference. |
abstract SourceDocBlockTag |
createDocBlockTagFromText(java.lang.String text)
Attempts to create a doc block tag with the given text. |
SourceDocReference |
createDocClassReference(java.lang.String qualifiedName)
Creates a doc reference with the class reference syntax. |
SourceDocComment |
createDocComment()
Creates a doc comment, empty. |
SourceDocComment |
createDocComment(SourceDocDescription description)
Creates a doc comment with the given description. |
SourceDocComment |
createDocComment(SourceDocDescription description,
SourceDocBlockTag tag)
Creates a doc comment with the given description and block tags. |
abstract SourceDocComment |
createDocComment(SourceDocDescription description,
SourceDocBlockTag[] tags)
Creates a doc comment with the given description and block tags. |
SourceDocComment |
createDocComment(java.lang.String text)
See createDocCommentFromText(java.lang.String) . |
abstract SourceDocComment |
createDocCommentFromText(java.lang.String text)
Attempts to create a doc comment with the given text. |
SourceDocDescription |
createDocDescription()
Creates a doc description, empty. |
SourceDocDescription |
createDocDescription(SourceDocTextFragment line)
Creates a doc description with a single line of text. |
abstract SourceDocDescription |
createDocDescription(SourceDocTextFragment[] lines)
Creates a doc description from the input lines of text. |
SourceDocInlineTag |
createDocInlineTag(SourceDocTagName name)
Creates a doc inline tag. |
SourceDocInlineTag |
createDocInlineTag(SourceDocTagName name,
SourceDocDescription description)
Creates a doc inline tag with no references. |
abstract SourceDocInlineTag |
createDocInlineTag(SourceDocTagName name,
SourceDocReference[] references,
SourceDocDescription description)
Creates a doc inline tag with many references. |
SourceDocInlineTag |
createDocInlineTag(SourceDocTagName name,
SourceDocReference reference,
SourceDocDescription description)
Creates a doc inline tag with one reference. |
abstract SourceDocInlineTag |
createDocInlineTagFromText(java.lang.String text)
Attempts to create a doc block tag with the given text. |
SourceDocReference |
createDocMemberReference(java.lang.String classString,
java.lang.String memberName)
Creates a doc reference with the member reference syntax. |
abstract SourceDocReference |
createDocMemberReferenceFromText(java.lang.String text)
Attempts to create a doc member reference with the given text. |
SourceDocReference |
createDocMethodReference(java.lang.String classString,
java.lang.String methodName,
java.lang.String[] parameterTypes)
Creates a doc reference with the method reference syntax. |
abstract SourceDocReference |
createDocParameterReference(java.lang.String parameterName)
Creates a doc reference with the parameter syntax. |
abstract SourceDocReference |
createDocReference(java.lang.String classString,
java.lang.String memberName,
java.lang.String[] parameterTypes)
Creates a doc reference. |
SourceDocTagName |
createDocTagName(short tag)
Creates a doc tag name from the token value. |
abstract SourceDocTagName |
createDocTagName(java.lang.String name)
Creates a doc tag name. |
abstract SourceDocTextFragment |
createDocTextFragment(java.lang.String text)
Creates a doc text fragment. |
abstract SourceDoStatement |
createDoStatement(SourceExpression e,
SourceStatement child)
Creates a do-while statement. |
abstract SourceDotExpression |
createDotReference(SourceExpression lhs,
java.lang.String name)
Creates a dot reference. |
abstract SourceElseClause |
createElseClause(SourceStatement child)
Creates an else clause for an if statement. |
abstract SourceEmptyStatement |
createEmptyStatement()
Creates an empty statement. |
abstract SourceEnumConstant |
createEnumConstant(java.lang.String name,
SourceListExpression arguments,
SourceClassBody body)
|
abstract SourceExpression |
createExpression(int code)
|
SourceExpression |
createExpression(java.lang.String text)
See createExpressionFromText(java.lang.String) . |
abstract SourceExpression |
createExpressionFromText(java.lang.String text)
Attempts to create an expression with the given text. |
SourceListExpression |
createExpressionList()
|
SourceListExpression |
createExpressionList(SourceExpression argument)
Creates a list expression with one element. |
abstract SourceListExpression |
createExpressionList(SourceExpression[] arguments)
Creates a list expression. |
abstract SourceExpressionStatement |
createExpressionStatement(SourceExpression e)
Creates an expression statement. |
SourceFieldDeclaration |
createFieldDeclaration(int modifiers,
SourceTypeReference type,
java.lang.String name)
Creates a field declaration. |
SourceFieldDeclaration |
createFieldDeclaration(int modifiers,
SourceTypeReference type,
java.lang.String name,
SourceExpression initializer)
Creates a field declaration. |
abstract SourceFieldDeclaration |
createFieldDeclaration(SourceFieldVariable variable)
Creates a field declaration. |
SourceFieldDeclaration |
createFieldDeclaration(SourceFieldVariable[] variables)
Deprecated. Not implemented yet. Creates a field declaration. |
SourceFieldDeclaration |
createFieldDeclaration(SourceLocalVariable variable)
Creates a field variable to match the local variable. |
abstract SourceFieldDeclaration |
createFieldDeclaration(SourceLocalVariableDeclaration locals)
Creates a field declaration to match the local variable declaration. |
SourceFieldDeclaration |
createFieldDeclaration(SourceTypeReference type,
java.lang.String name)
Creates a field declaration. |
SourceFieldDeclaration |
createFieldDeclaration(SourceTypeReference type,
java.lang.String name,
SourceExpression initializer)
Creates a field declaration. |
SourceFieldVariable |
createFieldVariable(int modifiers,
SourceTypeReference type,
java.lang.String name)
Creates a field variable. |
SourceFieldVariable |
createFieldVariable(int modifiers,
SourceTypeReference type,
java.lang.String name,
int xdimensions,
SourceExpression initializer)
Creates a field variable. |
SourceFieldVariable |
createFieldVariable(int modifiers,
SourceTypeReference type,
java.lang.String name,
SourceExpression initializer)
Creates a field variable. |
abstract SourceFieldVariable |
createFieldVariable(SourceLocalVariable variable)
Creates a field variable to match the local variable. |
SourceFieldVariable |
createFieldVariable(SourceTypeReference type,
java.lang.String name)
Creates a field variable. |
SourceFieldVariable |
createFieldVariable(SourceTypeReference type,
java.lang.String name,
SourceExpression initializer)
Creates a field variable |
static SourceFile |
createFile(int j2se)
The SourceFile's URL and provider cookies are set to null. |
abstract SourceFinallyClause |
createFinallyClause(SourceBlockStatement child)
Creates a finally clause for a try statement. |
abstract SourceForStatement |
createForEnhancedStatement(SourceLocalVariableDeclaration loopVarDecl,
SourceExpression collection,
SourceStatement child)
Creates an enhanced-for loop. |
SourceForStatement |
createForEnhancedStatement(SourceLocalVariable loopVariable,
SourceExpression collection,
SourceStatement child)
Creates an enhanced-for loop. |
abstract SourceFormalParameter |
createFormalParameter(SourceLocalVariable variable)
Creates a formal parameter using a local variable as a template. |
SourceFormalParameterList |
createFormalParameterList()
Creates an empty formal parameter list. |
SourceFormalParameterList |
createFormalParameterList(SourceFormalParameter parameter)
Input parameters, if any, will be converted to be formal parameters, namely SRC_FORMAL_PARAMETER. |
abstract SourceFormalParameterList |
createFormalParameterList(SourceFormalParameter[] parameters)
Input parameters, if any, will be converted to be formal parameters, namely SRC_FORMAL_PARAMETER. |
SourceFormalParameterList |
createFormalParameterList(SourceLocalVariable variable)
Input parameters, if any, will be converted to be formal parameters, namely SRC_FORMAL_PARAMETER. |
SourceFormalParameterList |
createFormalParameterList(SourceLocalVariable[] variables)
Input parameters, if any, will be converted to be formal parameters, namely SRC_FORMAL_PARAMETER. |
SourceForStatement |
createForStatement(SourceExpression initialization,
SourceExpression condition,
SourceExpression update,
SourceStatement child)
Convenience method. |
abstract SourceForStatement |
createForStatement(SourceListExpression initializations,
SourceExpression condition,
SourceListExpression updates,
SourceStatement child)
Creates a traditional for loop with no variable declarators. |
abstract SourceForStatement |
createForVariableStatement(SourceLocalVariableDeclaration variables,
SourceExpression condition,
SourceListExpression updates,
SourceStatement child)
Creates a traditional for loop with variable declarations. |
SourceForStatement |
createForVariableStatement(SourceLocalVariable variable,
SourceExpression condition,
SourceExpression update,
SourceStatement child)
Convenience method. |
SourceIfStatement |
createIfElseStatement(SourceExpression e,
SourceStatement trueClause,
SourceStatement elseClause)
Creates an if-else statement. |
abstract SourceIfStatement |
createIfStatement(SourceExpression e,
SourceStatement child)
Creates an if statement. |
abstract SourceIfStatement |
createIfStatement(SourceExpression e,
SourceStatement child,
SourceElseClause clause)
Creates an if or an if-else statement. |
abstract SourceImport |
createImportDeclaration(int modifiers,
java.lang.String name)
|
SourceImport |
createImportDeclaration(java.lang.String name)
|
abstract SourceInfixExpression |
createInfixExpression(int code,
SourceExpression[] operands)
Creates an infix expression with multiple operands. |
abstract SourceInfixExpression |
createInfixExpression(int code,
SourceExpression lhs,
SourceExpression rhs)
Creates an infix expression with two operands. |
SourceClassInitializer |
createInstanceInitializer(SourceBlock block)
Creates an instance class initializer. |
SourceInfixExpression |
createInstanceof(SourceExpression lhs,
SourceTypeReference type)
Creates a new instanceof expression. |
SourceInterfacesClause |
createInterfacesClause(SourceTypeReference one)
Creates an interfaces ("implements" on a class and "extends" on an interface) clause. |
abstract SourceInterfacesClause |
createInterfacesClause(SourceTypeReference[] types)
Creates an interfaces ("implements" on a class and "extends" on an interface) clause. |
SourceLocalVariable |
createLocalVariable(int modifiers,
SourceTypeReference type,
java.lang.String name)
Creates a local variable. |
abstract SourceLocalVariable |
createLocalVariable(int modifiers,
SourceTypeReference type,
java.lang.String name,
int xdimensions,
SourceExpression initializer)
Creates a local variable. |
SourceLocalVariable |
createLocalVariable(int modifiers,
SourceTypeReference type,
java.lang.String name,
SourceExpression initializer)
Creates a local variable. |
SourceLocalVariable |
createLocalVariable(SourceTypeReference type,
java.lang.String name)
Creates a local variable. |
SourceLocalVariable |
createLocalVariable(SourceTypeReference type,
java.lang.String name,
SourceExpression initializer)
Creates a local variable |
SourceLocalVariableDeclaration |
createLocalVariableDeclaration(int modifiers,
SourceTypeReference type,
java.lang.String name)
Creates a local variable declaration. |
SourceLocalVariableDeclaration |
createLocalVariableDeclaration(int modifiers,
SourceTypeReference type,
java.lang.String name,
SourceExpression initializer)
Creates a local variable declaration. |
abstract SourceLocalVariableDeclaration |
createLocalVariableDeclaration(SourceLocalVariable variable)
Creates a local variable declaration. |
SourceLocalVariableDeclaration |
createLocalVariableDeclaration(SourceLocalVariable[] variables)
Deprecated. Not implemented yet. Creates a local variable declaration. |
SourceLocalVariableDeclaration |
createLocalVariableDeclaration(SourceTypeReference type,
java.lang.String name)
Creates a local variable declaration. |
SourceLocalVariableDeclaration |
createLocalVariableDeclaration(SourceTypeReference type,
java.lang.String name,
SourceExpression initializer)
Creates a local variable declaration. |
SourceMember |
createMember(java.lang.String text)
See createMemberFromText(java.lang.String) . |
abstract SourceMember |
createMemberFromText(java.lang.String text)
Attempts to create a member with the given text. |
abstract SourceMethod |
createMethod(SourceTypeParameter[] tyParameters,
SourceTypeReference returnType,
java.lang.String methodName,
SourceFormalParameterList parameters,
SourceThrowsClause throwsClause,
SourceBlock block)
Creates a method declaration. |
SourceMethod |
createMethod(SourceTypeReference returnType,
java.lang.String methodName,
SourceFormalParameterList parameters,
SourceThrowsClause throwsClause,
SourceBlock block)
Creates a non-generic method declaration. |
abstract SourceMethodCallExpression |
createMethodCall(SourceExpression lhs,
SourceTypeArgument[] typeArguments,
java.lang.String name,
SourceListExpression arguments)
Creates a method call. |
SourceMethodCallExpression |
createMethodCall(SourceExpression lhs,
java.lang.String name,
SourceListExpression arguments)
Creates a method call. |
abstract SourceName |
createName(java.lang.String name)
Creates a name. |
protected abstract SourceNewArrayExpression |
createNewArrayExpressionImpl(SourceTypeReference type,
SourceListExpression list)
(Internal) Creates an array creator. |
abstract SourceNewClassExpression |
createNewClassExpression(SourceExpression lhs,
SourceTypeReference type,
SourceListExpression arguments,
SourceClassBody body)
Creates a class creator. |
SourceNewArrayExpression |
createNewInitializedArrayExpression(SourceTypeReference type,
SourceListExpression arrayconst)
Creates an array creator. |
SourceNewArrayExpression |
createNewUninitializedArrayExpression(SourceTypeReference type,
SourceListExpression args)
Creates an array creator. |
abstract SourcePackage |
createPackageDeclaration(java.lang.String name)
|
abstract SourceQuestionExpression |
createQuestionExpression(SourceExpression one,
SourceExpression two,
SourceExpression three)
Creates a question expression. |
abstract SourceReturnStatement |
createReturnStatement(SourceExpression e)
Creates a return statement. |
protected abstract SourceName |
createSimpleName(java.lang.String name)
Creates a name. |
abstract SourceSimpleNameExpression |
createSimpleNameExpression(java.lang.String name)
Creates a simple name expression. |
abstract SourceElement |
createSourceElement(int kind)
May NOT be used to instantiate SourceExpression's. |
SourceStatement |
createStatement(java.lang.String text)
See createStatementFromText(java.lang.String) . |
abstract SourceStatement |
createStatementFromText(java.lang.String text)
Attempts to create a statement with the given text. |
abstract SourceStatementLabel |
createStatementLabel(java.lang.String name)
|
SourceClassInitializer |
createStaticInitializer(SourceBlock block)
Creates a static class initializer. |
abstract SourceSuperclassClause |
createSuperclassClause(SourceTypeReference superclass)
Creates a superclass ("extends" on a class) clause. |
abstract SourceSwitchLabel |
createSwitchCaseLabel(SourceExpression e)
|
abstract SourceSwitchLabel |
createSwitchDefaultLabel()
|
abstract SourceSwitchStatement |
createSwitchStatement(SourceExpression e,
SourceBlockStatement child)
Creates a switch statement. |
abstract SourceSynchStatement |
createSynchronizedStatement(SourceExpression e,
SourceBlockStatement child)
Creates a synchronized statement. |
SourceThrowsClause |
createThrowsClause(SourceTypeReference exception)
|
abstract SourceThrowsClause |
createThrowsClause(SourceTypeReference[] exceptions)
|
abstract SourceThrowStatement |
createThrowStatement(SourceExpression e)
Creates a throw statement. |
abstract SourceTryStatement |
createTryCatchFinallyStatement(SourceBlockStatement tryClause,
SourceFormalParameterList parameters,
SourceBlockStatement catchClause,
SourceBlockStatement finallyClause)
Creates a try-catch-finally statement with a single catch clause. |
SourceTryStatement |
createTryCatchFinallyStatement(SourceBlockStatement tryClause,
SourceFormalParameter parameter,
SourceBlockStatement catchClause,
SourceBlockStatement finallyClause)
Creates a try-catch-finally statement with a single catch clause. |
SourceTryStatement |
createTryCatchFinallyStatement(SourceBlockStatement tryClause,
SourceLocalVariable parameter,
SourceBlockStatement catchClause,
SourceBlockStatement finallyClause)
Creates a try-catch-finally statement with a single catch clause. |
abstract SourceTryStatement |
createTryCatchStatement(SourceBlockStatement tryClause,
SourceFormalParameterList parameters,
SourceBlockStatement catchClause)
Creates a try-catch statement with a single catch clause. |
SourceTryStatement |
createTryCatchStatement(SourceBlockStatement tryClause,
SourceFormalParameter parameter,
SourceBlockStatement catchClause)
Creates a try-catch statement with a single catch clause. |
SourceTryStatement |
createTryCatchStatement(SourceBlockStatement tryClause,
SourceLocalVariable parameter,
SourceBlockStatement catchClause)
Creates a try-catch statement with a single catch clause. |
abstract SourceTryStatement |
createTryFinallyStatement(SourceBlockStatement child,
SourceBlockStatement finallyClause)
Creates a try-finally statement. |
abstract SourceTryStatement |
createTryStatement(SourceBlockStatement tryClause,
SourceCatchClause[] catchClauses,
SourceFinallyClause finallyClause)
Creates a try, try-catch, try-catch-finally, or a try-finally statement. |
SourceTypeReference |
createType(byte primitive)
Creates a primitive type reference. |
SourceTypeReference |
createType(java.lang.String name)
Creates a type reference. |
SourceTypeReference |
createType(java.lang.String name,
int dimensions)
Creates a type reference. |
abstract SourceTypeArgument |
createTypeArgument(int bound,
SourceTypeReference type)
Creates a type argument. |
abstract SourceTypecastExpression |
createTypecast(SourceTypeReference type,
SourceExpression operand)
Creates a typecast. |
abstract SourceTypeExpression |
createTypeExpression(SourceTypeReference type)
Creates a type expression. |
SourceTypeExpression |
createTypeExpression(java.lang.String type)
Creates a type expression. |
abstract SourceTypeReference |
createTypeFromText(java.lang.String text)
Attempts to create a type with the given text. |
protected abstract SourceTypeReference |
createTypeImpl(java.lang.String name,
int dimensions)
|
SourceTypeParameter |
createTypeParameter(java.lang.String name)
Creates a type parameter. |
SourceTypeParameter |
createTypeParameter(java.lang.String name,
SourceTypeReference type)
Convenience method. |
abstract SourceTypeParameter |
createTypeParameter(java.lang.String name,
SourceTypeReference[] bounds)
Creates a type parameter. |
abstract SourceUnaryExpression |
createUnaryExpression(int code,
SourceExpression operand)
Creates a unary expression. |
abstract SourceWhileStatement |
createWhileStatement(SourceExpression e,
SourceStatement child)
Creates a while statement. |
abstract SourceWrapperExpression |
createWrapperExpression(SourceExpression operand)
Creates a wrapper expression. |
abstract SourceFile |
getSourceFile()
Gets the source file to which this source factory is attached. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SourceFactory()
Method Detail |
---|
public static SourceFile createFile(int j2se)
j2se
- The j2se language value to use with this SourceFile.
Valid values are JavaTokens.J2SE_*.
public abstract SourceFile getSourceFile()
public abstract SourceElement createSourceElement(int kind)
kind
- Valid values are JavaConstants.SRC_* except for
SRC_EXPR_*.public abstract SourceExpression createExpression(int code)
code
- Valid values are JavaOperators.OPT_*.public abstract SourceName createName(java.lang.String name)
name
- Must be a valid qualified name.
java.lang.IllegalArgumentException
- if name is not a valid qualified name.protected abstract SourceName createSimpleName(java.lang.String name)
name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceTypeReference createType(byte primitive)
primitive
- Valid values are JavaConstants.PRIMITIVE_*.public final SourceTypeReference createType(java.lang.String name)
name
- Must be a valid qualified name.
java.lang.IllegalArgumentException
- if name is not a valid qualified name.public final SourceTypeReference createType(java.lang.String name, int dimensions)
name
- Must be a valid qualified name.dimensions
- Require non-negative.
java.lang.IllegalArgumentException
- if name is not a valid qualified name.protected abstract SourceTypeReference createTypeImpl(java.lang.String name, int dimensions)
public abstract SourceTypeArgument createTypeArgument(int bound, SourceTypeReference type)
bound
- Assuming the type is named "T", here is what you get
for the indicated value of bound.
bound | result |
BOUND_NARROW | T |
BOUND_EXTENDS | ? extends T |
BOUND_SUPER | ? super T |
BOUND_NONE | ? |
type
- Ignored if bound == BOUND_NONE.public abstract SourceLexicalComment createComment(java.lang.String text)
text
- A newline will be automatically appended to whatever you
pass in. Must be a comment, that is, it must be prefixed
by one of: "/*", "//".public abstract SourceLexicalBlankline createBlankline()
public final SourceBlock createBlock(java.lang.String text)
createBlockFromText(java.lang.String)
.
public final SourceClass createClass(java.lang.String text)
createClassFromText(java.lang.String)
.
public final SourceDocComment createDocComment(java.lang.String text)
createDocCommentFromText(java.lang.String)
.
public final SourceExpression createExpression(java.lang.String text)
createExpressionFromText(java.lang.String)
.
public final SourceMember createMember(java.lang.String text)
createMemberFromText(java.lang.String)
.
public final SourceStatement createStatement(java.lang.String text)
createStatementFromText(java.lang.String)
.
public abstract SourceAnnotation createAnnotationFromText(java.lang.String text)
Must
- include the beginning '@' character.public abstract SourceBlock createBlockFromText(java.lang.String text)
text
- Must include the start and end braces.public abstract SourceBlockElement createBlockElementFromText(java.lang.String text)
text
- May be a statement, local variable declaration, or a
class declaration. May NOT be a comment.public abstract SourceClass createClassFromText(java.lang.String text)
public abstract SourceDocBlockTag createDocBlockTagFromText(java.lang.String text)
text
- Must start with '@'. A trailing newline is not required.public abstract SourceDocComment createDocCommentFromText(java.lang.String text)
text
- Must include start with the "/**" comment beginning
and end with the comment ending.public abstract SourceDocInlineTag createDocInlineTagFromText(java.lang.String text)
text
- Must start with '{' and must end with '}'.public abstract SourceExpression createExpressionFromText(java.lang.String text)
public abstract SourceMember createMemberFromText(java.lang.String text)
public abstract SourceStatement createStatementFromText(java.lang.String text)
text
- Must be a statement of some sort. Cannot be a local
variable declaration or a class declaration. Don't
forget the trailing semicolon, if applicable.public abstract SourceTypeReference createTypeFromText(java.lang.String text)
public abstract SourceDocReference createDocMemberReferenceFromText(java.lang.String text)
public final SourceAnnotation createAnnotation(java.lang.String name)
name
- Must be a valid qualified name.
java.lang.IllegalArgumentException
- if name is not a valid qualified name.public abstract SourceAnnotation createAnnotation(java.lang.String name, SourceListExpression arguments)
name
- Must be a valid qualified name.arguments
- Null indicates no argument list.
java.lang.IllegalArgumentException
- if name is not a valid qualified name.public final SourceTypeParameter createTypeParameter(java.lang.String name)
name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceTypeParameter createTypeParameter(java.lang.String name, SourceTypeReference type)
name
- Must be a valid simple name.type
- Require non-null.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public abstract SourceTypeParameter createTypeParameter(java.lang.String name, SourceTypeReference[] bounds)
name
- Must be a valid simple name.bounds
- Null means no bounds.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public abstract SourcePackage createPackageDeclaration(java.lang.String name)
name
- Must be a valid qualified name.
java.lang.IllegalArgumentException
- if name is not a valid qualified name.public final SourceImport createImportDeclaration(java.lang.String name)
name
- Must be a valid import string.
java.lang.IllegalArgumentException
- if name is not a valid import string.public abstract SourceImport createImportDeclaration(int modifiers, java.lang.String name)
modifiers
- Valid values are ACC_none or ACC_STATIC.name
- Must be a valid import string.
java.lang.IllegalArgumentException
- if name is not a valid import string.public final SourceClass createClass(int tyKind, java.lang.String name)
tyKind
- Valid values are JavaConstants.TY_*.name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceClass createClass(int tyKind, java.lang.String name, SourceSuperclassClause superclassClause, SourceInterfacesClause interfacesClause, SourceClassBody body)
tyKind
- Valid values are JavaConstants.TY_*.name
- Must be a valid simple name.superclassClause
- Null means an empty superclass clause.interfacesClause
- Null means an interfaces empty clause.body
- Null indicates an empty body.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public abstract SourceClass createClass(int tyKind, java.lang.String name, SourceTypeParameter[] tyParameters, SourceSuperclassClause superclassClause, SourceInterfacesClause interfacesClause, SourceClassBody body)
tyKind
- Valid values are JavaConstants.TY_*.name
- Must be a valid simple name.tyParameters
- Null means no type parameters.superclassClause
- Null means an empty superclass clause.interfacesClause
- Null means an interfaces empty clause.body
- Null indicates an empty body.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceMethod createConstructor(SourceFormalParameterList parameters, SourceThrowsClause throwsClause, SourceBlock block)
parameters
- Null indicates an empty parameter list.throwsClause
- Null indicates no throws clause.block
- Null indicates no an empty block.public abstract SourceMethod createConstructor(SourceTypeParameter[] typeParameters, SourceFormalParameterList parameters, SourceThrowsClause throwsClause, SourceBlock block)
parameters
- Null indicates an empty parameter list.throwsClause
- Null indicates no throws clause.block
- Null indicates no an empty block.public final SourceMethod createMethod(SourceTypeReference returnType, java.lang.String methodName, SourceFormalParameterList parameters, SourceThrowsClause throwsClause, SourceBlock block)
returnType
- Null indicates a void return type.methodName
- Must be a valid simple name.parameters
- Null indicates an empty parameter list.throwsClause
- Null indicates no throws clause.block
- Null indicates no block.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public abstract SourceMethod createMethod(SourceTypeParameter[] tyParameters, SourceTypeReference returnType, java.lang.String methodName, SourceFormalParameterList parameters, SourceThrowsClause throwsClause, SourceBlock block)
tyParameters
- Require non-null. For none, use
SourceTypeParameter.EMPTY_ARRAY.returnType
- Null indicates a void return type.methodName
- Must be a valid simple name.parameters
- Null indicates an empty parameter list.throwsClause
- Null indicates no throws clause.block
- Null indicates no block.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public abstract SourceEnumConstant createEnumConstant(java.lang.String name, SourceListExpression arguments, SourceClassBody body)
name
- Must be a valid simple name.arguments
- Null indicates none.body
- Null indicates none.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceClassInitializer createInstanceInitializer(SourceBlock block)
block
- Null indicates an empty block.public final SourceClassInitializer createStaticInitializer(SourceBlock block)
block
- Null indicates an empty block.public abstract SourceClassInitializer createClassInitializer(int modifiers, SourceBlock block)
block
- Null indicates an empty block.modifiers
- Valid values are ACC_none and ACC_STATIC.public abstract SourceFieldVariable createFieldVariable(SourceLocalVariable variable)
variable
- Require non-null.public final SourceFieldDeclaration createFieldDeclaration(SourceLocalVariable variable)
variable
- Require non-null.public abstract SourceFieldDeclaration createFieldDeclaration(SourceFieldVariable variable)
variable
- Require non-null.@Deprecated public final SourceFieldDeclaration createFieldDeclaration(SourceFieldVariable[] variables)
public abstract SourceFieldDeclaration createFieldDeclaration(SourceLocalVariableDeclaration locals)
locals
- Require non-null.public abstract SourceSuperclassClause createSuperclassClause(SourceTypeReference superclass)
superclass
- Null means an empty superclass clause.
public final SourceInterfacesClause createInterfacesClause(SourceTypeReference one)
one
- Null indicates an empty interfaces clause.
public abstract SourceInterfacesClause createInterfacesClause(SourceTypeReference[] types)
interfaces
- Null indicates an empty interfaces clause.
public final SourceClassBody createClassBody()
public final SourceClassBody createClassBody(SourceMember member)
public abstract SourceClassBody createClassBody(SourceMember[] members)
members
- Require non-null. For an empty class body, use
SourceMember.EMPTY_ARRAY.public abstract SourceFormalParameter createFormalParameter(SourceLocalVariable variable)
variable
- A newly created local variable from this factory.public final SourceFormalParameterList createFormalParameterList()
public final SourceFormalParameterList createFormalParameterList(SourceLocalVariable variable)
parameter
- Require non-null.public final SourceFormalParameterList createFormalParameterList(SourceLocalVariable[] variables)
parameters
- Require non-null. For an empty parameter list, use
SourceLocalVariable.EMPTY_ARRAY.public final SourceFormalParameterList createFormalParameterList(SourceFormalParameter parameter)
parameter
- Require non-null.public abstract SourceFormalParameterList createFormalParameterList(SourceFormalParameter[] parameters)
parameters
- Require non-null. For an empty parameter list, use
SourceLocalVariable.EMPTY_ARRAY.public final SourceThrowsClause createThrowsClause(SourceTypeReference exception)
exception
- Require non-null.public abstract SourceThrowsClause createThrowsClause(SourceTypeReference[] exceptions)
exceptions
- Require non-null. For an empty exception array
use SourceTypeReference.EMPTY_ARRAY.
public final SourceFieldVariable createFieldVariable(SourceTypeReference type, java.lang.String name)
type
- Require non-null.name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceFieldVariable createFieldVariable(int modifiers, SourceTypeReference type, java.lang.String name)
type
- Require non-null.name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceFieldVariable createFieldVariable(SourceTypeReference type, java.lang.String name, SourceExpression initializer)
type
- Require non-null.name
- Must be a valid simple name.initializer
- Null indicates none.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceFieldVariable createFieldVariable(int modifiers, SourceTypeReference type, java.lang.String name, SourceExpression initializer)
type
- Require non-null.name
- Must be a valid simple name.initializer
- Null indicates none.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceFieldVariable createFieldVariable(int modifiers, SourceTypeReference type, java.lang.String name, int xdimensions, SourceExpression initializer)
type
- Require non-null.name
- Must be a valid simple name.xdimensions
- The number of extra array dimensions to modify
the field variable with.initializer
- Null indicates none.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceFieldDeclaration createFieldDeclaration(SourceTypeReference type, java.lang.String name)
createFieldVariable( SourceTypeReference, String )
public final SourceFieldDeclaration createFieldDeclaration(int modifiers, SourceTypeReference type, java.lang.String name)
createFieldVariable( int, SourceTypeReference, String )
public final SourceFieldDeclaration createFieldDeclaration(SourceTypeReference type, java.lang.String name, SourceExpression initializer)
createFieldVariable( SourceTypeReference,
String, SourceExpression )
public final SourceFieldDeclaration createFieldDeclaration(int modifiers, SourceTypeReference type, java.lang.String name, SourceExpression initializer)
createFieldVariable( int, SourceTypeReference,
String, SourceExpression )
public final SourceLocalVariable createLocalVariable(SourceTypeReference type, java.lang.String name)
type
- Require non-null.name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceLocalVariable createLocalVariable(int modifiers, SourceTypeReference type, java.lang.String name)
modifiers
- Valid values are ACC_none and ACC_FINAL.type
- Require non-null.name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceLocalVariable createLocalVariable(SourceTypeReference type, java.lang.String name, SourceExpression initializer)
type
- Require non-null.name
- Must be a valid simple name.initializer
- Null indicates none.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceLocalVariable createLocalVariable(int modifiers, SourceTypeReference type, java.lang.String name, SourceExpression initializer)
modifiers
- Valid values are ACC_none and ACC_FINAL.type
- Require non-null.name
- Must be a valid simple name.initializer
- Null indicates none.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public abstract SourceLocalVariable createLocalVariable(int modifiers, SourceTypeReference type, java.lang.String name, int xdimensions, SourceExpression initializer)
modifiers
- Valid values are ACC_none and ACC_FINAL.type
- Require non-null.name
- Must be a valid simple name.xdimensions
- The number of extra array dimensions to modify
the local variable with.initializer
- Null indicates none.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceLocalVariableDeclaration createLocalVariableDeclaration(SourceTypeReference type, java.lang.String name)
createLocalVariable( SourceTypeReference, String )
public final SourceLocalVariableDeclaration createLocalVariableDeclaration(int modifiers, SourceTypeReference type, java.lang.String name)
createLocalVariable( int, SourceTypeReference, String )
public final SourceLocalVariableDeclaration createLocalVariableDeclaration(SourceTypeReference type, java.lang.String name, SourceExpression initializer)
createLocalVariable( SourceTypeReference,
String, SourceExpression )
public final SourceLocalVariableDeclaration createLocalVariableDeclaration(int modifiers, SourceTypeReference type, java.lang.String name, SourceExpression initializer)
createLocalVariable( int, SourceTypeReference,
String, SourceExpression )
public abstract SourceLocalVariableDeclaration createLocalVariableDeclaration(SourceLocalVariable variable)
variable
- Require non-null.@Deprecated public final SourceLocalVariableDeclaration createLocalVariableDeclaration(SourceLocalVariable[] variables)
public final SourceBlock createBlock()
public abstract SourceBlock createBlock(SourceElement[] elements)
elements
- The elements for the code block.public abstract SourceAssertStatement createAssertStatement(SourceExpression condition, SourceExpression output)
condition
- Require non-null.output
- Require non-null.public abstract SourceBlockStatement createBlockStatement(SourceBlock block)
block
- Null indicates an empty block.public abstract SourceBreakStatement createBreakStatement(java.lang.String target)
target
- Null indicates the implicitly enclosing loop.public final SourceCatchClause createCatchClause(SourceLocalVariable parameter, SourceBlockStatement child)
parameter
- Require non-null.child
- Null indicates an empty clause.public abstract SourceCatchClause createCatchClause(SourceFormalParameterList parameters, SourceBlockStatement child)
parameters
- Require non-null. Must have exactly one parameter.child
- Null indicates an empty clause.public abstract SourceContinueStatement createContinueStatement(java.lang.String target)
target
- Null indicates the implicitly enclosing loop.public abstract SourceDoStatement createDoStatement(SourceExpression e, SourceStatement child)
e
- Require non-nullchild
- Null indicates an empty clause.public abstract SourceElseClause createElseClause(SourceStatement child)
child
- Null indicates an empty clause.public abstract SourceEmptyStatement createEmptyStatement()
public abstract SourceExpressionStatement createExpressionStatement(SourceExpression e)
e
- Require non-null.public abstract SourceFinallyClause createFinallyClause(SourceBlockStatement child)
child
- Null indicates an empty clause.public final SourceForStatement createForStatement(SourceExpression initialization, SourceExpression condition, SourceExpression update, SourceStatement child)
initialization
- Null means no initializations.condition
- Null means an implicitly true condition.update
- Null means no updates.child
- Null indicates an empty clause.public abstract SourceForStatement createForStatement(SourceListExpression initializations, SourceExpression condition, SourceListExpression updates, SourceStatement child)
initializations
- Null means no initializations.condition
- Null means an implicitly true condition.updates
- Null means no updates.child
- Null indicates an empty clause.public final SourceForStatement createForVariableStatement(SourceLocalVariable variable, SourceExpression condition, SourceExpression update, SourceStatement child)
variable
- Require non-null.condition
- Null means an implicitly true condition.update
- Null means no update.child
- Null indicates an empty clause.public abstract SourceForStatement createForVariableStatement(SourceLocalVariableDeclaration variables, SourceExpression condition, SourceListExpression updates, SourceStatement child)
variables
- Require non-null.condition
- Null means an implicitly true condition.updates
- Null means no updates.Null
- indicates an empty clause.public final SourceForStatement createForEnhancedStatement(SourceLocalVariable loopVariable, SourceExpression collection, SourceStatement child)
loopVariable
- Require non-null.collection
- Require non-null.child
- Null indicates an empty clause.public abstract SourceForStatement createForEnhancedStatement(SourceLocalVariableDeclaration loopVarDecl, SourceExpression collection, SourceStatement child)
loopVariable
- Require non-null.collection
- Require non-null.child
- Null indicates an empty clause.public abstract SourceIfStatement createIfStatement(SourceExpression e, SourceStatement child)
e
- Require non-null.child
- Null indicates an empty clause.public abstract SourceIfStatement createIfStatement(SourceExpression e, SourceStatement child, SourceElseClause clause)
e
- Require non-nullchild
- Null indicates an empty true clause.clause
- Null means no else clause.public final SourceIfStatement createIfElseStatement(SourceExpression e, SourceStatement trueClause, SourceStatement elseClause)
e
- Require non-null.trueClause
- Null indicates an empty true clause.elseClause
- Null indicates an empty else clause.public abstract SourceReturnStatement createReturnStatement(SourceExpression e)
e
- Null indicates a void return.public abstract SourceSwitchStatement createSwitchStatement(SourceExpression e, SourceBlockStatement child)
e
- Require non-null.child
- Null indicates an empty block.public abstract SourceSynchStatement createSynchronizedStatement(SourceExpression e, SourceBlockStatement child)
e
- Require non-null.child
- Null indicates an empty block.public abstract SourceThrowStatement createThrowStatement(SourceExpression e)
e
- Require non-null.public abstract SourceTryStatement createTryStatement(SourceBlockStatement tryClause, SourceCatchClause[] catchClauses, SourceFinallyClause finallyClause)
tryClause
- Null indicates an empty try clause.catchClauses
- Require non-null. If you want no catch clauses,
use SourceCatchClause.EMPTY_ARRAY.finallyClause
- Null indicates no finally clause.public final SourceTryStatement createTryCatchStatement(SourceBlockStatement tryClause, SourceLocalVariable parameter, SourceBlockStatement catchClause)
tryClause
- Null indicates an empty try clause.parameter
- Require non-null.catchClause
- Null indicates an empty catch clause.public final SourceTryStatement createTryCatchStatement(SourceBlockStatement tryClause, SourceFormalParameter parameter, SourceBlockStatement catchClause)
tryClause
- Null indicates an empty try clause.parameter
- Require non-null.catchClause
- Null indicates an empty catch clause.public abstract SourceTryStatement createTryCatchStatement(SourceBlockStatement tryClause, SourceFormalParameterList parameters, SourceBlockStatement catchClause)
tryClause
- Null indicates an empty try clause.parameter
- Require non-null.catchClause
- Null indicates an empty catch clause.public final SourceTryStatement createTryCatchFinallyStatement(SourceBlockStatement tryClause, SourceLocalVariable parameter, SourceBlockStatement catchClause, SourceBlockStatement finallyClause)
tryClause
- Null indicates an empty try clause.parameter
- Require non-null.catchClause
- Null indicates an empty catch clause.finallyClause
- Null indicates an empty finally clause.public final SourceTryStatement createTryCatchFinallyStatement(SourceBlockStatement tryClause, SourceFormalParameter parameter, SourceBlockStatement catchClause, SourceBlockStatement finallyClause)
tryClause
- Null indicates an empty try clause.parameter
- Require non-null.catchClause
- Null indicates an empty catch clause.finallyClause
- Null indicates an empty finally clause.public abstract SourceTryStatement createTryCatchFinallyStatement(SourceBlockStatement tryClause, SourceFormalParameterList parameters, SourceBlockStatement catchClause, SourceBlockStatement finallyClause)
tryClause
- Null indicates an empty try clause.parameter
- Require non-null.catchClause
- Null indicates an empty catch clause.finallyClause
- Null indicates an empty finally clause.public abstract SourceTryStatement createTryFinallyStatement(SourceBlockStatement child, SourceBlockStatement finallyClause)
child
- Null indicates an empty try clause.finallyClause
- Null indicates an empty finally clause.public abstract SourceWhileStatement createWhileStatement(SourceExpression e, SourceStatement child)
e
- Require non-null.child
- Null indicates an empty clause.public abstract SourceStatementLabel createStatementLabel(java.lang.String name)
public abstract SourceSwitchLabel createSwitchCaseLabel(SourceExpression e)
public abstract SourceSwitchLabel createSwitchDefaultLabel()
public abstract SourceAnnotationExpression createAnnotationExpression(SourceAnnotation a)
arg
- Require non-null.public final SourceListExpression createArgumentList()
arg
- Require non-null.public final SourceListExpression createArgumentList(SourceExpression arg)
arg
- Require non-null.public final SourceListExpression createArgumentList(SourceExpression[] arguments)
arguments
- Null indicates an empty list.public abstract SourceArrayAccessExpression createArrayAccess(SourceExpression lhs, SourceListExpression dereferences)
lhs
- Require non-null.dereferences
- Requires non-null. Use createArgumentList([).public abstract SourceListExpression createArrayConstant(SourceExpression[] operands)
operands
- The operands which cannot be null, and none of the
SourceExpressions in the array can be null
java.lang.NullPointerException
- if operands is null or any of the
SourceExpressions in the operands array are nullpublic abstract SourceAssignmentExpression createAssignment(int code, SourceExpression lhs, SourceExpression rhs)
code
- The simple assignment is JavaOperators.OPT_ASG
.
For a complete list of valid values, check the
JavaConstants.opt2srcTable array for SRC_EXPR_ASSIGNMENT.@Deprecated public final SourceNewClassExpression createClassCreator(SourceExpression lhs, SourceTypeReference type, SourceListExpression arguments, SourceClassBody body)
public abstract SourceDotExpression createDotReference(SourceExpression lhs, java.lang.String name)
lhs
- Require non-null.name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceListExpression createExpressionList()
public final SourceListExpression createExpressionList(SourceExpression argument)
argument
- Null indicates an empty list.public abstract SourceListExpression createExpressionList(SourceExpression[] arguments)
arguments
- Null indicates an empty list.public abstract SourceInfixExpression createInfixExpression(int code, SourceExpression lhs, SourceExpression rhs)
code
- For valid values, check the
JavaConstants.opt2srcTable array for SRC_EXPR_INFIX.public abstract SourceInfixExpression createInfixExpression(int code, SourceExpression[] operands)
code
- For valid values, check the
JavaConstants.opt2srcTable array for SRC_EXPR_INFIX.operands
- Must have at least two operands.public final SourceInfixExpression createInstanceof(SourceExpression lhs, SourceTypeReference type)
lhs
- Require non-null.type
- Require a reference type.public final SourceMethodCallExpression createMethodCall(SourceExpression lhs, java.lang.String name, SourceListExpression arguments)
lhs
- Null indicates the implicit "this" lhs.name
- Must be a valid simple name.arguments
- Null indicates no arguments. Use createArgumentList([).
java.lang.IllegalArgumentException
- if name is not a valid simple name.public abstract SourceMethodCallExpression createMethodCall(SourceExpression lhs, SourceTypeArgument[] typeArguments, java.lang.String name, SourceListExpression arguments)
lhs
- Null indicates the implicit "this" lhs.name
- Must be a valid simple name.arguments
- Null indicates no arguments. Use createArgumentList([).
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceNewArrayExpression createNewInitializedArrayExpression(SourceTypeReference type, SourceListExpression arrayconst)
type
- Require non-null.arrayconst
- Must be an array constant (e.g. created via
the createArrayConstant() method).public final SourceNewArrayExpression createNewUninitializedArrayExpression(SourceTypeReference type, SourceListExpression args)
type
- Require non-null.protected abstract SourceNewArrayExpression createNewArrayExpressionImpl(SourceTypeReference type, SourceListExpression list)
public abstract SourceNewClassExpression createNewClassExpression(SourceExpression lhs, SourceTypeReference type, SourceListExpression arguments, SourceClassBody body)
lhs
- Non-null indicates a qualified class creator (for
creating non-static inner classes).type
- Require non-null. Require non-array reference type.arguments
- Null indicates no arguments. Use createArgumentList([).body
- Non-null indicates an anonymous class.public abstract SourceQuestionExpression createQuestionExpression(SourceExpression one, SourceExpression two, SourceExpression three)
one
- The conditional operand. Require non-null.two
- The operand executed by the true branch. Require non-null.three
- The operand executed by the false branch. Require non-null.public abstract SourceSimpleNameExpression createSimpleNameExpression(java.lang.String name)
name
- Must be a valid simple name.
java.lang.IllegalArgumentException
- if name is not a valid simple name.public final SourceTypeExpression createTypeExpression(java.lang.String type)
type
- Require non-null.public abstract SourceTypeExpression createTypeExpression(SourceTypeReference type)
type
- Require non-null.public abstract SourceTypecastExpression createTypecast(SourceTypeReference type, SourceExpression operand)
type
- Require non-null. Require a reference type.operand
- Require non-null.public abstract SourceUnaryExpression createUnaryExpression(int code, SourceExpression operand)
code
- For valid values, check the
JavaConstants.opt2srcTable array for SRC_EXPR_UNARY.operand
- Require non-null.public abstract SourceWrapperExpression createWrapperExpression(SourceExpression operand)
operand
- Require non-null.public abstract SourceDocTextFragment createDocTextFragment(java.lang.String text)
If you want a full line of doc text, text should end with the '\n' character. Text may not contain more than one '\n' character. Newlines may optionally also be expressed as "\r" or "\r\n", both will be converted to being "\n". To get multiple lines of doc text, you must create multiple doc text fragments.
text
- Require non-null. Require non-empty.public final SourceDocTagName createDocTagName(short tag)
tag
- Require [TAG_base, TAG_max).public abstract SourceDocTagName createDocTagName(java.lang.String name)
name
- Require non-null. Require name.startsWith( "@" ).public final SourceDocComment createDocComment()
public final SourceDocComment createDocComment(SourceDocDescription description)
description
- May be null.public final SourceDocComment createDocComment(SourceDocDescription description, SourceDocBlockTag tag)
description
- May be null.tags
- Null indicates no block tags.public abstract SourceDocComment createDocComment(SourceDocDescription description, SourceDocBlockTag[] tags)
description
- May be null.tags
- Null indicates no block tags.public final SourceDocDescription createDocDescription()
public final SourceDocDescription createDocDescription(SourceDocTextFragment line)
line
- Require non-null. The line may optionally end with a newline.public abstract SourceDocDescription createDocDescription(SourceDocTextFragment[] lines)
lines
- If non-null, all but the last of the text lines
must end with a newline. The last one may optionally
end with a newline.public final SourceDocReference createDocClassReference(java.lang.String qualifiedName)
qualifiedName
- Require non-null. May be a simple or qualified
class name in dotted notation, e.g.
"String", "java.util.Map".public final SourceDocReference createDocMemberReference(java.lang.String classString, java.lang.String memberName)
classString
- May be null. Dotted notation.memberName
- The simple name identifying the member.public final SourceDocReference createDocMethodReference(java.lang.String classString, java.lang.String methodName, java.lang.String[] parameterTypes)
classString
- May be null. Dotted notation.methodName
- Require no-null. The simple method name.parameterTypes
- Require non-null. An array of names representing
the parameter types. Should be in dotted
notation, e.g. "String", "int[]".public abstract SourceDocReference createDocParameterReference(java.lang.String parameterName)
parameterName
- Require non-null.public abstract SourceDocReference createDocReference(java.lang.String classString, java.lang.String memberName, java.lang.String[] parameterTypes)
public final SourceDocBlockTag createDocBlockTag(SourceDocTagName name)
name
- Require non-null.public final SourceDocBlockTag createDocBlockTag(SourceDocTagName name, SourceDocDescription description)
name
- Require non-null.description
- May be null.public final SourceDocBlockTag createDocBlockTag(SourceDocTagName name, SourceDocReference reference, SourceDocDescription description)
name
- Require non-null.reference
- Require non-null.description
- May be null.public abstract SourceDocBlockTag createDocBlockTag(SourceDocTagName name, SourceDocReference[] references, SourceDocDescription description)
name
- Require non-null.references
- Require non-null.description
- May be null.public final SourceDocInlineTag createDocInlineTag(SourceDocTagName name)
name
- Require non-null.public final SourceDocInlineTag createDocInlineTag(SourceDocTagName name, SourceDocDescription description)
name
- Require non-null.description
- May be null.public final SourceDocInlineTag createDocInlineTag(SourceDocTagName name, SourceDocReference reference, SourceDocDescription description)
name
- Require non-null.reference
- Require non-null.description
- May be null.public abstract SourceDocInlineTag createDocInlineTag(SourceDocTagName name, SourceDocReference[] references, SourceDocDescription description)
name
- Require non-null.references
- Require non-null.description
- May be null.
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK 11g Release 2 (11.1.2.0.0) E17493-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |