OWBI1_CIMInstance.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 OWBI1_CIMINSTANCE_HPP_INCLUDE_GUARD_
#define OWBI1_CIMINSTANCE_HPP_INCLUDE_GUARD_
#include "OWBI1_config.h"
#include "OWBI1_COWIntrusiveReference.hpp"
#include "OWBI1_CIMElement.hpp"
#include "OWBI1_CIMFwd.hpp"
#include "OWBI1_CIMDataType.hpp" // for OWBI1_CIMDataType::INVALID
#include "OWBI1_WBEMFlags.hpp"
#include "OWBI1_CIMName.hpp" // necessary for implicit conversion (const char* -> CIMName) to work
#include "OWBI1_CIMPropertyList.hpp"

namespace OWBI1
{

class OWBI1_OWBI1PROVIFC_API CIMInstance : public CIMElement
{
public:
   enum { SERIALIZATION_VERSION = 1 };          // Version # for serialization
   
   enum EErrorCodes
   {
      E_INSTANCE_HAS_NO_SUCH_PROPERTY
   };

   CIMInstance();
   explicit CIMInstance(CIMNULL_t);
   CIMInstance(const CIMInstance& arg);
   explicit CIMInstance(const CIMName& name);
   explicit CIMInstance(const char* name);

   explicit CIMInstance(const detail::CIMInstanceRepRef& rep);

   ~CIMInstance();
   virtual void setNull();
   CIMInstance& operator= (const CIMInstance& arg);
   CIMName getClassName() const;
   CIMInstance& setKeys(const CIMPropertyArray& keys);
   CIMInstance& setClassName(const CIMName& name);
   String getLanguage() const;
   void setLanguage(const String& language);
   CIMPropertyArray getProperties(
      Int32 valueDataType = CIMDataType::INVALID) const;
   CIMInstance& setProperties(const CIMPropertyArray& props);
   CIMProperty getProperty(const CIMName& name,
      const CIMName& originClass) const;
   CIMProperty getProperty(const CIMName& name) const;
   CIMProperty getPropertyT(const CIMName& name) const;
   CIMValue getPropertyValue(const CIMName& name) const;
   bool propertyHasValue(const CIMName& name) const;
   CIMPropertyArray getKeyValuePairs() const;
   CIMInstance& updatePropertyValues(const CIMPropertyArray& props);
   CIMInstance& updatePropertyValue(const CIMProperty& prop);
   CIMInstance& updatePropertyValue(const CIMName& name, const CIMValue& cv);
   CIMInstance& setProperty(const CIMName& name, const CIMValue& cv);
   CIMInstance& setProperty(const CIMProperty& prop);
   CIMInstance& removeProperty(const CIMName& propName);
   CIMInstance clone(const CIMPropertyList& propertyList=CIMPropertyList()) const;
   CIMInstance& syncWithClass(const CIMClass& cc);
   CIMInstance createModifiedInstance(
      const CIMInstance& previousInstance,
      const CIMPropertyList& propertyList,
      const CIMClass& theClass) const;
   virtual CIMName getName() const;
   virtual void setName(const CIMName& name);
   virtual void readObject(std::istream &istrm);
   virtual void writeObject(std::ostream &ostrm) const;
   virtual String toMOF() const;
   virtual String toString() const;
   bool propertiesAreEqualTo(const CIMInstance& other) const;

   typedef detail::CIMInstanceRepRef CIMInstance::*safe_bool;
   operator safe_bool () const;
   bool operator!() const;
   
   detail::CIMInstanceRepRef getRep() const;
protected:
   void _buildKeys();

#ifdef OWBI1_WIN32
#pragma warning (push)
#pragma warning (disable: 4251)
#endif

   detail::CIMInstanceRepRef m_rep;
   
#ifdef OWBI1_WIN32
#pragma warning (pop)
#endif

   friend OWBI1_OWBI1PROVIFC_API bool operator<(const CIMInstance& x, const CIMInstance& y);
};

} // end namespace OWBI1

#endif

---