version 1.5, 2001/04/08 01:13:21
|
version 1.32, 2002/05/14 03:27:26
|
|
|
//BEGIN_LICENSE |
//%///////////////////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000 The Open Group, BMC Software, Tivoli Systems, IBM |
// Copyright (c) 2000, 2001 The Open group, BMC Software, Tivoli Systems, IBM |
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a |
// Permission is hereby granted, free of charge, to any person obtaining a copy |
// copy of this software and associated documentation files (the "Software"), |
// of this software and associated documentation files (the "Software"), to |
// to deal in the Software without restriction, including without limitation |
// deal in the Software without restriction, including without limitation the |
// the rights to use, copy, modify, merge, publish, distribute, sublicense, |
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or |
// and/or sell copies of the Software, and to permit persons to whom the |
// sell copies of the Software, and to permit persons to whom the Software is |
// Software is furnished to do so, subject to the following conditions: |
// furnished to do so, subject to the following conditions: |
// | // |
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN |
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED |
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT |
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN |
// DEALINGS IN THE SOFTWARE. |
// 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. |
// | // |
//END_LICENSE |
//============================================================================== |
//BEGIN_HISTORY |
|
// | // |
// Author: |
// Author: Mike Brasher (mbrasher@bmc.com) |
// | // |
// $Log$ |
// Modified By: Karl Schopmeyer (k.schopmeyer@opengroup.org) |
// Revision 1.5 2001/04/08 01:13:21 mike |
|
// Changed "ConstCIM" to "CIMConst" |
|
// | // |
// Revision 1.3 2001/02/20 05:16:57 mike |
//%///////////////////////////////////////////////////////////////////////////// |
// Implemented CIMInstance::getInstanceName() |
|
// |
|
// Revision 1.2 2001/02/19 01:47:16 mike |
|
// Renamed names of the form CIMConst to CIMConst. |
|
// |
|
// Revision 1.1 2001/02/18 18:39:06 mike |
|
// new |
|
// |
|
// Revision 1.3 2001/02/18 03:56:01 mike |
|
// Changed more class names (e.g., ConstClassDecl -> CIMConstClass) |
|
// |
|
// Revision 1.2 2001/02/17 00:41:28 bob |
|
// #ifdefed around the check of scope to avoid bogus exceptions |
|
// |
|
// Revision 1.1 2001/02/16 02:07:06 mike |
|
// Renamed many classes and headers (using new CIM prefixes). |
|
// |
|
// Revision 1.5 2001/02/13 02:06:40 mike |
|
// Added renameFile() method. |
|
// |
|
// Revision 1.4 2001/01/28 04:11:03 mike |
|
// fixed qualifier resolution |
|
// |
|
// Revision 1.3 2001/01/23 01:25:35 mike |
|
// Reworked resolve scheme. |
|
// |
|
// Revision 1.2 2001/01/22 00:45:47 mike |
|
// more work on resolve scheme |
|
// |
|
// Revision 1.1.1.1 2001/01/14 19:53:09 mike |
|
// Pegasus import |
|
// |
|
// |
|
//END_HISTORY |
|
| |
#include "CIMQualifierList.h" | #include "CIMQualifierList.h" |
#include "DeclContext.h" | #include "DeclContext.h" |
|
|
#include "CIMName.h" | #include "CIMName.h" |
#include "Indentor.h" | #include "Indentor.h" |
#include "XmlWriter.h" | #include "XmlWriter.h" |
|
#include <Pegasus/Common/Tracer.h> |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
|
PEGASUS_USING_STD; |
|
|
|
CIMQualifierList::CIMQualifierList() |
|
{ |
|
|
|
} |
|
|
|
CIMQualifierList::~CIMQualifierList() |
|
{ |
|
|
|
} |
| |
CIMQualifierList& CIMQualifierList::add(const CIMQualifier& qualifier) | CIMQualifierList& CIMQualifierList::add(const CIMQualifier& qualifier) |
{ | { |
if (!qualifier) |
if (qualifier.isNull()) |
throw UnitializedHandle(); |
throw UninitializedHandle(); |
| |
if (find(qualifier.getName()) != Uint32(-1)) |
if (find(qualifier.getName()) != PEG_NOT_FOUND) |
throw AlreadyExists(); | throw AlreadyExists(); |
| |
_qualifiers.append(qualifier); | _qualifiers.append(qualifier); |
| |
return *this; | return *this; |
} | } |
|
//ATTN: Why do we not do the outofbounds check here. KS 18 May 2k |
|
CIMQualifier& CIMQualifierList::getQualifier(Uint32 pos) |
|
{ |
|
return _qualifiers[pos]; |
|
} |
|
|
|
//ATTN: added ks 18 may 2001. Should we have outofbounds? |
|
void CIMQualifierList::removeQualifier(Uint32 pos) |
|
{ |
|
_qualifiers.remove(pos); |
|
} |
| |
Uint32 CIMQualifierList::find(const String& name) const | Uint32 CIMQualifierList::find(const String& name) const |
{ | { |
for (Uint32 i = 0, n = _qualifiers.getSize(); i < n; i++) |
for (Uint32 i = 0, n = _qualifiers.size(); i < n; i++) |
{ | { |
if (CIMName::equal(_qualifiers[i].getName(), name)) | if (CIMName::equal(_qualifiers[i].getName(), name)) |
return i; | return i; |
} | } |
| |
return Uint32(-1); |
return PEG_NOT_FOUND; |
|
} |
|
Boolean CIMQualifierList::isTrue(const String& name) const |
|
{ |
|
Uint32 pos = find(name); |
|
|
|
if (pos == PEG_NOT_FOUND) |
|
return false; |
|
|
|
Boolean flag; |
|
const CIMValue& value = getQualifier(pos).getValue(); |
|
|
|
if (value.getType() != CIMType::BOOLEAN) |
|
return false; |
|
|
|
value.get(flag); |
|
return flag; |
} | } |
| |
Uint32 CIMQualifierList::findReverse(const String& name) const | Uint32 CIMQualifierList::findReverse(const String& name) const |
{ | { |
for (Uint32 i = _qualifiers.getSize(); i; --i) |
for (Uint32 i = _qualifiers.size(); i; --i) |
{ | { |
if (CIMName::equal(_qualifiers[i - 1].getName(), name)) | if (CIMName::equal(_qualifiers[i - 1].getName(), name)) |
return i - 1; | return i - 1; |
} | } |
| |
return Uint32(-1); |
return PEG_NOT_FOUND; |
} | } |
| |
void CIMQualifierList::resolve( | void CIMQualifierList::resolve( |
DeclContext* declContext, | DeclContext* declContext, |
const String& nameSpace, | const String& nameSpace, |
Uint32 scope, |
Uint32 scope, // Scope of the entity being resolved. |
Boolean isInstancePart, | Boolean isInstancePart, |
CIMQualifierList& inheritedQualifiers) |
CIMQualifierList& inheritedQualifiers, |
|
Boolean propagateQualifiers) // Apparently not used ks 24 mar 2002 |
{ | { |
|
PEG_METHOD_ENTER(TRC_OBJECTRESOLUTION, "CIMQualifierList::resolve()"); |
// For each qualifier in the qualifiers array, the following | // For each qualifier in the qualifiers array, the following |
// is checked: | // is checked: |
// | // |
|
|
// | // |
// 2. Whether it has the same type as the declaration. | // 2. Whether it has the same type as the declaration. |
// | // |
// 3. Whether the the qualifier is valid for the given scope. |
// 3. Whether the qualifier is valid for the given scope. |
// | // |
// 4. Whether the qualifier can be overriden (the flavor is | // 4. Whether the qualifier can be overriden (the flavor is |
// ENABLEOVERRIDE on the corresponding reference qualifier). | // ENABLEOVERRIDE on the corresponding reference qualifier). |
|
|
// If the qualifier should be overriden, then it is injected into the | // If the qualifier should be overriden, then it is injected into the |
// qualifiers array (from the inheritedQualifiers array). | // qualifiers array (from the inheritedQualifiers array). |
| |
for (Uint32 i = 0, n = _qualifiers.getSize(); i < n; i++) |
for (Uint32 i = 0, n = _qualifiers.size(); i < n; i++) |
{ | { |
CIMQualifier q = _qualifiers[i]; | CIMQualifier q = _qualifiers[i]; |
|
|
//---------------------------------------------------------------------- | //---------------------------------------------------------------------- |
// 1. Check to see if it's declared. | // 1. Check to see if it's declared. |
//---------------------------------------------------------------------- | //---------------------------------------------------------------------- |
|
// set this back to CIMConstQualifierDecl |
CIMConstQualifierDecl qd = declContext->lookupQualifierDecl( |
CIMQualifierDecl qd = declContext->lookupQualifierDecl( |
nameSpace, q.getName()); | nameSpace, q.getName()); |
| |
if (!qd) |
if (qd.isNull()) |
throw UndeclaredQualifier(q.getName()); | throw UndeclaredQualifier(q.getName()); |
| |
//---------------------------------------------------------------------- | //---------------------------------------------------------------------- |
// 2. Check the type: |
// 2. Check the type and isArray. Must be the same: |
//---------------------------------------------------------------------- | //---------------------------------------------------------------------- |
| |
if (!(q.getType() == qd.getType() && q.isArray() == qd.isArray())) | if (!(q.getType() == qd.getType() && q.isArray() == qd.isArray())) |
throw BadQualifierType(q.getName()); | throw BadQualifierType(q.getName()); |
| |
//---------------------------------------------------------------------- | //---------------------------------------------------------------------- |
// 3. Check the scope: |
// 3. Check the scope: Must be legal for this qualifier |
//---------------------------------------------------------------------- | //---------------------------------------------------------------------- |
#if 0 |
//#if 0 |
// ATTN: These lines throw a bogus exception if the qualifier has | // ATTN: These lines throw a bogus exception if the qualifier has |
// a valid scope (such as Scope::ASSOCIATION) which is not Scope::CLASS | // a valid scope (such as Scope::ASSOCIATION) which is not Scope::CLASS |
// grb 1/16/01 |
// ks Mar 2002. Reinstalled 23 March 2002 to test. |
|
|
if (!(qd.getScope() & scope)) | if (!(qd.getScope() & scope)) |
throw BadQualifierScope(qd.getName(), ScopeToString(scope)); | throw BadQualifierScope(qd.getName(), ScopeToString(scope)); |
#endif |
//#endif |
//---------------------------------------------------------------------- | //---------------------------------------------------------------------- |
// See if this qualifier is contained in the inheritedQualifiers. If |
// Resolve the qualifierflavor. Since Flavors are a combination of inheritance |
// so then we must handle the OVERRIDABLE flavor. |
// and input characteristics, resolve the inherited characteristics |
|
// against those provided with the creation. If there is a superclass |
|
// the flavor is resolved against that superclass. If not, it is resolved |
|
// against the declaration. If the flavor is disableoverride and tosubclass |
|
// the resolved qualifier value must be identical to the original |
//---------------------------------------------------------------------- | //---------------------------------------------------------------------- |
|
// Test for Qualifier found in SuperClass. If found and qualifier |
|
// is not overridable. |
|
// Abstract (not Overridable and restricted) can be found in subclasses |
|
// Can have nonabstracts below abstracts. That is function of nottosubclass |
|
// Association (notOverridable and tosubclass) can be found in subclasses but |
|
// cannot be changed. No non-associatons below associations. In other words |
|
// once a class becomes an association, no subclass can override that definition |
|
// apparently |
|
// Throw exception if DisableOverride and tosubclass and different value. |
|
// Gets the source from superclass if qualifier exists or from declaraction |
|
// If we do not throw the exception, resolve the flavor from the inheritance |
|
// point and resolve against current input. |
|
// Diableoverride is defined in the CIM Spec to mean that the value cannot change |
|
// The other characteristics including the flavor can change apparently. Thus, we |
|
// need only confirm that the value is the same (2.2 pp 33). Strange since we |
|
// would think that override implies that you cannot override any of the |
|
// characteristics (value, type, flavor, etc.) This also leaves the question |
|
// of NULL or no values. The implication is that we must move the value |
|
// from the superclass or declaration. |
| |
// ATTN: there seems to be a problem with the CIM schema that marks the |
|
// abstract qualifier as non-overridable but then they override it. |
|
// For now it is just disabled. This problem exists in both XML and |
|
// CIM schema. |
|
|
|
#if 0 |
|
Uint32 pos = inheritedQualifiers.find(q.getName()); | Uint32 pos = inheritedQualifiers.find(q.getName()); |
| |
if (pos != Uint32(-1)) |
//cout << "KSTEST Qualifier resolve inherit test " << q.getName() |
{ |
//<< " Inherited From " << ((pos == PEG_NOT_FOUND) ? "Declaration" : "superclass") |
CIMConstQualifier iq = inheritedQualifiers.getQualifier(pos); |
//<< " Flavor " << q.getFlavor() |
|
//<< " inherited Flavor "; |
|
|
|
if (pos == PEG_NOT_FOUND) |
|
{ // Qualifier does not exist in superclass |
|
/* If from declaration, we can override the default value. |
|
However, we need some way to get the value if we have a Null. |
|
if (!qd.isFlavor(CIMFlavor::OVERRIDABLE) && qd.isFlavor(CIMFlavor::TOSUBCLASS)) |
|
{ |
|
if(!(q.getValue() == qd.getValue())) |
|
cout << "KSTEST QL err NSCL " << q.getName() |
|
<< " decl flavor " << qd.getFlavor() << " Flavor " << q.getFlavor() |
|
<< " Not override " << !qd.isFlavor(CIMFlavor::OVERRIDABLE) |
|
<< " tosubclass " << qd.isFlavor(CIMFlavor::TOSUBCLASS) << endl; |
|
qd.print(); q.print(); |
|
//throw BadQualifierOverride(q.getName()); |
|
} |
|
//cout << qd.getFlavor() << endl;*/ |
|
// Do not allow change from disable override to enable override. |
|
if(!qd.isFlavor(CIMFlavor::OVERRIDABLE) && q.isFlavor(CIMFlavor::OVERRIDABLE )) |
|
throw BadQualifierOverride(q.getName()); |
| |
if (!(iq.getFlavor() & CIMFlavor::OVERRIDABLE)) |
q.resolveFlavor(qd.getFlavor(), false); |
|
/*if(!(q.getValue() == qd.getValue())) |
|
cout << "KSTEST Flavor resolved from decl. " << q.getName() |
|
<< " decl flavor " << qd.getFlavor() << " Flavor " << q.getFlavor() |
|
<< " Not override " << !qd.isFlavor(CIMFlavor::OVERRIDABLE) |
|
<< " tosubclass " << qd.isFlavor(CIMFlavor::TOSUBCLASS) << endl; |
|
qd.print(); q.print(); */ |
|
} |
|
else // qualifier exists in superclass |
|
{ ////// Make Const again |
|
CIMQualifier iq = inheritedQualifiers.getQualifier(pos); |
|
// don't allow change override to notoverride. |
|
if(!iq.isFlavor(CIMFlavor::OVERRIDABLE) && q.isFlavor(CIMFlavor::OVERRIDABLE )) |
|
throw BadQualifierOverride(q.getName()); |
|
|
|
if (!iq.isFlavor(CIMFlavor::OVERRIDABLE) && iq.isFlavor(CIMFlavor::TOSUBCLASS)) |
|
{ |
|
/*if(!(q.getValue() == iq.getvalue())) |
|
cout << "KSTEST QL err inherit " << q.getName() |
|
<< " from superclass " << iq.getName() |
|
<< " Superclass flavor " << iq.getFlavor() |
|
<< " Flavor " << q.getFlavor() |
|
<< endl; |
|
iq.print(); q.print();*/ |
|
// test if values the same. |
|
CIMValue qv = q.getValue(); |
|
CIMValue iqv = iq.getValue(); |
|
if(!(qv == iqv)) { |
throw BadQualifierOverride(q.getName()); | throw BadQualifierOverride(q.getName()); |
} | } |
#endif |
|
} | } |
|
//cout << iq.getFlavor() << endl; |
|
q.resolveFlavor(iq.getFlavor(), true); |
|
} |
|
} // end of this objects qualifier loop |
| |
//-------------------------------------------------------------------------- | //-------------------------------------------------------------------------- |
// Propagate qualifiers to subclass or to instance that do not have | // Propagate qualifiers to subclass or to instance that do not have |
// already have those qualifiers: | // already have those qualifiers: |
//-------------------------------------------------------------------------- | //-------------------------------------------------------------------------- |
|
//cout << "KSTEST. Inherited qualifiers ct = " << inheritedQualifiers.getCount() << endl; |
| |
for (Uint32 i = 0, n = inheritedQualifiers.getCount(); i < n; i++) | for (Uint32 i = 0, n = inheritedQualifiers.getCount(); i < n; i++) |
{ | { |
CIMQualifier iq = inheritedQualifiers.getQualifier(i); | CIMQualifier iq = inheritedQualifiers.getQualifier(i); |
|
//cout << "KSTEST inherited qualifier propagate loop " << iq.getName() |
|
//<< " flavor " << iq.getFlavor << " count " << i << endl; |
| |
if (isInstancePart) | if (isInstancePart) |
{ | { |
if (!(iq.getFlavor() & CIMFlavor::TOINSTANCE)) |
if (!iq.isFlavor(CIMFlavor::TOINSTANCE)) |
continue; | continue; |
} | } |
else | else |
{ | { |
if (!(iq.getFlavor() & CIMFlavor::TOSUBCLASS)) |
if (!iq.isFlavor(CIMFlavor::TOSUBCLASS)) |
continue; | continue; |
} | } |
| |
// If the qualifiers list does not already contain this qualifier, | // If the qualifiers list does not already contain this qualifier, |
// then propagate it (and set the propagated flag to true). |
// then propagate it (and set the propagated flag to true). Else we |
|
// keep current value. Note we have already eliminated any possibity that |
if (find(iq.getName()) != Uint32(-1)) |
// a nonoverridable qualifier can be in the list. |
|
// Note that there is no exists() function ATTN:KS 25 Mar 2002 |
|
if(find(iq.getName()) != PEG_NOT_FOUND) |
continue; | continue; |
| |
CIMQualifier q = iq.clone(); | CIMQualifier q = iq.clone(); |
|
|
| |
void CIMQualifierList::toXml(Array<Sint8>& out) const | void CIMQualifierList::toXml(Array<Sint8>& out) const |
{ | { |
for (Uint32 i = 0, n = _qualifiers.getSize(); i < n; i++) |
for (Uint32 i = 0, n = _qualifiers.size(); i < n; i++) |
_qualifiers[i].toXml(out); | _qualifiers[i].toXml(out); |
} | } |
| |
void CIMQualifierList::print(std::ostream &os) const |
/** toMof - Generates MOF output for a list of CIM Qualifiers. |
|
The qualifiers may be class, property, parameter, etc. |
|
The BNF for this is: |
|
<pre> |
|
qualifierList = "[" qualifier *( "," qualifier ) "]" |
|
</pre> |
|
Produces qualifiers as a string on without nl. |
|
*/ |
|
void CIMQualifierList::toMof(Array<Sint8>& out) const |
|
{ |
|
// if no qualifiers, return |
|
if (_qualifiers.size() == 0) |
|
return; |
|
|
|
// Qualifier leading bracket. |
|
out <<"["; |
|
|
|
// Loop to list qualifiers |
|
for (Uint32 i = 0, n = _qualifiers.size(); i < n; i++) |
|
{ |
|
// if second or greater, add comma separator |
|
if (i > 0) |
|
out << ", \n"; |
|
_qualifiers[i].toMof(out); |
|
} |
|
|
|
// Terminating bracket |
|
out << "]"; |
|
} |
|
|
|
|
|
void CIMQualifierList::print(PEGASUS_STD(ostream) &os) const |
{ | { |
Array<Sint8> tmp; | Array<Sint8> tmp; |
toXml(tmp); | toXml(tmp); |
tmp.append('\0'); | tmp.append('\0'); |
os << tmp.getData() << std::endl; |
os << tmp.getData() << PEGASUS_STD(endl); |
} | } |
| |
Boolean CIMQualifierList::identical(const CIMQualifierList& x) const | Boolean CIMQualifierList::identical(const CIMQualifierList& x) const |
|
|
return false; | return false; |
| |
for (Uint32 i = 0; i < count; i++) | for (Uint32 i = 0; i < count; i++) |
return _qualifiers[i].identical(x._qualifiers[i]); |
{ |
|
if (!_qualifiers[i].identical(x._qualifiers[i])) |
|
return false; |
|
} |
| |
return true; | return true; |
} | } |
|
|
void CIMQualifierList::cloneTo(CIMQualifierList& x) const | void CIMQualifierList::cloneTo(CIMQualifierList& x) const |
{ | { |
x._qualifiers.clear(); | x._qualifiers.clear(); |
x._qualifiers.reserve(_qualifiers.getSize()); |
x._qualifiers.reserve(_qualifiers.size()); |
| |
for (Uint32 i = 0, n = _qualifiers.getSize(); i < n; i++) |
for (Uint32 i = 0, n = _qualifiers.size(); i < n; i++) |
x._qualifiers.append(_qualifiers[i].clone()); | x._qualifiers.append(_qualifiers[i].clone()); |
} | } |
| |