Package com.intellij.execution.junit

Class JUnitConfiguration

java.lang.Object

com.intellij.openapi.util.UserDataHolderBase

com.intellij.execution.configurations.RunConfigurationBase<T>

com.intellij.execution.configurations.LocatableConfigurationBase<T>

com.intellij.execution.configurations.ModuleBasedConfiguration<JavaRunConfigurationModule,Element>

com.intellij.execution.JavaTestConfigurationBase

com.intellij.execution.JavaTestConfigurationWithDiscoverySupport

com.intellij.execution.junit.JUnitConfiguration

All Implemented Interfaces:

CommonJavaRunConfigurationParameters, CommonProgramRunConfigurationParameters, ConfigurationCreationListener, ConfigurationWithAlternativeJre, LocatableConfiguration, ModuleRunConfiguration, ModuleRunProfile, RefactoringListenerProvider, RunConfiguration, RunProfile, RunProfileWithCompileBeforeLaunchOption, SearchScopeProvidingRunProfile, TargetAwareRunProfile, ConfigurationWithCommandLineShortener, InputRedirectAware, TargetEnvironmentAwareRunProfile, SMRunnerConsolePropertiesProvider, UserDataHolder, UserDataHolderEx, java.lang.Cloneable

public class JUnitConfiguration
extends JavaTestConfigurationWithDiscoverySupport
implements InputRedirectAware

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JUnitConfiguration.Data

Nested classes/interfaces inherited from interface com.intellij.execution.InputRedirectAware

InputRedirectAware.InputRedirectOptions, InputRedirectAware.InputRedirectOptionsImpl

Nested classes/interfaces inherited from interface com.intellij.execution.configurations.RunConfiguration

RunConfiguration.RestartSingletonResult

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	ALTERNATIVE_JRE_PATH
boolean	ALTERNATIVE_JRE_PATH_ENABLED
static java.lang.String	BY_SOURCE_CHANGES
static java.lang.String	BY_SOURCE_POSITION
static java.lang.String	FORK_KLASS
static java.lang.String	FORK_METHOD
static java.lang.String	FORK_NONE
static java.lang.String	FORK_REPEAT
static byte	FRAMEWORK_ID
static java.lang.String	JUNIT_START_CLASS
static java.lang.String	TEST_CATEGORY
static java.lang.String	TEST_CLASS
static java.lang.String	TEST_DIRECTORY
static java.lang.String	TEST_METHOD
static java.lang.String	TEST_PACKAGE
static java.lang.String	TEST_PATTERN
static java.lang.String	TEST_TAGS
static java.lang.String	TEST_UNIQUE_ID

Fields inherited from class com.intellij.execution.configurations.ModuleBasedConfiguration

TO_CLONE_ELEMENT_NAME

Fields inherited from interface com.intellij.execution.InputRedirectAware

TYPES_WITH_REDIRECT_AWARE_UI

Fields inherited from interface com.intellij.execution.configurations.RunConfiguration

DATA_KEY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JUnitConfiguration(Project project, JUnitConfiguration.Data data, ConfigurationFactory configurationFactory)
	JUnitConfiguration(java.lang.String name, Project project)
	JUnitConfiguration(java.lang.String name, Project project, ConfigurationFactory configurationFactory)
protected	JUnitConfiguration(java.lang.String name, Project project, JUnitConfiguration.Data data, ConfigurationFactory configurationFactory)

Method Summary

Modifier and Type	Method and Description
void	beClassConfiguration(PsiClass testClass)
void	beFromSourcePosition(PsiLocation<? extends PsiMethod> sourceLocation)
void	beMethodConfiguration(Location<PsiMethod> methodLocation)
void	bePatternConfiguration(java.util.List<PsiClass> classes, PsiMethod method)
void	checkConfiguration() Checks whether the run configuration settings are valid.
boolean	collectOutputFromProcessHandler()
SMTRunnerConsoleProperties	createTestConsoleProperties(Executor executor)
java.lang.String	getActionName() Returns the text of the context menu action to start this run configuration.
java.lang.String	getAlternativeJrePath()
SettingsEditor<? extends RunConfiguration>	getConfigurationEditor() Returns the UI control for editing the run configuration settings.
static java.lang.String	getDefaultPackageName()
java.util.Map<java.lang.String,java.lang.String>	getEnvs()
java.lang.String	getForkMode()
InputRedirectAware.InputRedirectOptions	getInputRedirectOptions()
Module []	getModules()
java.lang.String	getPackage()
JUnitConfiguration.Data	getPersistentData()
java.lang.String	getProgramParameters()
RefactoringElementListener	getRefactoringElementListener(PsiElement element) Returns a listener to handle a rename or move refactoring of the specified PSI element.
int	getRepeatCount()
java.lang.String	getRepeatMode()
java.lang.String	getRunClass()
TestObject	getState(Executor executor, ExecutionEnvironment env) Prepares for executing a specific instance of the run configuration.
byte	getTestFrameworkId()
TestObject	getTestObject()
TestSearchScope	getTestSearchScope()
java.lang.String	getTestType()
java.util.Collection<Module>	getValidModules()
java.lang.String	getVMParameters()
java.lang.String	getWorkingDirectory()
boolean	isAlternativeJrePathEnabled()
boolean	isConfiguredByElement(PsiElement element)
boolean	isPassParentEnvs()
void	readExternal(Element element)
void	setAlternativeJrePath(java.lang.String path)
void	setAlternativeJrePathEnabled(boolean enabled)
void	setCategory(java.lang.String categoryName)
void	setEnvs(java.util.Map<java.lang.String,java.lang.String> envs)
void	setForkMode(java.lang.String forkMode)
void	setMainClass(PsiClass testClass)
void	setPassParentEnvs(boolean passParentEnvs)
void	setProgramParameters(java.lang.String value)
void	setRepeatCount(int repeatCount)
void	setRepeatMode(java.lang.String repeatMode)
void	setSearchScope(TestSearchScope searchScope)
void	setVMParameters(java.lang.String value)
void	setWorkingDirectory(java.lang.String value)
java.lang.String	suggestedName() Returns the default name for the run configuration based on its settings (such as the name of class or file to run).
void	writeExternal(Element element)

Methods inherited from class com.intellij.execution.JavaTestConfigurationBase

canRunOn, getDefaultLanguageRuntimeType, getDefaultTargetName, getShortenCommandLine, isUseModulePath, prepareParameterizedParameter, setDefaultTargetName, setShortenCommandLine, setUseModulePath

Methods inherited from class com.intellij.execution.configurations.ModuleBasedConfiguration

canRestoreOriginalModule, clone, createInstance, getAllModules, getConfigurationModule, getDefaultOptionsClass, getOptions, getState, isModuleDirMacroSupported, loadState, onNewConfigurationCreated, readModule, restoreOriginalModule, setModule, setModuleName, syncModuleName, writeModule

Methods inherited from class com.intellij.execution.configurations.LocatableConfigurationBase

isGeneratedName, setGeneratedName, setNameChangedByUser

Methods inherited from class com.intellij.execution.configurations.RunConfigurationBase

addLogFile, addLogFile, addPredefinedLogFile, checkRunnerSettings, checkSettingsBeforeRun, createAdditionalTabComponents, customizeLogConsole, equals, excludeCompileBeforeLaunchOption, getAllLogFiles, getBeforeRunTasks, getFactory, getIcon, getLogFiles, getName, getOptionsClass, getOptionsForPredefinedLogFile, getOutputFilePath, getPredefinedLogFiles, getProject, hashCode, isAllowRunningInParallel, isNewSerializationUsed, isSaveOutputToFile, isShowConsoleOnStdErr, isShowConsoleOnStdOut, onConfigurationCopied, removeAllLogFiles, removeAllPredefinedLogFiles, setAllowRunningInParallel, setBeforeRunTasks, setFileOutputPath, setName, setOptionsFromConfigurationFile, setSaveOutputToFile, setShowConsoleOnStdErr, setShowConsoleOnStdOut, toString

Methods inherited from class com.intellij.openapi.util.UserDataHolderBase

changeUserMap, clearUserData, copyCopyableDataTo, copyUserDataTo, getCopyableUserData, getUserData, getUserDataString, getUserMap, isUserDataEmpty, putCopyableUserData, putUserData, putUserDataIfAbsent, replace, setUserMap

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.intellij.execution.InputRedirectAware

getInputFile, getInputRedirectOptions

Methods inherited from interface com.intellij.execution.configurations.RunConfiguration

clone, createRunnerSettings, getBeforeRunTasks, getFactory, getId, getPresentableType, getProject, getRunnerSettingsEditor, getType, getUniqueID, hideDisabledExecutorButtons, isAllowRunningInParallel, restartSingleton, setAllowRunningInParallel, setBeforeRunTasks, setName

Methods inherited from interface com.intellij.execution.configurations.RunProfile

getIcon, getName

Methods inherited from interface com.intellij.execution.CommonProgramRunConfigurationParameters

getProject

Methods inherited from interface com.intellij.execution.ConfigurationWithCommandLineShortener

getProject

Methods inherited from interface com.intellij.execution.configurations.ModuleRunProfile

getSearchScope

Methods inherited from interface com.intellij.execution.configurations.RunProfileWithCompileBeforeLaunchOption

isBuildBeforeLaunchAddedByDefault, isBuildProjectOnEmptyModuleList, isExcludeCompileBeforeLaunchOption

Field Detail

FRAMEWORK_ID

public static final byte FRAMEWORK_ID

See Also:

Constant Field Values

TEST_CLASS

public static final java.lang.String TEST_CLASS

See Also:

Constant Field Values

TEST_PACKAGE

public static final java.lang.String TEST_PACKAGE

See Also:

Constant Field Values

TEST_DIRECTORY

public static final java.lang.String TEST_DIRECTORY

See Also:

Constant Field Values

TEST_CATEGORY

public static final java.lang.String TEST_CATEGORY

See Also:

Constant Field Values

TEST_METHOD

public static final java.lang.String TEST_METHOD

See Also:

Constant Field Values

TEST_UNIQUE_ID

public static final java.lang.String TEST_UNIQUE_ID

See Also:

Constant Field Values

TEST_TAGS

public static final java.lang.String TEST_TAGS

See Also:

Constant Field Values

BY_SOURCE_POSITION

public static final java.lang.String BY_SOURCE_POSITION

See Also:

Constant Field Values

BY_SOURCE_CHANGES

public static final java.lang.String BY_SOURCE_CHANGES

See Also:

Constant Field Values

FORK_NONE

public static final java.lang.String FORK_NONE

See Also:

Constant Field Values

FORK_METHOD

public static final java.lang.String FORK_METHOD

See Also:

Constant Field Values

FORK_KLASS

public static final java.lang.String FORK_KLASS

See Also:

Constant Field Values

FORK_REPEAT

public static final java.lang.String FORK_REPEAT

See Also:

Constant Field Values

JUNIT_START_CLASS

public static final java.lang.String JUNIT_START_CLASS

See Also:

Constant Field Values

TEST_PATTERN

public static final java.lang.String TEST_PATTERN

See Also:

Constant Field Values

ALTERNATIVE_JRE_PATH_ENABLED

public boolean ALTERNATIVE_JRE_PATH_ENABLED

ALTERNATIVE_JRE_PATH

public java.lang.String ALTERNATIVE_JRE_PATH

Constructor Detail

JUnitConfiguration

public JUnitConfiguration(java.lang.String name,
                          Project project,
                          ConfigurationFactory configurationFactory)

JUnitConfiguration

public JUnitConfiguration(java.lang.String name,
                          Project project)

JUnitConfiguration

protected JUnitConfiguration(java.lang.String name,
                             Project project,
                             JUnitConfiguration.Data data,
                             ConfigurationFactory configurationFactory)

JUnitConfiguration

protected JUnitConfiguration(Project project,
                             JUnitConfiguration.Data data,
                             ConfigurationFactory configurationFactory)

Method Detail

getState

public TestObject getState(Executor executor,
                           ExecutionEnvironment env)
                    throws ExecutionException

Description copied from interface: RunProfile

Prepares for executing a specific instance of the run configuration.

Specified by:

getState in interface RunProfile

Specified by:

getState in class JavaTestConfigurationBase

Parameters:

executor - the execution mode selected by the user (run, debug, profile etc.)

env - the environment object containing additional settings for executing the configuration.

Returns:

the RunProfileState describing the process which is about to be started, or null if it's impossible to start the process.

Throws:

ExecutionException

getConfigurationEditor

public SettingsEditor<? extends RunConfiguration> getConfigurationEditor()

Description copied from interface: RunConfiguration

Returns the UI control for editing the run configuration settings. If additional control over validation is required, the object returned from this method may also implement CheckableRunConfigurationEditor. The returned object can also implement SettingsEditorGroup if the settings it provides need to be displayed in multiple tabs.

Specified by:

getConfigurationEditor in interface RunConfiguration

Returns:

the settings editor component.

getPersistentData

public JUnitConfiguration.Data getPersistentData()

getRefactoringElementListener

public RefactoringElementListener getRefactoringElementListener(PsiElement element)

Description copied from interface: RefactoringListenerProvider

Returns a listener to handle a rename or move refactoring of the specified PSI element.

Specified by:

getRefactoringElementListener in interface RefactoringListenerProvider

Parameters:

element - the element on which a refactoring was invoked.

Returns:

the listener to handle the refactoring, or null if the run configuration doesn't care about refactoring of this element.

checkConfiguration

public void checkConfiguration()
                        throws RuntimeConfigurationException

Description copied from interface: RunConfiguration

Checks whether the run configuration settings are valid. Note that this check may be invoked on every change (i.e. after each character typed in an input field).

Specified by:

checkConfiguration in interface RunConfiguration

Throws:

RuntimeConfigurationException - if the configuration settings contain a non-fatal problem which the user should be warned about but the execution should still be allowed.

RuntimeConfigurationError - if the configuration settings contain a fatal problem which makes it impossible to execute the run configuration.

getValidModules

public java.util.Collection<Module> getValidModules()

Specified by:

getValidModules in class ModuleBasedConfiguration<JavaRunConfigurationModule,Element>

suggestedName

public java.lang.String suggestedName()

Description copied from interface: LocatableConfiguration

Returns the default name for the run configuration based on its settings (such as the name of class or file to run).

Specified by:

suggestedName in interface LocatableConfiguration

Returns:

the suggested name for the configuration, or null if no name could be suggested based on the current settings (for example, the name of the file to run isn't yet specified). NOTE: Please don't return hard-coded strings which are not based on the current run configuration settings (such as "Unnamed").

getActionName

public java.lang.String getActionName()

Description copied from class: LocatableConfigurationBase

Returns the text of the context menu action to start this run configuration. This can be different from the run configuration name (for example, for a Java unit test method, the context menu shows just the name of the method, whereas the name of the run configuration includes the class name).

Overrides:

getActionName in class LocatableConfigurationBase<Element>

Returns:

the name of the action.

getVMParameters

public java.lang.String getVMParameters()

Specified by:

getVMParameters in interface CommonJavaRunConfigurationParameters

setVMParameters

public void setVMParameters(java.lang.String value)

Specified by:

setVMParameters in interface CommonJavaRunConfigurationParameters

getProgramParameters

public java.lang.String getProgramParameters()

Specified by:

getProgramParameters in interface CommonProgramRunConfigurationParameters

setProgramParameters

public void setProgramParameters(java.lang.String value)

Specified by:

setProgramParameters in interface CommonProgramRunConfigurationParameters

getWorkingDirectory

public java.lang.String getWorkingDirectory()

Specified by:

getWorkingDirectory in interface CommonProgramRunConfigurationParameters

setWorkingDirectory

public void setWorkingDirectory(java.lang.String value)

Specified by:

setWorkingDirectory in interface CommonProgramRunConfigurationParameters

getEnvs

public java.util.Map<java.lang.String,java.lang.String> getEnvs()

Specified by:

getEnvs in interface CommonProgramRunConfigurationParameters

setEnvs

public void setEnvs(java.util.Map<java.lang.String,java.lang.String> envs)

Specified by:

setEnvs in interface CommonProgramRunConfigurationParameters

isPassParentEnvs

public boolean isPassParentEnvs()

Specified by:

isPassParentEnvs in interface CommonProgramRunConfigurationParameters

setPassParentEnvs

public void setPassParentEnvs(boolean passParentEnvs)

Specified by:

setPassParentEnvs in interface CommonProgramRunConfigurationParameters

isAlternativeJrePathEnabled

public boolean isAlternativeJrePathEnabled()

Specified by:

isAlternativeJrePathEnabled in interface CommonJavaRunConfigurationParameters

Specified by:

isAlternativeJrePathEnabled in interface ConfigurationWithAlternativeJre

setAlternativeJrePathEnabled

public void setAlternativeJrePathEnabled(boolean enabled)

Specified by:

setAlternativeJrePathEnabled in interface CommonJavaRunConfigurationParameters

getAlternativeJrePath

public java.lang.String getAlternativeJrePath()

Specified by:

getAlternativeJrePath in interface CommonJavaRunConfigurationParameters

Specified by:

getAlternativeJrePath in interface ConfigurationWithAlternativeJre

setAlternativeJrePath

public void setAlternativeJrePath(java.lang.String path)

Specified by:

setAlternativeJrePath in interface CommonJavaRunConfigurationParameters

getRunClass

public java.lang.String getRunClass()

Specified by:

getRunClass in interface CommonJavaRunConfigurationParameters

getPackage

public java.lang.String getPackage()

Specified by:

getPackage in interface CommonJavaRunConfigurationParameters

beClassConfiguration

public void beClassConfiguration(PsiClass testClass)

Specified by:

beClassConfiguration in class JavaTestConfigurationBase

isConfiguredByElement

public boolean isConfiguredByElement(PsiElement element)

Specified by:

isConfiguredByElement in class JavaTestConfigurationBase

getTestType

public java.lang.String getTestType()

Specified by:

getTestType in class JavaTestConfigurationBase

getTestSearchScope

public TestSearchScope getTestSearchScope()

Specified by:

getTestSearchScope in class JavaTestConfigurationBase

setSearchScope

public void setSearchScope(TestSearchScope searchScope)

Specified by:

setSearchScope in class JavaTestConfigurationBase

beFromSourcePosition

public void beFromSourcePosition(PsiLocation<? extends PsiMethod> sourceLocation)

setMainClass

public void setMainClass(PsiClass testClass)

setCategory

public void setCategory(java.lang.String categoryName)

beMethodConfiguration

public void beMethodConfiguration(Location<PsiMethod> methodLocation)

Specified by:

beMethodConfiguration in class JavaTestConfigurationBase

getModules

public Module [] getModules()

Specified by:

getModules in interface RunProfileWithCompileBeforeLaunchOption

Overrides:

getModules in class ModuleBasedConfiguration<JavaRunConfigurationModule,Element>

Returns:

modules to compile before run. Empty list to build project

getTestObject

public TestObject getTestObject()

getInputRedirectOptions

public InputRedirectAware.InputRedirectOptions getInputRedirectOptions()

Specified by:

getInputRedirectOptions in interface InputRedirectAware

readExternal

public void readExternal(Element element)
                  throws InvalidDataException

Specified by:

readExternal in interface RunConfiguration

Overrides:

readExternal in class JavaTestConfigurationBase

Throws:

InvalidDataException

writeExternal

public void writeExternal(Element element)

Specified by:

writeExternal in interface RunConfiguration

Overrides:

writeExternal in class JavaTestConfigurationBase

getForkMode

public java.lang.String getForkMode()

setForkMode

public void setForkMode(java.lang.String forkMode)

collectOutputFromProcessHandler

public boolean collectOutputFromProcessHandler()

Overrides:

collectOutputFromProcessHandler in class RunConfigurationBase<Element>

bePatternConfiguration

public void bePatternConfiguration(java.util.List<PsiClass> classes,
                                   PsiMethod method)

Specified by:

bePatternConfiguration in class JavaTestConfigurationBase

getRepeatCount

public int getRepeatCount()

setRepeatCount

public void setRepeatCount(int repeatCount)

getRepeatMode

public java.lang.String getRepeatMode()

setRepeatMode

public void setRepeatMode(java.lang.String repeatMode)

createTestConsoleProperties

public SMTRunnerConsoleProperties createTestConsoleProperties(Executor executor)

Specified by:

createTestConsoleProperties in interface SMRunnerConsolePropertiesProvider

getTestFrameworkId

public byte getTestFrameworkId()

Specified by:

getTestFrameworkId in class JavaTestConfigurationWithDiscoverySupport

getDefaultPackageName

public static java.lang.String getDefaultPackageName()