Class ContainsFieldJSONObjectFilter

  • All Implemented Interfaces:
    java.io.Serializable

    @Mutable
    @ThreadSafety(level=NOT_THREADSAFE)
    public final class ContainsFieldJSONObjectFilter
    extends JSONObjectFilter
    This class provides an implementation of a JSON object filter that can be used to identify JSON objects containing a specified field, optionally restricting it by the data type of the value.
    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.

    The fields that are required to be included in a "contains field" filter are:
    • field -- A field path specifier for the JSON field for which to make the determination. This may be either a single string or an array of strings as described in the "Targeting Fields in JSON Objects" section of the class-level documentation for JSONObjectFilter.
    The fields that may optionally be included in a "contains field" filter are:
    • expectedType -- Specifies the expected data type for the value of the target field. If this is not specified, then any data type will be permitted. If this is specified, then the filter will only match a JSON object that contains the specified fieldName if its value has the expected data type. The value of the expectedType field must be either a single string or an array of strings, and the only values allowed will be:
      • boolean -- Indicates that the value may be a Boolean value of true or false.
      • empty-array -- Indicates that the value may be an empty array.
      • non-empty-array -- Indicates that the value may be an array that contains at least one element. There will not be any constraints placed on the values inside of the array.
      • null -- Indicates that the value may be null.
      • number -- Indicates that the value may be a number.
      • object -- Indicates that the value may be a JSON object.
      • string -- Indicates that the value may be a string.

    Examples

    The following is an example of a "contains field" filter that will match any JSON object that includes a top-level field of "department" with any kind of value:
       { "filterType" : "containsField",
         "field" : "department" }
     
    The above filter can be created with the code:
       ContainsFieldJSONObjectFilter filter =
            new ContainsFieldJSONObjectFilter("department");
     


    The following is an example of a "contains field" filter that will match any JSON object with a top-level field of "first" whose value is a JSON object (or an array containing a JSON object) with a field named "second" whose value is a Boolean of either true or false.
       { "filterType" : "containsField",
         "field" : [ "first", "second" ],
         "expectedType" : "boolean" }
     
    The above filter can be created with the code:
       ContainsFieldJSONObjectFilter filter = new ContainsFieldJSONObjectFilter(
            Arrays.asList("first", "second"),
            EnumSet.of(ExpectedValueType.BOOLEAN));
     
    See Also:
    Serialized Form
    • Field Detail

      • FILTER_TYPE

        public static final java.lang.String FILTER_TYPE
        The value that should be used for the filterType element of the JSON object that represents a "contains field" filter.
        See Also:
        Constant Field Values
      • FIELD_FIELD_PATH

        public static final java.lang.String FIELD_FIELD_PATH
        The name of the JSON field that is used to specify the field in the target JSON object for which to make the determination.
        See Also:
        Constant Field Values
      • FIELD_EXPECTED_TYPE

        public static final java.lang.String FIELD_EXPECTED_TYPE
        The name of the JSON field that is used to specify the expected data type for the target field.
        See Also:
        Constant Field Values
    • Constructor Detail

      • ContainsFieldJSONObjectFilter

        public ContainsFieldJSONObjectFilter​(java.lang.String... field)
        Creates a new "contains field" filter that targets the specified field.
        Parameters:
        field - The field path specifier for this filter. It must not be null or empty. See the class-level documentation for the JSONObjectFilter class for information about field path specifiers.
      • ContainsFieldJSONObjectFilter

        public ContainsFieldJSONObjectFilter​(java.util.List<java.lang.String> field)
        Creates a new "contains field" filter that targets the specified field.
        Parameters:
        field - The field path specifier for this filter. It must not be null or empty. See the class-level documentation for the JSONObjectFilter class for information about field path specifiers.
    • Method Detail

      • getField

        public java.util.List<java.lang.String> getField()
        Retrieves the field path specifier for this filter.
        Returns:
        The field path specifier for this filter.
      • setField

        public void setField​(java.lang.String... field)
        Sets the field path specifier for this filter.
        Parameters:
        field - The field path specifier for this filter. It must not be null or empty. See the class-level documentation for the JSONObjectFilter class for information about field path specifiers.
      • setField

        public void setField​(java.util.List<java.lang.String> field)
        Sets the field path specifier for this filter.
        Parameters:
        field - The field path specifier for this filter. It must not be null or empty. See the class-level documentation for the JSONObjectFilter class for information about field path specifiers.
      • getExpectedType

        public java.util.Set<ExpectedValueTypegetExpectedType()
        Retrieves the set of acceptable value types for the specified field.
        Returns:
        The set of acceptable value types for the specified field.
      • setExpectedType

        public void setExpectedType​(ExpectedValueType... expectedTypes)
        Specifies the set of acceptable value types for the specified field.
        Parameters:
        expectedTypes - The set of acceptable value types for the specified field. It may be null or empty if the field may have a value of any type.
      • setExpectedType

        public void setExpectedType​(java.util.Collection<ExpectedValueType> expectedTypes)
        Specifies the set of acceptable value types for the specified field.
        Parameters:
        expectedTypes - The set of acceptable value types for the specified field. It may be null or empty if the field may have a value of any type.
      • getFilterType

        public java.lang.String getFilterType()
        Retrieves the value that must appear in the filterType field for this filter.
        Specified by:
        getFilterType in class JSONObjectFilter
        Returns:
        The value that must appear in the filterType field for this filter.
      • getRequiredFieldNames

        protected java.util.Set<java.lang.String> getRequiredFieldNames()
        Retrieves the names of all fields (excluding the filterType field) that must be present in the JSON object representing a filter of this type.
        Specified by:
        getRequiredFieldNames in class JSONObjectFilter
        Returns:
        The names of all fields (excluding the filterType field) that must be present in the JSON object representing a filter of this type.
      • getOptionalFieldNames

        protected java.util.Set<java.lang.String> getOptionalFieldNames()
        Retrieves the names of all fields that may optionally be present but are not required in the JSON object representing a filter of this type.
        Specified by:
        getOptionalFieldNames in class JSONObjectFilter
        Returns:
        The names of all fields that may optionally be present but are not required in the JSON object representing a filter of this type.
      • matchesJSONObject

        public boolean matchesJSONObject​(JSONObject o)
        Indicates whether this JSON object filter matches the provided JSON object.
        Specified by:
        matchesJSONObject in class JSONObjectFilter
        Parameters:
        o - The JSON object for which to make the determination.
        Returns:
        true if this JSON object filter matches the provided JSON object, or false if not.
      • decodeFilter

        protected ContainsFieldJSONObjectFilter decodeFilter​(JSONObject filterObject)
                                                      throws JSONException
        Decodes the provided JSON object as a filter of this type.
        Specified by:
        decodeFilter in class JSONObjectFilter
        Parameters:
        filterObject - The JSON object to be decoded. The caller will have already validated that all required fields are present, and that it does not have any fields that are neither required nor optional.
        Returns:
        The decoded JSON object filter.
        Throws:
        JSONException - If the provided JSON object cannot be decoded as a valid filter of this type.