Interface Connector.Argument

All Superinterfaces:
Serializable
All Known Subinterfaces:
Connector.BooleanArgument, Connector.IntegerArgument, Connector.SelectedArgument, Connector.StringArgument
Enclosing interface:
Connector

public static interface Connector.Argument extends Serializable
Specification for and value of a Connector argument. Will always implement a subinterface of Argument: Connector.StringArgument, Connector.BooleanArgument, Connector.IntegerArgument, or Connector.SelectedArgument.
Since:
1.3
  • Method Summary

    Modifier and Type
    Method
    Description
    Returns a human-readable description of this argument and its purpose.
    boolean
    isValid(String value)
    Performs basic sanity check of argument.
    Returns a short human-readable label for this argument.
    boolean
    Indicates whether the argument must be specified.
    Returns a short, unique identifier for the argument.
    void
    Sets the value of the argument.
    Returns the current value of the argument.
  • Method Details

    • name

      String name()
      Returns a short, unique identifier for the argument. Not intended for exposure to end-user.
      Returns:
      the name of this argument.
    • label

      String label()
      Returns a short human-readable label for this argument.
      Returns:
      a label for this argument
    • description

      String description()
      Returns a human-readable description of this argument and its purpose.
      Returns:
      the description of this argument
    • value

      String value()
      Returns the current value of the argument. Initially, the default value is returned. If the value is currently unspecified, null is returned.
      Returns:
      the current value of the argument.
    • setValue

      void setValue(String value)
      Sets the value of the argument. The value should be checked with isValid(String) before setting it; invalid values will throw an exception when the connection is established - for example, on LaunchingConnector.launch(java.util.Map<java.lang.String, ? extends com.sun.jdi.connect.Connector.Argument>)
    • isValid

      boolean isValid(String value)
      Performs basic sanity check of argument.
      Returns:
      true if the value is valid to be used in setValue(String)
    • mustSpecify

      boolean mustSpecify()
      Indicates whether the argument must be specified. If true, setValue(java.lang.String) must be used to set a non-null value before using this argument in establishing a connection.
      Returns:
      true if the argument must be specified; false otherwise.