version 1.10, 2004/10/17 20:40:15
|
version 1.11, 2004/12/14 13:16:52
|
|
|
#define Pegasus_WQLSelectStatement_h | #define Pegasus_WQLSelectStatement_h |
| |
#include <Pegasus/Common/Config.h> | #include <Pegasus/Common/Config.h> |
|
#include <Pegasus/WQL/Linkage.h> |
#include <Pegasus/Common/ArrayInternal.h> | #include <Pegasus/Common/ArrayInternal.h> |
#include <Pegasus/Common/CIMName.h> | #include <Pegasus/Common/CIMName.h> |
#include <Pegasus/Common/CIMPropertyList.h> | #include <Pegasus/Common/CIMPropertyList.h> |
|
|
#include <Pegasus/WQL/WQLOperation.h> | #include <Pegasus/WQL/WQLOperation.h> |
#include <Pegasus/WQL/WQLOperand.h> | #include <Pegasus/WQL/WQLOperand.h> |
#include <Pegasus/WQL/WQLPropertySource.h> | #include <Pegasus/WQL/WQLPropertySource.h> |
|
#include <Pegasus/Query/QueryCommon/SelectStatement.h> |
|
#include <Pegasus/Query/QueryCommon/QueryContext.h> |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
|
|
|
class PEGASUS_WQL_LINKAGE WQLSelectStatementRep; |
|
|
/** This class represents a compiled WQL1 select statement. | /** This class represents a compiled WQL1 select statement. |
| |
An instance of WQLSelectStatement is passed to WQLParser::parse() which | An instance of WQLSelectStatement is passed to WQLParser::parse() which |
|
|
YACC parser). Evaluation is performed using a Boolean stack. See the | YACC parser). Evaluation is performed using a Boolean stack. See the |
implementation of evaluateWhereClause() for details. | implementation of evaluateWhereClause() for details. |
*/ | */ |
class PEGASUS_WQL_LINKAGE WQLSelectStatement |
class PEGASUS_WQL_LINKAGE WQLSelectStatement: public SelectStatement |
{ | { |
public: | public: |
| |
|
|
|
WQLSelectStatement(String& queryLang, String& query); |
|
|
|
WQLSelectStatement(String& queryLang, String& query, QueryContext& inCtx); |
|
|
/** Default constructor. | /** Default constructor. |
*/ | */ |
WQLSelectStatement(); | WQLSelectStatement(); |
| |
|
WQLSelectStatement(const WQLSelectStatement& statement); |
|
|
/** Destructor. | /** Destructor. |
*/ | */ |
~WQLSelectStatement(); | ~WQLSelectStatement(); |
| |
|
WQLSelectStatement& operator=(const WQLSelectStatement& rhs); |
|
|
/** Clears all data members of this object. | /** Clears all data members of this object. |
*/ | */ |
void clear(); | void clear(); |
| |
/** Accessor. | /** Accessor. |
*/ | */ |
const CIMName& getClassName() const |
const CIMName& getClassName() const; |
{ |
|
return _className; |
|
} |
|
| |
/** Modifier. This method should not be called by the user (only by the | /** Modifier. This method should not be called by the user (only by the |
parser). | parser). |
*/ | */ |
void setClassName(const CIMName& className) |
void setClassName(const CIMName& className); |
{ |
|
_className = className; |
|
} |
|
| |
/** | /** |
Returns true if the query selects all properties ("*") | Returns true if the query selects all properties ("*") |
|
|
selection list. | selection list. |
This function should only be used if getAllProperties() returns false. | This function should only be used if getAllProperties() returns false. |
*/ | */ |
Uint32 getSelectPropertyNameCount() const |
Uint32 getSelectPropertyNameCount() const; |
{ |
|
return _selectPropertyNames.size(); |
|
} |
|
| |
/** Gets the i-th selected property name in the list. | /** Gets the i-th selected property name in the list. |
This function should only be used if getAllProperties() returns false. | This function should only be used if getAllProperties() returns false. |
*/ | */ |
const CIMName& getSelectPropertyName(Uint32 i) const |
const CIMName& getSelectPropertyName(Uint32 i) const; |
{ |
|
return _selectPropertyNames[i]; |
|
} |
|
| |
/** | /** |
Returns a CIMPropertyList containing the selected properties. | Returns a CIMPropertyList containing the selected properties. |
|
|
/** Appends a property name to the property name list. The user should | /** Appends a property name to the property name list. The user should |
not call this method; it should only be called by the parser. | not call this method; it should only be called by the parser. |
*/ | */ |
void appendSelectPropertyName(const CIMName& x) |
void appendSelectPropertyName(const CIMName& x); |
{ |
|
_selectPropertyNames.append(x); |
|
} |
|
| |
/** Returns the number of unique property names from the where clause. | /** Returns the number of unique property names from the where clause. |
*/ | */ |
Uint32 getWherePropertyNameCount() const |
Uint32 getWherePropertyNameCount() const; |
{ |
|
return _wherePropertyNames.size(); |
|
} |
|
| |
/** Gets the i-th unique property appearing in the where clause. | /** Gets the i-th unique property appearing in the where clause. |
*/ | */ |
const CIMName& getWherePropertyName(Uint32 i) const |
const CIMName& getWherePropertyName(Uint32 i) const; |
{ |
|
return _wherePropertyNames[i]; |
|
} |
|
| |
/** | /** |
Returns a CIMPropertyList containing the unique properties used in the | Returns a CIMPropertyList containing the unique properties used in the |
|
|
/** Appends an operation to the operation array. This method should only | /** Appends an operation to the operation array. This method should only |
be called by the parser itself. | be called by the parser itself. |
*/ | */ |
void appendOperation(WQLOperation x) |
void appendOperation(WQLOperation x); |
{ |
|
_operations.append(x); |
|
} |
|
| |
/** Appends an operand to the operation array. This method should only | /** Appends an operand to the operation array. This method should only |
be called by the parser itself. | be called by the parser itself. |
*/ | */ |
void appendOperand(const WQLOperand& x) |
void appendOperand(const WQLOperand& x); |
{ |
|
_operands.append(x); |
|
} |
|
| |
/** Returns true if this class has a where clause. | /** Returns true if this class has a where clause. |
*/ | */ |
Boolean hasWhereClause() const |
Boolean hasWhereClause() const; |
{ |
|
return _operations.size() != 0; |
|
} |
|
| |
/** Evalautes the where clause using the symbol table to resolve symbols. | /** Evalautes the where clause using the symbol table to resolve symbols. |
*/ | */ |
|
|
| |
/** Inspect an instance and remove properties not listed in Select projection. | /** Inspect an instance and remove properties not listed in Select projection. |
*/ | */ |
void applyProjection(CIMInstance& inst); |
void applyProjection(CIMInstance& inst) throw (Exception); |
void applyProjection(CIMObject& inst); | void applyProjection(CIMObject& inst); |
| |
/** Prints out the members of this class. | /** Prints out the members of this class. |
|
|
void print() const; | void print() const; |
| |
static const WQLSelectStatement EMPTY; | static const WQLSelectStatement EMPTY; |
private: |
|
| |
// |
Boolean evaluate(const CIMInstance& inCI); |
// The name of the target class. For example: |
|
// |
void validate() throw (Exception); |
// SELECT * |
|
// FROM TargetClass |
CIMPropertyList getPropertyList(const CIMObjectPath& inClassName = CIMObjectPath()); |
// WHERE ... |
|
// |
Array<CIMObjectPath> getClassPathList(); |
|
|
CIMName _className; |
private: |
|
|
// |
|
// Indicates that all properties are selected (i.e. SELECT * FROM ...) |
|
// |
|
Boolean _allProperties; |
|
|
|
// |
|
// The list of property names being selected. For example, see "firstName", |
|
// and "lastName" below. |
|
// |
|
// SELECT firstName, lastName |
|
// FROM TargetClass |
|
// WHERE ... |
|
// |
|
// NOTE: if the query selects all properties, this list is empty, and |
|
// _allProperties is true |
|
// |
|
// NOTE: duplicate property names are not removed from the select list |
|
// (e.g. SELECT firstName, firstName FROM...) results in a list of |
|
// two properties |
|
// |
|
|
|
Array<CIMName> _selectPropertyNames; |
|
|
|
// |
|
// The unique list of property names appearing in the WHERE clause. |
|
// Although a property may occur many times in the WHERE clause, it will |
|
// only appear once in this list. |
|
// |
|
|
|
Array<CIMName> _wherePropertyNames; |
|
|
|
// |
|
// The list of operations encountered while parsing the WHERE clause. |
|
// Consider this query: |
|
// |
|
// SELECT * |
|
// FROM TargetClass |
|
// WHERE count > 10 OR peak < 20 AND state = "OKAY" |
|
// |
|
// This would generate the following stream of WQLOperations: |
|
// |
|
// WQL_GT |
|
// WQL_LT |
|
// WQL_EQ |
|
// WQL_AND |
|
// WQL_OR |
|
// |
|
|
|
Array<WQLOperation> _operations; |
|
|
|
// |
|
// The list of operands encountered while parsing the WHERE clause. The |
|
// query just above would generate the following stream of operands: |
|
// |
|
// count, 10, peak, 20, state, "OKAY" |
|
// |
|
| |
Array<WQLOperand> _operands; |
WQLSelectStatementRep* _rep; |
| |
void f() const { } |
//void f() const { } |
| |
friend class CMPI_Wql2Dnf; | friend class CMPI_Wql2Dnf; |
}; | }; |