|
 |
|
|
org.eclipse.core.resources
Interface ICommand
-
public interface ICommand
A builder command names a builder and supplies a table of
name-value argument pairs.
Changes to a command will only take effect if the modified command is installed
into a project description via
IProjectDescription.setBuildSpec(ICommand[]) .
-
See Also:
-
IProjectDescription
-
Restriction:
- This interface is not intended to be implemented by clients.
-
Restriction:
- This interface is not intended to be extended by clients.
Method Summary
|
Map
|
getArguments
()
Returns a table of the arguments for this command, or null
if there are no arguments. |
String
|
getBuilderName
()
Returns the name of the builder to run for this command, or
null if the name has not been set. |
boolean
|
isBuilding
(int kind)
Returns whether this build command responds to the given kind of build. |
boolean
|
isConfigurable
()
Returns whether this command allows configuring of what kinds of builds
it responds to. |
void
|
setArguments
(
Map args)
Sets this command's arguments to be the given table of name-values
pairs, or to null if there are no arguments. |
void
|
setBuilderName
(
String builderName)
Sets the name of the builder to run for this command. |
void
|
setBuilding
(int kind,
boolean value)
Specifies whether this build command responds to the provided kind of build. |
getArguments
Map getArguments()
- Returns a table of the arguments for this command, or
null
if there are no arguments. The argument names and values are both strings.
-
-
Returns:
- a table of command arguments (key type :
String
value type : String ), or null
-
See Also:
-
setArguments(Map)
getBuilderName
String getBuilderName()
- Returns the name of the builder to run for this command, or
null if the name has not been set.
-
-
Returns:
- the name of the builder, or
null if not set -
See Also:
-
setBuilderName(String)
isBuilding
boolean isBuilding(int kind)
- Returns whether this build command responds to the given kind of build.
By default, build commands respond to all kinds of builds.
-
-
Parameters:
-
kind - One of the *_BUILD constants defined
on IncrementalProjectBuilder
-
Returns:
-
true if this build command responds to the specified
kind of build, and false otherwise. -
Since:
- 3.1
-
See Also:
-
setBuilding(int, boolean)
isConfigurable
boolean isConfigurable()
- Returns whether this command allows configuring of what kinds of builds
it responds to. By default, commands are only configurable
if the corresponding builder defines the
isConfigurable()
attribute in its builder extension declaration. A command that is not
configurable will always respond to all kinds of builds.
-
-
Returns:
-
true If this command allows configuration of
what kinds of builds it responds to, and false otherwise. -
Since:
- 3.1
-
See Also:
-
setBuilding(int, boolean)
setArguments
void setArguments(
Map args)
- Sets this command's arguments to be the given table of name-values
pairs, or to
null if there are no arguments. The argument
names and values are both strings.
Individual builders specify their argument expectations.
Note that modifications to the arguments of a command
being used in a running builder may affect the run of that builder
but will not affect any subsequent runs. To change a command
permanently you must install the command into the relevant project
build spec using
IProjectDescription.setBuildSpec(ICommand[]) .
-
-
Parameters:
-
args - a table of command arguments (keys and values must
both be of type String ), or null
-
See Also:
-
getArguments()
setBuilderName
void setBuilderName(
String builderName)
- Sets the name of the builder to run for this command.
The builder name comes from the extension that plugs in
to the standard org.eclipse.core.resources.builders
extension point.
-
-
Parameters:
-
builderName - the name of the builder -
See Also:
-
getBuilderName()
setBuilding
void setBuilding(int kind,
boolean value)
- Specifies whether this build command responds to the provided kind of build.
When a command is configured to not respond to a given kind of build, the
builder instance will not be called when a build of that kind is initiated.
This method has no effect if this build command does not allow its
build kinds to be configured.
-
-
Parameters:
-
kind - One of the *_BUILD constants defined
on IncrementalProjectBuilder
-
value - true if this build command responds to the
specified kind of build, and false otherwise. -
Since:
- 3.1
-
See Also:
-
isBuilding(int) ,
isConfigurable() ,
IWorkspace.build(int, IProgressMonitor) ,
IProject.build(int, IProgressMonitor)
Guidelines for using Eclipse APIs.
Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.
|
|
|