Package 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:
Restriction:
This interface is not intended to be implemented by clients.
Restriction:
This interface is not intended to be extended by clients.

  • Method Summary

    Modifier and Type
    Method
    Description
    Map<String,String>
    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<String,String> 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.

  • Method Details

    • getArguments

      Map<String,String> 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:

    • 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:

    • 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:

    • 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:

    • setArguments

      void setArguments(Map<String,String> 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:

    • 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:

    • 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.

      Note:

      • A request for INCREMENTAL_BUILD or AUTO_BUILD will result in the builder being called with the FULL_BUILD kind, if there is no previous delta (e.g. after a clean build).
      • If INCREMENTAL_BUILD (or AUTO_BUILD) is promoted to FULL_BUILD, the builder will be called, if the command responds to INCREMENTAL_BUILD (or AUTO_BUILD).
      • If INCREMENTAL_BUILD is promoted to FULL_BUILD, the builder will be called, if the command responds to FULL_BUILD.
      • If AUTO_BUILD is promoted to FULL_BUILD, the builder will be called, only if the command responds to AUTO_BUILD.
      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: