OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv

OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv Class Reference

Inheritance diagram for OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv:

Inheritance graph
[legend]
Collaboration diagram for OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 OpenWBEM_ObjectManagerInstProv ()
virtual void getInstanceProviderInfo (InstanceProviderInfo &info)
 A provider should override this method to report which classes in which namespaces it instruments.
virtual void getAssociatorProviderInfo (AssociatorProviderInfo &info)
 A provider should override this method to report which classes in which namespaces it instruments.
virtual void getIndicationProviderInfo (IndicationProviderInfo &info)
 A provider should override this method to report which classes in which namespaces it instruments.
void activateFilter (const ProviderEnvironmentIFCRef &env, const WQLSelectStatement &filter, const String &eventType, const String &nameSpace, const StringArray &classes, bool firstActivation)
void deActivateFilter (const ProviderEnvironmentIFCRef &env, const WQLSelectStatement &filter, const String &eventType, const String &nameSpace, const StringArray &classes, bool lastActivation)
virtual void initialize (const ProviderEnvironmentIFCRef &env)
 Called by the CIMOM when the provider is initialized.
virtual void shuttingDown (const ProviderEnvironmentIFCRef &env)
 Called by the CIMOM just before it starts shutting down services.
void doSimpleEnumInstances (const ProviderEnvironmentIFCRef &env, const String &ns, const CIMClass &cimClass, CIMInstanceResultHandlerIFC &result, EPropertiesFlag propertiesFlag)
void doReferences (const ProviderEnvironmentIFCRef &env, CIMInstanceResultHandlerIFC &result, const String &ns, const CIMObjectPath &objectName, const CIMClass &assocClass, const String &resultClass, const String &role, const String &resultRole)
 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.

Static Public Member Functions

static CIMInstance createTheInstance (const ProviderEnvironmentIFCRef &env, const String &omName)

Private Attributes

CIMInstance m_inst
bool m_haveSubscriptions

Detailed Description

Definition at line 62 of file OW_provinstOpenWBEM_ObjectManager.cpp.

Constructor & Destructor Documentation

OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::OpenWBEM_ObjectManagerInstProv (   )  [inline]
 

Definition at line 77 of file OW_provinstOpenWBEM_ObjectManager.cpp.

Member Function Documentation

void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::activateFilter (  const ProviderEnvironmentIFCRef &  env,
const WQLSelectStatement &  filter,
const String &  eventType,
const String &  nameSpace,
const StringArray &  classes,
bool  firstActivation
)  [inline, virtual]
 

Reimplemented from OW_NAMESPACE::CppIndicationProviderIFC.

Definition at line 135 of file OW_provinstOpenWBEM_ObjectManager.cpp.

static CIMInstance OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::createTheInstance (  const ProviderEnvironmentIFCRef &  env,
const String &  omName
)  [inline, static]
 

Definition at line 243 of file OW_provinstOpenWBEM_ObjectManager.cpp.

References OW_NAMESPACE::Class_OpenWBEM_ComputerSystem, OW_NAMESPACE::CLASS_OpenWBEM_ObjectManager, env, hdl, OW_NAMESPACE::ConfigOpts::INTEROP_SCHEMA_NAMESPACE_opt, OW_DEFAULT_INTEROP_SCHEMA_NAMESPACE, and OW_THROWCIMMSG.

void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::deActivateFilter (  const ProviderEnvironmentIFCRef &  env,
const WQLSelectStatement &  filter,
const String &  eventType,
const String &  nameSpace,
const StringArray &  classes,
bool  lastActivation
)  [inline, virtual]
 

Reimplemented from OW_NAMESPACE::CppIndicationProviderIFC.

Definition at line 147 of file OW_provinstOpenWBEM_ObjectManager.cpp.

void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::doReferences (  const ProviderEnvironmentIFCRef &  env,
CIMInstanceResultHandlerIFC &  result,
const String &  ns,
const CIMObjectPath &  objectName,
const CIMClass &  assocClass,
const String &  resultClass,
const String &  role,
const String &  resultRole
)  [inline, 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) +----------------------------+

Implements OW_NAMESPACE::CppSimpleAssociatorProviderIFC.

Definition at line 311 of file OW_provinstOpenWBEM_ObjectManager.cpp.

References env, ns, and result.

void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::doSimpleEnumInstances (  const ProviderEnvironmentIFCRef &  env,
const String &  ns,
const CIMClass &  cimClass,
CIMInstanceResultHandlerIFC &  result,
EPropertiesFlag  propertiesFlag
)  [inline]
 

Definition at line 283 of file OW_provinstOpenWBEM_ObjectManager.cpp.

References cimClass, OW_NAMESPACE::CLASS_OpenWBEM_ObjectManager, OW_NAMESPACE::CIMClass::getName(), OW_NAMESPACE::ResultHandlerIFC< T >::handle(), and result.

virtual void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::getAssociatorProviderInfo (  AssociatorProviderInfo &  info  )  [inline, virtual]
 

A provider should override this method to report which classes in which namespaces it instruments.

It should insert an entry for each class it is responsible for. The entry consists of the class name and an optional list of namespaces. If the namespace list is empty, all namespaces are implied. If the method does nothing, then the provider's class must have a provider qualifier that identifies the provider. This old behavior is deprecated and will be removed sometime in the future. This method has a default implementation that does nothing, to allow old providers to be migrated forward with little or no change, but once the old provider location method is removed, this member function will be pure virtual.

Reimplemented from OW_NAMESPACE::CppAssociatorProviderIFC.

Definition at line 92 of file OW_provinstOpenWBEM_ObjectManager.cpp.

References OW_NAMESPACE::ProviderInfoBase< ClassInfoT >::addInstrumentedClass(), and OW_NAMESPACE::CLASS_OpenWBEM_HostedObjectManager.

virtual void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::getIndicationProviderInfo (  IndicationProviderInfo &  info  )  [inline, virtual]
 

A provider should override this method to report which classes in which namespaces it instruments.

It should insert an entry for each class it is responsible for. It should also insert one entry for each base class of the classes of indications the provider may generate. Note that this base class requirement is unique to indication providers and doesn't apply to other types of providers. The entry consists of the class name and an optional list of namespaces. If the namespace list is empty, all namespaces are implied. If the method does nothing, then the provider's class must have a provider qualifier that identifies the provider. This old behavior is deprecated and will be removed sometime in the future. This method has a default implementation that does nothing, to allow old providers to be migrated forward with little or no change, but once the old provider location method is removed, this member function will be pure virtual.

Reimplemented from OW_NAMESPACE::CppIndicationProviderIFC.

Definition at line 99 of file OW_provinstOpenWBEM_ObjectManager.cpp.

References OW_NAMESPACE::IndicationProviderInfoEntry::classes, className, and OW_NAMESPACE::Array< T >::push_back().

virtual void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::getInstanceProviderInfo (  InstanceProviderInfo &  info  )  [inline, virtual]
 

A provider should override this method to report which classes in which namespaces it instruments.

It should insert an entry for each class it is responsible for. The entry consists of the class name and an optional list of namespaces. If the namespace list is empty, all namespaces are implied. If the method does nothing, then the provider's class must have a provider qualifier that identifies the provider. This old behavior is deprecated and will be removed sometime in the future. This method has a default implementation that does nothing, to allow old providers to be migrated forward with little or no change, but once the old provider location method is removed, this member function will be pure virtual.

Reimplemented from OW_NAMESPACE::CppInstanceProviderIFC.

Definition at line 84 of file OW_provinstOpenWBEM_ObjectManager.cpp.

References OW_NAMESPACE::ProviderInfoBase< ClassInfoT >::addInstrumentedClass(), OW_NAMESPACE::CLASS_OpenWBEM_HostedObjectManager, and OW_NAMESPACE::CLASS_OpenWBEM_ObjectManager.

virtual void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::initialize (  const ProviderEnvironmentIFCRef &  env  )  [inline, virtual]
 

Called by the CIMOM when the provider is initialized.

Parameters:
env Gives the provider access to things such as a CIMOM handle, logger, etc. This provider environment carries its own OperationContext and hence things like the CIMOM handle remain valid for the lifetime of *env. Thus the provider can store a copy of env for later use, e.g., by a separate thread spawned by the provider.
Exceptions:
CIMException 

Reimplemented from OW_NAMESPACE::CppProviderBaseIFC.

Definition at line 163 of file OW_provinstOpenWBEM_ObjectManager.cpp.

References OW_NAMESPACE::CLASS_OpenWBEM_InternalData, OW_NAMESPACE::dataKey, env, OW_NAMESPACE::CIMException::getErrNo(), OW_NAMESPACE::ConfigOpts::INTEROP_SCHEMA_NAMESPACE_opt, OW_DEFAULT_INTEROP_SCHEMA_NAMESPACE, OW_NAMESPACE::PROP_Name, OW_NAMESPACE::CIMObjectPath::setKeyValue(), OW_NAMESPACE::String::toString(), and OW_NAMESPACE::CIMObjectPath::toString().

virtual void OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::shuttingDown (  const ProviderEnvironmentIFCRef &  env  )  [inline, virtual]
 

Called by the CIMOM just before it starts shutting down services.

Providers should override this to do any portion of their shutdown process that requires access to the CIMOM.

Reimplemented from OW_NAMESPACE::CppProviderBaseIFC.

Definition at line 211 of file OW_provinstOpenWBEM_ObjectManager.cpp.

References OW_NAMESPACE::CLASS_CIM_InstModification, OW_NAMESPACE::COMPONENT_NAME, env, hdl, OW_NAMESPACE::ConfigOpts::INTEROP_SCHEMA_NAMESPACE_opt, OW_DEFAULT_INTEROP_SCHEMA_NAMESPACE, OW_LOG_ERROR, and OW_NAMESPACE::ThreadImpl::sleep().

Member Data Documentation

bool OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::m_haveSubscriptions [private]
 

Definition at line 73 of file OW_provinstOpenWBEM_ObjectManager.cpp.

CIMInstance OW_NAMESPACE::OpenWBEM_ObjectManagerInstProv::m_inst [private]
 

Definition at line 72 of file OW_provinstOpenWBEM_ObjectManager.cpp.

The documentation for this class was generated from the following file:
Generated on Thu Feb 9 09:16:28 2006 for openwbem by  doxygen 1.4.6