public abstract class SourceFactory extends java.lang.Object implements JavaConstants, JavadocTokens
JavaPreferences.MemberOrder
ACC_ABSTRACT, ACC_ANNOTATION, ACC_BRIDGE, ACC_DEFAULT, ACC_ENUM, ACC_FINAL, ACC_INTERFACE, ACC_MODULE, ACC_NATIVE, ACC_none, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STRICTFP, ACC_SUPER, ACC_SYNCHRONIZED, ACC_SYNTHETIC, ACC_TRANSIENT, ACC_VARARGS, ACC_VOLATILE, ACCX_DEPRECATED, ACCX_HIDDEN, ARRAY_implements, BOUND_EXTENDS, BOUND_NARROW, BOUND_NONE, BOUND_SUPER, ELEM_ANNOTATION, ELEM_base, ELEM_CLASS, ELEM_COMPONENT, ELEM_EXPRESSION, ELEM_FIELD, ELEM_FILE, ELEM_IMPORT, ELEM_INTERSECTION_TYPE, ELEM_invalid, ELEM_LOCAL_VARIABLE, ELEM_max, ELEM_METHOD, ELEM_MODULE, ELEM_MODULE_EXPORTS, ELEM_MODULE_PROVIDES, ELEM_MODULE_REQUIRES, ELEM_MODULE_USES, ELEM_NOTHING, ELEM_PACKAGE, ELEM_SELF_VARIABLE, ELEM_STATEMENT_LABEL, ELEM_TMP_VARIABLE, ELEM_TYPE_VARIABLE, ELEM_WILDCARD_TYPE, ELEM_words, EMPTY_OBJECT_ARRAY, EMPTY_STRING_ARRAY, FOR_ENHANCED, FOR_EXPRESSION, FOR_VARIABLE_D, kEmptyCollection, opt2srcTable, PACKAGE_INFO, PRIMITIVE_autoboxes, PRIMITIVE_binary, PRIMITIVE_BOOLEAN, PRIMITIVE_BYTE, PRIMITIVE_CHAR, PRIMITIVE_descriptors, PRIMITIVE_DOUBLE, PRIMITIVE_FLOAT, PRIMITIVE_INT, PRIMITIVE_invalid, PRIMITIVE_LONG, PRIMITIVE_max, PRIMITIVE_min, PRIMITIVE_NULL, PRIMITIVE_SHORT, PRIMITIVE_tokens, PRIMITIVE_unary, PRIMITIVE_VOID, SRC_ANNOTATION, SRC_base, SRC_BLOCK, SRC_CATCH_PARAMETER, SRC_CLASS, SRC_CLASS_BODY, SRC_CLASS_INITIALIZER, SRC_CONSTRUCTOR_D, SRC_DOC_base, SRC_DOC_BLOCK_TAG, SRC_DOC_COMMENT, SRC_DOC_DESCRIPTION, SRC_DOC_INLINE_TAG, SRC_DOC_max, SRC_DOC_REFERENCE, SRC_DOC_TAG_NAME, SRC_DOC_TEXT, SRC_ENUM_CONSTANT_D, SRC_ERROR, SRC_EXPR_ANNOTATION, SRC_EXPR_ARRAY_ACCESS, SRC_EXPR_ASSIGNMENT, SRC_EXPR_base, SRC_EXPR_DOT, SRC_EXPR_ERROR, SRC_EXPR_INFIX, SRC_EXPR_INTERSECTION_TYPE, SRC_EXPR_LAMBDA, SRC_EXPR_LIST, SRC_EXPR_LITERAL, SRC_EXPR_max, SRC_EXPR_METHOD_CALL, SRC_EXPR_METHOD_REFERENCE, SRC_EXPR_NEW_ARRAY, SRC_EXPR_NEW_CLASS, SRC_EXPR_QUESTION, SRC_EXPR_SIMPLE_NAME, SRC_EXPR_TYPE, SRC_EXPR_TYPECAST, SRC_EXPR_UNARY, SRC_EXPR_WRAPPER, SRC_FIELD_D, SRC_FIELD_VARIABLE, SRC_FILE, SRC_FORMAL_PARAMETER, SRC_FORMAL_PARAMETER_LIST, SRC_IMPORT_D, SRC_INTERFACES_CLAUSE, SRC_invalid, SRC_LABEL, SRC_LAMBDA_PARAMETER, SRC_LEX_base, SRC_LEX_BLANKLINE, SRC_LEX_COMMENT, SRC_LEX_max, SRC_LEX_SQLJ, SRC_LOCAL_VARIABLE, SRC_LOCAL_VARIABLE_D, SRC_max, SRC_METHOD_D, SRC_MODULE, SRC_MODULE_BODY, SRC_MODULE_EXPORTS, SRC_MODULE_EXPORTS_TO, SRC_MODULE_PROVIDES, SRC_MODULE_PROVIDES_WITH, SRC_MODULE_REQUIRES, SRC_MODULE_USES, SRC_NAME, SRC_PACKAGE_D, SRC_STMT_ASSERT, SRC_STMT_base, SRC_STMT_BLOCK, SRC_STMT_BREAK, SRC_STMT_CATCH, SRC_STMT_CONTINUE, SRC_STMT_DO, SRC_STMT_ELSE, SRC_STMT_EMPTY, SRC_STMT_EXPRESSION, SRC_STMT_FINALLY, SRC_STMT_FOR, SRC_STMT_IF, SRC_STMT_max, SRC_STMT_RETURN, SRC_STMT_SWITCH, SRC_STMT_SYNCH, SRC_STMT_THROW, SRC_STMT_TRY, SRC_STMT_WHILE, SRC_SUPERCLASS_CLAUSE, SRC_SWITCH_LABEL, SRC_THROWS_CLAUSE, SRC_TRY_RESOURCES_LIST, SRC_TYPE_ARGUMENT, SRC_TYPE_ARGUMENT_LIST, SRC_TYPE_PARAMETER, SRC_TYPE_REF, SRC_words, TY_ANNOTATE, TY_CLASS, TY_ENUM, TY_INTERFACE, TY_invalid, TY_max, TY_MODULE, TY_words
ERROR_ABSTRACT_CLASS, ERROR_ABSTRACT_METHOD_CALL, ERROR_AMBIGUOUS_IMPORT, ERROR_AMBIGUOUS_REF, ERROR_ANNOTATION_ELEMENT_NAME_NOT_FOUND, ERROR_ANONYMOUS_CLASS_CONSTRUCTOR, ERROR_ASSERT_IDENTIFIER, ERROR_base, ERROR_BREAK_OUTSIDE_SWITCH_OR_LOOP, ERROR_CANCELLED, ERROR_CANNOT_ASSIGN_FINAL, ERROR_CANNOT_INSTANTIATE_ENUMS, ERROR_CANT_ASSIGN, ERROR_CANT_EXTEND_ENUM, ERROR_CANT_EXTEND_FINAL, ERROR_CANT_EXTEND_INTERFACE, ERROR_CANT_IMPLEMENT_CLASS, ERROR_CANT_TYPECAST, ERROR_CATEGORY_ALL, ERROR_CATEGORY_COMPILE, ERROR_CATEGORY_PARSE, ERROR_CATEGORY_SCAN, ERROR_CATEGORY_unclassified, ERROR_CHECK_EXCEPTION, ERROR_CLASS_CIRCULARITY, ERROR_COMPILE_base, ERROR_COMPILE_GENERIC, ERROR_COMPILE_max, ERROR_CONSTRUCTOR_NAME, ERROR_CONTINUE_OUTSIDE_OF_LOOP, ERROR_CYCLIC_ANNOTATION_TYPE_REFERENCE, ERROR_DUPLICATE, ERROR_EMPTY_CHAR_LITERAL, ERROR_EMPTY_EXPRESSION, ERROR_EXCEPTION_NEVER_THROWN, ERROR_EXPECTING_ONE, ERROR_EXPECTING_TWO, ERROR_EXPECTING_TYPE, ERROR_EXTENDS_NOT_ALLOWED, ERROR_EXTENDS_TOO_MANY, ERROR_FINAL_ALREADY_ASSIGNED, ERROR_FORWARD_REFERENCE, ERROR_GENERIC_COMPILER_ERROR, ERROR_GENERIC_TYPE, ERROR_ILLEGAL_ANNOTATION, ERROR_ILLEGAL_ARRAY_INITIALIZER, ERROR_ILLEGAL_DEFAULT, ERROR_ILLEGAL_DIAMOND, ERROR_ILLEGAL_LABEL, ERROR_ILLEGAL_METHOD_ARGUMENT_EXPRESSION, ERROR_ILLEGAL_METHOD_RETURN_TYPE_OVERRIDE, ERROR_ILLEGAL_METHOD_THROW_TYPE_OVERRIDE, ERROR_ILLEGAL_METHOD_VISIBILITY_OVERRIDE, ERROR_ILLEGAL_OVERRIDE_ANNOTATION, ERROR_ILLEGAL_START_OF_EXPR, ERROR_ILLEGAL_TYPE_PARAMETERS, ERROR_ILLEGAL_VARARGS, ERROR_IMPLEMENTS_NOT_ALLOWED, ERROR_IMPORT_NOT_FOUND, ERROR_INCOMPATIBLE_TYPES, ERROR_INCOMPATIBLE_WITH_FUNCTIONAL_INTERFACE_TARGET, ERROR_INTERNAL, ERROR_INVALID_ANNOTATION_MEMBER_TYPE, ERROR_INVALID_CHAR_LITERAL, ERROR_INVALID_ESCAPE_SEQUENCE, ERROR_INVALID_EXPR_STMT, ERROR_INVALID_NAME, ERROR_INVALID_OPERATION, ERROR_INVALID_STRING_LITERAL, ERROR_INVALID_SUPERTYPE, ERROR_keys, ERROR_LONE_CATCH, ERROR_LONE_ELSE, ERROR_LONE_FINALLY, ERROR_LONE_TRY, ERROR_max, ERROR_MEMBER_NOT_FOUND, ERROR_METHOD_NOT_FOUND, ERROR_MISSING_ANNOTATION_ARGUMENT, ERROR_MISSING_ANNOTATION_ELEMENT_NAME, ERROR_MISSING_CASE_OR_DEFAULT_LABEL, ERROR_MISSING_CONDITION, ERROR_MISSING_METHOD_BODY, ERROR_MISSING_RETURN, ERROR_MODIFIER_NOT_ALLOWED, ERROR_MODIFIER_REPEATED, ERROR_MULTIPLE_COMPONENTS, ERROR_NAME_NOT_FOUND, ERROR_none, ERROR_NOT_A_CONSTANT_EXPRESSION, ERROR_NOT_ACCESSIBLE, ERROR_NOT_ANNOTATION_TYPE, ERROR_NOT_ASSIGNABLE, ERROR_NOT_GENERIC_TYPE, ERROR_NOT_IMPLEMENTED_YET, ERROR_NOT_THROWABLE, ERROR_NUMBER_FORMAT, ERROR_NUMERIC_OVERFLOW, ERROR_NUMERIC_UNDERFLOW, ERROR_ONLY_STATIC_ACCESS, ERROR_PARSE_base, ERROR_PARSE_GENERIC, ERROR_PARSE_max, ERROR_REQUIRE_ARRAY, ERROR_REQUIRE_BLOCK, ERROR_REQUIRE_FINAL, ERROR_REQUIRE_FINAL_OR_EFFECTIVELY_FINAL, ERROR_REQUIRE_OBJECT, ERROR_REQUIRE_OUTER_CLASS, ERROR_REQUIRE_VARIABLE, ERROR_SCAN_base, ERROR_SCAN_GENERIC, ERROR_SCAN_max, ERROR_SUPER_NOT_FIRST, ERROR_TARGET_NOT_FUNCTIONAL_INTERFACE, ERROR_THIS_NOT_FIRST, ERROR_TYPE_ARGUMENT_MISMATCH, ERROR_TYPE_IS_NOT_AUTOCLOSEABLE, ERROR_TYPE_IS_NOT_DISJUNCTIVE, ERROR_TYPE_IS_NOT_ITERABLE, ERROR_TYPE_NOT_ALLOWED, ERROR_TYPE_NOT_FOUND, ERROR_UNEXPECTED, ERROR_UNKNOWN, ERROR_UNREACHABLE_STATEMENT, ERROR_VARIABLE_NOT_ASSIGNED, ERROR_VOID_RETURN, ERROR_warnings, ERROR_words, ERROR_WRONG_RECEIVER_TYPE, ERROR_WRONG_TARGET_META_ANNOTATION, NOTE_GENERIC_COMPILER_NOTE, SEVERITY_ERROR, SEVERITY_FATAL, SEVERITY_LINT, SEVERITY_NOTE, SEVERITY_WARNING, SEVERITY_ZERO, WARNING_AMBIGUOUS_DOC_REFERENCE, WARNING_ASSERT_IDENTIFIER, WARNING_DIAMOND_REDUNDANT_TYPE_ARGUMENTS, WARNING_DOC_REFERENCE_NOT_FOUND, WARNING_FINALLY_CANNOT_COMPLETE, WARNING_GENERIC_COMPILER_WARNING, WARNING_IMPORT_UNUSED, WARNING_INVALID_NAME, WARNING_METHOD_NAME, WARNING_POTENTIAL_LAMBDA, WARNING_SWITCH_CASE_FALL_THROUGH, WARNING_UNCHECKED_CONVERSION
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_ERROR, OPT_GE, OPT_GT, OPT_INSTANCEOF, OPT_INTERSECTION_TYPE, OPT_invalid, OPT_INVOKE, OPT_LAMBDA, OPT_LE, OPT_LIST, OPT_LITERAL, OPT_LSH, OPT_LSHASG, OPT_LT, OPT_max, OPT_METHOD_REFERENCE, 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
DW_values, DW_words, J2SE_13, J2SE_14, J2SE_15, J2SE_16, J2SE_17, J2SE_18, J2SE_MAX, J2SE_MIN, KW_ABSTRACT, KW_ASSERT, KW_base, KW_BOOLEAN, KW_BREAK, KW_BYTE, KW_CASE, KW_CATCH, KW_CHAR, KW_CLASS, KW_CONST, KW_CONTINUE, KW_DEFAULT, KW_DO, KW_DOUBLE, KW_ELSE, KW_ENUM, KW_EXTENDS, KW_FINAL, KW_FINALLY, KW_FLOAT, KW_FOR, KW_GOTO, KW_IF, KW_IMPLEMENTS, KW_IMPORT, KW_INSTANCEOF, KW_INT, KW_INTERFACE, KW_j2se13_max, KW_j2se14_max, KW_j2se15_max, KW_j2se16_max, KW_j2se17_max, KW_j2se18_max, KW_j2se19_max, KW_LONG, KW_max, KW_NATIVE, KW_NEW, KW_PACKAGE, KW_PRIVATE, KW_PROTECTED, KW_PUBLIC, KW_RETURN, KW_SHORT, KW_STATIC, KW_STRICTFP, KW_SUPER, KW_SWITCH, KW_SYNCHRONIZED, KW_THIS, KW_THROW, KW_THROWS, KW_TRANSIENT, KW_TRY, KW_VOID, KW_VOLATILE, KW_WHILE, KW_words, OP_AND_ASG, OP_ASG, OP_AT, OP_base, OP_BINAND, OP_binary, OP_BINNOT, OP_BINOR, OP_BINXOR, OP_COLON, OP_COLONCOLON, OP_COMMA, OP_DEC, OP_DIV, OP_DIV_ASG, OP_DOT, OP_ELLIPSIS, OP_EQ, OP_GE, OP_GT, OP_HASH, OP_INC, OP_LBRACE, OP_LBRACKET, OP_LE, OP_LOGAND, OP_LOGNOT, OP_LOGOR, OP_LPAREN, OP_LSH, OP_LSH_ASG, OP_LT, OP_max, OP_MINUS, OP_MINUS_ASG, OP_MOD, OP_MOD_ASG, OP_MUL, OP_MUL_ASG, OP_NE, OP_OR_ASG, OP_PLUS, OP_PLUS_ASG, OP_prefix, OP_QUES, OP_RBRACE, OP_RBRACKET, OP_RIGHT_ARROW, OP_RPAREN, OP_RSH, OP_RSH_ASG, OP_SEMI, OP_URSH, OP_URSH_ASG, OP_words, OP_XOR_ASG, TK_base, TK_BOOLEAN_LITERAL, TK_CHAR_LITERAL, TK_DOC_COMMENT, TK_DOUBLE_LITERAL, TK_EOF, TK_FLOAT_LITERAL, TK_IDENTIFIER, TK_INT_LITERAL, TK_LITERAL_base, TK_LITERAL_max, TK_LONG_LITERAL, TK_max, TK_MULTI_COMMENT, TK_NULL_LITERAL, TK_SINGLE_COMMENT, TK_SQLJ, TK_STRING_LITERAL, TK_WHITESPACE, TK_words
ALIGN_ANONYMOUS_CLASS, ALIGN_ARRAY_INITIALIZERS, ALIGN_LAMBDA_BODIES, ALIGN_VARIABLE_NAMES, BLANKLINES_AFTER_LAST_MEMBER, BLANKLINES_AFTER_LAST_MODULE_MEMBER, BLANKLINES_base, BLANKLINES_BEFORE_DOC_COMMENT, BLANKLINES_BEFORE_FIELD, BLANKLINES_BEFORE_FIRST_CLASS, BLANKLINES_BEFORE_FIRST_MEMBER, BLANKLINES_BEFORE_FIRST_MODULE_MEMBER, BLANKLINES_BEFORE_MEMBER_CLASS, BLANKLINES_BEFORE_METHOD, BLANKLINES_BEFORE_MODULE_EXPORTS, BLANKLINES_BEFORE_MODULE_PROVIDES, BLANKLINES_BEFORE_MODULE_REQUIRES, BLANKLINES_BEFORE_MODULE_USES, BLANKLINES_EMPTY_ANONYMOUS, BLANKLINES_EMPTY_BLOCK, BLANKLINES_EMPTY_CLASS, BLANKLINES_EMPTY_METHOD, BLANKLINES_EMPTY_MODULE, BLANKLINES_IMPORTS_AFTER, BLANKLINES_max, BLANKLINES_PACKAGE_AFTER, BLANKLINES_PRESERVE_COUNT, CLONE_QUALIFIES_TYPES, CUDDLE_EMPTY_BRACES, CUDDLE_MODULE_MEMBERS, FALSE, IGNORED_I, IGNORED_Z, IMPORT_base, IMPORT_GROUP_IMPORTS, IMPORT_GROUP_PACKAGE_DEPTH, IMPORT_INNER_CLASS_NAME, IMPORT_max, IMPORT_NARROW_MEMBERS_THRESHOLD, IMPORT_NARROW_THRESHOLD, INDENT_base, INDENT_BLOCK_CHILDREN, INDENT_CLASS_MEMBERS, INDENT_CONTROL_BLOCKS, INDENT_max, INDENT_MODULE_MEMBERS, INDENT_NUM_SPACES, INDENT_REPLACE_WITH_TABS, INDENT_SWITCH_CASES, INDENT_TAB_SIZE, INDENT_TRAILING_COMMENTS, INTEGER_ALWAYS_WRAP, INTEGER_NEVER_WRAP, INTEGER_WRAP_IF_LONG, MEMBER_ORDER, MISC_base, MISC_max, NEWLINE_AFTER_SWITCH_CASE, NEWLINE_ANONYMOUS_CLASS_BRACES, NEWLINE_ARRAY_BRACES, NEWLINE_base, NEWLINE_BLOCK_BRACES, NEWLINE_CASE_BRACES, NEWLINE_CATCH, NEWLINE_CATCH_BRACES, NEWLINE_CLASS_BRACES, NEWLINE_DO_BRACES, NEWLINE_ELSE, NEWLINE_ELSE_BRACES, NEWLINE_EXTENDS, NEWLINE_FINALLY, NEWLINE_FINALLY_BRACES, NEWLINE_FOR_BRACES, NEWLINE_IF_BRACES, NEWLINE_IMPLEMENTS, NEWLINE_max, NEWLINE_METHOD_BRACES, NEWLINE_MODULE_BRACES, NEWLINE_STATIC_INITIALIZER_BRACES, NEWLINE_SWITCH_BRACES, NEWLINE_SYNCHRONIZED_BRACES, NEWLINE_THROWS, NEWLINE_TRY_BRACES, NEWLINE_WHILE, NEWLINE_WHILE_BRACES, ONE, PREFERENCES_base, PREFERENCES_defaults, PREFERENCES_explanations, PREFERENCES_keys, PREFERENCES_max, PREFERENCES_sun, SPACE_ARGUMENTS_BEFORE, SPACE_ASSIGN_AROUND, SPACE_base, SPACE_BINARYOP_AROUND, SPACE_BRACES_AROUND, SPACE_BRACKETS_WITHIN, SPACE_COLON_AFTER, SPACE_COLON_BEFORE, SPACE_COMMA_AFTER, SPACE_COMMA_BEFORE, SPACE_KEYWORD_AFTER, SPACE_LAMBDA_OPERATOR_AROUND, SPACE_max, SPACE_OPENBRACE_BEFORE, SPACE_PARAMETERS_BEFORE, SPACE_PARENS_WITHIN, SPACE_QUESTION_AFTER, SPACE_QUESTION_BEFORE, SPACE_SEMICOLON_AFTER, SPACE_SEMICOLON_BEFORE, SPACE_TYPECAST_AFTER, TRI_ALWAYS_WRAP, TRI_NEVER_WRAP, TRI_WRAP_IF_LONG, TRUE, TWO, UNKNOWN_I, UNKNOWN_Z, WRAP_ALIGN, WRAP_ANNOTATIONS, WRAP_ANONYMOUS_CLASS_ASSIGNMENTS, WRAP_ARRAY_CONSTANT, WRAP_ASSERT_OPERATORS, WRAP_base, WRAP_BEFORE_OPERATORS, WRAP_BEFORE_TERNARY_OPERATORS, WRAP_BINARY_OPERATOR, WRAP_CLASS_ANNOTATIONS, WRAP_DOT_CHAIN, WRAP_DOT_CHAIN_BEFORE_DOT, WRAP_EXTENDS, WRAP_FIELD_ANNOTATIONS, WRAP_FOR_STATEMENT, WRAP_IMPLEMENTS, WRAP_INVOKE_ARGUMENTS, WRAP_LINE_WIDTH, WRAP_LOCAL_VARIABLE_ANNOTATIONS, WRAP_MARKER_ANNOTATIONS, WRAP_max, WRAP_METHOD_ANNOTATIONS, WRAP_MODIFIERS, WRAP_PARAMETER_ANNOTATIONS, WRAP_PARAMETER_LIST, WRAP_QUES_OPERATOR, WRAP_STRING_EOL_CONCATENATIONS, WRAP_THROWS, WRAP_TYPE_ANNOTATIONS, ZERO
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 and Description |
---|
SourceFactory() |
Modifier and Type | Method and Description |
---|---|
abstract boolean |
addAnonymousClass(SourceNewClassExpression expr,
SourceClassBody body)
Adds an anonymous class to a SourceNewClassExpression, e.g.
|
SourceAnnotation |
createAnnotation(SourceTypeReference type)
Creates an annotation (but not an annotation type), e.g.
|
abstract SourceAnnotation |
createAnnotation(SourceTypeReference type,
SourceListExpression arguments)
Creates an annotation (but not an annotation type), e.g.
|
SourceAnnotation |
createAnnotation(java.lang.String name)
Creates an annotation (but not an annotation type), e.g.
|
abstract SourceAnnotation |
createAnnotation(java.lang.String name,
SourceListExpression arguments)
Creates an annotation (but not an annotation type), e.g.
|
abstract SourceExpression |
createAnnotationArgumentFromText(java.lang.String text)
Attempts to create an annotation argument with the given text.
|
abstract SourceAnnotationExpression |
createAnnotationExpression(SourceAnnotation arg)
Creates an annotation expression.
|
abstract SourceAnnotation |
createAnnotationFromText(java.lang.String text)
Attempts to create an annotation with the given text.
|
SourceListExpression |
createArgumentList()
Creates an empty argument list; should not be used
for the creation of array constants.
|
SourceListExpression |
createArgumentList(SourceExpression arg)
Creates an argument list with one argument; should not be used
for the creation of array constants.
|
SourceListExpression |
createArgumentList(SourceExpression[] arguments)
Creates an argument list; should not be used
for the creation of array constants.
|
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.
|
SourceAssignmentExpression |
createAssignment(int code,
java.lang.String lhs,
java.lang.String 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)
Attempts to create a block with the given text.
|
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(SourceCatchParameter parameter,
SourceBlockStatement block)
Creates a catch clause for a try-catch or a try-catch-finally
statement.
|
abstract SourceCatchClause |
createCatchClause(SourceFormalParameterList parameters,
SourceBlockStatement block)
Deprecated.
Use createCatchClause( SourceCatchParameter, SourceBlockStatement )
instead
|
SourceCatchClause |
createCatchClause(SourceLocalVariable parameter,
SourceBlockStatement child)
Deprecated.
This method can only create JDK6 ( or before )
compatible catch parameters.
Use createCatchClause( SourceCatchParameter, SourceBlockStatement )
instead
|
abstract SourceCatchParameter |
createCatchParameter(java.util.List<SourceTypeReference> types,
java.lang.String name)
Creates a catch clause parameter from a union of types.
|
abstract SourceCatchParameter |
createCatchParameter(SourceTypeReference type,
java.lang.String name)
Creates a catch clause parameter from one type.
|
SourceCatchParameter |
createCatchParameter(java.lang.String typeName,
java.lang.String name)
Creates a catch clause parameter from one type.
|
SourceClass |
createClass(int tyKind,
java.lang.String name)
Creates a class with an empty body.
|
SourceClass |
createClass(int tyKind,
java.lang.String name,
SourceSuperclassClause superclassClause,
SourceInterfacesClause interfacesClause,
SourceClassBody body)
Creates a class definition.
|
abstract SourceClass |
createClass(int tyKind,
java.lang.String name,
SourceTypeParameter[] tyParameters,
SourceSuperclassClause superclassClause,
SourceInterfacesClause interfacesClause,
SourceClassBody body)
Creates a class definition.
|
SourceClass |
createClass(java.lang.String text)
Attempts to create a class with the given text.
|
SourceClassBody |
createClassBody()
Creates an empty class body.
|
SourceClassBody |
createClassBody(SourceMember member)
Creates a class body with one member.
|
abstract SourceClassBody |
createClassBody(SourceMember[] members)
Creates a class body with members.
|
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)
Deprecated.
Use createStaticInitializer(SourceBlock) or
createInstanceInitializer(SourceBlock)
|
abstract SourceExpression |
createClassLiteralExpression(java.lang.String fullyQualifiedTypeName)
Create a class literal expression for the incoming type name.
|
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 an empty doc comment.
|
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)
Attempts to create a JavaDoc comment with the given text.
|
abstract SourceDocComment |
createDocCommentFromText(java.lang.String text)
Attempts to create a JavaDoc comment with the given text.
|
SourceDocDescription |
createDocDescription()
Creates an empty doc description.
|
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 inline 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.
|
abstract 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 such as lhs.name.
|
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)
Creates an enum constant.
|
abstract SourceExpression |
createExpression(int code)
Create a SourceExpression.
|
SourceExpression |
createExpression(java.lang.String text)
Attempts to create an expression with the given text.
|
abstract SourceExpression |
createExpressionFromText(java.lang.String text)
Attempts to create an expression with the given text.
|
SourceListExpression |
createExpressionList()
Creates a list expression; should not be used
for the creation of array constants.
|
SourceListExpression |
createExpressionList(SourceExpression argument)
Creates a list expression with one element; should not be used
for the creation of array constants.
|
abstract SourceListExpression |
createExpressionList(SourceExpression[] arguments)
Creates a list expression; should not be used
for the creation of array constants.
|
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.
|
abstract SourceFieldDeclaration |
createFieldDeclaration(SourceFieldVariable[] variables)
Creates a field declaration from one or more field variables.
|
SourceFieldDeclaration |
createFieldDeclaration(SourceLocalVariable variable)
Creates a field declaration 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.
|
abstract 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)
Deprecated.
Use createFile( JdkVersion ) instead
|
static SourceFile |
createFile(JdkVersion jdkVersion)
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.
|
SourceForStatement |
createForEnhancedStatement(java.lang.String loopVariableTypeName,
java.lang.String loopVariableName,
java.lang.String collectionName,
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)
Creates a formal parameter list.
|
abstract SourceFormalParameterList |
createFormalParameterList(SourceFormalParameter[] parameters)
Creates a formal parameter list.
|
SourceFormalParameterList |
createFormalParameterList(SourceLocalVariable variable)
Creates a formal parameter list using a local variable as a template.
|
SourceFormalParameterList |
createFormalParameterList(SourceLocalVariable[] variables)
Creates a formal parameter list using local variables as a template.
|
SourceForStatement |
createForStatement(SourceExpression initialization,
SourceExpression condition,
SourceExpression update,
SourceStatement child)
Creates a traditional for loop with no variable declarators and
with at most one initialization and at most one update.
|
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)
Creates a traditional for loop with a single
local variable and at most one update expression.
|
SourceIfStatement |
createIfElseStatement(SourceExpression e,
SourceStatement trueClause,
SourceStatement elseClause)
Creates an if-else statement.
|
abstract SourceIfStatement |
createIfStatement(SourceExpression e,
SourceStatement child)
Creates an if statement without an else clause.
|
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)
Creates an import declaration.
|
SourceImport |
createImportDeclaration(java.lang.String name)
Creates an import declaration.
|
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 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.
|
abstract SourceIntersectionTypeExpression |
createIntersectionTypeExpression(SourceTypeReference[] types)
Create an intersection type expression consisting of two
or more intersecting types.
|
abstract SourceLambdaExpression |
createLambdaExpression(SourceLambdaParameter[] parameters,
SourceElement body)
Create a lambda expression with formal parameters.
|
abstract SourceLambdaExpression |
createLambdaExpression(java.lang.String[] inferredParameterNames,
boolean parenthesizeParameters,
SourceElement body)
Create a lambda expression with inferred parameters.
|
abstract SourceLambdaParameter |
createLambdaParameter(int modifiers,
SourceTypeReference type,
java.lang.String name)
Creates a formal parameter for a lambda expression.
|
abstract SourceLiteralExpression |
createLiteralExpression(java.lang.Object object)
Create a literal expression from an incoming Object representing
a literal constant.
|
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.
|
abstract SourceLocalVariableDeclaration |
createLocalVariableDeclaration(SourceLocalVariable[] variables)
Creates a local variable declaration from one or more local variables.
|
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)
Attempts to create a member with the given text.
|
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 SourceMethodReferenceExpression |
createMethodReferenceExpression(SourceExpression lhs,
SourceTypeArgument[] typeArguments,
java.lang.String methodName)
Create a SourceMethodReferenceExpression, valid in JDK8 and higher.
|
abstract SourceName |
createName(java.lang.String name)
Creates a name.
|
protected abstract SourceNewArrayExpression |
createNewArrayExpressionImpl(SourceTypeReference type,
SourceListExpression list,
int requiredListCode)
Creates a new array expression.
|
abstract SourceNewClassExpression |
createNewClassExpression(SourceExpression lhs,
SourceTypeReference type,
SourceListExpression arguments,
SourceClassBody body)
Creates a class creator.
|
SourceNewArrayExpression |
createNewInitializedArrayExpression(SourceTypeReference type,
SourceListExpression arrayconst)
Creates a new array expression of the form new Foo[] { bar }.
|
SourceNewArrayExpression |
createNewUninitializedArrayExpression(SourceTypeReference type,
SourceListExpression args)
Creates a new array expression of the form new Foo[1].
|
abstract SourcePackage |
createPackageDeclaration(java.lang.String name)
Creates a package declaration.
|
abstract SourceQuestionExpression |
createQuestionExpression(SourceExpression one,
SourceExpression two,
SourceExpression three)
Creates a question expression.
|
abstract SourceReturnStatement |
createReturnStatement(SourceExpression e)
Creates a return statement.
|
abstract SourceSimpleNameExpression |
createSimpleNameExpression(java.lang.String name)
Creates a simple name expression.
|
abstract SourceElement |
createSourceElement(int kind)
Can NOT be used to instantiate SourceExpression's.
|
SourceStatement |
createStatement(java.lang.String text)
Attempts to create a statement with the given text.
|
abstract SourceStatement |
createStatementFromText(java.lang.String text)
Attempts to create a statement with the given text.
|
abstract SourceStatementLabel |
createStatementLabel(java.lang.String name)
Creates a statement label.
|
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)
Creates a switch case.
|
abstract SourceSwitchLabel |
createSwitchDefaultLabel()
Creates the default switch case.
|
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)
Creates a throws clause.
|
abstract SourceThrowsClause |
createThrowsClause(SourceTypeReference[] exceptions)
Creates a throws clause.
|
abstract SourceThrowStatement |
createThrowStatement(SourceExpression e)
Creates a throw statement.
|
abstract SourceTryStatement |
createTryCatchFinallyStatement(SourceBlockStatement tryClause,
SourceCatchParameter parameter,
SourceBlockStatement catchClause,
SourceBlockStatement finallyClause)
Creates a try-catch-finally statement with a single catch clause
and a finally clause.
|
abstract SourceTryStatement |
createTryCatchFinallyStatement(SourceBlockStatement tryClause,
SourceFormalParameterList parameters,
SourceBlockStatement catchClause,
SourceBlockStatement finallyClause)
Deprecated.
Use createTryCatchFinallyStatement(
SourceBlockStatement, SourceCatchParameter, SourceBlockStatement,
SourceBlockStatement instead
|
SourceTryStatement |
createTryCatchFinallyStatement(SourceBlockStatement tryClause,
SourceFormalParameter parameter,
SourceBlockStatement catchClause,
SourceBlockStatement finallyClause)
Deprecated.
Use createTryCatchFinallyStatement(
SourceBlockStatement, SourceCatchParameter, SourceBlockStatement,
SourceBlockStatement instead
|
SourceTryStatement |
createTryCatchFinallyStatement(SourceBlockStatement tryClause,
SourceLocalVariable parameter,
SourceBlockStatement catchClause,
SourceBlockStatement finallyClause)
Deprecated.
Use createTryCatchFinallyStatement(
SourceBlockStatement, SourceCatchParameter, SourceBlockStatement,
SourceBlockStatement instead
|
abstract SourceTryStatement |
createTryCatchStatement(SourceBlockStatement tryClause,
SourceCatchParameter parameter,
SourceBlockStatement catchClause)
Creates a try-catch statement with a single catch clause.
|
abstract SourceTryStatement |
createTryCatchStatement(SourceBlockStatement tryClause,
SourceFormalParameterList parameters,
SourceBlockStatement catchClause)
Deprecated.
Use createTryCatchStatement( SourceBlockStatement,
SourceCatchParameter, SourceBlockStatement ) instead
|
SourceTryStatement |
createTryCatchStatement(SourceBlockStatement tryClause,
SourceFormalParameter parameter,
SourceBlockStatement catchClause)
Deprecated.
Use createTryCatchStatement( SourceBlockStatement,
SourceCatchParameter, SourceBlockStatement ) instead
|
SourceTryStatement |
createTryCatchStatement(SourceBlockStatement tryClause,
SourceLocalVariable parameter,
SourceBlockStatement catchClause)
Deprecated.
Use createTryCatchStatement( SourceBlockStatement,
SourceCatchParameter, SourceBlockStatement ) instead
|
abstract SourceTryStatement |
createTryFinallyStatement(SourceBlockStatement child,
SourceBlockStatement finallyClause)
Creates a try-finally statement.
|
abstract SourceTryResourcesList |
createTryResourcesList(SourceLocalVariableDeclaration[] variables)
Deprecated.
Use createTryResourcesList(SourceTryResourcesElement[]) instead
|
abstract SourceTryResourcesList |
createTryResourcesList(SourceTryResourcesElement[] elements)
Create a try resources list.
|
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.
|
abstract SourceTypeReference |
createType(java.lang.String name,
int dimensions)
Creates a dimensional type reference.
|
abstract SourceTypeArgument |
createTypeArgument(int bound,
SourceTypeReference type)
Creates a type argument.
|
abstract SourceTypeArgument |
createTypeArgumentFromText(java.lang.String text)
Parses the incoming text and attempts to make a type argument
from that text.
|
abstract SourceTypeArgumentList |
createTypeArgumentList(SourceTypeArgument[] typeArguments)
Creates a SourceTypeArgumentList.
|
abstract SourceTypecastExpression |
createTypecast(SourceTypeReference[] types,
SourceExpression operand)
Creates an intersection typecast of two or more intersecting types.
|
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.
|
SourceTypeParameter |
createTypeParameter(java.lang.String name)
Creates a type parameter.
|
SourceTypeParameter |
createTypeParameter(java.lang.String name,
SourceTypeReference type)
Creates a type parameter.
|
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.
|
@Deprecated public static SourceFile createFile(int j2se)
j2se
- The j2se language value to use with this SourceFile.
Valid values are JavaTokens.J2SE_*public static SourceFile createFile(JdkVersion jdkVersion)
jdkVersion
- The JDK version to use with this SourceFilepublic 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_*.java.lang.IllegalArgumentException
- if code is not a valid operatorpublic abstract SourceName createName(java.lang.String name)
name
- Must be a valid qualified name.java.lang.IllegalArgumentException
- if name is not a valid qualified namepublic final SourceTypeReference createType(byte primitive)
primitive
- Valid values are JavaConstants.PRIMITIVE_*.java.lang.IllegalArgumentException
- when primitive is less than
PrimitiveType.PRIMITIVE_min or equal to or more than
PrimitiveType.PRIMITIVE_maxpublic final SourceTypeReference createType(java.lang.String name)
name
- A name that can be resolved to a type, which can be a simple type name or a more
complex one such as one with generic type arguments or diamond syntaxjava.lang.IllegalArgumentException
- when name is nullpublic abstract SourceTypeReference createType(java.lang.String name, int dimensions)
name
- Must be a valid type name, which can be a generic type such
as List<String>dimensions
- Require non-negativejava.lang.IllegalArgumentException
- if name is not a valid type name,
or if dimensions is negativepublic 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 |
JavaConstants.BOUND_NARROW | T |
JavaConstants.BOUND_EXTENDS | ? extends T |
JavaConstants.BOUND_SUPER | ? super T |
JavaConstants.BOUND_NONE | ? |
type
- Ignored if bound == BOUND_NONEjava.lang.IllegalArgumentException
- if bound != BOUND_NONE and type == nullpublic abstract SourceTypeArgument createTypeArgumentFromText(java.lang.String text)
text
- A String that contains the text of a type argumentjava.lang.IllegalArgumentException
- if text is nullpublic abstract SourceTypeArgumentList createTypeArgumentList(SourceTypeArgument[] typeArguments)
typeArguments
- The type arguments for the list which can be null
or empty in which case a diamond syntax type argument list is createdjava.lang.IllegalArgumentException
- if any typeArgument is nullpublic 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: "/*", "//".java.lang.IllegalArgumentException
- if text is null, or if text
is not formatted as a commentpublic abstract SourceLexicalBlankline createBlankline()
public final SourceBlock createBlock(java.lang.String text)
text
- Must include the start and end braces.java.lang.IllegalArgumentException
- if text is nullpublic final SourceClass createClass(java.lang.String text)
text
- A class definitionjava.lang.IllegalArgumentException
- if text is nullpublic final SourceDocComment createDocComment(java.lang.String text)
text
- Must start with the "/**" comment beginning
and end with the "*/" comment endingjava.lang.IllegalArgumentException
- if text is nullpublic final SourceExpression createExpression(java.lang.String text)
text
- An expressionjava.lang.IllegalArgumentException
- if text is nullpublic final SourceMember createMember(java.lang.String text)
text
- A class memberjava.lang.IllegalArgumentException
- if text is nullpublic final SourceStatement createStatement(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.java.lang.IllegalArgumentException
- if text is nullpublic abstract SourceAnnotation createAnnotationFromText(java.lang.String text)
text
- include the beginning '@' character.java.lang.IllegalArgumentException
- if text is nullpublic abstract SourceExpression createAnnotationArgumentFromText(java.lang.String text)
text
- The annotation argument, such as foo=bar or foo
or foo={foo,bar} or {foo,bar}java.lang.IllegalArgumentException
- if text is nullpublic abstract SourceBlock createBlockFromText(java.lang.String text)
text
- Must include the start and end braces.java.lang.IllegalArgumentException
- if text is nullpublic abstract SourceBlockElement createBlockElementFromText(java.lang.String text)
text
- May be a statement, local variable declaration, or a
class declaration. May NOT be a comment.java.lang.IllegalArgumentException
- if text is nullpublic abstract SourceClass createClassFromText(java.lang.String text)
text
- A class definitionjava.lang.IllegalArgumentException
- if text is nullpublic abstract SourceDocBlockTag createDocBlockTagFromText(java.lang.String text)
text
- Must start with '@'. A trailing newline is not required.java.lang.IllegalArgumentException
- if text is null or if text does
not start with '@'public abstract SourceDocComment createDocCommentFromText(java.lang.String text)
text
- Must include start with the "/**" comment beginning
and end with the "*/" comment endingjava.lang.IllegalArgumentException
- if text is nullpublic abstract SourceDocInlineTag createDocInlineTagFromText(java.lang.String text)
text
- Must start with '{' and must end with '}'java.lang.IllegalArgumentException
- if text is null or if text does
not start with '{' and ends with '}public abstract SourceExpression createExpressionFromText(java.lang.String text)
text
- An expressionjava.lang.IllegalArgumentException
- if text is nullpublic abstract SourceMember createMemberFromText(java.lang.String text)
text
- A class memberjava.lang.IllegalArgumentException
- if text is nullpublic 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.java.lang.IllegalArgumentException
- if text is nullpublic abstract SourceTypeReference createTypeFromText(java.lang.String text)
text
- A type which can be a generic typejava.lang.IllegalArgumentException
- if text is nullpublic abstract SourceDocReference createDocMemberReferenceFromText(java.lang.String text)
text
- A member referencejava.lang.IllegalArgumentException
- if text is nullpublic final SourceAnnotation createAnnotation(SourceTypeReference type)
type
- Must be a valid typejava.lang.IllegalArgumentException
- if type is nullpublic final SourceAnnotation createAnnotation(java.lang.String name)
name
- Must be a valid qualified namejava.lang.IllegalArgumentException
- if name is not a valid qualified name.public abstract SourceAnnotation createAnnotation(SourceTypeReference type, SourceListExpression arguments)
type
- Must be a valid typearguments
- Null indicates no argument listjava.lang.IllegalArgumentException
- if type is nullpublic abstract SourceAnnotation createAnnotation(java.lang.String name, SourceListExpression arguments)
name
- Must be a valid qualified namearguments
- Null indicates no argument listjava.lang.IllegalArgumentException
- if name is not a valid qualified name.public final SourceTypeParameter createTypeParameter(java.lang.String name)
name
- Must be a valid simple namejava.lang.IllegalArgumentException
- if name is not a valid simple namepublic final SourceTypeParameter createTypeParameter(java.lang.String name, SourceTypeReference type)
name
- Must be a valid simple nametype
- Require non-nulljava.lang.IllegalArgumentException
- if name is not a valid
simple name or if type is nullpublic abstract SourceTypeParameter createTypeParameter(java.lang.String name, SourceTypeReference[] bounds)
name
- Must be a valid simple namebounds
- Null means no bounds.java.lang.IllegalArgumentException
- if name is not a valid simple name
or if any bound is nullpublic abstract SourcePackage createPackageDeclaration(java.lang.String name)
name
- Must be a valid qualified namejava.lang.IllegalArgumentException
- if name is not a valid qualified namepublic final SourceImport createImportDeclaration(java.lang.String name)
name
- Must be a valid qualified namejava.lang.IllegalArgumentException
- if name is not a valid qualified namepublic abstract SourceImport createImportDeclaration(int modifiers, java.lang.String name)
modifiers
- Valid values are JavaConstants.ACC_none or JavaConstants.ACC_STATICname
- Must be a valid qualified namejava.lang.IllegalArgumentException
- if name is not a valid qualified namepublic final SourceClass createClass(int tyKind, java.lang.String name)
tyKind
- Valid values are JavaConstants.TY_*name
- Must be a valid simple namejava.lang.IllegalArgumentException
- if name is not a valid simple name
or if tyKind is not a valid TY_* valuepublic 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 namesuperclassClause
- Null means no superclass clauseinterfacesClause
- Null means no interfaces clausebody
- Null indicates an empty bodyjava.lang.IllegalArgumentException
- if name is not a valid simple name
or if tyKind is not a valid TY_* valuepublic 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 nametyParameters
- Null means no type parameterssuperclassClause
- Null means no superclass clauseinterfacesClause
- Null means no interfaces clausebody
- Null indicates an empty bodyjava.lang.IllegalArgumentException
- if name is not a valid simple name
or if tyKind is not a valid TY_* value or if any tyParameter
is nullpublic abstract boolean addAnonymousClass(SourceNewClassExpression expr, SourceClassBody body)
expr
- The new class expression, which cannot be null and cannot have
an anonymous class yetbody
- The body of the anonymous class, which cannot be nulljava.lang.IllegalArgumentException
- if expr or body is null or if the new
class expression already has an anonymous classpublic final SourceMethod createConstructor(SourceFormalParameterList parameters, SourceThrowsClause throwsClause, SourceBlock block)
parameters
- Null indicates an empty parameter listthrowsClause
- Null indicates no throws clauseblock
- Null indicates an empty blockpublic abstract SourceMethod createConstructor(SourceTypeParameter[] typeParameters, SourceFormalParameterList parameters, SourceThrowsClause throwsClause, SourceBlock block)
typeParameters
- Null indicates no type parametersparameters
- Null indicates an empty parameter listthrowsClause
- Null indicates no throws clauseblock
- Null indicates an empty blockjava.lang.IllegalArgumentException
- if any typeParameter is nullpublic final SourceMethod createMethod(SourceTypeReference returnType, java.lang.String methodName, SourceFormalParameterList parameters, SourceThrowsClause throwsClause, SourceBlock block)
SourceMethod.addModifiers( JavaConstants.ACC_VARARGS )To add a default value for annotation methods, create a SourceExpression for the value and add it as a child to the SourceMethod.
returnType
- Null indicates a void return typemethodName
- Must be a valid simple nameparameters
- Null indicates an empty parameter listthrowsClause
- Null indicates no throws clauseblock
- Null indicates no blockjava.lang.IllegalArgumentException
- if name is not a valid simple namepublic abstract SourceMethod createMethod(SourceTypeParameter[] tyParameters, SourceTypeReference returnType, java.lang.String methodName, SourceFormalParameterList parameters, SourceThrowsClause throwsClause, SourceBlock block)
tyParameters
- Null means no type parametersreturnType
- Null indicates a void return typemethodName
- Must be a valid simple nameparameters
- Null indicates an empty parameter listthrowsClause
- Null indicates no throws clauseblock
- Null indicates no blockjava.lang.IllegalArgumentException
- if name is not a valid simple name
or if any tyParameter is nullpublic abstract SourceEnumConstant createEnumConstant(java.lang.String name, SourceListExpression arguments, SourceClassBody body)
name
- Must be a valid simple namearguments
- Null indicates no argumentsbody
- Null indicates no bodyjava.lang.IllegalArgumentException
- if name is not a valid simple namepublic final SourceClassInitializer createInstanceInitializer(SourceBlock block)
block
- Null indicates an empty block.public final SourceClassInitializer createStaticInitializer(SourceBlock block)
block
- Null indicates an empty block@Deprecated public abstract SourceClassInitializer createClassInitializer(int modifiers, SourceBlock block)
modifiers
- Valid values are ACC_none and ACC_STATICblock
- Null indicates an empty blockjava.lang.IllegalArgumentException
- if modifiers is not ACC_none or ACC_STATICpublic abstract SourceFieldVariable createFieldVariable(SourceLocalVariable variable)
variable
- Require non-nulljava.lang.IllegalArgumentException
- if variable is nullpublic final SourceFieldDeclaration createFieldDeclaration(SourceLocalVariable variable)
variable
- Require non-nulljava.lang.IllegalArgumentException
- if variable is nullpublic abstract SourceFieldDeclaration createFieldDeclaration(SourceFieldVariable variable)
variable
- Require non-nulljava.lang.IllegalArgumentException
- if variable is nullpublic abstract SourceFieldDeclaration createFieldDeclaration(SourceFieldVariable[] variables)
variables
- One or more field variables which should not be nulljava.lang.IllegalArgumentException
- if variables is null or empty or
any of the variables is null or the types and access modifiers
are not all the samepublic abstract SourceFieldDeclaration createFieldDeclaration(SourceLocalVariableDeclaration locals)
locals
- Require non-nulljava.lang.IllegalArgumentException
- if locals is nullpublic abstract SourceSuperclassClause createSuperclassClause(SourceTypeReference superclass)
superclass
- Should not be nulljava.lang.IllegalArgumentException
- if superclass is nullpublic final SourceInterfacesClause createInterfacesClause(SourceTypeReference one)
one
- Should not be nulljava.lang.IllegalArgumentException
- if one is nullpublic abstract SourceInterfacesClause createInterfacesClause(SourceTypeReference[] types)
types
- Should not be null or emptyjava.lang.IllegalArgumentException
- if types is null or empty or
contains a null elementpublic final SourceClassBody createClassBody()
public final SourceClassBody createClassBody(SourceMember member)
member
- Should not be nulljava.lang.IllegalArgumentException
- if member is nullpublic abstract SourceClassBody createClassBody(SourceMember[] members)
members
- Null creates a body with no membersjava.lang.IllegalArgumentException
- if members contains
a null elementpublic abstract SourceFormalParameter createFormalParameter(SourceLocalVariable variable)
variable
- A newly created local variable from this factoryjava.lang.IllegalArgumentException
- if variable is null or variable
is not an unparented newly created SourceLocalVariable made by
this factorypublic SourceCatchParameter createCatchParameter(java.lang.String typeName, java.lang.String name)
typeName
- A type name which should not be nullname
- The name of the parameter which should not be nulljava.lang.IllegalArgumentException
- if typeName or name
is nullpublic abstract SourceCatchParameter createCatchParameter(SourceTypeReference type, java.lang.String name)
type
- A type which should not be nullname
- The name of the parameter which should not be nulljava.lang.IllegalArgumentException
- if type or name is nullpublic abstract SourceCatchParameter createCatchParameter(java.util.List<SourceTypeReference> types, java.lang.String name)
types
- A union of typesname
- The name of the parameterjava.lang.IllegalArgumentException
- if name or types is null, or if
types is empty or contains a null elementpublic final SourceFormalParameterList createFormalParameterList()
public final SourceFormalParameterList createFormalParameterList(SourceLocalVariable variable)
variable
- A variable which should not be nulljava.lang.IllegalArgumentException
- if variable is null or variable
is not an unparented newly created SourceLocalVariable made by
this factorypublic final SourceFormalParameterList createFormalParameterList(SourceLocalVariable[] variables)
variables
- The local variablesjava.lang.IllegalArgumentException
- if variables contains a null element
or an element that is not an unparented newly created SourceLocalVariable
made by this factorypublic final SourceFormalParameterList createFormalParameterList(SourceFormalParameter parameter)
parameter
- Require non-nulljava.lang.IllegalArgumentException
- if parameter is nullpublic abstract SourceFormalParameterList createFormalParameterList(SourceFormalParameter[] parameters)
parameters
- Null means an empty parameter listjava.lang.IllegalArgumentException
- if parameters contains a null elementpublic final SourceThrowsClause createThrowsClause(SourceTypeReference exception)
exception
- Require non-nulljava.lang.IllegalArgumentException
- if exception is nullpublic abstract SourceThrowsClause createThrowsClause(SourceTypeReference[] exceptions)
exceptions
- Require non-null.java.lang.IllegalArgumentException
- if exceptions is null or
empty or contains a null elementpublic final SourceFieldVariable createFieldVariable(SourceTypeReference type, java.lang.String name)
type
- Require non-nullname
- Must be a valid simple namejava.lang.IllegalArgumentException
- if name is not a valid simple name
or if type is nullpublic final SourceFieldVariable createFieldVariable(int modifiers, SourceTypeReference type, java.lang.String name)
modifiers
- Union of one or more of JavaConstants.ACC_XXXtype
- Require non-nullname
- Must be a valid simple namejava.lang.IllegalArgumentException
- if name is not a valid simple name
or if type is nullpublic final SourceFieldVariable createFieldVariable(SourceTypeReference type, java.lang.String name, SourceExpression initializer)
type
- Require non-nullname
- Must be a valid simple nameinitializer
- Null indicates nonejava.lang.IllegalArgumentException
- if name is not a valid simple name
or if type is nullpublic final SourceFieldVariable createFieldVariable(int modifiers, SourceTypeReference type, java.lang.String name, SourceExpression initializer)
modifiers
- Union of one or more of JavaConstants.ACC_XXXtype
- Require non-nullname
- Must be a valid simple nameinitializer
- Null indicates nonejava.lang.IllegalArgumentException
- if name is not a valid simple name
or if type is nullpublic abstract SourceFieldVariable createFieldVariable(int modifiers, SourceTypeReference type, java.lang.String name, int xdimensions, SourceExpression initializer)
modifiers
- Union of one or more JavaConstants.ACC_XXXtype
- Require non-nullname
- Must be a valid simple namexdimensions
- The number of extra array dimensions to modify
the field variable withinitializer
- Null indicates nonejava.lang.IllegalArgumentException
- if name is not a valid simple name
or if type is null or if xdimensions less than 0public final SourceFieldDeclaration createFieldDeclaration(SourceTypeReference type, java.lang.String name)
type
- The type which should not be nullname
- The name which should be a simple namejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceFieldDeclaration createFieldDeclaration(int modifiers, SourceTypeReference type, java.lang.String name)
modifiers
- A union of one or more JavaConstants.ACC_XXXtype
- The type which should not be nullname
- The name which should be a simple namejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceFieldDeclaration createFieldDeclaration(SourceTypeReference type, java.lang.String name, SourceExpression initializer)
type
- The type of the field declarationname
- The name of the field declarationinitializer
- The optional initializer expressionjava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceFieldDeclaration createFieldDeclaration(int modifiers, SourceTypeReference type, java.lang.String name, SourceExpression initializer)
modifiers
- A union of one or more JavaConstants.ACC_XXXtype
- The type of the field declarationname
- The name of the field declarationinitializer
- The optional initializer expressionjava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceLocalVariable createLocalVariable(SourceTypeReference type, java.lang.String name)
type
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple namejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceLocalVariable createLocalVariable(int modifiers, SourceTypeReference type, java.lang.String name)
modifiers
- Valid values are ACC_none and ACC_FINALtype
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple namejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceLocalVariable createLocalVariable(SourceTypeReference type, java.lang.String name, SourceExpression initializer)
type
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple nameinitializer
- Null indicates nonejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceLocalVariable createLocalVariable(int modifiers, SourceTypeReference type, java.lang.String name, SourceExpression initializer)
modifiers
- Valid values are ACC_none and ACC_FINALtype
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple nameinitializer
- Null indicates none.java.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic abstract SourceLocalVariable createLocalVariable(int modifiers, SourceTypeReference type, java.lang.String name, int xdimensions, SourceExpression initializer)
modifiers
- Valid values are ACC_none and ACC_FINALtype
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple namexdimensions
- The number of extra array dimensions to modify
the local variable withinitializer
- Null indicates nonejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple name or xdimensions is less than zeropublic final SourceLocalVariableDeclaration createLocalVariableDeclaration(SourceTypeReference type, java.lang.String name)
type
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple namejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceLocalVariableDeclaration createLocalVariableDeclaration(int modifiers, SourceTypeReference type, java.lang.String name)
modifiers
- A union of one or more JavaConstants.ACC_XXXtype
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple namejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceLocalVariableDeclaration createLocalVariableDeclaration(SourceTypeReference type, java.lang.String name, SourceExpression initializer)
type
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple nameinitializer
- The optional initializer of the local variablejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic final SourceLocalVariableDeclaration createLocalVariableDeclaration(int modifiers, SourceTypeReference type, java.lang.String name, SourceExpression initializer)
modifiers
- A union of one or more JavaConstants.ACC_XXXtype
- The type of the local variable which cannot be nullname
- The name of the local variable which should be a simple nameinitializer
- The optional initializer of the local variablejava.lang.IllegalArgumentException
- if type is null or name
is not a valid simple namepublic abstract SourceLocalVariableDeclaration createLocalVariableDeclaration(SourceLocalVariable variable)
variable
- Require non-nulljava.lang.IllegalArgumentException
- if variable is nullpublic abstract SourceLocalVariableDeclaration createLocalVariableDeclaration(SourceLocalVariable[] variables)
variables
- One or more local variablesjava.lang.IllegalArgumentException
- if variables is null or empty or
contains a null element or if the types and access modifiers of
the variables are not the samepublic final SourceBlock createBlock()
public abstract SourceBlock createBlock(SourceElement[] elements)
elements
- The elements for the code blockjava.lang.IllegalArgumentException
- if elements contains a null elementpublic abstract SourceAssertStatement createAssertStatement(SourceExpression condition, SourceExpression output)
condition
- Require non-nulloutput
- An optional output expressionjava.lang.IllegalArgumentException
- if condition is nullpublic abstract SourceBlockStatement createBlockStatement(SourceBlock block)
block
- Null indicates an empty blockpublic abstract SourceBreakStatement createBreakStatement(java.lang.String target)
target
- Null indicates a break with no specific targetjava.lang.IllegalArgumentException
- if target is non-null and not
a valid simple name@Deprecated public final SourceCatchClause createCatchClause(SourceLocalVariable parameter, SourceBlockStatement child)
parameter
- Should be a un-parented SourceLocalVariable newly
created by this factorychild
- Null indicates an empty blockjava.lang.IllegalArgumentException
- if parameter is not an un-parented
newly created SourceLocalVariable created by this factory@Deprecated public abstract SourceCatchClause createCatchClause(SourceFormalParameterList parameters, SourceBlockStatement block)
parameters
- Require non-null. Must have exactly one parameter
in the listblock
- Null indicates an empty blockjava.lang.IllegalArgumentException
- if parameters is null or doesn't
contain one non-null element which is either an un-parented SourceFormalParameter
newly created by this factory, or a SourceCatchParameterpublic abstract SourceCatchClause createCatchClause(SourceCatchParameter parameter, SourceBlockStatement block)
parameter
- Require non-nullblock
- Null indicates an empty blockjava.lang.IllegalArgumentException
- if parameter is nullpublic abstract SourceContinueStatement createContinueStatement(java.lang.String target)
target
- Null indicates a continue with no specific targetjava.lang.IllegalArgumentException
- if target is non-null and not
a valid simple namepublic abstract SourceDoStatement createDoStatement(SourceExpression e, SourceStatement child)
e
- Require non-nullchild
- Null creates an empty statement as the clausejava.lang.IllegalArgumentException
- if e is nullpublic abstract SourceElseClause createElseClause(SourceStatement child)
child
- Null creates an empty statement as the clausepublic abstract SourceEmptyStatement createEmptyStatement()
public abstract SourceExpressionStatement createExpressionStatement(SourceExpression e)
e
- Require non-nulljava.lang.IllegalArgumentException
- if e is nullpublic abstract SourceFinallyClause createFinallyClause(SourceBlockStatement child)
child
- Null creates an empty blockpublic final SourceForStatement createForStatement(SourceExpression initialization, SourceExpression condition, SourceExpression update, SourceStatement child)
initialization
- Null means no initializationscondition
- Null means an implicitly true conditionupdate
- Null means no updateschild
- Null creates an empty statement as the clausepublic abstract SourceForStatement createForStatement(SourceListExpression initializations, SourceExpression condition, SourceListExpression updates, SourceStatement child)
initializations
- Null means no initializationscondition
- Null means an implicitly true conditionupdates
- Null means no updateschild
- Null creates an empty statement as the clausepublic final SourceForStatement createForVariableStatement(SourceLocalVariable variable, SourceExpression condition, SourceExpression update, SourceStatement child)
variable
- Require non-nullcondition
- Null means an implicitly true conditionupdate
- Null means no updatechild
- Null creates an empty statement as the clausejava.lang.IllegalArgumentException
- is variable is nullpublic abstract SourceForStatement createForVariableStatement(SourceLocalVariableDeclaration variables, SourceExpression condition, SourceListExpression updates, SourceStatement child)
variables
- Require non-nullcondition
- Null means an implicitly true conditionupdates
- Null means no updateschild
- Null creates an empty statement as the clausejava.lang.IllegalArgumentException
- if variables is nullpublic final SourceForStatement createForEnhancedStatement(java.lang.String loopVariableTypeName, java.lang.String loopVariableName, java.lang.String collectionName, SourceStatement child)
loopVariableTypeName
- Require non-nullloopVariableName
- Require non-nullcollectionName
- Require non-nullchild
- Null creates an empty statement as the clausejava.lang.IllegalArgumentException
- if loopVariableTypeName or
loopVariableName or collectionName is nullpublic final SourceForStatement createForEnhancedStatement(SourceLocalVariable loopVariable, SourceExpression collection, SourceStatement child)
loopVariable
- Require non-nullcollection
- Require non-nullchild
- Null creates an empty statement as the clausejava.lang.IllegalArgumentException
- if loopVariable or collection is nullpublic abstract SourceForStatement createForEnhancedStatement(SourceLocalVariableDeclaration loopVarDecl, SourceExpression collection, SourceStatement child)
loopVarDecl
- Require non-nullcollection
- Require non-nullchild
- Null creates an empty statement as the clausejava.lang.IllegalArgumentException
- if loopVarDecl or collection is nullpublic abstract SourceIfStatement createIfStatement(SourceExpression e, SourceStatement child)
e
- Require non-nullchild
- Null creates an empty statement as the clausejava.lang.IllegalArgumentException
- if e is nullpublic abstract SourceIfStatement createIfStatement(SourceExpression e, SourceStatement child, SourceElseClause clause)
e
- Require non-nullchild
- Null creates an empty statement as the clauseclause
- If non-null will create an elsejava.lang.IllegalArgumentException
- if e is nullpublic final SourceIfStatement createIfElseStatement(SourceExpression e, SourceStatement trueClause, SourceStatement elseClause)
e
- Require non-nulltrueClause
- Null creates an empty statement as the true clauseelseClause
- Null creates an empty statement as the else clausejava.lang.IllegalArgumentException
- if e is nullpublic abstract SourceReturnStatement createReturnStatement(SourceExpression e)
e
- Null indicates a void returnpublic abstract SourceSwitchStatement createSwitchStatement(SourceExpression e, SourceBlockStatement child)
e
- Require non-nullchild
- Null creates an empty blockjava.lang.IllegalArgumentException
- if e is nullpublic abstract SourceSynchStatement createSynchronizedStatement(SourceExpression e, SourceBlockStatement child)
e
- Require non-nullchild
- Null creates an empty blockjava.lang.IllegalArgumentException
- if e is nullpublic abstract SourceThrowStatement createThrowStatement(SourceExpression e)
e
- Require non-nulljava.lang.IllegalArgumentException
- if e is nullpublic abstract SourceTryStatement createTryStatement(SourceBlockStatement tryClause, SourceCatchClause[] catchClauses, SourceFinallyClause finallyClause)
tryClause
- Null indicates an empty try blockcatchClauses
- Null means no catch clausesfinallyClause
- Null indicates no finally clausejava.lang.IllegalArgumentException
- if any catchClause is null@Deprecated public final SourceTryStatement createTryCatchStatement(SourceBlockStatement tryClause, SourceLocalVariable parameter, SourceBlockStatement catchClause)
tryClause
- Null indicates an empty try blockparameter
- Require non-nullcatchClause
- Null indicates an empty catch blockjava.lang.IllegalArgumentException
- if parameter is null or parameter
is not an unparented newly created SourceLocalVariable made by
this factory@Deprecated public final SourceTryStatement createTryCatchStatement(SourceBlockStatement tryClause, SourceFormalParameter parameter, SourceBlockStatement catchClause)
tryClause
- Null indicates an empty try blockparameter
- Require non-nullcatchClause
- Null indicates an empty catch blockjava.lang.IllegalArgumentException
- if parameter is null@Deprecated public abstract SourceTryStatement createTryCatchStatement(SourceBlockStatement tryClause, SourceFormalParameterList parameters, SourceBlockStatement catchClause)
tryClause
- Null indicates an empty try blockparameters
- Require non-nullcatchClause
- Null indicates an empty catch blockjava.lang.IllegalArgumentException
- if parameters is nullpublic abstract SourceTryStatement createTryCatchStatement(SourceBlockStatement tryClause, SourceCatchParameter parameter, SourceBlockStatement catchClause)
tryClause
- Null indicates an empty try blockparameter
- Require non-nullcatchClause
- Null indicates an empty catch blockjava.lang.IllegalArgumentException
- if parameter is null@Deprecated public final SourceTryStatement createTryCatchFinallyStatement(SourceBlockStatement tryClause, SourceLocalVariable parameter, SourceBlockStatement catchClause, SourceBlockStatement finallyClause)
tryClause
- Null indicates an empty try blockparameter
- Require non-nullcatchClause
- Null indicates an empty catch blockfinallyClause
- Null indicates an empty finally blockjava.lang.IllegalArgumentException
- if parameter is null@Deprecated public final SourceTryStatement createTryCatchFinallyStatement(SourceBlockStatement tryClause, SourceFormalParameter parameter, SourceBlockStatement catchClause, SourceBlockStatement finallyClause)
tryClause
- Null indicates an empty try blockparameter
- Require non-nullcatchClause
- Null indicates an empty catch blockfinallyClause
- Null indicates an empty finally blockjava.lang.IllegalArgumentException
- if parameter is null@Deprecated public abstract SourceTryStatement createTryCatchFinallyStatement(SourceBlockStatement tryClause, SourceFormalParameterList parameters, SourceBlockStatement catchClause, SourceBlockStatement finallyClause)
tryClause
- Null indicates an empty try blockparameters
- Require non-nullcatchClause
- Null indicates an empty catch blockfinallyClause
- Null indicates an empty finally blockjava.lang.IllegalArgumentException
- if parameters is nullpublic abstract SourceTryStatement createTryCatchFinallyStatement(SourceBlockStatement tryClause, SourceCatchParameter parameter, SourceBlockStatement catchClause, SourceBlockStatement finallyClause)
tryClause
- Null indicates an empty try blockparameter
- Require non-nullcatchClause
- Null indicates an empty catch blockfinallyClause
- Null indicates an empty finally blockjava.lang.IllegalArgumentException
- if parameter is nullpublic abstract SourceTryStatement createTryFinallyStatement(SourceBlockStatement child, SourceBlockStatement finallyClause)
child
- Null indicates an empty try blockfinallyClause
- Null indicates an empty finally block@Deprecated public abstract SourceTryResourcesList createTryResourcesList(SourceLocalVariableDeclaration[] variables)
variables
- The try resource variablesjava.lang.IllegalArgumentException
- if any variable is nullpublic abstract SourceTryResourcesList createTryResourcesList(SourceTryResourcesElement[] elements)
elements
- The try resources elementsjava.lang.IllegalArgumentException
- if any element is nullpublic abstract SourceWhileStatement createWhileStatement(SourceExpression e, SourceStatement child)
e
- Require non-nullchild
- Null creates an empty statement as the clausejava.lang.IllegalArgumentException
- if e is nullpublic abstract SourceStatementLabel createStatementLabel(java.lang.String name)
name
- The name of the label which should be a simple namejava.lang.IllegalArgumentException
- if name is nullpublic abstract SourceSwitchLabel createSwitchCaseLabel(SourceExpression e)
e
- The case label expression, if null the default case will be createdpublic abstract SourceSwitchLabel createSwitchDefaultLabel()
public abstract SourceAnnotationExpression createAnnotationExpression(SourceAnnotation arg)
arg
- Require non-nulljava.lang.IllegalArgumentException
- if arg is nullpublic final SourceListExpression createArgumentList()
createArrayConstant(SourceExpression[])
public final SourceListExpression createArgumentList(SourceExpression arg)
arg
- If null creates an empty argument listcreateArrayConstant(SourceExpression[])
public final SourceListExpression createArgumentList(SourceExpression[] arguments)
arguments
- If null creates an empty argument listjava.lang.IllegalArgumentException
- if any argument is nullcreateArrayConstant(SourceExpression[])
public abstract SourceArrayAccessExpression createArrayAccess(SourceExpression lhs, SourceListExpression dereferences)
lhs
- Require non-nulldereferences
- Requires non-null; can be created with
createArgumentList(SourceExpression[])java.lang.IllegalArgumentException
- if lhs or dereferences is nullcreateArgumentList(SourceExpression[])
public abstract SourceListExpression createArrayConstant(SourceExpression[] operands)
operands
- The operands which cannot be null, and none of the
SourceExpressions in the array can be nulljava.lang.IllegalArgumentException
- if operands is null or if one of
the operands is nullpublic SourceAssignmentExpression createAssignment(int code, java.lang.String lhs, java.lang.String rhs)
code
- The simple assignment is JavaOperators.OPT_ASG
.
For a complete list of valid values, check the
JavaConstants.opt2srcTable array for SRC_EXPR_ASSIGNMENTlhs
- The left hand side of the assignment which should not be nullrhs
- The right hand side of the assignment which should not be nulljava.lang.IllegalArgumentException
- if lhs or rhs is null, or if code
is not a valid assignment expression codepublic 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_ASSIGNMENTlhs
- The left hand side of the assignment which should not be nullrhs
- The right hand side of the assignment which should not be nulljava.lang.IllegalArgumentException
- if lhs or rhs is null, or if code
is not a valid assignment expression code@Deprecated public final SourceNewClassExpression createClassCreator(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 typearguments
- Null indicates no arguments; can be created
with createArgumentList(SourceExpression[])body
- Non-null indicates an anonymous classjava.lang.IllegalArgumentException
- if type is nullpublic abstract SourceDotExpression createDotReference(SourceExpression lhs, java.lang.String name)
lhs
- Require non-nullname
- Must be a valid simple namejava.lang.IllegalArgumentException
- if lhs is null or name
is not a valid simple namepublic final SourceListExpression createExpressionList()
public final SourceListExpression createExpressionList(SourceExpression argument)
argument
- Null indicates an empty listpublic abstract SourceListExpression createExpressionList(SourceExpression[] arguments)
arguments
- Null indicates an empty list.java.lang.IllegalArgumentException
- if any of the arguments is nullpublic abstract SourceInfixExpression createInfixExpression(int code, SourceExpression lhs, SourceExpression rhs)
code
- For valid values, check the
JavaConstants.opt2srcTable array for SRC_EXPR_INFIXlhs
- The left hand side, should not be nullrhs
- The right hand side, should not be nulljava.lang.IllegalArgumentException
- if lhs or rhs is null or if code
is not a valid infix expression codepublic abstract SourceInfixExpression createInfixExpression(int code, SourceExpression[] operands)
code
- For valid values, check the
JavaConstants.opt2srcTable array for SRC_EXPR_INFIXoperands
- Must have at least two operandsjava.lang.IllegalArgumentException
- if operands or any of its elements
is null or if there are not at least two operands or if code is not
a valid infix expression codepublic final SourceInfixExpression createInstanceof(SourceExpression lhs, SourceTypeReference type)
lhs
- Require non-nulltype
- Require non-nulljava.lang.IllegalArgumentException
- if lhs or type is nullpublic final SourceMethodCallExpression createMethodCall(SourceExpression lhs, java.lang.String name, SourceListExpression arguments)
lhs
- Null indicates the implicit "this" lhsname
- Must be a valid simple namearguments
- Null indicates no arguments; can be created
using createArgumentList(SourceExpression[])java.lang.IllegalArgumentException
- if name is not a valid simple namepublic abstract SourceMethodCallExpression createMethodCall(SourceExpression lhs, SourceTypeArgument[] typeArguments, java.lang.String name, SourceListExpression arguments)
lhs
- Null indicates the implicit "this" lhstypeArguments
- Null indicates no type argumentsname
- Must be a valid simple namearguments
- Null indicates no arguments; can be created
using createArgumentList(SourceExpression[])java.lang.IllegalArgumentException
- if name is not a valid simple name
or if any of the type arguments is nullpublic final SourceNewArrayExpression createNewInitializedArrayExpression(SourceTypeReference type, SourceListExpression arrayconst)
type
- Require non-nullarrayconst
- Must be an array constant created with
createArrayConstant(SourceExpression[])java.lang.IllegalArgumentException
- if type is null or if arrayconst
is not an array constantpublic final SourceNewArrayExpression createNewUninitializedArrayExpression(SourceTypeReference type, SourceListExpression args)
type
- Require non-nullargs
- Must be a list expression, not an array constantjava.lang.IllegalArgumentException
- if type is null or if args
is an array constantprotected abstract SourceNewArrayExpression createNewArrayExpressionImpl(SourceTypeReference type, SourceListExpression list, int requiredListCode)
type
- Require non-nulllist
- Must be a list expression or an array constantrequiredListCode
- Should match the type of listjava.lang.IllegalArgumentException
- if type is null or if the type
of list is not the same as the requiredListCodepublic 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 typearguments
- Null indicates no arguments; can be created
with createArgumentList(SourceExpression[])body
- Non-null indicates an anonymous classjava.lang.IllegalArgumentException
- if type is nullpublic abstract SourceQuestionExpression createQuestionExpression(SourceExpression one, SourceExpression two, SourceExpression three)
one
- The conditional operand, requires non-nulltwo
- The operand executed by the true branch, requires non-nullthree
- The operand executed by the false branch, requires non-nulljava.lang.IllegalArgumentException
- if one or two or three is nullpublic abstract SourceSimpleNameExpression createSimpleNameExpression(java.lang.String name)
name
- Must be a valid simple name, meaning it's not qualified,
suitable for identifier usage. Keywords except 'this' and 'super' are
not allowed, and for 'null', 'true' or 'false' use createExpressionFromText(java.lang.String)
.java.lang.IllegalArgumentException
- if name is not a valid simple name,
or if name is a keyword (except 'this' or 'super') or 'null', 'true', or 'false'.public final SourceTypeExpression createTypeExpression(java.lang.String type)
type
- Requires non-nulljava.lang.IllegalArgumentException
- if type is nullpublic abstract SourceTypeExpression createTypeExpression(SourceTypeReference type)
type
- Requires non-nulljava.lang.IllegalArgumentException
- if type is nullpublic abstract SourceIntersectionTypeExpression createIntersectionTypeExpression(SourceTypeReference[] types)
types
- Require two or more typesjava.lang.IllegalArgumentException
- if types is null, or if there are
not at least 2 types, or if one of the types is nullpublic abstract SourceTypecastExpression createTypecast(SourceTypeReference type, SourceExpression operand)
type
- Require non-nulloperand
- Require non-nulljava.lang.IllegalArgumentException
- if type or operand is nullpublic abstract SourceTypecastExpression createTypecast(SourceTypeReference[] types, SourceExpression operand)
types
- Requires two or more reference typesoperand
- Require non-nulljava.lang.IllegalArgumentException
- if types or operand is null or
if there are not at least 2 types or if one of the types is nullpublic abstract SourceUnaryExpression createUnaryExpression(int code, SourceExpression operand)
code
- One of JavaOperators.OPT_XXX. For valid values, check the
JavaConstants.opt2srcTable array for OPT_XXX values
that correspond to SRC_EXPR_UNARYoperand
- The operand, require non-nulljava.lang.IllegalArgumentException
- if operand is null or if code
is not a valid source unary expression codepublic abstract SourceWrapperExpression createWrapperExpression(SourceExpression operand)
operand
- Require non-nulljava.lang.IllegalArgumentException
- if operand is nullpublic abstract SourceMethodReferenceExpression createMethodReferenceExpression(SourceExpression lhs, SourceTypeArgument[] typeArguments, java.lang.String methodName)
lhs
- The left hand side, either a name or expressiontypeArguments
- Optional array of type argumentsmethodName
- The method namejava.lang.IllegalArgumentException
- if lhs is null or one of the
typeArguments is null or methodName is nullpublic abstract SourceLambdaParameter createLambdaParameter(int modifiers, SourceTypeReference type, java.lang.String name)
modifiers
- The modifiers of the parametertype
- A type if this is a typed formal parameter, or null
if this is an inferred formal parametername
- The name of the parameterpublic abstract SourceLambdaExpression createLambdaExpression(SourceLambdaParameter[] parameters, SourceElement body)
return x -> System.out.println(x); // Commentcreate the lambdaExpression, wrap it in a return statement, add the return statement to a block, create a comment, call
setStartsNewline( false )on that comment, and add the comment to the block as well. To create a lambda expression preceded by a comment, e,g,:
return x -> // Comment System.out.println(x);create the expression for the println, create the lambdaExpression using that 'println' expression, create a comment and add that comment as a child before the 'println' expression in the lambdaExpression.
parameters
- The formal parameters, if null or empty the
lambda expression will be created with empty parenthesesbody
- The body which can either be a SourceBlock or
a SourceExpression, but should not be nulljava.lang.IllegalArgumentException
- if any of the parameters
is null or body is not a block or expressionpublic abstract SourceLambdaExpression createLambdaExpression(java.lang.String[] inferredParameterNames, boolean parenthesizeParameters, SourceElement body)
return x -> System.out.println(x); // Commentcreate the lambdaExpression, wrap it in a return statement, add the return statement to a block, create a comment, call
setStartsNewline( false )on that comment, and add the comment to the block as well. To create a lambda expression preceded by a comment, e,g,:
return x -> // Comment System.out.println(x);create the expression for the println, create the lambdaExpression using that 'println' expression, create a comment and add that comment as a child before the 'println' expression in the lambdaExpression.
inferredParameterNames
- The inferred parameter names, if null or
empty the lambda expression will have no parametersparenthesizeParameters
- If false and there is exactly one
inferredParameterName, the lambda expression will have no parentheses
around the inferredParameter. In all other cases this parameter
is ignored and parentheses are addedbody
- The body which can either be a SourceBlock or
a SourceExpression, but should not be nulljava.lang.IllegalArgumentException
- if any of the inferredParameterNames
is null or body is not a block or expressionpublic abstract SourceLiteralExpression createLiteralExpression(java.lang.Object object)
object
- Which has to be one of several specific Objects (Integer,
Long, Float, Double, Boolean, Character, String) or null (which creates
the null literal expression)public abstract SourceExpression createClassLiteralExpression(java.lang.String fullyQualifiedTypeName)
fullyQualifiedTypeName
- A type name which should not be nulljava.lang.IllegalArgumentException
- if fullyQualifiedTypeName is nullpublic 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-nulljava.lang.IllegalArgumentException
- if text is nullpublic abstract SourceDocTagName createDocTagName(short tag)
tag
- One of JavadocTokens.TAG_XXXjava.lang.IllegalArgumentException
- if tag is less than
JavadocTokens.TAG_base or not less than JavadocTokens.TAG_maxpublic abstract SourceDocTagName createDocTagName(java.lang.String name)
name
- Requires a name starting with '@'java.lang.IllegalArgumentException
- if name is null or doesn't start with '@'public final SourceDocComment createDocComment()
public final SourceDocComment createDocComment(SourceDocDescription description)
description
- May be nullpublic final SourceDocComment createDocComment(SourceDocDescription description, SourceDocBlockTag tag)
description
- May be nulltag
- Null indicates no block tagspublic abstract SourceDocComment createDocComment(SourceDocDescription description, SourceDocBlockTag[] tags)
description
- May be nulltags
- Null indicates no block tagsjava.lang.IllegalArgumentException
- if any tag is nullpublic final SourceDocDescription createDocDescription()
public final SourceDocDescription createDocDescription(SourceDocTextFragment line)
line
- 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 newlinejava.lang.IllegalArgumentException
- if any line but the last one is
not ended with a newline, or if any line is nullpublic 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 or java.util.Mapjava.lang.IllegalArgumentException
- if qualifiedName is nullpublic final SourceDocReference createDocMemberReference(java.lang.String classString, java.lang.String memberName)
classString
- May be null. A simple or qualified
class name in dotted notation, e.g.
String or java.util.MapmemberName
- The simple name identifying the memberjava.lang.IllegalArgumentException
- if memberName is null and
classString is nullpublic final SourceDocReference createDocMethodReference(java.lang.String classString, java.lang.String methodName, java.lang.String[] parameterTypes)
classString
- May be null. A simple or qualified
class name in dotted notation, e.g.
String or java.util.MapmethodName
- The simple name identifying the methodparameterTypes
- An array of names representing
the parameter types. Should be in dotted
notation, e.g. String or int[]java.lang.IllegalArgumentException
- if memberName is null and
classString is null or any of the parameterTypes is nullpublic abstract SourceDocReference createDocParameterReference(java.lang.String parameterName)
parameterName
- Require non-nulljava.lang.IllegalArgumentException
- if parameterName is nullpublic abstract SourceDocReference createDocReference(java.lang.String classString, java.lang.String memberName, java.lang.String[] parameterTypes)
classString
- A simple or qualified
class name in dotted notation, e.g.
String or java.util.MapmemberName
- The simple name identifying the memberparameterTypes
- An array of names representing
the parameter types. Should be in dotted
notation, e.g. String or int[]java.lang.IllegalArgumentException
- if memberName is null and
classString is null or any of the parameterTypes is nullpublic final SourceDocBlockTag createDocBlockTag(SourceDocTagName name)
name
- Require non-nulljava.lang.IllegalArgumentException
- if name is nullpublic final SourceDocBlockTag createDocBlockTag(SourceDocTagName name, SourceDocDescription description)
name
- Require non-nulldescription
- May be nulljava.lang.IllegalArgumentException
- if name is nullpublic final SourceDocBlockTag createDocBlockTag(SourceDocTagName name, SourceDocReference reference, SourceDocDescription description)
name
- Require non-nullreference
- Require non-nulldescription
- May be nulljava.lang.IllegalArgumentException
- if name or reference is nullpublic abstract SourceDocBlockTag createDocBlockTag(SourceDocTagName name, SourceDocReference[] references, SourceDocDescription description)
name
- Require non-nullreferences
- Require non-nulldescription
- May be nulljava.lang.IllegalArgumentException
- if name or references
is null or any reference is nullpublic final SourceDocInlineTag createDocInlineTag(SourceDocTagName name)
name
- Require non-nulljava.lang.IllegalArgumentException
- if name is nullpublic final SourceDocInlineTag createDocInlineTag(SourceDocTagName name, SourceDocDescription description)
name
- Require non-nulldescription
- May be nulljava.lang.IllegalArgumentException
- if name is nullpublic final SourceDocInlineTag createDocInlineTag(SourceDocTagName name, SourceDocReference reference, SourceDocDescription description)
name
- Require non-nullreference
- Require non-nulldescription
- May be nulljava.lang.IllegalArgumentException
- if name or reference is nullpublic abstract SourceDocInlineTag createDocInlineTag(SourceDocTagName name, SourceDocReference[] references, SourceDocDescription description)
name
- Require non-nullreferences
- Require non-nulldescription
- May be nulljava.lang.IllegalArgumentException
- if name or references is null
or if any reference is null