1 chuck 1.2 //%2003////////////////////////////////////////////////////////////////////////
  2           //
  3           // Copyright (c) 2000, 2001, 2002  BMC Software, Hewlett-Packard Development
  4           // Company, L. P., IBM Corp., The Open Group, Tivoli Systems.
  5           // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L. P.;
  6           // IBM Corp.; EMC Corporation, The Open Group.
  7           //
  8           // Permission is hereby granted, free of charge, to any person obtaining a copy
  9           // of this software and associated documentation files (the "Software"), to
 10           // deal in the Software without restriction, including without limitation the
 11           // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 12           // sell copies of the Software, and to permit persons to whom the Software is
 13           // furnished to do so, subject to the following conditions:
 14           // 
 15           // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
 16           // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
 17           // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
 18           // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
 19           // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 20           // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 21           // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 22 chuck 1.2 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 23           //
 24           //==============================================================================
 25           //
 26           // Authors: David Rosckes (rosckes@us.ibm.com)
 27           //          Bert Rivero (hurivero@us.ibm.com)
 28           //          Chuck Carmack (carmack@us.ibm.com)
 29           //          Brian Lucier (lucier@us.ibm.com) 
 30           //
 31           // Modified By:
 32           //
 33           //%/////////////////////////////////////////////////////////////////////////////
 34           
 35           #ifndef Pegasus_CQLSimplePredicate_h 
 36           #define Pegasus_CQLSimplePredicate_h
 37           
 38           #include <Pegasus/Common/Config.h>
 39           #include <Pegasus/CQL/Linkage.h>
 40           #include <Pegasus/Common/CIMInstance.h>
 41           #include <Pegasus/Query/QueryCommon/QueryContext.h>
 42           
 43 chuck 1.2 #ifdef PEGASUS_USE_EXPERIMENTAL_INTERFACES
 44           
 45           PEGASUS_NAMESPACE_BEGIN
 46           
 47           class PEGASUS_CQL_LINKAGE CQLExpression;
 48           class PEGASUS_CQL_LINKAGE CQLFactory;
 49           class PEGASUS_CQL_LINKAGE CQLSimplePredicateRep;
 50           
 51           	enum ExpressionOpType { LT, GT, EQ, LE, GE, NE, IS_NULL, IS_NOT_NULL, ISA, LIKE };
 52           
 53           /** 
 54              */
 55           class CQLSimplePredicate
 56           {
 57             public:
 58               CQLSimplePredicate();
 59           
 60               CQLSimplePredicate(const CQLExpression& inExpression);
 61           
 62               CQLSimplePredicate(const CQLExpression& inExpression, 
 63           		       ExpressionOpType inOperator);
 64 chuck 1.2 
 65               CQLSimplePredicate(const CQLExpression& leftSideExpression, 
 66           		       const CQLExpression& rightSideExpression, 
 67           		       ExpressionOpType inOperator);
 68           
 69                CQLSimplePredicate(const CQLSimplePredicate& inSimplePredicate);
 70           
 71               ~CQLSimplePredicate();
 72           
 73               /**  
 74                 CQLExpressions: 
 75                     For an expression, CQLExpression::getValue is called and will return a
 76               CQLValue.
 77                     The appropriate operator is then invoked on CQLValue and that operator
 78               function will
 79                     enforce the type restrictions as documented in the DMTF CQL
 80               Specification.
 81                     That operator then determines whether the predicate is TRUE / FALSE.
 82               
 83               
 84                  CQLPredicates: 
 85 chuck 1.2           The CQLPredicate is non-terminal if it contains only CQLPredicate
 86               objects.
 87                     A non-terminal CQLPredicate is evaluated by in turn evaluating the
 88               contained CQLPredicates and
 89                     boolean operator.
 90                    Valid operators are:
 91                             AND, OR
 92               
 93                    For the evaluate method on each CQLPredicate. the CQLPredicate is
 94               evaluated to TRUE/FALSE and 
 95                    the result of the evaluation is then applied to the appropriate boolean
 96               operator. 
 97               
 98                   The result of the evaluation is and then inverted if the _invert member
 99               variable is set to TRUE
100                   and then returned to the caller.
101               
102                 */
103               Boolean evaluate(CIMInstance CI, QueryContext& QueryCtx);
104           
105               CQLExpression getLeftExpression()const;
106 chuck 1.2 
107               CQLExpression getRightExpression()const;
108           
109               enum ExpressionOpType getOperation()const;
110           
111               void applyContext(QueryContext& queryContext);
112           
113               String toString()const;
114           
115               Boolean isSimple()const;
116           
117               Boolean isSimpleValue()const;
118           
119               CQLSimplePredicate& operator=(const CQLSimplePredicate& rhs);
120           
121               Boolean operator==(const CQLSimplePredicate &rhs)const;
122           
123               void setOperation(ExpressionOpType op);
124           
125               friend class CQLFactory;
126             private:
127 chuck 1.2     CQLSimplePredicateRep *_rep;
128           
129           };
130           PEGASUS_NAMESPACE_END
131           #endif
132           #endif