OW_ProviderManager.hpp

Go to the documentation of this file.

/*******************************************************************************
* Copyright (C) 2001-2004 Vintela, Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
*  - Redistributions of source code must retain the above copyright notice,
*    this list of conditions and the following disclaimer.
*
*  - Redistributions in binary form must reproduce the above copyright notice,
*    this list of conditions and the following disclaimer in the documentation
*    and/or other materials provided with the distribution.
*
*  - Neither the name of Vintela, Inc. nor the names of its
*    contributors may be used to endorse or promote products derived from this
*    software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS''
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL Vintela, Inc. OR THE CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*******************************************************************************/

#ifndef OW_PROVIDERMANAGER_HPP_
#define OW_PROVIDERMANAGER_HPP_
#include "OW_config.h"
#include "OW_InstanceProviderIFC.hpp"
#include "OW_MethodProviderIFC.hpp"
#ifndef OW_DISABLE_ASSOCIATION_TRAVERSAL
#include "OW_AssociatorProviderIFC.hpp"
#endif
#include "OW_PolledProviderIFC.hpp"
#include "OW_IndicationExportProviderIFC.hpp"
#include "OW_IndicationProviderIFC.hpp"
#include "OW_SecondaryInstanceProviderIFC.hpp"
#include "OW_ProviderIFCLoader.hpp"
#include "OW_Mutex.hpp"
#include "OW_HashMap.hpp"
#include "OW_HashMultiMap.hpp"
#include "OW_ServiceIFC.hpp"
#include "OW_Logger.hpp"
#include "OW_CimomCommonFwd.hpp"
#include "OW_SortedVectorSet.hpp"

namespace OW_NAMESPACE
{

class OW_CIMOMCOMMON_API ProviderManager : public ServiceIFC
{
public:
   void load(const ProviderIFCLoaderRef& ifcLoader, const ServiceEnvironmentIFCRef& env);

   virtual String getName() const;
   virtual void init(const ServiceEnvironmentIFCRef& env);
   
   virtual void shutdown();

   virtual void shuttingDown();

   InstanceProviderIFCRef getInstanceProvider(const ProviderEnvironmentIFCRef& env,
      const String& ns, const CIMClass& cc) const;

   SecondaryInstanceProviderIFCRefArray getSecondaryInstanceProviders(const ProviderEnvironmentIFCRef& env,
      const String& ns, const CIMName& className) const;
   MethodProviderIFCRef getMethodProvider(const ProviderEnvironmentIFCRef& env,
      const String& ns, const CIMClass& cc, const CIMMethod& method) const;
#ifndef OW_DISABLE_ASSOCIATION_TRAVERSAL

   AssociatorProviderIFCRef getAssociatorProvider(const ProviderEnvironmentIFCRef& env,
      const String& ns, const CIMClass& cc) const;
#endif

   IndicationExportProviderIFCRefArray
      getIndicationExportProviders(const ProviderEnvironmentIFCRef& env) const;
   PolledProviderIFCRefArray
      getPolledProviders(const ProviderEnvironmentIFCRef& env) const;
   IndicationProviderIFCRefArray
      getIndicationProviders(const ProviderEnvironmentIFCRef& env,
         const String& ns, const CIMName& indicationClassName,
         const CIMNameArray& monitoredClassNames) const;
   void unloadProviders(const ProviderEnvironmentIFCRef& env);
private:
   ProviderIFCBaseIFCRef getProviderIFC(const ProviderEnvironmentIFCRef& env,
      const CIMQualifier& qual,
      String& provStr) const;
   bool isRestrictedNamespace(const String& ns) const;
   Array<ProviderIFCBaseIFCRef> m_IFCArray;
   Mutex m_guard;
public:  // so free functions in cpp file can access them.
   struct ProvReg
   {
      String provName;
      ProviderIFCBaseIFCRef ifc;
   };
   typedef HashMap<String, ProvReg> ProvRegMap_t;
   typedef HashMultiMap<String, ProvReg> MultiProvRegMap_t;
   typedef SortedVectorSet<String> NameSpaceSet_t;
   
   static String COMPONENT_NAME;

private:

   void findIndicationProviders(
      const ProviderEnvironmentIFCRef& env,
      const String& ns,
      const CIMName& className,
      const ProviderManager::MultiProvRegMap_t& indProvs,
      IndicationProviderIFCRefArray& rval) const;

   // The key must be: a classname if the provider supports any namespace,
   // or namespace:classname for a specific namespace.
   ProvRegMap_t m_registeredInstProvs;

   // The key must be: a classname if the provider supports any namespace,
   // or namespace:classname for a specific namespace.
   MultiProvRegMap_t m_registeredSecInstProvs;

#ifndef OW_DISABLE_ASSOCIATION_TRAVERSAL
   ProvRegMap_t m_registeredAssocProvs;
#endif
   // The key must be: [namespace:]className[:methodname]
   ProvRegMap_t m_registeredMethProvs;
   // The key must be: [namespace:]className[:propertyname]
   ProvRegMap_t m_registeredPropProvs;
   // The key must be: a classname if the provider supports any namespace,
   // namespace:classname for a specific namespace.
   // For a lifecycle provider, /* and /classname entries are made for each lifecycle class.
   MultiProvRegMap_t m_registeredIndProvs;

   LoggerRef m_logger;
   ServiceEnvironmentIFCRef m_env;
   NameSpaceSet_t m_restrictedNamespaces;
};

} // end namespace OW_NAMESPACE

#endif

---