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

Return to CIMResponseData.h CVS log

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

Diff for /pegasus/src/Pegasus/Common/CIMResponseData.h between version 1.6.2.2 and 1.12

version 1.6.2.2, 2011/10/11 18:18:08

version 1.12, 2013/03/28 19:54:32

Line 27

//////////////////////////////////////////////////////////////////////////

// Class CIMResponseData encapsulates the possible types of response data

// representations and supplies conversion methods between these types.

// PEP#348 - The CMPI infrastructure using SCMO (Single Chunk Memory Objects)

// describes its usage in the server flow.

// The design document can be found on the OpenPegasus website openpegasus.org

// at https://collaboration.opengroup.org/pegasus/pp/documents/21210/PEP_348.pdf

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

#ifndef Pegasus_CIMResponseData_h

Line 38

Line 45

#include <Pegasus/Common/CIMBuffer.h>

#include <Pegasus/Common/SCMOClass.h>

#include <Pegasus/Common/SCMOInstance.h>

#include <Pegasus/Common/SCMODump.h>

#include <Pegasus/Common/Magic.h>

PEGASUS_NAMESPACE_BEGIN

PEGASUS_USING_STD;

typedef Array<Sint8> ArraySint8;

#define PEGASUS_ARRAY_T ArraySint8

# include <Pegasus/Common/ArrayInter.h>

#undef PEGASUS_ARRAY_T

class PEGASUS_COMMON_LINKAGE CIMResponseData

{

public:

Line 68

Line 74

};

//includeClassOrigin & _includeQualifiers are set to true by default.

//_propertyList is initialized to an empty propertylist to enable

// sending all properties by default.

// sending all properties by default. _isClassOperation set false and

// only reset by selected operations (ex. associator response builder)

CIMResponseData(ResponseDataContent content):

_encoding(0),_mapObjectsToIntances(false),_dataType(content), _size(0),

_encoding(0),_dataType(content),_includeQualifiers(true),

_includeQualifiers(true),_includeClassOrigin(true),

_includeClassOrigin(true),

_isClassOperation(false),

_propertyList(CIMPropertyList())

{

PEGASUS_ASSERT(valid()); // KS_TEMP

}

CIMResponseData(const CIMResponseData & x):

_encoding(x._encoding),

_mapObjectsToIntances(x._mapObjectsToIntances),

_dataType(x._dataType),

_size(x._size),

_referencesData(x._referencesData),

_instanceData(x._instanceData),

_hostsData(x._hostsData),

Line 95

Line 100

_scmoInstances(x._scmoInstances),

_includeQualifiers(x._includeQualifiers),

_includeClassOrigin(x._includeClassOrigin),

_propertyList(x._propertyList),

_isClassOperation(x._isClassOperation),

_magic(x._magic)

_propertyList(x._propertyList)

{

/////PEGASUS_ASSERT(x.valid()); // KS_TEMP

PEGASUS_ASSERT(valid()); // KS_TEMP

}

// Construct an empty object. Issue here in that we would like to

// assure that this is invalid but if we add the _dataType parameter

// it must be a valid one. The alternative would be to define an

// invalid enum but that would cost us in all case/if statements.

// Therefore up to the user to create and then use correctly.

// KS_TODO fix this so that the empty state is somehow protected.

CIMResponseData():

_encoding(0),_mapObjectsToIntances(false), _size(0),

_includeQualifiers(true), _includeClassOrigin(true),

_propertyList(CIMPropertyList())

{}

/**

* Move CIM objects from another CIMResponse data object to this

* CIMResponseData object. Moves the number of objects defined

* in the count parameter from one to another. They are removed

* from the from object and inserted into the to object.

* @param CIMResponseData from which the objects are moved

* @param count Uint32 count of objects to move

* @return - Actual number of objects moved.

Uint32 moveObjects(CIMResponseData & x, Uint32 count);

/**

* Return count of the number of CIM objects in the

* CIMResponseData object

* @return Uint32 The count of the number of CIM objects

* (instances, paths, or objects)in the CIMResponsedata object

Uint32 size();

~CIMResponseData()

{

}

// This one may be a hack but we have issue with pull and other operations

// in that the other assoc operations return objects and objectPaths

// and the pulls return instances and instancePaths). The pull operation

// must be able to handle either so we use this to reset the datatype

// KS_TODO -- This should check size and only allow if nothing in the

// object.

Boolean setDataType(ResponseDataContent content)

{

PEGASUS_ASSERT(valid());

PEGASUS_ASSERT(_size == 0); // KS_TODO_TEMP or debug mode.

_dataType = content;

return true;

}

// get the datatype property

ResponseDataContent getResponseDataContent()

{

PEGASUS_ASSERT(valid()); // KS_TEMP KS_TODO

return _dataType;

}

// C++ objects interface handling

// Instance Names handling

Line 167

Line 118

{

_instanceNames=x;

_encoding |= RESP_ENC_CIM;

_size += x.size();

}

// Instance handling

Line 175

Line 125

void setInstance(const CIMInstance& x)

{

SVALID();

_instances.clear();

_instances.append(x);

_size++;

_encoding |= RESP_ENC_CIM;

SVALID();

}

// Instances handling

Array<CIMInstance>& getInstances();

// Get an array of CIMInstances from the CIMResponseData converting from

// any of the internal forms to the C++ format. This will also convert

// CIMObjects to CIMInstances if there are any CIMObjects.

// NOTE: This is a temporary solution to satisfy the BinaryCodec passing

// of data to the client where the data could be either instances or

// objects. The correct solution is to convert back when the provider, etc.

// returns the data to the server. We must convert to that solution but

// this keeps the BinaryCodec working for the moment.

// Expect that this will be used only in CIMCLient.cpp

Array<CIMInstance>& getInstancesFromInstancesOrObjects();

void setInstances(const Array<CIMInstance>& x)

{

SVALID();

_instances=x;

_encoding |= RESP_ENC_CIM;

_size += x.size();

SVALID();

}

void appendInstance(const CIMInstance& x)

{

PEGASUS_ASSERT(valid());

_instances.append(x);

_encoding |= RESP_ENC_CIM;

_size += 1;

}

void appendInstances(const Array<CIMInstance>& x)

{

PEGASUS_ASSERT(valid());

_instances.appendArray(x);

_encoding |= RESP_ENC_CIM;

_size += x.size();

}

// Objects handling

Array<CIMObject>& getObjects();

void setObjects(const Array<CIMObject>& x)

{

PEGASUS_ASSERT(valid());

_objects=x;

_encoding |= RESP_ENC_CIM;

_size += x.size();

}

void appendObject(const CIMObject& x)

{

PEGASUS_ASSERT(valid());

_objects.append(x);

_encoding |= RESP_ENC_CIM;

_size += 1;

}

// SCMO representation, single instance stored as one element array

Line 248

Line 165

void appendSCMO(const Array<SCMOInstance>& x)

{

PEGASUS_ASSERT(valid());

_scmoInstances.appendArray(x);

_encoding |= RESP_ENC_SCMO;

_size += x.size();

}

Array<Uint8>& getBinary();

Line 284

Line 199

// Encoding responses

// Encode the CIMResponse data into binary format used with Provider Agents

// binary format used with Provider Agents and OP Clients

// and OP Clients in the provider CIMBuffer

void encodeBinaryResponse(CIMBuffer& out);

// Xml format used with Provider Agents only

// Encode the CIMResponse data into Xml format used with Provider Agents

// only in the provided CIMBuffer

void encodeInternalXmlResponse(CIMBuffer& out);

// Encode the CIMResponse data into official Xml format(CIM over Http)

// used to communicate to clients in the provided CIMBuffer.

//Note that the pull responses requires a flag.

void encodeXmlResponse(Buffer& out, Boolean isPull);

// diagnostic tests magic number in context to see if valid object

Boolean valid();

// official Xml format(CIM over Http) used to communicate to clients

void encodeXmlResponse(Buffer& out);

Line 311

Line 214

const Boolean includeClassOrigin,

const CIMPropertyList& propertyList);

// Used with association and reference operations (i.e. operations that

// return CIMObject or CIMObjectPath to set a parameter to define whether

// responseData is for operation on a class or instance.

// Allows building the correct path (classPath or instancePath) and

// object type (Class or Instance) on response.

void setIsClassOperation(Boolean b);

void setPropertyList(const CIMPropertyList& propertyList)

{

_propertyList = propertyList;

Line 320

Line 230

return _propertyList;

}

void SVALID(); //KS_TEMP

private:

// helper functions to transform different formats into one-another

Line 344

Line 252

SCMOInstance _getSCMOFromCIMObject(const CIMObject& cimObj);

SCMOInstance _getSCMOFromCIMObjectPath(const CIMObjectPath& cimPath);

SCMOClass* _getSCMOClass(const char* ns,const char* cls);

void _deserializeInstance(Uint32 idx,CIMInstance& cimInstance);

void _deserializeObject(Uint32 idx,CIMObject& cimObject);

Boolean _deserializeReference(Uint32 idx,CIMObjectPath& cimObjectPath);

Boolean _deserializeInstanceName(Uint32 idx,CIMObjectPath& cimObjectPath);

// Bitflags in this integer will reflect what data representation types

// are currently stored in this CIMResponseData object

Uint32 _encoding;

// Special flag to handle the case where binary data in passed through the

// system but must be mapped to instances in the getInstances. This

// accounts for only one case today, binary data in the BinaryCodec

Boolean _mapObjectsToIntances;

// Storing type of data in this enumeration

ResponseDataContent _dataType;

// Count of objects stored in this CIMResponseData object. This is the

// accumulated count of objects stored in all of the data

// representations

Uint32 _size;

// unused arrays are represented by ArrayRepBase _empty_rep

// which is a 16 byte large static shared across all of them

// so, even though this object looks large, it holds just

Line 373

Line 275

Array<String> _hostsData;

Array<CIMNamespaceName> _nameSpacesData;

// For binary encoding.

Array<Uint8> _binaryData;

CIMNamespaceName _defaultNamespace;

Line 385

Line 288

// SCMO encoding

Array<SCMOInstance> _scmoInstances;

// Request characteristics that are carried through operation for

// modification of response generation.

Boolean _includeQualifiers;

Boolean _includeClassOrigin;

// Defines whether response CIMObjects or ObjectPaths are class or instance.

// becasue associators, etc. operations provide both class and instance

// responses

Boolean _isClassOperation;

CIMPropertyList _propertyList;

// magic number to use with valid function to confirm validity

// of response data.

Magic<0x57D11323> _magic;

};

PEGASUS_NAMESPACE_END

Legend:

Removed from v.1.6.2.2
changed lines
	Added in v.1.12

No CVS admin address has been configured