Class Matcher

java.lang.Object
org.forgerock.opendj.ldap.Matcher
public final class Matcher extends Object
A compiled search Filter which may be used for matching against entries.

Compilation may produce an optimized matcher having a different structure to the original filter. In particular, filter components may be simplified, removed, or re-ordered. Equivalent matchers compare equal using equals(Object) and produce the same hashCode().

  • Method Details

    • equals

      public boolean equals(Object obj)
      This method returns true when two filters are equivalent. In particular, the attribute descriptions "cn" and "commonName" will be treated the same, as will AND/OR filters containing the same sub-filters regardless of their order.
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      This method returns the same hash-code for any two equivalent filters. In particular, the attribute descriptions "cn" and "commonName" will be treated the same, as will AND/OR filters containing the same sub-filters regardless of their order.
      Overrides:
      hashCode in class Object

    • getMatcherType

      public Matcher.MatcherType getMatcherType()
      Returns the type of this filter Matcher.
      Returns:
      the type of this filter Matcher

    • getSubMatchers

      public List<Matcher> getSubMatchers()
      Returns an unmodifiable list containing the sub-matchers for this AND or OR filter matcher.
      Returns:
      an unmodifiable list containing the sub-matchers for this AND or OR filter matcher
      Throws:
      UnsupportedOperationException - If this filter Matcher is not an AND or OR filter.

    • getNotSubMatcher

      public Matcher getNotSubMatcher()
      Returns the sub-matcher for this NOT filter matcher.
      Returns:
      the sub-matcher for this NOT filter matcher
      Throws:
      UnsupportedOperationException - If this filter Matcher is not a NOT filter.

    • getAttributeDescription

      public AttributeDescription getAttributeDescription()
      Returns the attribute description for this comparison filter matcher, which may be null if the filter is an extensible match filter specifying an extensible matching rule..
      Returns:
      the attribute description for this comparison filter matcher, which may be null if the filter is an extensible match filter specifying an extensible matching rule
      Throws:
      UnsupportedOperationException - If this filter Matcher is not an equality, greater than, less than, approximate, presence, substrings, or extensible match filter.

    • getAssertion

      public Assertion getAssertion()
      Returns the assertion for this comparison filter matcher.
      Returns:
      the assertion for this comparison filter matcher
      Throws:
      UnsupportedOperationException - If this filter Matcher is not an equality, greater than, less than, approximate, or extensible match filter.

    • getUndefinedReason

      public String getUndefinedReason()
      Returns the diagnostic reasons for this undefined filter matcher.
      Returns:
      the diagnostic reasons for this undefined filter matcher
      Throws:
      UnsupportedOperationException - If this filter Matcher is not an undefined match filter.

    • isDnAttributes

      public boolean isDnAttributes()
      Returns whether extensible matching should be performed against attributes in an entry's DN.
      Returns:
      whether extensible matching should be performed against attributes in an entry's DN
      Throws:
      UnsupportedOperationException - If this filter Matcher is not an extensible match filter.

    • matches

      public ConditionResult matches(Entry entry)
      Indicates whether this filter Matcher matches the provided Entry.
      Parameters:
      entry - The entry to be matched.
      Returns:
      The result of matching the provided Entry against this filter Matcher.

    • toString

      public String toString()
      Overrides:
      toString in class Object