pegasus/src/Pegasus/CQL/CQLSelectStatement.h - diff

Return to CQLSelectStatement.h CVS log

Up to [Pegasus] / pegasus / src / Pegasus / CQL

Diff for /pegasus/src/Pegasus/CQL/CQLSelectStatement.h between version 1.1 and 1.1.2.12

version 1.1, 2004/08/20 18:22:36

version 1.1.2.12, 2004/10/30 15:16:35

Line 0

Line 1

//%2003////////////////////////////////////////////////////////////////////////

// Company, L. P., IBM Corp., The Open Group, Tivoli Systems.

// IBM Corp.; EMC 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.

//==============================================================================

// Authors: David Rosckes (rosckes@us.ibm.com)

// Bert Rivero (hurivero@us.ibm.com)

// Chuck Carmack (carmack@us.ibm.com)

// Brian Lucier (lucier@us.ibm.com)

// Modified By:

//%/////////////////////////////////////////////////////////////////////////////

#ifndef Pegasus_CQLSelectStatement_h

#define Pegasus_CQLSelectStatement_h

#include <Pegasus/Common/Config.h>

#include <Pegasus/Common/AutoPtr.h>

#include <Pegasus/CQL/SelectStatement.h>

#include <Pegasus/CQL/CQLChainedIdentifier.h>

#include <Pegasus/CQL/CQLIdentifier.h>

#include <Pegasus/CQL/Linkage.h>

PEGASUS_NAMESPACE_BEGIN

class PEGASUS_CQL_LINKAGE CQLSelectStatementRep;

/**

This class is derived from the SelectStatement base class.

The purpose of this class is to perform the select statement operations for

CIM Query Language (CQL).

Notes on CQLSelectStatement class:

(A) Contains a CQLPredicate for the WHERE clause

(B) Contains an array of CQLIdentifiers for the SELECT projection

class PEGASUS_CQL_LINKAGE CQLSelectStatement : public SelectStatement

{

public:

CQLSelectStatement();

/** This is the constructor for the CQLSelectStatement object.

The ctor requires 3 parameters:

query language (qlang) which is CQL,

the query itself,

and the name of the CIM namespace.

CQLSelectStatement(

/** The query language is needed so the

base class can retrieve the query language.

The class member variable where this data

is stored is located in the base SelectStatement

class.

String& inQlang,

/** input parameter containing the query string.

String& inQuery,

QueryContext& inCtx);

CQLSelectStatement(const CQLSelectStatement& statement);

~CQLSelectStatement();

CQLSelectStatement& operator=(const CQLSelectStatement& rhs);

/** Implements the evaluate method from the

base SelectStatement class.

Boolean evaluate(

/** The CIM instance that will be evaluated.

The CIMInstance object is not modified by this method.

const CIMInstance& inCI);

/** Implements the applyProjection method from the

base SelectStatement class.

void applyProjection(

/** Input the CIMInstance object in which to apply the

projection.

CIMInstance& inCI) throw(Exception);

/** Implements the validatedClass method from the

base SelectStatement class.

void validateClass(const CIMObjectPath& inClassName) throw(Exception);

/** Implements the validatedProperties method from the

base SelectStatement class.

void validateProperties() throw(Exception);

/** Returns an array of CIMObjectPath objects that are the

class paths from the select statement in the FROM list.

Array<CIMObjectPath> getClassPathList();

/** Returns the required properties from the combined SELECT and WHERE

clauses for the classname passed in.

If all the properties for the input classname are required, a null

CIMPropertyList is returned.

CIMPropertyList getPropertyList(

/** The input parameter className is one of the

classes from the FROM list.

const CIMObjectPath& inClassName = CIMObjectPath());

/** Modifier. This method should not be called by the user (only by the

parser).

Appends a CQLIdentifier to an array of CIMObjectPaths from the FROM

statement.

void appendClassPath(

/**

const CQLIdentifier& inIdentifier);

/** Sets a predicate into this object. This method should only

be called by Bison.

void setPredicate(

// CQLOperation is an enum similar to the WQLOperation enum in CVS:

// enum CQLOperation

// {

// <,

// >,

// =,

// >=,

// <=,

// +,

// -,

// *,

// /,

// CQL_IS_NULL,

// CQL_IS_NOT_NULL,

// CQL_IS_A,

// CQL_LIKE

// };

const CQLPredicate& inPredicate);

/** This method calls QueryContext::insertClassPathAlias() to insert a

classpath-alias pair

into the hash table. The record is keyed by the class alias.

This method is used by Bison.

TODO: think about exceptions such as duplicate key.

void insertClassPathAlias(

/** The CQLIdentifier object that contains the class path.

const CQLIdentifier& inIdentifier,

/** The alias for the class.

String inAlias);

/** Appends a CQL chained identifier to the CQL identifier list. The user

should

not call this method; it should only be called by the Bison.

void appendSelectIdentifier(const CQLChainedIdentifier& x);

/** Appends a CQL Identifier to the where CQL identifier list. The user

should not call this method; it should only be called by Bison.

@param x the CQL identifier.

@return false if that identifier already exists.

Since the identifiers in the WHERE clause must be distinct,

a boolean is returned indicating if the identifier is not distinct.

TODO: THIS MAY BE NEEDED IN A FUTURE RELEASE.

NOT IMPLEMENTED IN PEGASUS V2.5

Boolean appendWhereIdentifier(

/** Input the chained CQL identifiers to append.

const CQLChainedIdentifier& x);

/**

Applies the class contexts from the FROM list to the identifiers

in the statement.

void applyContext();

/**

Normalizes the WHERE clause to disjunction of conjunctions.

void normalizeToDOC();

void setHasWhereClause();

Boolean hasWhereClause();

String toString();

void clear();

private:

CQLSelectStatementRep* _rep;

};

PEGASUS_NAMESPACE_END

#endif

Legend:

Removed from v.1.1
changed lines
	Added in v.1.1.2.12

No CVS admin address has been configured