er.extensions.qualifiers

Class ERXKeyValueQualifier

java.lang.Object

com.webobjects.eocontrol.EOQualifier

com.webobjects.eocontrol.EOKeyValueQualifier

er.extensions.qualifiers.ERXKeyValueQualifier

All Implemented Interfaces:

EOKeyValueArchiving, EOQualifierEvaluation, NSCoding, IERXChainableQualifier, Serializable

Direct Known Subclasses:

ERXBetweenQualifier, ERXInQualifier, ERXQuicksilverQualifier, ERXRegExQualifier, ERXToManyQualifier

public class ERXKeyValueQualifier
extends EOKeyValueQualifier
implements IERXChainableQualifier

ERXKeyValueQualifier is a chainable extension of EOKeyValueQualifier.

See Also:

Serialized Form

Author:

mschrag

Nested Class Summary

Nested classes/interfaces inherited from class com.webobjects.eocontrol.EOQualifier

EOQualifier.Comparison, EOQualifier.ComparisonSupport, EOQualifier.QualifierVariableSubstitutionException

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSCoding

NSCoding._BigDecimalSupport, NSCoding._BigIntegerSupport, NSCoding._BooleanSupport, NSCoding._ByteSupport, NSCoding._CharacterSupport, NSCoding._DateSupport, NSCoding._DoubleSupport, NSCoding._FloatSupport, NSCoding._IntegerSupport, NSCoding._LongSupport, NSCoding._NumberSupport, NSCoding._ShortSupport, NSCoding._StringSupport, NSCoding.Support

Nested classes/interfaces inherited from interface com.webobjects.eocontrol.EOKeyValueArchiving

EOKeyValueArchiving._NullValueSupport, EOKeyValueArchiving._NumberSupport, EOKeyValueArchiving._TimestampSupport, EOKeyValueArchiving.Awaking, EOKeyValueArchiving.FinishInitialization, EOKeyValueArchiving.Support

Field Summary

Fields inherited from class com.webobjects.eocontrol.EOKeyValueQualifier

_CLASS, _key, _lowercaseCache, _selector, _value

Fields inherited from class com.webobjects.eocontrol.EOQualifier

QualifierOperatorCaseInsensitiveLike, QualifierOperatorContains, QualifierOperatorEqual, QualifierOperatorGreaterThan, QualifierOperatorGreaterThanOrEqualTo, QualifierOperatorLessThan, QualifierOperatorLessThanOrEqualTo, QualifierOperatorLike, QualifierOperatorNotEqual

Constructor Summary

Constructors

Constructor and Description
ERXKeyValueQualifier(String key, NSSelector selector, Object value)

Method Summary

Modifier and Type	Method and Description
ERXAndQualifier	and(EOQualifier... qualifiers) Returns a new qualifier that represents this qualifier and'd to the given list of qualifiers.
boolean	evaluateWithObject(Object object) Overridden to handle case of in-memory evaluation of QualifierOperatorContains selector and a keyPath that has multiple toMany and/or manyToMany-flattened relationships resulting in arrays of arrays rather than an array of discrete objects.
void	filter(NSMutableArray<?> array) Equivalent to EOQualifier.filterArrayWithQualifier(NSMutableArray, EOQualfier)
<T> NSArray<T>	filtered(NSArray<T> array) Equivalent to EOQualifier.filteredArrayWithQualifier(NSArray, EOQualifier)
<T> T	first(NSArray<T> array) Equivalent to EOQualifier.first(NSMutableArray, EOQualfier)
ERXNotQualifier	not() Returns a new qualifier that represents this qualifier not'd.
<T> T	one(NSArray<T> array) Equivalent to EOQualifier.one(NSMutableArray, EOQualfier)
ERXOrQualifier	or(EOQualifier... qualifiers) Returns a new qualifier that represents this qualifier or'd with the given list of qualifiers.
<T> T	requiredOne(NSArray<T> array) Equivalent to EOQualifier.requiredOne(NSArray, EOQualfier)

Methods inherited from class com.webobjects.eocontrol.EOKeyValueQualifier

_accept, addQualifierKeysToSet, classForCoder, decodeObject, decodeWithKeyValueUnarchiver, encodeWithCoder, encodeWithKeyValueArchiver, equals, key, qualifierWithBindings, selector, toString, validateKeysWithRootClassDescription, value

Methods inherited from class com.webobjects.eocontrol.EOQualifier

_isEmpty, allQualifierKeys, allQualifierOperators, bindingKeys, clone, filterArrayWithQualifier, filteredArrayWithQualifier, keyPathForBindingKey, operatorSelectorForSelectorNamed, operatorSelectorForString, qualifierToMatchAllValues, qualifierToMatchAnyValue, qualifierWithQualifierFormat, relationalQualifierOperators, stringForOperatorSelector

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ERXKeyValueQualifier

public ERXKeyValueQualifier(String key,
                            NSSelector selector,
                            Object value)

Method Detail

and

public ERXAndQualifier and(EOQualifier... qualifiers)

Description copied from interface: IERXChainableQualifier

Returns a new qualifier that represents this qualifier and'd to the given list of qualifiers.

Specified by:

and in interface IERXChainableQualifier

Parameters:

qualifiers - the qualifiers to and with this qualifier

Returns:

an ERXAndQualifier

not

public ERXNotQualifier not()

Description copied from interface: IERXChainableQualifier

Returns a new qualifier that represents this qualifier not'd.

Specified by:

not in interface IERXChainableQualifier

Returns:

an ERXNotQualifier

or

public ERXOrQualifier or(EOQualifier... qualifiers)

Description copied from interface: IERXChainableQualifier

Returns a new qualifier that represents this qualifier or'd with the given list of qualifiers.

Specified by:

or in interface IERXChainableQualifier

Parameters:

qualifiers - the qualifiers to or with this qualifier

Returns:

an ERXOrQualifier

filter

public void filter(NSMutableArray<?> array)

Description copied from interface: IERXChainableQualifier

Equivalent to EOQualifier.filterArrayWithQualifier(NSMutableArray, EOQualfier)

Specified by:

filter in interface IERXChainableQualifier

Parameters:

array - the array to filter (in place)

filtered

public <T> NSArray<T> filtered(NSArray<T> array)

Description copied from interface: IERXChainableQualifier

Equivalent to EOQualifier.filteredArrayWithQualifier(NSArray, EOQualifier)

Specified by:

filtered in interface IERXChainableQualifier

Type Parameters:

T - the type of the array

Parameters:

array - the array to filter

Returns:

the filtered array

first

public <T> T first(NSArray<T> array)

Description copied from interface: IERXChainableQualifier

Equivalent to EOQualifier.first(NSMutableArray, EOQualfier)

Specified by:

first in interface IERXChainableQualifier

Type Parameters:

T - the type of the array

Parameters:

array - the array to filter (in place)

Returns:

the first matching object or null

one

public <T> T one(NSArray<T> array)

Description copied from interface: IERXChainableQualifier

Equivalent to EOQualifier.one(NSMutableArray, EOQualfier)

Specified by:

one in interface IERXChainableQualifier

Type Parameters:

T - the type of the array

Parameters:

array - the array to filter (in place)

Returns:

one matching object or null

requiredOne

public <T> T requiredOne(NSArray<T> array)

Description copied from interface: IERXChainableQualifier

Equivalent to EOQualifier.requiredOne(NSArray, EOQualfier)

Specified by:

requiredOne in interface IERXChainableQualifier

Type Parameters:

T - the type of the array

Parameters:

array - the array to filter (in place)

Returns:

one matching object

evaluateWithObject

public boolean evaluateWithObject(Object object)

Overridden to handle case of in-memory evaluation of QualifierOperatorContains selector and a keyPath that has multiple toMany and/or manyToMany-flattened relationships resulting in arrays of arrays rather than an array of discrete objects. In that case the object is evaluated against a flattened array which gives the same result as SQL evaluation. Since legacy code may depend on workarounds to the incorrect behavior, this patch can be disabled by setting the property er.extensions.ERXKeyValueQualifier.Contains.flatten to false

Specified by:

evaluateWithObject in interface EOQualifierEvaluation

Overrides:

evaluateWithObject in class EOKeyValueQualifier