pegasus/src/Pegasus/Common/CIMQualifierList.h - diff

Return to CIMQualifierList.h CVS log

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

Diff for /pegasus/src/Pegasus/Common/CIMQualifierList.h between version 1.26 and 1.40

version 1.26, 2002/08/05 16:14:41

version 1.40, 2008/03/05 21:31:45

Line 1

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

//%2006////////////////////////////////////////////////////////////////////////

// The Open Group, Tivoli Systems

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

// IBM Corp.; EMC Corporation, The Open Group.

// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; VERITAS Software Corporation; The Open Group.

// 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

Line 21

Line 29

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

// Author: Mike Brasher (mbrasher@bmc.com)

// Modified By: Carol Ann Krug Graves, Hewlett-Packard Company

// (carolann_graves@hp.com)

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

#ifndef Pegasus_QualifierList_h

Line 33

Line 36

#include <Pegasus/Common/Config.h>

#include <Pegasus/Common/Linkage.h>

#include <Pegasus/Common/Constants.h>

#include <Pegasus/Common/CIMName.h>

#include <Pegasus/Common/CIMQualifier.h>

#include <Pegasus/Common/CIMScope.h>

#include <Pegasus/Common/Array.h>

#include <Pegasus/Common/Pair.h>

#include <Pegasus/Common/Buffer.h>

#include <Pegasus/Common/OrderedSet.h>

/* ATTN: P2 KS 25 Mar 2002 - The function names are a mismash of local and taken

/* ATTN: P2 KS 25 Mar 2002 - The function names are a mismash of local and

from the class and instance functions. Thus, we have getCount but getQualifier

taken from the class and instance functions. Thus, we have getCount but

This causes confusion with the functions in class and instance which are specifically

getQualifier. This causes confusion with the functions in class and

getQualifier. We should clean up so the names here remove the Qualifier portion.

instance which are specifically getQualifier. We should clean up so the

names here remove the Qualifier portion.

PEGASUS_NAMESPACE_BEGIN

class DeclContext;

/* ATTN: KS P3 DEFER 1 May 2002.

/* ATTN: KS P3 DEFER 1 May 2002. We have list processors (really array processors) for

We have list processors (really array processors) for

qualifiers, properties, methods(???) but they are all slightly different.

Should we create a common base??

Line 83

Line 90

return _qualifiers.size();

}

/** getQualifer - Gets the qaulifier defined at the position provided

/** getQualifer - Gets the qaulifier defined at the index provided

in the Qualifier list.

@param pos - The position in the qualifierlist containing the

@param index - The position in the qualifierlist containing the

qualifier.

@return CIMQualifier object.

@exception - Throws OutofBounds exception of pso not within the

qualifier list.

ATTN: P0 KS Mar 2002 Add the outofbounds exception.

CIMQualifier& getQualifier(Uint32 pos);

CIMQualifier& getQualifier(Uint32 index);

const CIMQualifier& getQualifier(Uint32 pos) const

const CIMQualifier& getQualifier(Uint32 index) const

{

return _qualifiers[pos];

return _qualifiers[index];

}

/** removeQualifier - Removes the Qualifier defined by

the pos parameter

the index parameter

@exception Throws "OutOfBounds" if pos not within

@exception IndexOutOfBoundsException if index not within

range of current qualifiers.

void removeQualifier(Uint32 pos);

void removeQualifier(Uint32 index);

/**

Removes all the qualifiers from the list.

void clear();

/** find - Searches for a qualifier with the specified `

input name if it exists in the class

Line 124

Line 136

Boolean exists(const CIMName& name) const

{

return (((find(name)) == PEG_NOT_FOUND)? false : true);

return (find(name) != PEG_NOT_FOUND);

}

/** isTrue - Determines if the qualifier defined by

Line 137

Line 149

Boolean isTrue(const CIMName& name) const;

/// findReverse - See find

/** resolve - Resolves the qualifierList based on the information provided.

Uint32 findReverse(const CIMName& name) const;

The resolved qualifiers are the result of validating and testing the

qualifiers against the inherited qualifiers and qualifier declarations.

The qualifier list contains the set of resolved qualifiers when the

function is complete.

/** resolve - Resolves the qualifierList based on the information provided. The resolved

qualifiers are the result of validating and testing the qualifiers against the

inherited qualifiers and qualifier declarations. The qualifier list contains

the set of resolved qualifiers when the function is complete.

Resolution includes:

1. Determining if the qualifier is declared (obtainable form declContext).

1. Determining if the qualifier is declared (obtainable form

declContext).

2. Qualifier is same type as declaration

3. Valid for the scope provided (Qualifier scope contains the provided scope).

3. Valid for the scope provided (Qualifier scope contains the provided

scope).

4. Whether qualifier can be overridden.

5. Whether it should be propagated to subclass

If a qualifier can be overridden it is put into the qualifiers array.

@param declContext Declaration context for this resolution (ex repository, simple)

@param declContext Declaration context for this resolution (ex

repository, simple)

@param nameSpace Namespace in which to find the declaration.

@param scope - Scope of the entity doing the resolution (ex. Class, association, etc.)

@param scope - Scope of the entity doing the resolution (ex. Class,

association, etc.)

@param isInstancePart - TBD

@param inheritedQualifiers - CimQualifierList defining List of inherited qualifiers

@param inheritedQualifiers - CimQualifierList defining List of

@param propagateQualifiers Boolean indicator whether to propagate qualifiers.

inherited qualifiers

@return

@param propagateQualifiers Boolean indicator whether to propagate

qualifiers.

@exception - There are a number of different

void resolve(

DeclContext* declContext,

const String& nameSpace,

const CIMNamespaceName & nameSpace,

CIMScope scope,

Boolean isInstancePart,

CIMQualifierList& inheritedQualifiers,

Boolean propagateQualifiers);

///

void toXml(Array<Sint8>& out) const;

///

void toMof(Array<Sint8>& out) const;

///

void print(PEGASUS_STD(ostream) &o=PEGASUS_STD(cout)) const;

///

Line 183

Line 194

///

void cloneTo(CIMQualifierList& x) const;

Boolean isKey() const;

private:

Array<CIMQualifier> _qualifiers;

typedef OrderedSet<CIMQualifier,

CIMQualifierRep,

PEGASUS_QUALIFIER_ORDEREDSET_HASHSIZE> QualifierSet;

QualifierSet _qualifiers;

/** Index of key qualifier or the meaning is as follows:

PEGASUS_ORDEREDSET_INDEX_NOTFOUND --

there is no key qualifier in the list.

PEGASUS_ORDEREDSET_INDEX_UNKNOWN --

the index is unresolved.

Uint32 _keyIndex;

friend class CIMPropertyInternal;

};

/**

Applies a specified qualifier list to a specified object, using an

addQualifier method which is expected to exist for the object type.

@param qualifierList The CIMQualifierList to apply to the object.

@param object The object to which to apply the qualifierList.

template <class T>

void applyQualifierList(CIMQualifierList& qualifierList, T& object)

{

for (Uint32 i = 0; i < qualifierList.getCount(); i++)

{

object.addQualifier(qualifierList.getQualifier(i));

}

qualifierList.clear();

}

PEGASUS_NAMESPACE_END

#endif /* Pegasus_QualifierList_h */

Legend:

Removed from v.1.26
changed lines
	Added in v.1.40

No CVS admin address has been configured