Package com.unboundid.ldap.matchingrules

Class CaseIgnoreStringMatchingRule

java.lang.Object

com.unboundid.ldap.matchingrules.MatchingRule

com.unboundid.ldap.matchingrules.SimpleMatchingRule

com.unboundid.ldap.matchingrules.AcceptAllSimpleMatchingRule

com.unboundid.ldap.matchingrules.CaseIgnoreStringMatchingRule

All Implemented Interfaces:

Serializable

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

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

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	EQUALITY_RULE_NAME	The name for the caseIgnoreMatch equality matching rule.
static final String	EQUALITY_RULE_OID	The OID for the caseIgnoreMatch equality matching rule.
static final String	ORDERING_RULE_NAME	The name for the caseIgnoreOrderingMatch ordering matching rule.
static final String	ORDERING_RULE_OID	The OID for the caseIgnoreOrderingMatch ordering matching rule.
static final String	SUBSTRING_RULE_NAME	The name for the caseIgnoreSubstringsMatch substring matching rule.
static final String	SUBSTRING_RULE_OID	The OID for the caseIgnoreSubstringsMatch substring matching rule.

Fields inherited from class com.unboundid.ldap.matchingrules.MatchingRule

SUBSTRING_TYPE_SUBANY, SUBSTRING_TYPE_SUBFINAL, SUBSTRING_TYPE_SUBINITIAL

Constructor Summary

Constructors

Constructor	Description
CaseIgnoreStringMatchingRule()	Creates a new instance of this case ignore string matching rule.

Method Summary

Modifier and Type	Method	Description
String	getEqualityMatchingRuleName()	Retrieves the name for this matching rule when used to perform equality matching, if appropriate.
String	getEqualityMatchingRuleOID()	Retrieves the OID for this matching rule when used to perform equality matching, if appropriate.
static CaseIgnoreStringMatchingRule	getInstance()	Retrieves a singleton instance of this matching rule.
String	getOrderingMatchingRuleName()	Retrieves the name for this matching rule when used to perform ordering matching, if appropriate.
String	getOrderingMatchingRuleOID()	Retrieves the OID for this matching rule when used to perform ordering matching, if appropriate.
String	getSubstringMatchingRuleName()	Retrieves the name for this matching rule when used to perform substring matching, if appropriate.
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, matchesAnyValue, 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 Details

EQUALITY_RULE_NAME

@NotNull
public static final String EQUALITY_RULE_NAME

The name for the caseIgnoreMatch equality matching rule.

See Also:

• Constant Field Values

EQUALITY_RULE_OID

@NotNull
public static final String EQUALITY_RULE_OID

The OID for the caseIgnoreMatch equality matching rule.

See Also:

• Constant Field Values

ORDERING_RULE_NAME

@NotNull
public static final String ORDERING_RULE_NAME

The name for the caseIgnoreOrderingMatch ordering matching rule.

See Also:

• Constant Field Values

ORDERING_RULE_OID

@NotNull
public static final String ORDERING_RULE_OID

The OID for the caseIgnoreOrderingMatch ordering matching rule.

See Also:

• Constant Field Values

SUBSTRING_RULE_NAME

@NotNull
public static final String SUBSTRING_RULE_NAME

The name for the caseIgnoreSubstringsMatch substring matching rule.

See Also:

• Constant Field Values

SUBSTRING_RULE_OID

@NotNull
public static final String SUBSTRING_RULE_OID

The OID for the caseIgnoreSubstringsMatch substring matching rule.

See Also:

• Constant Field Values

Constructor Details

CaseIgnoreStringMatchingRule

public CaseIgnoreStringMatchingRule()

Creates a new instance of this case ignore string matching rule.

Method Details

getInstance

@NotNull
public static CaseIgnoreStringMatchingRule getInstance()

Retrieves a singleton instance of this matching rule.

Returns:

A singleton instance of this matching rule.

getEqualityMatchingRuleName

@NotNull
public 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

@NotNull
public 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

@NotNull
public 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

@NotNull
public 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

@NotNull
public 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

@NotNull
public 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(@NotNull
 ASN1OctetString value1,
 @NotNull
 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

@NotNull
public ASN1OctetString normalize(@NotNull
 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

@NotNull
public ASN1OctetString normalizeSubstring(@NotNull
 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.