OWBI1::BI1SimpleAssociatorProviderIFC Class Reference

class BI1SimpleAssociatorProviderIFC The intent of this class is to simplify the writing of Associator Providers. More...

#include <OWBI1_SimpleAssociatorProviderIFC.hpp>

Inheritance diagram for OWBI1::BI1SimpleAssociatorProviderIFC:

Inheritance graph
[legend]
Collaboration diagram for OWBI1::BI1SimpleAssociatorProviderIFC:

Collaboration graph
[legend]
List of all members.

Public Member Functions

virtual void associators (const ProviderEnvironmentIFCRef &env, CIMInstanceResultHandlerIFC &result, const String &ns, const CIMObjectPath &objectName, const CIMName &assocClass, const CIMName &resultClass, const CIMName &role, const CIMName &resultRole, const CIMPropertyList &propertyList)
 This method is invoked in order to do the Associators operation as defined by the CIM operations over HTTP spec at http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm#SecAssociators This operation is used to enumerate CIM Instances that are associated to a particular source CIM Object.
virtual void associatorNames (const ProviderEnvironmentIFCRef &env, CIMObjectPathResultHandlerIFC &result, const String &ns, const CIMObjectPath &objectName, const CIMName &assocClass, const CIMName &resultClass, const CIMName &role, const CIMName &resultRole)
 For the definition of this operation, refer to http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm#SecAssociatorNames This operation is used to enumerate the names of CIM Instances that are associated to a particular source CIM Instance.
virtual void references (const ProviderEnvironmentIFCRef &env, CIMInstanceResultHandlerIFC &result, const String &ns, const CIMObjectPath &objectName, const CIMName &resultClass, const CIMName &role, const CIMPropertyList &propertyList)
 For definition of this operation, refer to http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm#SecReferencesMethod This operation is used to enumerate the association objects that refer to a particular target CIM Instance.
virtual void referenceNames (const ProviderEnvironmentIFCRef &env, CIMObjectPathResultHandlerIFC &result, const String &ns, const CIMObjectPath &objectName, const CIMName &resultClass, const CIMName &role)
 For definition of this operation, refer to ttp://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm::SecReferenceNames This operation is used to enumerate the association objects that refer to a particular target CIM Instance.

Protected Member Functions

virtual void doReferences (const ProviderEnvironmentIFCRef &env, CIMInstanceResultHandlerIFC &result, const String &ns, const CIMObjectPath &objectName, const CIMClass &assocClass, const CIMName &resultClass, const CIMName &role, const CIMName &resultRole)=0
 This method is invoked in order to do the Associators, AssociatorNames, References, and ReferenceNames operation as defined by the CIM operations over HTTP spec at http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm#SecAssociators This operation is used to enumerate CIM Instances of a particular Association class.

Detailed Description

class BI1SimpleAssociatorProviderIFC The intent of this class is to simplify the writing of Associator Providers.

Instead of implementing four functions (referneceNames, references, associators, associatorNames), you just have to implement one: doReferences(). doReferences() is a modified version of references. This base class does the work of providing the CIMOM with the four original functions based on what is returned from doReferences.

Definition at line 55 of file OWBI1_SimpleAssociatorProviderIFC.hpp.


Member Function Documentation

void OWBI1::BI1SimpleAssociatorProviderIFC::associatorNames const ProviderEnvironmentIFCRef env,
CIMObjectPathResultHandlerIFC result,
const String ns,
const CIMObjectPath objectName,
const CIMName assocClass,
const CIMName resultClass,
const CIMName role,
const CIMName resultRole
[virtual]
 

For the definition of this operation, refer to http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm#SecAssociatorNames This operation is used to enumerate the names of CIM Instances that are associated to a particular source CIM Instance.

Parameters:
assocClass see associator parameter assocClass
objectName see associator parameter objectName
resultClass see associator parameter resultClass
role see associator parameter role
resultRole see associator parameter resultRole
Returns:
If successful, the method returns zero or more full CIM Instance of Objects meeting the requested criteria.
Exceptions:
CIMException - as defined in the associator method

Implements OWBI1::BI1AssociatorProviderIFC.

Definition at line 230 of file OWBI1_SimpleAssociatorProviderIFC.cpp.

References doReferences(), env, ns, and result.

void OWBI1::BI1SimpleAssociatorProviderIFC::associators const ProviderEnvironmentIFCRef env,
CIMInstanceResultHandlerIFC result,
const String ns,
const CIMObjectPath objectName,
const CIMName assocClass,
const CIMName resultClass,
const CIMName role,
const CIMName resultRole,
const CIMPropertyList propertyList
[virtual]
 

This method is invoked in order to do the Associators operation as defined by the CIM operations over HTTP spec at http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm#SecAssociators This operation is used to enumerate CIM Instances that are associated to a particular source CIM Object.

Parameters:
assocClass Defines the association that the objectName object should be associated to. The provider uses this information to identify which association must be traversed in case it supports more than one association.
objectName Defines the source CIM Object whose associated Objects are to be returned. This is an instance name. Instance name (modelpath).
resultClass The resultClass input parameter, if not empty (""), MUST be a valid CIM Class name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be either an Instance of this Class (or one of its subclasses) or be this Class (or one of its subclasses).
role The role input parameter, if not empty (""), MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Association in which the source Object plays the specified role (i.e. the name of the Property in the Association Class that refers to the source Object MUST match the value of this parameter).
resultRole The resultRole input parameter if not empty (""), MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Association in which the returned Object plays the specified role (i.e. the name of the Property in the Association Class that refers to the returned Object MUST match the value of this parameter).
includeQualifiers If the includeQualifiers input parameter is true this specifies that all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included as elements in the response. If false no elements are present in each returned Object.
includeClassOrigin If the includeClassOrigin input parameter is true, this specifies that the CLASSORIGIN attribute MUST be present on all appropriate elements in each returned Object. If false, no CLASSORIGIN attributes are present in each returned Object.
propertyList If the propertyList input parameter is not NULL the members of the array define one or more Property names. Each returned Object MUST NOT include elements for any Properties missing from this list. Note that if localOnly is specified as true (or deepInheritance is specified as false) this acts as an additional filter on the set or Properties returned (for example, if Property A is included in the propertyList but localOnly is set to true and A is not local to a returned Instance, then it will not be included in that Instance). If the propertyList input parameter is an empty array this signifies that no Properties are included in each returned Object. If the propertyList parameter is omitted this specifies that all Properties (subject to the conditions expressed by the other parameters) are included in each returned Object. If the propertyList contains duplicate elements, the Server ignores the duplicates but otherwise processes the request normally. If the propertyList contains elements which are invalid Property names for any target Object, the Server ignores such entries but should otherwise process the request normally. Clients SHOULD NOT explicitly specify properties in the propertyList parameter unless they have specified a non-empty value for the resultClass parameter.
Returns:
If successful, the method returns zero or more CIM Instances meeting the requested criteria.
Exceptions:
CIMException. - The following IDs can be expected. CIM_ERR_ACCESS_DENIED CIM_ERR_NOT_SUPPORTED CIM_ERR_INVALID_NAMESPACE CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or otherwise incorrect parameters) CIM_ERR_FAILED (some other unspecifed error occurred)

Implements OWBI1::BI1AssociatorProviderIFC.

Definition at line 209 of file OWBI1_SimpleAssociatorProviderIFC.cpp.

References doReferences(), env, ns, propertyList, and result.

virtual void OWBI1::BI1SimpleAssociatorProviderIFC::doReferences const ProviderEnvironmentIFCRef env,
CIMInstanceResultHandlerIFC result,
const String ns,
const CIMObjectPath objectName,
const CIMClass assocClass,
const CIMName resultClass,
const CIMName role,
const CIMName resultRole
[protected, pure virtual]
 

This method is invoked in order to do the Associators, AssociatorNames, References, and ReferenceNames operation as defined by the CIM operations over HTTP spec at http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm#SecAssociators This operation is used to enumerate CIM Instances of a particular Association class.

Parameters:
assocClass Defines the association that the objectName object should be associated to. The provider uses this information to identify which association must be traversed in case it supports more than one association.
objectName Defines the source CIM Object whose associated Objects are to be returned. This is an instance name. Instance name (modelpath).
resultClass The resultClass input parameter, if not empty (""), MUST be a valid CIM Class name. It acts as a filter on the returned set of Objects by mandating that the resultRole of each returned Object MUST be an ObjectPath to either an Instance of this Class (or one of its subclasses) or be this Class (or one of its subclasses).
role The role input parameter, if not empty (""), MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Association in which the source Object plays the specified role (i.e. the name of the Property in the Association Class that refers to the source Object MUST match the value of this parameter).
resultRole The resultRole input parameter if not empty (""), MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST contain a reference (ObjectPath) to an Instance or Class which is associated to the source Object via an Association in which the Associated Object plays the specified role (i.e. the name of the Property in the Association Class that refers to the Associated Object MUST match the value of this parameter).
Returns:
If successful, the method returns zero or more CIM Instances meeting the requested criteria.
Exceptions:
CIMException. - The following IDs can be expected. CIM_ERR_ACCESS_DENIED CIM_ERR_NOT_SUPPORTED CIM_ERR_INVALID_NAMESPACE CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or otherwise incorrect parameters) CIM_ERR_FAILED (some other unspecifed error occurred)
+------------------+ +-----------------+ | ObjectNameClass | | ResultClass | | ~~~~~~~~~~~~~~~ | | ~~~~~~~~~~~ | +------------------+ +-----------------+ | +----------------------------+ | | | [Association] AssocClass | | | ObjectName | ~~~~~~~~~~~~~~~~~~~~~~~~ | | +----------------+ ObjectNameClass REF Role | | (CIMObjectPath) | ResultClass REF ResultRole +-----------------+ | | (CIMObjectPath) +----------------------------+

Referenced by associatorNames(), associators(), referenceNames(), and references().

void OWBI1::BI1SimpleAssociatorProviderIFC::referenceNames const ProviderEnvironmentIFCRef env,
CIMObjectPathResultHandlerIFC result,
const String ns,
const CIMObjectPath objectName,
const CIMName resultClass,
const CIMName role
[virtual]
 

For definition of this operation, refer to ttp://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm::SecReferenceNames This operation is used to enumerate the association objects that refer to a particular target CIM Instance.

Parameters:
resultClass see the reference method.
objectName see the reference method.
role see the reference method
Returns:
If successful, the method returns the names of zero or more full CIM Instance paths of Objects meeting the requested criteria.
Exceptions:
CIMException - as defined for associators method.

Implements OWBI1::BI1AssociatorProviderIFC.

Definition at line 281 of file OWBI1_SimpleAssociatorProviderIFC.cpp.

References doReferences(), env, ns, and result.

void OWBI1::BI1SimpleAssociatorProviderIFC::references const ProviderEnvironmentIFCRef env,
CIMInstanceResultHandlerIFC result,
const String ns,
const CIMObjectPath objectName,
const CIMName resultClass,
const CIMName role,
const CIMPropertyList propertyList
[virtual]
 

For definition of this operation, refer to http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm#SecReferencesMethod This operation is used to enumerate the association objects that refer to a particular target CIM Instance.

Parameters:
resultClass Defines the association that the objectName object should be associated to. The provider uses this information to identify which association must be traversed in case it supports more than one association.
objectName The objectName input parameter defines the target CIM Object whose referring Objects are to be returned. This is an Instance name (model path).
role The role input parameter, if not empty (""), MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST refer to the target Object via a Property whose name matches the value of this parameter.
includeQualifiers see the includeQualifiers for associators.
includeClassOrigin see the includeClassOrigin for associators.
propertyList see the propertyList for associators
Returns:
If successful, the method returns zero or more CIM Instances meeting the requested criteria.
Exceptions:
CIMException - as defined for the associators method.

Implements OWBI1::BI1AssociatorProviderIFC.

Definition at line 251 of file OWBI1_SimpleAssociatorProviderIFC.cpp.

References doReferences(), env, ns, propertyList, and result.


The documentation for this class was generated from the following files:
Generated on Thu Feb 9 09:18:57 2006 for openwbem by  doxygen 1.4.6