Package com.unboundid.ldap.sdk.unboundidds.tasks

Class TaskProperty

java.lang.Object
com.unboundid.ldap.sdk.unboundidds.tasks.TaskProperty
All Implemented Interfaces:
Serializable
@NotMutable @ThreadSafety(level=COMPLETELY_THREADSAFE) public final class TaskProperty extends Object implements Serializable
This class provides information about a property that may be used to schedule a task.
NOTE: This class, and other classes within the com.unboundid.ldap.sdk.unboundidds package structure, are only supported for use against Ping Identity, UnboundID, and Nokia/Alcatel-Lucent 8661 server products. These classes provide support for proprietary functionality or for external specifications that are not considered stable or mature enough to be guaranteed to work in an interoperable way with other types of LDAP servers.

Elements of a task property include:
  • The name of the LDAP attribute used to store values for this property.
  • A user-friendly display name for the property.
  • A user-friendly description for the property.
  • The expected data type for values of the property.
  • An optional set of allowed values for the property. If this is defined, then the property will not be allowed to have any value that is not included in this set.
  • A flag that indicates whether the property is required when scheduling the corresponding type of task.
  • A flag that indicates whether the property is allowed to have multiple values.
  • A flag that indicates whether the property should be considered advanced and therefore may be hidden from users if a simplified interface is to be presented.
See Also:

  • Constructor Summary

    Constructors
    Constructor
    Description
    TaskProperty(String attributeName, String displayName, String description, Class<?> dataType, boolean required, boolean multiValued, boolean advanced)
    Creates a new task property with the provided information.
    TaskProperty(String attributeName, String displayName, String description, Class<?> dataType, boolean required, boolean multiValued, boolean advanced, Object[] allowedValues)
    Creates a new task property with the provided information.

  • Method Summary

    Modifier and Type
    Method
    Description
    Object[]
    getAllowedValues()
    Retrieves the set of values that may be used for this task property.
    String
    getAttributeName()
    Retrieves the name of the LDAP attribute associated with this task property.
    Class<?>
    getDataType()
    Retrieves the data type for this task property, which represents the expected data type for the value(s) of this property.
    String
    getDescription()
    Retrieves the human-readable description for this task property.
    String
    getDisplayName()
    Retrieves the human-readable display name for this task property.
    boolean
    isAdvanced()
    Indicates whether this task property is considered advanced.
    boolean
    isMultiValued()
    Indicates whether this task property is allowed to have multiple values.
    boolean
    isRequired()
    Indicates whether this task property is required to be provided in order to schedule a task.
    String
    toString()
    Retrieves a string representation of this task property.
    void
    toString(StringBuilder buffer)
    Appends a string representation of this task property to the provided buffer.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • TaskProperty

      public TaskProperty(@NotNull String attributeName, @NotNull String displayName, @NotNull String description, @NotNull Class<?> dataType, boolean required, boolean multiValued, boolean advanced)
      Creates a new task property with the provided information.
      Parameters:
      attributeName - The name of the LDAP attribute associated with this task property. It must not be null.
      displayName - The human-readable display name for this task property. It must not be null.
      description - The human-readable description for this task property. It must not be null.
      dataType - A class representing the data type for this property. Allowed data type classes include: Boolean, Date, Long, and String. It must not be null.
      required - Indicates whether this property must be provided when scheduling a task.
      multiValued - Indicates whether this property is allowed to have multiple values.
      advanced - Indicates whether this property may be considered advanced and doesn't necessarily need to be presented to the user. Advanced properties must not be required.

    • TaskProperty

      public TaskProperty(@NotNull String attributeName, @NotNull String displayName, @NotNull String description, @NotNull Class<?> dataType, boolean required, boolean multiValued, boolean advanced, @Nullable Object[] allowedValues)
      Creates a new task property with the provided information.
      Parameters:
      attributeName - The name of the LDAP attribute associated with this task property. It must not be null.
      displayName - The human-readable display name for this task property. It must not be null.
      description - The human-readable description for this task property. It must not be null.
      dataType - A class representing the data type for this property. Allowed data type classes include: Boolean, Date, Long, and String. It must not be null.
      required - Indicates whether this property must be provided when scheduling a task.
      multiValued - Indicates whether this property is allowed to have multiple values.
      advanced - Indicates whether this property may be considered advanced and doesn't necessarily need to be presented to the user. Advanced properties must not be required.
      allowedValues - The set of allowed values for this task property. It may be null if there is not a predefined set of acceptable values. If it is provided, then all values must be objects of the class specified as the data type.

  • Method Details

    • getAttributeName

      @NotNull public String getAttributeName()
      Retrieves the name of the LDAP attribute associated with this task property.
      Returns:
      The name of the LDAP attribute associated with this task property.

    • getDisplayName

      @NotNull public String getDisplayName()
      Retrieves the human-readable display name for this task property.
      Returns:
      The human-readable display name for this task property.

    • getDescription

      @NotNull public String getDescription()
      Retrieves the human-readable description for this task property.
      Returns:
      The human-readable description for this task property.

    • getDataType

      @NotNull public Class<?> getDataType()
      Retrieves the data type for this task property, which represents the expected data type for the value(s) of this property. Supported data types include Boolean, Date, Long, and String.
      Returns:
      The data type for this task property.

    • isRequired

      public boolean isRequired()
      Indicates whether this task property is required to be provided in order to schedule a task.
      Returns:
      true if this task property is required, or false if it is not.

    • isMultiValued

      public boolean isMultiValued()
      Indicates whether this task property is allowed to have multiple values.
      Returns:
      true if this task property is allowed to have multiple values, or false if it may only have a single value.

    • isAdvanced

      public boolean isAdvanced()
      Indicates whether this task property is considered advanced. Advanced properties are not necessarily required to schedule the task and may be hidden from the user if simplicity is desired over flexibility.
      Returns:
      true if this task property is considered advanced, or false if not.

    • getAllowedValues

      @Nullable public Object[] getAllowedValues()
      Retrieves the set of values that may be used for this task property.
      Returns:
      The set of values that may be used for this task property, or null if there is not a predefined set of allowed values.

    • toString

      @NotNull public String toString()
      Retrieves a string representation of this task property.
      Overrides:
      toString in class Object
      Returns:
      A string representation of this task property.

    • toString

      public void toString(@NotNull StringBuilder buffer)
      Appends a string representation of this task property to the provided buffer.
      Parameters:
      buffer - The buffer to which the string representation should be appended.