![]() ![]() |
![]() |
File: [Pegasus] / pegasus / src / Pegasus / Query / QueryCommon / SelectStatementRep.h
(download)
Revision: 1.8, Tue Feb 12 19:02:46 2008 UTC (16 years, 4 months ago) by kumpf Branch: MAIN CVS Tags: TASK_PEP328_SOLARIS_NEVADA_PORT, TASK-PEP328_SOLARIS_NEVADA_PORT_v2-root, TASK-PEP328_SOLARIS_NEVADA_PORT_v2-branch, TASK-PEP328_SOLARIS_NEVADA_PORT-root, TASK-PEP328_SOLARIS_NEVADA_PORT-branch, TASK-PEP328_SOLARIS_IX86_CC_PORT-root, TASK-PEP328_SOLARIS_IX86_CC_PORT-branch-v2, TASK-PEP328_SOLARIS_IX86_CC_PORT-branch, TASK-PEP311_WSMan-root, TASK-PEP311_WSMan-branch, RELEASE_2_8_2-RC1, RELEASE_2_8_2, RELEASE_2_8_1-RC1, RELEASE_2_8_1, RELEASE_2_8_0_BETA, RELEASE_2_8_0-RC2, RELEASE_2_8_0-RC1, RELEASE_2_8_0-FC, RELEASE_2_8_0, RELEASE_2_8-root, RELEASE_2_8-branch Changes since 1.7: +1 -1 lines BUG#: 3560 TITLE: SelectStatementRep setQueryContext() method (and inheritors) should use const reference parameter DESCRIPTION: Pass a const QueryContext reference to setQueryContext(). |
//%2006//////////////////////////////////////////////////////////////////////// // // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; // IBM Corp.; EMC Corporation, The Open Group. // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; // EMC Corporation; VERITAS Software Corporation; The Open Group. // Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; // EMC Corporation; Symantec 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"), to // deal in the Software without restriction, including without limitation the // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or // 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 SOFTWARE IS PROVIDED // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. // //============================================================================== // //%///////////////////////////////////////////////////////////////////////////// #ifndef Pegasus_SelectStatementRep_h #define Pegasus_SelectStatementRep_h #include <Pegasus/Common/Config.h> #include <Pegasus/Query/QueryCommon/Linkage.h> #include <Pegasus/Common/String.h> #include <Pegasus/Common/CIMInstance.h> #include <Pegasus/Common/AutoPtr.h> #include <Pegasus/Query/QueryCommon/QueryContext.h> PEGASUS_NAMESPACE_BEGIN /* An example of a simple query language SELECT statement may take the following form (although CQL architecture includes much more extensive forms of the SELECT statement): <pre> SELECT <select-list> FROM <class list> WHERE <selection expression> </pre> There are methods for obtaining the various elements of the select statement. See the concrete subclasses for specific information on each type of query language select statement. */ class PEGASUS_QUERYCOMMON_LINKAGE SelectStatementRep { public: virtual ~SelectStatementRep(); /** Returns the query language (WQL or CQL). */ String getQueryLanguage() const; /** Returns the query string. */ String getQuery() const; virtual void setQueryContext(const QueryContext& inCtx); /** This method operates on a single CIMInstance. @param inCI The CIMInstance that will be evaluated. @return A boolean value indicating the evaluation result: TRUE means the CIMInstance passed conforms to the criteria on the WHERE clause, FALSE means the CIMInstance passed does not conform to the criteria on the WHERE clause */ virtual Boolean evaluate(const CIMInstance& inCI) = 0; /** applyProjection() method operates on a single CIMInstance to determine what properties to include. On that CIMInstance it will remove all propoerties that are not included in the projection. @param inCI The CIMInstance object in which to apply the projection. TODO: document the exceptions! */ virtual void applyProjection( CIMInstance& inCI, Boolean allowMissing) = 0; /** Validates that all the property name identifiers actually exist on a class from the FROM list of the query string. It checks the class in the default namespace (passed on the CTOR) in the repository. An exception is thrown if a property is not valid. TODO: document the exceptions. repository errors, namespace not found, etc. */ virtual void validate() = 0; /** Returns an array of CIMObjectPath objects that are the class paths from the select statement in the FROM list. */ virtual Array<CIMObjectPath> getClassPathList() const = 0; /** Returns the required properties from the combined SELECT and WHERE clauses for the classname passed in. This is a pure virtual function that must be implemented in one or more subclasses. If all the properties for the input classname are required, a null CIMPropertyList is returned. @param One of the classes from the FROM list, for which the properties required for evaluation will be returned. */ virtual CIMPropertyList getPropertyList( const CIMObjectPath& inClassName) = 0; protected: SelectStatementRep(); SelectStatementRep(const SelectStatementRep& ssr); SelectStatementRep( const String& inQlang, const String& inQuery, const QueryContext& ctx); SelectStatementRep( const String& inQlang, const String& inQuery); SelectStatementRep& operator=(const SelectStatementRep& rhs); /** The query language to be used for processing this query (e.g. WQL or CQL). */ String _qlang; /** The query string to be processed. */ String _query; QueryContext* _ctx; }; PEGASUS_NAMESPACE_END #endif
No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |