Environment (Spoon Core 8.4.0-SNAPSHOT API)

All Known Implementing Classes:

StandardEnvironment
```
public interface Environment
```
This interface represents the environment in which Spoon is launched - accessible through Factory.getEnvironment(). Its primary use is to report messages, warnings, and errors.

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`Environment.PRETTY_PRINTING_MODE` Drives how the model is pretty-printed to disk, or when `CtElement.prettyprint()` is called

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`boolean`	`checksAreSkipped()` Tells whether Spoon does no checks at all.
`PrettyPrinter`	`createPrettyPrinter()`
`PrettyPrinter`	`createPrettyPrinterAutoImport()`
`void`	`debugMessage(java.lang.String message)` Logs a debug message
`void`	`disableConsistencyChecks()` Disable all consistency checks on the AST.
`java.lang.String`	`getBinaryOutputDirectory()` Set the directory where binary .class files are created
`int`	`getComplianceLevel()` Gets the Java version compliance level.
`CompressionType`	`getCompressionType()` Get the type of serialization to be used by default
`FileGenerator<? extends CtElement>`	`getDefaultFileGenerator()` Returns the default file generator for this environment (gives the default output directory for the created files).
`java.nio.charset.Charset`	`getEncoding()` Get the encoding used inside the project
`EncodingProvider`	`getEncodingProvider()` Get encoding provider, which is used to detect encoding for each file separately
`int`	`getErrorCount()` Gets the error count from building, processing, and compiling within this environment.
`java.lang.ClassLoader`	`getInputClassLoader()` Returns the `ClassLoader` which is used by JDT and to resolve classes from references.
`org.slf4j.event.Level`	`getLevel()` Gets the level of loggers asked by the user.
`ProcessingManager`	`getManager()` Gets the processing manager.
`FineModelChangeListener`	`getModelChangeListener()` get the model change listener that is used to follow the change of the AST.
`boolean`	`getNoClasspath()` Returns the value ot the option noclasspath
`OutputDestinationHandler`	`getOutputDestinationHandler()` Returns the output destination that handles where source files are written
`OutputType`	`getOutputType()` Get the output type
`Environment.PRETTY_PRINTING_MODE`	`getPrettyPrintingMode()`
`ProcessorProperties`	`getProcessorProperties(java.lang.String processorName)` Returns the properties for a given processor.
`java.lang.String[]`	`getSourceClasspath()` Returns the source class path of the Spoon model.
`java.io.File`	`getSourceOutputDirectory()` Returns the directory where source files are written
`SpoonProgress`	`getSpoonProgress()` Get the spoonProgress logger.
`int`	`getTabulationSize()` Gets the size of the tabulations in the generated source code.
`int`	`getWarningCount()` Gets the warning count from building, processing, and compiling within this environment.
`boolean`	`isAutoImports()` Returns true is we let Spoon handle imports
`boolean`	`isCommentsEnabled()` Returns the value of the option enable-comments.
`boolean`	`isCopyResources()` Returns the value of the option copy-resources.
`boolean`	`isIgnoreDuplicateDeclarations()`
`boolean`	`isPreserveLineNumbers()` Tells if the source generator will try to preserve the original line numbers.
`boolean`	`isPreviewFeaturesEnabled()` Returns true if preview language features are enabled.
`boolean`	`isProcessingStopped()` Tells if the processing is stopped, generally because one of the processors called `setProcessingStopped(boolean)` after reporting an error.
`boolean`	`isUsingTabulations()` Tells if Spoon uses tabulations in the source code.
`void`	`report(Processor<?> processor, org.slf4j.event.Level level, CtElement element, java.lang.String message)` Helper method called by a processor to report an error, warning or message as dictated by the severity parameter.
`void`	`report(Processor<?> processor, org.slf4j.event.Level level, java.lang.String message)` This method should be called to print out a message during the processing.
`void`	`reportEnd()` This method should be called to report the end of the processing.
`void`	`reportProgressMessage(java.lang.String message)` This method should be called to print out a progress message during the processing.
`void`	`setAutoImports(boolean autoImports)` Tell to the Java printer to automatically generate imports and use simple names instead of fully-qualified name.
`void`	`setBinaryOutputDirectory(java.lang.String directory)` Return the directory where binary .class files are created
`void`	`setCommentEnabled(boolean commentEnabled)` Sets the option enable-comments to parse comments of the target project.
`void`	`setComplianceLevel(int level)` Sets the Java version compliance level.
`void`	`setCompressionType(CompressionType serializationType)` Set the type of serialization to be used by default
`void`	`setCopyResources(boolean copyResources)` Sets the option copy-resources to copy all resources in a project on the folder destination.
`void`	`setDefaultFileGenerator(FileGenerator<? extends CtElement> generator)` Sets the default file generator for this environment.
`void`	`setEncoding(java.nio.charset.Charset encoding)` Set the encoding to use for parsing source code
`void`	`setEncodingProvider(EncodingProvider encodingProvider)` Set encoding provider, which is used to detect encoding for each file separately
`void`	`setIgnoreDuplicateDeclarations(boolean ignoreDuplicateDeclarations)`
`void`	`setInputClassLoader(java.lang.ClassLoader classLoader)` Sets a specific classloader for JDT and reference resolution
`void`	`setLevel(java.lang.String level)` Sets the level of loggers asked by the user.
`void`	`setManager(ProcessingManager manager)` Sets the processing manager of this environment.
`void`	`setModelChangeListener(FineModelChangeListener modelChangeListener)` set the model change listener
`void`	`setNoClasspath(boolean option)` Sets the option "noclasspath", use with caution (see explanation below).
`void`	`setOutputDestinationHandler(OutputDestinationHandler outputDestinationHandler)` Set the output destination that handles where source files are written
`void`	`setOutputType(OutputType outputType)` Set the output type used for processing files
`void`	`setPreserveLineNumbers(boolean preserveLineNumbers)` When set, the generated source code will try to generate code that preserves the line numbers of the original source code.
`void`	`setPrettyPrinterCreator(java.util.function.Supplier<PrettyPrinter> creator)`
`void`	`setPrettyPrintingMode(Environment.PRETTY_PRINTING_MODE prettyPrintingMode)`
`void`	`setPreviewFeaturesEnabled(boolean enabled)` Set to true to enable latest preview language features.
`void`	`setProcessingStopped(boolean processingStopped)` This method can be called to stop the processing and all the remaining tasks.
`void`	`setProcessorProperties(java.lang.String processorName, ProcessorProperties prop)` Sets the properties for a given processor.
`void`	`setShouldCompile(boolean shouldCompile)` Sets the compile argument.
`void`	`setSourceClasspath(java.lang.String[] sourceClasspath)` Sets the source class path of the Spoon model.
`void`	`setSourceOutputDirectory(java.io.File directory)` Sets the directory where source files are written
`void`	`setSpoonProgress(SpoonProgress spoonProgress)`
`void`	`setTabulationSize(int size)` Sets the size of the tabulations in the generated source code.
`boolean`	`shouldCompile()` Checks if we want compile the target source code and get their binary.
`void`	`useTabulations(boolean b)` Sets Spoon to use tabulations in the source code.

- Method Detail
  - getComplianceLevel
```
int getComplianceLevel()
```
    Gets the Java version compliance level.
  - setComplianceLevel
```
void setComplianceLevel(int level)
```
    Sets the Java version compliance level.
  - isPreviewFeaturesEnabled
```
boolean isPreviewFeaturesEnabled()
```
    Returns true if preview language features are enabled.
  - setPreviewFeaturesEnabled
```
void setPreviewFeaturesEnabled(boolean enabled)
```
    Set to true to enable latest preview language features. Note: compliance level should be set to the latest.
  - getPrettyPrintingMode
```
Environment.PRETTY_PRINTING_MODE getPrettyPrintingMode()
```
    Returns:
    
    the kind of pretty-printing expected. most robust: Environment.PRETTY_PRINTING_MODE.DEBUG most sophisticated: Environment.PRETTY_PRINTING_MODE.AUTOIMPORT
  - setPrettyPrintingMode
```
void setPrettyPrintingMode(Environment.PRETTY_PRINTING_MODE prettyPrintingMode)
```
  - debugMessage
```
void debugMessage(java.lang.String message)
```
    Logs a debug message
  - getDefaultFileGenerator
```
FileGenerator<? extends CtElement> getDefaultFileGenerator()
```
    Returns the default file generator for this environment (gives the default output directory for the created files).
  - getManager
```
ProcessingManager getManager()
```
    Gets the processing manager.
  - getProcessorProperties
```
ProcessorProperties getProcessorProperties(java.lang.String processorName)
```
    Returns the properties for a given processor.
  - setProcessorProperties
```
void setProcessorProperties(java.lang.String processorName,
                            ProcessorProperties prop)
```
    Sets the properties for a given processor.
  - isAutoImports
```
boolean isAutoImports()
```
    Returns true is we let Spoon handle imports
  - isProcessingStopped
```
boolean isProcessingStopped()
```
    Tells if the processing is stopped, generally because one of the processors called setProcessingStopped(boolean) after reporting an error.
  - report
```
void report(Processor<?> processor,
            org.slf4j.event.Level level,
            CtElement element,
            java.lang.String message)
```
    Helper method called by a processor to report an error, warning or message as dictated by the severity parameter. Note that this does not stop the processing or any remaining task. To do so, use setProcessingStopped(boolean).
    
    Parameters:
    
    processor - The processor that report this message. Can be null.
    
    level - The level of the report
    
    element - The CtElement to which the report is associated
    
    message - The message to report
  - report
```
void report(Processor<?> processor,
            org.slf4j.event.Level level,
            java.lang.String message)
```
    This method should be called to print out a message during the processing.
    
    Parameters:
    
    processor - The processor that report this message. Can be null.
    
    level - The level of the report
    
    message - The message to report
  - reportEnd
```
void reportEnd()
```
    This method should be called to report the end of the processing.
  - reportProgressMessage
```
void reportProgressMessage(java.lang.String message)
```
    This method should be called to print out a progress message during the processing. On contrary to regular messages, progress messages are not meant to remain in the message logs and just indicate to the user some task progression information.
  - setDefaultFileGenerator
```
void setDefaultFileGenerator(FileGenerator<? extends CtElement> generator)
```
    Sets the default file generator for this environment.
  - setManager
```
void setManager(ProcessingManager manager)
```
    Sets the processing manager of this environment.
  - setProcessingStopped
```
void setProcessingStopped(boolean processingStopped)
```
    This method can be called to stop the processing and all the remaining tasks. In general, a processor calls it after reporting a fatal error.
  - getTabulationSize
```
int getTabulationSize()
```
    Gets the size of the tabulations in the generated source code.
  - setTabulationSize
```
void setTabulationSize(int size)
```
    Sets the size of the tabulations in the generated source code.
  - isUsingTabulations
```
boolean isUsingTabulations()
```
    Tells if Spoon uses tabulations in the source code.
  - useTabulations
```
void useTabulations(boolean b)
```
    Sets Spoon to use tabulations in the source code.
  - setAutoImports
```
void setAutoImports(boolean autoImports)
```
    Tell to the Java printer to automatically generate imports and use simple names instead of fully-qualified name.
  - getErrorCount
```
int getErrorCount()
```
    Gets the error count from building, processing, and compiling within this environment.
  - getWarningCount
```
int getWarningCount()
```
    Gets the warning count from building, processing, and compiling within this environment.
  - getInputClassLoader
```
java.lang.ClassLoader getInputClassLoader()
```
    Returns the ClassLoader which is used by JDT and to resolve classes from references. By default, returns a class loader able to load classes from the Spoon-specific class path set with setSourceClasspath(String[])
  - setInputClassLoader
```
void setInputClassLoader(java.lang.ClassLoader classLoader)
```
    Sets a specific classloader for JDT and reference resolution
  - setPreserveLineNumbers
```
void setPreserveLineNumbers(boolean preserveLineNumbers)
```
    When set, the generated source code will try to generate code that preserves the line numbers of the original source code. This option may lead to difficult-to-read indentation and formatting.
  - isPreserveLineNumbers
```
boolean isPreserveLineNumbers()
```
    Tells if the source generator will try to preserve the original line numbers.
  - getSourceClasspath
```
java.lang.String[] getSourceClasspath()
```
    Returns the source class path of the Spoon model. This class path is used when the SpoonCompiler is building the model and also to find external classes, referenced from within the model.
  - setSourceClasspath
```
void setSourceClasspath(java.lang.String[] sourceClasspath)
```
    Sets the source class path of the Spoon model. After the class path is set, it can be retrieved by getSourceClasspath(). Only .jar files or directories with *.class files are accepted. The *.jar or *.java files contained in given directories are ignored.
    
    Throws:
    
    InvalidClassPathException - if a given classpath does not exists or does not have the right format (.jar file or directory)
  - setNoClasspath
```
void setNoClasspath(boolean option)
```
    Sets the option "noclasspath", use with caution (see explanation below). With this option, Spoon does not require the full classpath to build the model. In this case, all references to classes that are not in the classpath are handled with the reference mechanism. The "simplename" of the reference object refers to the unbound identifier. This option facilitates the use of Spoon when is is hard to have the complete and correct classpath, for example for mining software repositories. For writing analyses, this option works well if you don't cross the reference by a call to getDeclaration() (if you really want to do so, then check for nullness of the result before). In normal mode, compilation errors are signaled as exception, with this option enabled they are signaled as message only. The reason is that in most cases, there are necessarily errors related to the missing classpath elements.
  - getNoClasspath
```
boolean getNoClasspath()
```
    Returns the value ot the option noclasspath
  - isCopyResources
```
boolean isCopyResources()
```
    Returns the value of the option copy-resources.
  - setCopyResources
```
void setCopyResources(boolean copyResources)
```
    Sets the option copy-resources to copy all resources in a project on the folder destination.
  - isCommentsEnabled
```
boolean isCommentsEnabled()
```
    Returns the value of the option enable-comments.
  - setCommentEnabled
```
void setCommentEnabled(boolean commentEnabled)
```
    Sets the option enable-comments to parse comments of the target project.
  - getLevel
```
org.slf4j.event.Level getLevel()
```
    Gets the level of loggers asked by the user.
  - setLevel
```
void setLevel(java.lang.String level)
```
    Sets the level of loggers asked by the user.
  - shouldCompile
```
boolean shouldCompile()
```
    Checks if we want compile the target source code and get their binary.
  - setShouldCompile
```
void setShouldCompile(boolean shouldCompile)
```
    Sets the compile argument.
  - checksAreSkipped
```
boolean checksAreSkipped()
```
    Tells whether Spoon does no checks at all. - parents are consistent (see AstParentConsistencyChecker) - hashcode violation (see CtElementImpl.equals(Object)) - method violation (see CtType.addMethod(CtMethod)) are active or not. By default all checks are enabled and checksAreSkipped() return false.
  - disableConsistencyChecks
```
void disableConsistencyChecks()
```
    Disable all consistency checks on the AST. Dangerous! The only valid usage of this is to keep full backward-compatibility.
  - setBinaryOutputDirectory
```
void setBinaryOutputDirectory(java.lang.String directory)
```
    Return the directory where binary .class files are created
  - getBinaryOutputDirectory
```
java.lang.String getBinaryOutputDirectory()
```
    Set the directory where binary .class files are created
  - setSourceOutputDirectory
```
void setSourceOutputDirectory(java.io.File directory)
```
    Sets the directory where source files are written
  - getSourceOutputDirectory
```
java.io.File getSourceOutputDirectory()
```
    Returns the directory where source files are written
  - setOutputDestinationHandler
```
void setOutputDestinationHandler(OutputDestinationHandler outputDestinationHandler)
```
    Set the output destination that handles where source files are written
  - getOutputDestinationHandler
```
OutputDestinationHandler getOutputDestinationHandler()
```
    Returns the output destination that handles where source files are written
  - getModelChangeListener
```
FineModelChangeListener getModelChangeListener()
```
    get the model change listener that is used to follow the change of the AST.
  - setModelChangeListener
```
void setModelChangeListener(FineModelChangeListener modelChangeListener)
```
    set the model change listener
  - getEncoding
```
java.nio.charset.Charset getEncoding()
```
    Get the encoding used inside the project
  - getEncodingProvider
```
EncodingProvider getEncodingProvider()
```
    Get encoding provider, which is used to detect encoding for each file separately
  - setEncoding
```
void setEncoding(java.nio.charset.Charset encoding)
```
    Set the encoding to use for parsing source code
  - setEncodingProvider
```
void setEncodingProvider(EncodingProvider encodingProvider)
```
    Set encoding provider, which is used to detect encoding for each file separately
  - setOutputType
```
void setOutputType(OutputType outputType)
```
    Set the output type used for processing files
  - getOutputType
```
OutputType getOutputType()
```
    Get the output type
  - getSpoonProgress
```
SpoonProgress getSpoonProgress()
```
    Get the spoonProgress logger. This method mustn't return null.
    
    Returns:
    
    the spoonProgress
  - setSpoonProgress
```
void setSpoonProgress(SpoonProgress spoonProgress)
```
  - getCompressionType
```
CompressionType getCompressionType()
```
    Get the type of serialization to be used by default
  - setCompressionType
```
void setCompressionType(CompressionType serializationType)
```
    Set the type of serialization to be used by default
  - createPrettyPrinter
```
PrettyPrinter createPrettyPrinter()
```
    Returns:
    
    new instance of PrettyPrinter which is configured for this environment
  - createPrettyPrinterAutoImport
```
PrettyPrinter createPrettyPrinterAutoImport()
```
    Returns:
    
    new instance of PrettyPrinter which prints nice code
  - setPrettyPrinterCreator
```
void setPrettyPrinterCreator(java.util.function.Supplier<PrettyPrinter> creator)
```
    Parameters:
    
    creator - a Supplier, which creates new instance of pretty printer. Can be used to create a SniperJavaPrettyPrinter for enabling the sniper mode.
  - isIgnoreDuplicateDeclarations
```
boolean isIgnoreDuplicateDeclarations()
```
    Returns:
    
    true if spoon is allowed to create a model of a project that contains multiple times the same class
  - setIgnoreDuplicateDeclarations
```
void setIgnoreDuplicateDeclarations(boolean ignoreDuplicateDeclarations)
```
    Parameters:
    
    ignoreDuplicateDeclarations - (default false) set to true to allow spoon to create a model of a project that contains multiple times the same class

Interface Environment

Nested Class Summary

Method Summary

Method Detail

getComplianceLevel

setComplianceLevel

isPreviewFeaturesEnabled

setPreviewFeaturesEnabled

getPrettyPrintingMode

setPrettyPrintingMode

debugMessage

getDefaultFileGenerator

getManager

getProcessorProperties

setProcessorProperties

isAutoImports

isProcessingStopped

report

report

reportEnd

reportProgressMessage

setDefaultFileGenerator

setManager

setProcessingStopped

getTabulationSize

setTabulationSize

isUsingTabulations

useTabulations

setAutoImports

getErrorCount

getWarningCount

getInputClassLoader

setInputClassLoader

setPreserveLineNumbers

isPreserveLineNumbers

getSourceClasspath

setSourceClasspath

setNoClasspath

getNoClasspath

isCopyResources

setCopyResources

isCommentsEnabled

setCommentEnabled

getLevel

setLevel

shouldCompile

setShouldCompile

checksAreSkipped

disableConsistencyChecks

setBinaryOutputDirectory

getBinaryOutputDirectory

setSourceOutputDirectory

getSourceOutputDirectory

setOutputDestinationHandler

getOutputDestinationHandler

getModelChangeListener

setModelChangeListener

getEncoding

getEncodingProvider

setEncoding

setEncodingProvider

setOutputType

getOutputType

getSpoonProgress

setSpoonProgress

getCompressionType

setCompressionType

createPrettyPrinter

createPrettyPrinterAutoImport

setPrettyPrinterCreator

isIgnoreDuplicateDeclarations

setIgnoreDuplicateDeclarations