PATH Documentation > WebObjects 4.5 > EOControl Reference

EONotQualifier

Inherits from:
(com.apple.client.eocontrol) EOQualifier : Object
(com.apple.yellow.eocontrol) EOQualifier : NSObject

Implements:
EOQualifierEvaluation
(com.apple.client.eocontrol only) NSCoding

Package:
com.apple.client.eocontrol

com.apple.yellow.eocontrol

Class Description

EONotQualifier is a subclass of EOQualifier that contains a single qualifier. When an EONotQualifier object is evaluated, it returns the inverse of the result obtained by evaluating the qualifier it contains.

EONotQualifier implements the EOQualifierEvaluation interface, which defines the method evaluateWithObject for in-memory evaluation. When an EONotQualifier object receives an evaluateWithObject message, it evaluates the given object to determine if it satisfies the qualifier criteria.

You can generate SQL code for an EONotQualifier using the EOSQLExpression static method sqlStringForNegatedQualifier.

Interfaces Implemented

EOQualifierEvaluation
evaluateWithObject

NSCoding (com.apple.client.eocontrol only)
classForCoder

encodeWithCoder

Constructors

EONotQualifier

public com.apple.yellow.eocontrol.EONotQualifier(EOQualifier aQualifier)

Creates and returns a new EONotQualifier

If aQualifier is specified, it is used as the qualifier. For example, the following code excerpt constructs a qualifier, baseQual, and uses it to initialize an EONotQualifier, negQual. The EONotQualifier negQual is then used to filter an in-memory array. The code excerpt returns an array of Guest objects whose lastName properties do not have the same value as the lastName property of the guest's sponsoring member (this example is based on the Rentals sample database). In other words, the EONotQualifier negQual inverts the effects of baseQual.

NSArray guests /* Assume this exists */
EOQualifier baseQual;
EONotQualifier negQual;

baseQual = EOQualifier.qualifierWithQualifierFormat("lastName = member.lastName", null);
negQual = new EONotQualifier(baseQual);
return EOQualifier.filteredArrayWithQualifier(guests, negQual);

Instance Methods

evaluateWithObject

public boolean evaluateWithObject(Object anObject)

Returns true if the object anObject satisfies the EONotQualifier, false otherwise. This method can throw one of several possible exceptions if an error occurs. If your application allows users to construct arbitrary qualifiers (such as through a user interface), you may want to write code to catch any exceptions and respond to errors (for example, by displaying a panel saying that the user typed a poorly formed qualifier).

qualifier

EOQualifier qualifier()

Returns the receiver's qualifier .