Package com.intellij.openapi.compiler

Interface CompileContext

All Superinterfaces:

UserDataHolder

All Known Subinterfaces:

CompileContextEx

All Known Implementing Classes:

CompileContextImpl, DummyCompileContext

public interface CompileContext
extends UserDataHolder

An interface allowing access and modification of the data associated with the current compile session.

Method Summary

Modifier and Type	Method and Description
void	addMessage(CompilerMessageCategory category, java.lang.String message, java.lang.String url, int lineNum, int columnNum) Allows to add a message to be shown in Compiler message view.
void	addMessage(CompilerMessageCategory category, java.lang.String message, java.lang.String url, int lineNum, int columnNum, Navigatable navigatable) Allows to add a message to be shown in Compiler message view, with a specified Navigatable that is used to navigate to the error location.
CompileScope	getCompileScope() Returns the current compile scope.
int	getMessageCount(CompilerMessageCategory category) Returns the count of messages of the specified category added during the current compile session.
CompilerMessage []	getMessages(CompilerMessageCategory category) Returns all messages of the specified category added during the current compile session.
Module	getModuleByFile(VirtualFile file) Returns the module to which the specified file belongs.
VirtualFile	getModuleOutputDirectory(Module module) Returns the output directory for the specified module.
VirtualFile	getModuleOutputDirectoryForTests(Module module) Returns the test output directory for the specified module.
ProgressIndicator	getProgressIndicator() Returns the progress indicator of the compilation process.
Project	getProject()
CompileScope	getProjectCompileScope() Returns the compile scope which would be used if the entire project was rebuilt.
java.lang.String	getRebuildReason()
boolean	isAnnotationProcessorsEnabled()
boolean	isAutomake()
boolean	isMake() Checks if the compilation is incremental, i.e.
boolean	isRebuild()
boolean	isRebuildRequested()
void	requestRebuildNextTime(java.lang.String message) A compiler may call this method in order to request complete project rebuild.

Methods inherited from interface com.intellij.openapi.util.UserDataHolder

getUserData, putUserData

Method Detail

addMessage

void addMessage(CompilerMessageCategory category,
                java.lang.String message,
                java.lang.String url,
                int lineNum,
                int columnNum)

Allows to add a message to be shown in Compiler message view. If correct url, line and column numbers are supplied, the navigation to the specified file is available from the view.

Parameters:

category - the category of a message (information, error, warning).

message - the text of the message.

url - a url to the file to which the message applies, null if not available.

lineNum - a line number, -1 if not available.

columnNum - a column number, -1 if not available.

addMessage

void addMessage(CompilerMessageCategory category,
                java.lang.String message,
                java.lang.String url,
                int lineNum,
                int columnNum,
                Navigatable navigatable)

Allows to add a message to be shown in Compiler message view, with a specified Navigatable that is used to navigate to the error location.

Parameters:

category - the category of a message (information, error, warning).

message - the text of the message.

url - a url to the file to which the message applies, null if not available.

lineNum - a line number, -1 if not available.

columnNum - a column number, -1 if not available.

navigatable - the navigatable pointing to the error location.

getMessages

CompilerMessage [] getMessages(CompilerMessageCategory category)

Returns all messages of the specified category added during the current compile session.

Parameters:

category - the category for which messages are requested.

Returns:

all compiler messages of the specified category

getMessageCount

int getMessageCount(CompilerMessageCategory category)

Returns the count of messages of the specified category added during the current compile session.

Parameters:

category - the category for which messages are requested.

Returns:

the number of messages of the specified category

getProgressIndicator

ProgressIndicator getProgressIndicator()

Returns the progress indicator of the compilation process.

Returns:

the progress indicator instance.

getCompileScope

CompileScope getCompileScope()

Returns the current compile scope.

Returns:

current compile scope

getProjectCompileScope

CompileScope getProjectCompileScope()

Returns the compile scope which would be used if the entire project was rebuilt. getCompileScope() may return the scope, that is more narrow than ProjectCompileScope.

Returns:

project-wide compile scope.

requestRebuildNextTime

void requestRebuildNextTime(java.lang.String message)

A compiler may call this method in order to request complete project rebuild. This may be necessary, for example, when compiler caches are corrupted.

isRebuildRequested

boolean isRebuildRequested()

getRebuildReason

java.lang.String getRebuildReason()

getModuleByFile

Module getModuleByFile(VirtualFile file)

Returns the module to which the specified file belongs. This method is aware of the file->module mapping for generated files.

Parameters:

file - the file to check.

Returns:

the module to which the file belongs

getModuleOutputDirectory

VirtualFile getModuleOutputDirectory(Module module)

Returns the output directory for the specified module.

Parameters:

module - the module to check.

Returns:

the output directory for the module specified, null if corresponding VirtualFile is not valid or directory not specified

getModuleOutputDirectoryForTests

VirtualFile getModuleOutputDirectoryForTests(Module module)

Returns the test output directory for the specified module.

Parameters:

module - the module to check.

Returns:

the tests output directory the module specified, null if corresponding VirtualFile is not valid. If in Paths settings output directory for tests is not configured explicitly, but the output path is present, the output path will be returned.

isMake

boolean isMake()

Checks if the compilation is incremental, i.e. triggered by one of "Make" actions.

Returns:

true if compilation is incremental.

isAutomake

boolean isAutomake()

isRebuild

boolean isRebuild()

getProject

Project getProject()

isAnnotationProcessorsEnabled

boolean isAnnotationProcessorsEnabled()