com.unboundid.ldap.matchingrules
Class CaseExactStringMatchingRule

java.lang.Object
  extended by com.unboundid.ldap.matchingrules.MatchingRule
      extended by com.unboundid.ldap.matchingrules.SimpleMatchingRule
          extended by com.unboundid.ldap.matchingrules.AcceptAllSimpleMatchingRule
              extended by com.unboundid.ldap.matchingrules.CaseExactStringMatchingRule
All Implemented Interfaces:
java.io.Serializable

@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class CaseExactStringMatchingRule
extends AcceptAllSimpleMatchingRule

This class provides an implementation of a matching rule that uses case-sensitive matching that also treats multiple consecutive (non-escaped) spaces as a single space.

See Also:
Serialized Form

Field Summary
static java.lang.String EQUALITY_RULE_NAME
          The name for the caseExactMatch equality matching rule.
static java.lang.String EQUALITY_RULE_OID
          The OID for the caseExactMatch equality matching rule.
static java.lang.String ORDERING_RULE_NAME
          The name for the caseExactOrderingMatch ordering matching rule.
static java.lang.String ORDERING_RULE_OID
          The OID for the caseExactOrderingMatch ordering matching rule.
static java.lang.String SUBSTRING_RULE_NAME
          The name for the caseExactSubstringsMatch substring matching rule.
static java.lang.String SUBSTRING_RULE_OID
          The OID for the caseExactSubstringsMatch substring matching rule.
 
Fields inherited from class com.unboundid.ldap.matchingrules.MatchingRule
SUBSTRING_TYPE_SUBANY, SUBSTRING_TYPE_SUBFINAL, SUBSTRING_TYPE_SUBINITIAL
 
Constructor Summary
CaseExactStringMatchingRule()
          Creates a new instance of this case exact string matching rule.
 
Method Summary
 java.lang.String getEqualityMatchingRuleName()
          Retrieves the name for this matching rule when used to perform equality matching, if appropriate.
 java.lang.String getEqualityMatchingRuleOID()
          Retrieves the OID for this matching rule when used to perform equality matching, if appropriate.
static CaseExactStringMatchingRule getInstance()
          Retrieves a singleton instance of this matching rule.
 java.lang.String getOrderingMatchingRuleName()
          Retrieves the name for this matching rule when used to perform ordering matching, if appropriate.
 java.lang.String getOrderingMatchingRuleOID()
          Retrieves the OID for this matching rule when used to perform ordering matching, if appropriate.
 java.lang.String getSubstringMatchingRuleName()
          Retrieves the name for this matching rule when used to perform substring matching, if appropriate.
 java.lang.String getSubstringMatchingRuleOID()
          Retrieves the OID for this matching rule when used to perform substring matching, if appropriate.
 ASN1OctetString normalize(ASN1OctetString value)
          Normalizes the provided value for easier matching.
 ASN1OctetString normalizeSubstring(ASN1OctetString value, byte substringType)
          Normalizes the provided value for use as part of a substring assertion.
 boolean valuesMatch(ASN1OctetString value1, ASN1OctetString value2)
          Indicates whether the provided values are equal to each other, according to the constraints of this matching rule.
 
Methods inherited from class com.unboundid.ldap.matchingrules.AcceptAllSimpleMatchingRule
compareValues, matchesSubstring
 
Methods inherited from class com.unboundid.ldap.matchingrules.MatchingRule
getDefaultEqualityMatchingRule, getDefaultOrderingMatchingRule, getDefaultSubstringMatchingRule, getEqualityMatchingRuleNameOrOID, getOrderingMatchingRuleNameOrOID, getSubstringMatchingRuleNameOrOID, selectEqualityMatchingRule, selectEqualityMatchingRule, selectEqualityMatchingRule, selectMatchingRuleForSyntax, selectOrderingMatchingRule, selectOrderingMatchingRule, selectOrderingMatchingRule, selectSubstringMatchingRule, selectSubstringMatchingRule, selectSubstringMatchingRule
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

EQUALITY_RULE_NAME

public static final java.lang.String EQUALITY_RULE_NAME
The name for the caseExactMatch equality matching rule.

See Also:
Constant Field Values

EQUALITY_RULE_OID

public static final java.lang.String EQUALITY_RULE_OID
The OID for the caseExactMatch equality matching rule.

See Also:
Constant Field Values

ORDERING_RULE_NAME

public static final java.lang.String ORDERING_RULE_NAME
The name for the caseExactOrderingMatch ordering matching rule.

See Also:
Constant Field Values

ORDERING_RULE_OID

public static final java.lang.String ORDERING_RULE_OID
The OID for the caseExactOrderingMatch ordering matching rule.

See Also:
Constant Field Values

SUBSTRING_RULE_NAME

public static final java.lang.String SUBSTRING_RULE_NAME
The name for the caseExactSubstringsMatch substring matching rule.

See Also:
Constant Field Values

SUBSTRING_RULE_OID

public static final java.lang.String SUBSTRING_RULE_OID
The OID for the caseExactSubstringsMatch substring matching rule.

See Also:
Constant Field Values
Constructor Detail

CaseExactStringMatchingRule

public CaseExactStringMatchingRule()
Creates a new instance of this case exact string matching rule.

Method Detail

getInstance

public static CaseExactStringMatchingRule getInstance()
Retrieves a singleton instance of this matching rule.

Returns:
A singleton instance of this matching rule.

getEqualityMatchingRuleName

public java.lang.String getEqualityMatchingRuleName()
Retrieves the name for this matching rule when used to perform equality matching, if appropriate.

Specified by:
getEqualityMatchingRuleName in class MatchingRule
Returns:
The name for this matching rule when used to perform equality matching, or null if this matching rule is not intended to be used for equality matching.

getEqualityMatchingRuleOID

public java.lang.String getEqualityMatchingRuleOID()
Retrieves the OID for this matching rule when used to perform equality matching, if appropriate.

Specified by:
getEqualityMatchingRuleOID in class MatchingRule
Returns:
The OID for this matching rule when used to perform equality matching, or null if this matching rule is not intended to be used for equality matching.

getOrderingMatchingRuleName

public java.lang.String getOrderingMatchingRuleName()
Retrieves the name for this matching rule when used to perform ordering matching, if appropriate.

Specified by:
getOrderingMatchingRuleName in class MatchingRule
Returns:
The name for this matching rule when used to perform ordering matching, or null if this matching rule is not intended to be used for ordering matching.

getOrderingMatchingRuleOID

public java.lang.String getOrderingMatchingRuleOID()
Retrieves the OID for this matching rule when used to perform ordering matching, if appropriate.

Specified by:
getOrderingMatchingRuleOID in class MatchingRule
Returns:
The OID for this matching rule when used to perform ordering matching, or null if this matching rule is not intended to be used for ordering matching.

getSubstringMatchingRuleName

public java.lang.String getSubstringMatchingRuleName()
Retrieves the name for this matching rule when used to perform substring matching, if appropriate.

Specified by:
getSubstringMatchingRuleName in class MatchingRule
Returns:
The name for this matching rule when used to perform substring matching, or null if this matching rule is not intended to be used for substring matching.

getSubstringMatchingRuleOID

public java.lang.String getSubstringMatchingRuleOID()
Retrieves the OID for this matching rule when used to perform substring matching, if appropriate.

Specified by:
getSubstringMatchingRuleOID in class MatchingRule
Returns:
The OID for this matching rule when used to perform substring matching, or null if this matching rule is not intended to be used for substring matching.

valuesMatch

public boolean valuesMatch(ASN1OctetString value1,
                           ASN1OctetString value2)
Indicates whether the provided values are equal to each other, according to the constraints of this matching rule.

Overrides:
valuesMatch in class AcceptAllSimpleMatchingRule
Parameters:
value1 - The first value for which to make the determination.
value2 - The second value for which to make the determination.
Returns:
true if the provided values are considered equal, or false if not.

normalize

public ASN1OctetString normalize(ASN1OctetString value)
Normalizes the provided value for easier matching. This variant of the normalize method is not allowed to throw exceptions.

Specified by:
normalize in class AcceptAllSimpleMatchingRule
Parameters:
value - The value to be normalized.
Returns:
The normalized form of the provided value.

normalizeSubstring

public ASN1OctetString normalizeSubstring(ASN1OctetString value,
                                          byte substringType)
Normalizes the provided value for use as part of a substring assertion. This variant of the normalizeSubstring method is not allowed to throw exceptions.

Specified by:
normalizeSubstring in class AcceptAllSimpleMatchingRule
Parameters:
value - The value to be normalized for use as part of a substring assertion.
substringType - The substring assertion component type for the provided value. It should be one of SUBSTRING_TYPE_SUBINITIAL, SUBSTRING_TYPE_SUBANY, or SUBSTRING_TYPE_SUBFINAL.
Returns:
The normalized form of the provided value.