PATH  WebObjects 4.0 Documentation > EOControl Reference



EONotQualifier

Inherits From:
EOQualifier

Implements:
EOQualifierEvaluation
NSCoding (Java Client only)

Package:
com.apple.client.eocontrol (Java Client)
com.apple.yellow.eocontrol (Yellow Box)

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.

Interfaces Implemented

EOQualifierEvaluation
- evaluateWithObject
NSCoding (Java Client 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

EOQualifierEvaluation interface

public boolean evaluateWithObject (java.lang.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.





Copyright © 1998, Apple Computer, Inc. All rights reserved.