er.extensions.eof.qualifiers

Class ERXPrimaryKeyListQualifier

java.lang.Object

com.webobjects.eocontrol.EOQualifier

com.webobjects.eocontrol.EOKeyValueQualifier

er.extensions.qualifiers.ERXKeyValueQualifier

er.extensions.eof.qualifiers.ERXInQualifier

er.extensions.eof.qualifiers.ERXPrimaryKeyListQualifier

All Implemented Interfaces:

com.webobjects.eocontrol.EOKeyValueArchiving, com.webobjects.eocontrol.EOQualifierEvaluation, com.webobjects.foundation.NSCoding, IERXChainableQualifier, Serializable, Cloneable

public class ERXPrimaryKeyListQualifier
extends ERXInQualifier

The primary key list qualifier is used to generate a qualifier that can be used to filter a result set for a given set of primary keys. Note that this uses the IN expression and as such may not work with some databases.

Given a list of EOs, this generates a query looking like ... t0.ID in (< the list of primary Keys for EOs in the list >) .. this is useful for pre-fetching type uses.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ERXPrimaryKeyListQualifier.Support Support class that listens for EOKeyValueQualifiers that have an isContainedInArray-selector and replaces these with the ERXInQualifier.

Nested classes/interfaces inherited from class er.extensions.eof.qualifiers.ERXInQualifier

ERXInQualifier.InQualifierSQLGenerationSupport

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

com.webobjects.eocontrol.EOQualifier.Comparison, com.webobjects.eocontrol.EOQualifier.ComparisonSupport, com.webobjects.eocontrol.EOQualifier.QualifierVariableSubstitutionException

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

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

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

com.webobjects.eocontrol.EOKeyValueArchiving._NullValueSupport, com.webobjects.eocontrol.EOKeyValueArchiving._NumberSupport, com.webobjects.eocontrol.EOKeyValueArchiving._TimestampSupport, com.webobjects.eocontrol.EOKeyValueArchiving.Awaking, com.webobjects.eocontrol.EOKeyValueArchiving.FinishInitialization

Field Summary

Fields

Modifier and Type	Field and Description
static String	IsContainedInArraySelectorName

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
ERXPrimaryKeyListQualifier(NSArray eos) Constructs a primary key list qualifer for a given set of enterprise objects.
ERXPrimaryKeyListQualifier(String key, NSArray eos) Constructs a primary key list qualifer for a given set of enterprise objects and the primary key attribute name.
ERXPrimaryKeyListQualifier(String key, String foreignKey, NSArray eos) Constructs a primary key list qualifer for a given set of enterprise objects, the primary key attribute name and a foreign key.

Method Summary

Modifier and Type	Method and Description
Object	clone() EOF seems to be wanting to clone qualifiers when they are inside an and-or qualifier without this method, ERXInQualifier is cloned into an EOKeyValueQualifier and the generated SQL is incorrect...
protected static String	primaryKeyNameForObjects(NSArray eos) Calculates the primary key attribute name for an array of enterprise objects.
protected static NSArray	validateObjects(NSArray eos) Simple validation routine used to ensure that the objects being passed in are enterprise objects and have more than one in the array.

Methods inherited from class er.extensions.eof.qualifiers.ERXInQualifier

classForCoder, decodeObject, decodeWithKeyValueUnarchiver, encodeWithCoder, encodeWithKeyValueArchiver, evaluateWithObject, toString, values

Methods inherited from class er.extensions.qualifiers.ERXKeyValueQualifier

and, filter, filtered, first, not, one, or, requiredOne

Methods inherited from class com.webobjects.eocontrol.EOKeyValueQualifier

_accept, addQualifierKeysToSet, equals, key, qualifierWithBindings, selector, validateKeysWithRootClassDescription, value

Methods inherited from class com.webobjects.eocontrol.EOQualifier

_isEmpty, allQualifierKeys, allQualifierOperators, bindingKeys, 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

Field Detail

IsContainedInArraySelectorName

public static final String IsContainedInArraySelectorName

See Also:

Constant Field Values

Constructor Detail

ERXPrimaryKeyListQualifier

public ERXPrimaryKeyListQualifier(NSArray eos)

Constructs a primary key list qualifer for a given set of enterprise objects. For now only use this qualifier if the primary key attribute of your enterprise object is named 'id'.

Parameters:

eos - array of enterprise objects

ERXPrimaryKeyListQualifier

public ERXPrimaryKeyListQualifier(String key,
                                  NSArray eos)

Constructs a primary key list qualifer for a given set of enterprise objects and the primary key attribute name.

Parameters:

key - primary key attribute name

eos - array of enterprise objects

ERXPrimaryKeyListQualifier

public ERXPrimaryKeyListQualifier(String key,
                                  String foreignKey,
                                  NSArray eos)

Constructs a primary key list qualifer for a given set of enterprise objects, the primary key attribute name and a foreign key. This type of qualifier can be useful for prefetching a to-one relationship off of many enterprise objects.

Parameters:

key - primary key attribute name

foreignKey - attribute name.

eos - array of enterprise objects

Method Detail

clone

public Object clone()

Description copied from class: ERXInQualifier

EOF seems to be wanting to clone qualifiers when they are inside an and-or qualifier without this method, ERXInQualifier is cloned into an EOKeyValueQualifier and the generated SQL is incorrect...

Overrides:

clone in class ERXInQualifier

Returns:

cloned primary key list qualifier.

primaryKeyNameForObjects

protected static String primaryKeyNameForObjects(NSArray eos)

Calculates the primary key attribute name for an array of enterprise objects. This method assumes that all the entities of the objects have the same primary key attribute name.

Parameters:

eos - array of enterprise objects

Returns:

primary key name for the enterprise objects in the array.

validateObjects

protected static NSArray validateObjects(NSArray eos)

Simple validation routine used to ensure that the objects being passed in are enterprise objects and have more than one in the array.

Parameters:

eos - array of objects to check

Returns:

the array of objects if they pass the check.