version 1.12, 2005/02/05 23:00:52
|
version 1.23, 2012/12/28 08:46:21
|
|
|
//%2005//////////////////////////////////////////////////////////////////////// |
//%LICENSE//////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
// Licensed to The Open Group (TOG) under one or more contributor license |
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
// agreements. Refer to the OpenPegasusNOTICE.txt file distributed with |
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
// this work for additional information regarding copyright ownership. |
// IBM Corp.; EMC Corporation, The Open Group. |
// Each contributor licenses this file to you under the OpenPegasus Open |
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
// Source License; you may not use this file except in compliance with the |
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
// License. |
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
// |
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
// Permission is hereby granted, free of charge, to any person obtaining a |
// |
// copy of this software and associated documentation files (the "Software"), |
// Permission is hereby granted, free of charge, to any person obtaining a copy |
// to deal in the Software without restriction, including without limitation |
// of this software and associated documentation files (the "Software"), to |
// the rights to use, copy, modify, merge, publish, distribute, sublicense, |
// deal in the Software without restriction, including without limitation the |
// and/or sell copies of the Software, and to permit persons to whom the |
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or |
// Software is furnished to do so, subject to the following conditions: |
// sell copies of the Software, and to permit persons to whom the Software is |
// |
// furnished to do so, subject to the following conditions: |
// The above copyright notice and this permission notice shall be included |
// |
// in all copies or substantial portions of the Software. |
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN |
// |
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED |
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT |
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY |
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN |
// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION |
// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
// | // |
//============================================================================== |
////////////////////////////////////////////////////////////////////////// |
// | // |
// Author: Mike Brasher (mbrasher@bmc.com) |
|
// |
|
// Modified By: Carol Ann Krug Graves, Hewlett-Packard Company |
|
// (carolann_graves@hp.com) |
|
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
|
|
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
| |
class PEGASUS_WQL_LINKAGE WQLSelectStatementRep; |
class WQLSelectStatementRep; |
| |
/** This class represents a compiled WQL1 select statement. | /** This class represents a compiled WQL1 select statement. |
| |
|
|
{ | { |
public: | public: |
| |
|
WQLSelectStatement( |
WQLSelectStatement(String& queryLang, String& query); |
const String& queryLang, |
|
const String& query); |
WQLSelectStatement(String& queryLang, String& query, QueryContext& inCtx); |
|
|
WQLSelectStatement( |
|
const String& queryLang, |
|
const String& query, |
|
const QueryContext& inCtx); |
| |
/** Default constructor. | /** Default constructor. |
*/ | */ |
|
|
const CIMName& getSelectPropertyName(Uint32 i) const; | const CIMName& getSelectPropertyName(Uint32 i) const; |
| |
/** | /** |
Returns a CIMPropertyList containing the selected properties. |
Returns the required properties from the SELECT clause for the specified |
The list is NULL if the query selects all properties (SELECT * FROM...). |
class. |
|
|
|
@param inClassName name of the class; must be one of the classes from |
|
the FROM clause |
|
|
|
@return CIMPropertyList containing the required properties from the |
|
SELECT clause for the specified class; |
|
or a null CIMPropertyList if all properties of the specified |
|
class are required |
*/ | */ |
const CIMPropertyList getSelectPropertyList() const; |
CIMPropertyList getSelectPropertyList( |
|
const CIMObjectPath& inClassName = CIMObjectPath()); |
| |
/** 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. |
|
|
const CIMName& getWherePropertyName(Uint32 i) const; | const CIMName& getWherePropertyName(Uint32 i) const; |
| |
/** | /** |
Returns a CIMPropertyList containing the unique properties used in the |
Returns the required properties from the WHERE clause for the specified |
WHERE clause |
class. |
|
|
|
@param inClassName name of the class; must be one of the classes from |
|
the FROM clause |
|
|
|
@return CIMPropertyList containing the required properties from the |
|
WHERE clause for the specified class; |
|
or a null CIMPropertyList if all properties of the specified |
|
class are required |
*/ | */ |
const CIMPropertyList getWherePropertyList() const; |
CIMPropertyList getWherePropertyList( |
|
const CIMObjectPath& inClassName = CIMObjectPath()); |
| |
/** Appends a property name to the where property name list. The user | /** Appends a property name to the where property name list. The user |
should not call this method; it should only be called by the parser. | should not call this method; it should only be called by the parser. |
|
|
*/ | */ |
Boolean evaluateWhereClause(const WQLPropertySource* source) const; | Boolean evaluateWhereClause(const WQLPropertySource* source) const; |
| |
/** 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) throw (Exception); |
|
void applyProjection(CIMObject& inst); |
@param allowMissing Boolean specifying whether missing project |
|
properties are allowed |
|
@exception Exception |
|
*/ |
|
void applyProjection( |
|
CIMInstance& inst, |
|
Boolean allowMissing); |
|
void applyProjection( |
|
CIMObject& inst, |
|
Boolean allowMissing); |
| |
/** Prints out the members of this class. | /** Prints out the members of this class. |
*/ | */ |
void print() const; | void print() const; |
| |
static const WQLSelectStatement EMPTY; |
|
|
|
Boolean evaluate(const CIMInstance& inCI); | Boolean evaluate(const CIMInstance& inCI); |
| |
void validate() throw (Exception); |
void validate(); |
| |
CIMPropertyList getPropertyList(const CIMObjectPath& inClassName = CIMObjectPath()); |
CIMPropertyList getPropertyList( |
|
const CIMObjectPath& inClassName = CIMObjectPath()); |
| |
Array<CIMObjectPath> getClassPathList(); |
Array<CIMObjectPath> getClassPathList() const; |
| |
private: | private: |
| |