Schnittstelle IDOMFactory
- Alle bekannten Implementierungsklassen:
DOMFactory
IDOMCompilationUnit
represents the root of a complete JDOM (that
is, a source file with one of the
Java-like extensions
). Other node types represent fragments of a compilation
unit.
The factory can be used to create empty DFs or it can create DFs from source
strings. All DFs created empty are assigned default values as required, such
that a call to IDOMNode.getContents
will generate a valid source
string. See individual create
methods for details on the default
values supplied. The factory does its best to recognize Java structures in
the source provided. If the factory is completely unable to recognize source
constructs, the factory method returns null
.
Even if a DF is created successfully from source code, it does not guarantee that the source code will compile error free. Similarly, the contents of a DF are not guaranteed to compile error free. However, syntactically correct source code is guaranteed to be recognized and successfully generate a DF. Similarly, if all of the fragments of a JDOM are syntactically correct, the contents of the entire document will be correct too.
The factory does not perform or provide any code formatting. Document fragments created on source strings must be pre-formatted. The JDOM attempts to maintain the formatting of documents as best as possible. For this reason, document fragments created for nodes that are to be strung together should end with a new-line character. Failing to do so will result in a document that has elements strung together on the same line. This is especially important if a source string ends with a // comment. In this case, it would be syntactically incorrect to omit the new line character.
- Siehe auch:
-
Methodenübersicht
Modifizierer und TypMethodeBeschreibungVeraltet.Creates a default type document fragment.Veraltet.Creates and return an empty JDOM.createCompilationUnit
(char[] sourceCode, String name) Veraltet.Creates a JDOM on the given source code.createCompilationUnit
(String sourceCode, String name) Veraltet.Creates a JDOM on the given source code.Veraltet.Creates a default field document fragment.createField
(String sourceCode) Veraltet.Creates a field document fragment on the given source code.Veraltet.Creates an empty import document fragment.createImport
(String sourceCode) Veraltet.Creates an import document fragment on the given source code.Veraltet.Creates an empty initializer document fragment.createInitializer
(String sourceCode) Veraltet.Creates an initializer document fragment from the given source code.Veraltet.Creates a default type document fragment.Veraltet.Creates a default method document fragment.createMethod
(String sourceCode) Veraltet.Creates a method document fragment on the given source code.Veraltet.Creates an empty package document fragment.createPackage
(String sourceCode) Veraltet.Creates a package document fragment on the given source code.Veraltet.Creates a default type document fragment.createType
(String sourceCode) Veraltet.Creates a type document fragment on the given source code.
-
Methodendetails
-
createCompilationUnit
IDOMCompilationUnit createCompilationUnit()Veraltet.Creates and return an empty JDOM. The initial content is an empty string.- Gibt zurück:
- the new compilation unit
-
createCompilationUnit
Veraltet.Creates a JDOM on the given source code. The syntax for the given source code corresponds to CompilationUnit (JLS2 7.3).- Parameter:
sourceCode
- the source code character array, ornull
name
- the name of the compilation unit- Gibt zurück:
- the new compilation unit, or
null
if unable to recognize the source code, or if the source code isnull
-
createCompilationUnit
Veraltet.Creates a JDOM on the given source code. The syntax for the given source code corresponds to CompilationUnit (JLS2 7.3).- Parameter:
sourceCode
- the source code string, ornull
name
- the name of the compilation unit- Gibt zurück:
- the new compilation unit, or
null
if unable to recognize the source code, or if the source code isnull
-
createField
IDOMField createField()Veraltet.Creates a default field document fragment. Initially the field will have default protection, type"Object"
, name"aField"
, no comment, and no initializer.- Gibt zurück:
- the new field
-
createField
Veraltet.Creates a field document fragment on the given source code. The given source string corresponds to FieldDeclaration (JLS2 8.3) and ConstantDeclaration (JLS2 9.3) restricted to a single VariableDeclarator clause.- Parameter:
sourceCode
- the source code- Gibt zurück:
- the new field, or
null
if unable to recognize the source code, if the source code isnull
, or when the source contains more than one VariableDeclarator clause
-
createImport
IDOMImport createImport()Veraltet.Creates an empty import document fragment. Initially the import will have name"java.lang.*"
and be non-static.- Gibt zurück:
- the new import
-
createImport
Veraltet.Creates an import document fragment on the given source code. The syntax for the given source string corresponds to ImportDeclaration (JLS2 7.5).- Parameter:
sourceCode
- the source code- Gibt zurück:
- the new import, or
null
if unable to recognize the source code, or if the source code isnull
-
createInitializer
IDOMInitializer createInitializer()Veraltet.Creates an empty initializer document fragment. Initially the initializer will be static and have no body or comment.- Gibt zurück:
- the new initializer
-
createInitializer
Veraltet.Creates an initializer document fragment from the given source code. The syntax for the given source string corresponds to InstanceInitializer (JLS2 8.6) and StaticDeclaration (JLS2 8.7).- Parameter:
sourceCode
- the source code- Gibt zurück:
- the new initializer, or
null
if unable to recognize the source code, or if the source code isnull
-
createMethod
IDOMMethod createMethod()Veraltet.Creates a default method document fragment. Initially the method will have public visibility, return type"void"
, be named"newMethod"
, have no parameters, no comment, and an empty body.- Gibt zurück:
- the new method
-
createMethod
Veraltet.Creates a method document fragment on the given source code. The syntax for the given source string corresponds to MethodDeclaration (JLS2 8.4), ConstructorDeclaration (JLS2 8.8), and AbstractMethodDeclaration (JLS2 9.4).- Parameter:
sourceCode
- the source code- Gibt zurück:
- the new method, or
null
if unable to recognize the source code, or if the source code isnull
-
createPackage
IDOMPackage createPackage()Veraltet.Creates an empty package document fragment. Initially the package declaration will have no name.- Gibt zurück:
- the new package
-
createPackage
Veraltet.Creates a package document fragment on the given source code. The syntax for the given source string corresponds to PackageDeclaration (JLS2 7.4).- Parameter:
sourceCode
- the source code- Gibt zurück:
- the new package, or
null
if unable to recognize the source code, or if the source code isnull
-
createType
IDOMType createType()Veraltet.Creates a default type document fragment. Initially the type will be a public class named"AClass"
, with no members or comment.- Gibt zurück:
- the new type
-
createClass
IDOMType createClass()Veraltet.Creates a default type document fragment. Initially the type will be a public class named"AClass"
, with no members or comment.- Gibt zurück:
- the new class
- Seit:
- 2.0
-
createInterface
IDOMType createInterface()Veraltet.Creates a default type document fragment. Initially the type will be a public interface named"AnInterface"
, with no members or comment.- Gibt zurück:
- the new interface
- Seit:
- 2.0
-
createType
Veraltet.Creates a type document fragment on the given source code. The syntax for the given source string corresponds to ClassDeclaration (JLS2 8.1) and InterfaceDeclaration (JLS2 9.1).- Parameter:
sourceCode
- the source code- Gibt zurück:
- the new type, or
null
if unable to recognize the source code, or if the source code isnull
-