version 1.24.2.7, 2001/11/08 23:15:30
|
version 1.27, 2002/02/20 23:14:19
|
|
|
// | // |
// Modified By: Carol Ann Krug Graves, Hewlett-Packard Company | // Modified By: Carol Ann Krug Graves, Hewlett-Packard Company |
// (carolann_graves@hp.com) | // (carolann_graves@hp.com) |
// |
|
// Nitin Upasani, Hewlett-Packard Company (Nitin_Upasani@hp.com) | // Nitin Upasani, Hewlett-Packard Company (Nitin_Upasani@hp.com) |
|
// Roger Kumpf, Hewlett-Packard Company (roger_kumpf@hp.com) |
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
|
|
#include "CIMClass.h" | #include "CIMClass.h" |
#include "CIMInstance.h" | #include "CIMInstance.h" |
#include "CIMObject.h" | #include "CIMObject.h" |
|
#include "CIMNamedInstance.h" |
#include "CIMParamValue.h" | #include "CIMParamValue.h" |
| |
PEGASUS_USING_STD; | PEGASUS_USING_STD; |
|
|
// | // |
// getCimTypeAttribute() | // getCimTypeAttribute() |
// | // |
|
// This method can be used to get a TYPE attribute or a PARAMTYPE attribute. |
|
// The only significant difference is that PARAMTYPE may specify a value of |
|
// "reference" type. This method recognizes these attributes by name, and |
|
// does not allow a "TYPE" attribute to be of "reference" type. |
|
// |
// <!ENTITY % CIMType "TYPE (boolean|string|char16|uint8|sint8|uint16 | // <!ENTITY % CIMType "TYPE (boolean|string|char16|uint8|sint8|uint16 |
// |sint16|uint32|sint32|uint64|sint64|datetime|real32|real64)"> | // |sint16|uint32|sint32|uint64|sint64|datetime|real32|real64)"> |
// | // |
|
// <!ENTITY % ParamType "PARAMTYPE (boolean|string|char16|uint8|sint8 |
|
// |uint16|sint16|uint32|sint32|uint64|sint64|datetime|real32|real64 |
|
// |reference)"> |
|
// |
//------------------------------------------------------------------------------ | //------------------------------------------------------------------------------ |
| |
CIMType XmlReader::getCimTypeAttribute( | CIMType XmlReader::getCimTypeAttribute( |
Uint32 lineNumber, | Uint32 lineNumber, |
const XmlEntry& entry, | const XmlEntry& entry, |
const char* tagName) |
const char* tagName, |
|
const char* attributeName, |
|
Boolean required) |
{ | { |
const char* typeName; | const char* typeName; |
| |
if (!entry.getAttributeValue("TYPE", typeName)) |
if (!entry.getAttributeValue(attributeName, typeName)) |
|
{ |
|
if (required) |
{ | { |
char message[MESSAGE_SIZE]; | char message[MESSAGE_SIZE]; |
sprintf(message, "missing %s.TYPE attribute", tagName); |
sprintf(message, "missing %s.%s attribute", tagName, attributeName); |
throw XmlValidationError(lineNumber, message); | throw XmlValidationError(lineNumber, message); |
} | } |
|
else |
|
{ |
|
return CIMType::NONE; |
|
} |
|
} |
| |
CIMType type = CIMType::NONE; | CIMType type = CIMType::NONE; |
| |
|
|
type = CIMType::REAL32; | type = CIMType::REAL32; |
else if (strcmp(typeName, "real64") == 0) | else if (strcmp(typeName, "real64") == 0) |
type = CIMType::REAL64; | type = CIMType::REAL64; |
|
else if (strcmp(typeName, "reference") == 0) |
|
type = CIMType::REFERENCE; |
| |
if (type == CIMType::NONE) |
if ((type == CIMType::NONE) || |
|
((type == CIMType::REFERENCE) && |
|
(strcmp(attributeName, "PARAMTYPE") != 0))) |
{ | { |
char message[MESSAGE_SIZE]; | char message[MESSAGE_SIZE]; |
sprintf(message, "Illegal value for %s.TYPE attribute", tagName); |
sprintf(message, "Illegal value for %s.%s attribute", tagName, |
|
attributeName); |
throw XmlSemanticError(lineNumber, message); | throw XmlSemanticError(lineNumber, message); |
} | } |
| |
|
|
| |
//------------------------------------------------------------------------------ | //------------------------------------------------------------------------------ |
// | // |
|
// getParameterReferenceArrayElement() |
|
// |
|
// <!ELEMENT PARAMETER.REFARRAY (QUALIFIER*)> |
|
// <!ATTLIST PARAMETER.REFARRAY |
|
// %CIMName; |
|
// %ReferenceClass; |
|
// %ArraySize;> |
|
// |
|
//------------------------------------------------------------------------------ |
|
|
|
Boolean XmlReader::getParameterReferenceArrayElement( |
|
XmlParser& parser, |
|
CIMParameter& parameter) |
|
{ |
|
XmlEntry entry; |
|
|
|
if (!testStartTagOrEmptyTag(parser, entry, "PARAMETER.REFARRAY")) |
|
return false; |
|
|
|
Boolean empty = entry.type == XmlEntry::EMPTY_TAG; |
|
|
|
// Get PARAMETER.NAME attribute: |
|
|
|
String name = getCimNameAttribute( |
|
parser.getLine(), entry, "PARAMETER.REFARRAY"); |
|
|
|
// Get PARAMETER.REFERENCECLASS attribute: |
|
|
|
String referenceClass = getReferenceClassAttribute( |
|
parser.getLine(), entry, "PARAMETER.REFARRAY"); |
|
|
|
// Get PARAMETER.ARRAYSIZE attribute: |
|
|
|
Uint32 arraySize = 0; |
|
getArraySizeAttribute(parser.getLine(), entry, "PARAMETER.REFARRAY", |
|
arraySize); |
|
|
|
// Create parameter: |
|
|
|
parameter = CIMParameter(name, CIMType::REFERENCE, true, arraySize, |
|
referenceClass); |
|
|
|
if (!empty) |
|
{ |
|
getQualifierElements(parser, parameter); |
|
expectEndTag(parser, "PARAMETER.REFARRAY"); |
|
} |
|
|
|
return true; |
|
} |
|
|
|
//------------------------------------------------------------------------------ |
|
// |
// GetParameterElements() | // GetParameterElements() |
// | // |
//------------------------------------------------------------------------------ | //------------------------------------------------------------------------------ |
|
|
| |
while (XmlReader::getParameterElement(parser, parameter) || | while (XmlReader::getParameterElement(parser, parameter) || |
XmlReader::getParameterArrayElement(parser, parameter) || | XmlReader::getParameterArrayElement(parser, parameter) || |
XmlReader::getParameterReferenceElement(parser, parameter)) |
XmlReader::getParameterReferenceElement(parser, parameter) || |
|
XmlReader::getParameterReferenceArrayElement(parser, parameter)) |
{ | { |
try | try |
{ | { |
|
|
| |
if (!empty) | if (!empty) |
{ | { |
|
// ATTN-RK-P2-20020219: Decoding algorithm must not depend on the |
|
// ordering of qualifiers and parameters. |
getQualifierElements(parser, method); | getQualifierElements(parser, method); |
| |
GetParameterElements(parser, method); | GetParameterElements(parser, method); |
|
|
} | } |
| |
//------------------------------------------------------------------------------ | //------------------------------------------------------------------------------ |
|
// getNamedInstanceElement() |
|
// |
|
// <!ELEMENT VALUE.NAMEDINSTANCE (INSTANCENAME,INSTANCE)> |
|
// |
|
//------------------------------------------------------------------------------ |
|
|
|
Boolean XmlReader::getNamedInstanceElement( |
|
XmlParser& parser, |
|
CIMNamedInstance& namedInstance) |
|
{ |
|
XmlEntry entry; |
|
|
|
if (!testStartTag(parser, entry, "VALUE.NAMEDINSTANCE")) |
|
return false; |
|
|
|
CIMReference instanceName; |
|
|
|
// Get INSTANCENAME elements: |
|
|
|
if (!getInstanceNameElement(parser, instanceName)) |
|
{ |
|
throw XmlValidationError(parser.getLine(), |
|
"expected INSTANCENAME element"); |
|
} |
|
|
|
CIMInstance instance; |
|
|
|
// Get INSTANCE elements: |
|
|
|
if (!getInstanceElement(parser, instance)) |
|
{ |
|
throw XmlValidationError(parser.getLine(), |
|
"expected INSTANCE element"); |
|
} |
|
|
|
// Get VALUE.NAMEDINSTANCE end tag: |
|
|
|
expectEndTag(parser, "VALUE.NAMEDINSTANCE"); |
|
|
|
namedInstance.set(instanceName, instance); |
|
|
|
return true; |
|
} |
|
|
|
//------------------------------------------------------------------------------ |
// | // |
// getObject() | // getObject() |
// | // |
|
|
CIMReference& objectName) | CIMReference& objectName) |
{ | { |
String className; | String className; |
CIMReference instanceName; |
|
| |
if (getClassNameElement(parser, className, false)) | if (getClassNameElement(parser, className, false)) |
{ | { |
|
|
| |
//------------------------------------------------------------------------------ | //------------------------------------------------------------------------------ |
// | // |
// getParamValueTag() |
// getParamValueElement() |
|
// |
|
// <!ELEMENT PARAMVALUE (VALUE|VALUE.REFERENCE|VALUE.ARRAY|VALUE.REFARRAY)?> |
|
// <!ATTLIST PARAMVALUE |
|
// %CIMName; |
|
// %ParamType;> |
// | // |
//------------------------------------------------------------------------------ | //------------------------------------------------------------------------------ |
| |
Boolean XmlReader::getParamValueTag( |
Boolean XmlReader::getParamValueElement( |
XmlParser& parser, | XmlParser& parser, |
const char*& name) |
CIMParamValue& paramValue) |
{ | { |
XmlEntry entry; | XmlEntry entry; |
|
const char* name; |
|
CIMType type; |
|
CIMValue value; |
| |
if (!testStartTag(parser, entry, "PARAMVALUE")) |
if (!testStartTagOrEmptyTag(parser, entry, "PARAMVALUE")) |
return false; | return false; |
| |
// Get IPARAMVALUE.NAME attribute: |
Boolean empty = entry.type == XmlEntry::EMPTY_TAG; |
|
|
|
// Get PARAMVALUE.NAME attribute: |
| |
if (!entry.getAttributeValue("NAME", name)) | if (!entry.getAttributeValue("NAME", name)) |
throw XmlValidationError(parser.getLine(), | throw XmlValidationError(parser.getLine(), |
"Missing PARAMVALUE.NAME attribute"); | "Missing PARAMVALUE.NAME attribute"); |
| |
|
// Get PARAMVALUE.PARAMTYPE attribute: |
|
|
|
type = getCimTypeAttribute(parser.getLine(), entry, "PARAMVALUE", |
|
"PARAMTYPE", false); |
|
|
|
if (!empty) |
|
{ |
|
// Parse VALUE.REFERENCE and VALUE.REFARRAY type |
|
if ( (type == CIMType::REFERENCE) || (type == CIMType::NONE) ) |
|
{ |
|
CIMReference reference; |
|
if (XmlReader::getValueReferenceElement(parser, reference)) |
|
{ |
|
value.set(reference); |
|
type = CIMType::REFERENCE; |
|
} |
|
// ATTN-RK-P2-20010219: This method does not exist. CIMValue does |
|
// not currently allow for an array of CIMReferences. |
|
//else if (XmlReader::getValueReferenceArrayElement(parser, value)) |
|
//{ |
|
// type = CIMType::REFERENCE; |
|
//} |
|
// If type==reference but no VALUE.REFERENCE found, use null value |
|
} |
|
|
|
// Parse non-reference value |
|
if ( type != CIMType::REFERENCE ) |
|
{ |
|
// If we don't know what type the value is, read it as a String |
|
CIMType effectiveType = type; |
|
if ( effectiveType == CIMType::NONE) |
|
{ |
|
effectiveType = CIMType::STRING; |
|
} |
|
|
|
if ( !XmlReader::getValueArrayElement(parser, effectiveType, value) && |
|
!XmlReader::getValueElement(parser, effectiveType, value) ) |
|
{ |
|
value.clear(); // Isn't necessary; should already be cleared |
|
} |
|
} |
|
|
|
expectEndTag(parser, "PARAMVALUE"); |
|
} |
|
|
|
paramValue = CIMParamValue(CIMParameter(name, type), value); |
|
|
|
return true; |
|
} |
|
|
|
//------------------------------------------------------------------------------ |
|
// |
|
// getReturnValueElement() |
|
// |
|
// <!ELEMENT RETURNVALUE (VALUE|VALUE.REFERENCE)> |
|
// <!ATTLIST RETURNVALUE |
|
// %ParamType;> |
|
// |
|
//------------------------------------------------------------------------------ |
|
|
|
Boolean XmlReader::getReturnValueElement( |
|
XmlParser& parser, |
|
CIMValue& returnValue) |
|
{ |
|
XmlEntry entry; |
|
CIMType type; |
|
CIMValue value; |
|
|
|
if (!testStartTag(parser, entry, "RETURNVALUE")) |
|
return false; |
|
|
|
// Get RETURNVALUE.PARAMTYPE attribute: |
|
// NOTE: Array type return values are not allowed (2/20/02) |
|
|
|
type = getCimTypeAttribute(parser.getLine(), entry, "RETURNVALUE", |
|
"PARAMTYPE", false); |
|
|
|
// Parse VALUE.REFERENCE type |
|
if ( (type == CIMType::REFERENCE) || (type == CIMType::NONE) ) |
|
{ |
|
CIMReference reference; |
|
if (XmlReader::getValueReferenceElement(parser, reference)) |
|
{ |
|
returnValue.set(reference); |
|
type = CIMType::REFERENCE; |
|
} |
|
else if (type == CIMType::REFERENCE) |
|
{ |
|
throw XmlValidationError(parser.getLine(), |
|
"expected VALUE.REFERENCE element"); |
|
} |
|
} |
|
|
|
// Parse non-reference return value |
|
if ( type != CIMType::REFERENCE ) |
|
{ |
|
// If we don't know what type the value is, read it as a String |
|
if ( type == CIMType::NONE) |
|
{ |
|
type = CIMType::STRING; |
|
} |
|
|
|
if ( !XmlReader::getValueElement(parser, type, returnValue) ) |
|
{ |
|
throw XmlValidationError(parser.getLine(), |
|
"expected VALUE element"); |
|
} |
|
} |
|
|
|
expectEndTag(parser, "RETURNVALUE"); |
|
|
return true; | return true; |
} | } |
| |