OW_CIMProperty.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_CIMPROPERTY_HPP_INCLUDE_GUARD_
#define OW_CIMPROPERTY_HPP_INCLUDE_GUARD_
#include "OW_config.h"
#include "OW_COWIntrusiveReference.hpp"
#include "OW_CIMElement.hpp"
#include "OW_CIMFwd.hpp"
#include "OW_CIMDataType.hpp"
#include "OW_CIMNULL.hpp"
#include "OW_WBEMFlags.hpp"
#include "OW_CIMName.hpp" // necessary for implicit conversion (const char* -> CIMName) to work

namespace OW_NAMESPACE
{

class OW_COMMON_API CIMProperty : public CIMElement
{
public:
   struct PROPData;
   static const char* const NAME_PROPERTY;
   CIMProperty();
   explicit CIMProperty(CIMNULL_t);
   explicit CIMProperty(const CIMName& name);
   explicit CIMProperty(const char* name);
   CIMProperty(const CIMName& name, const CIMValue& value);
   CIMProperty(const CIMName& name, const CIMDataType& dt);
   CIMProperty(const CIMProperty& arg);
   ~CIMProperty();
   virtual void setNull();
   CIMProperty& operator= (const CIMProperty& arg);

   typedef COWIntrusiveReference<PROPData> CIMProperty::*safe_bool;
   operator safe_bool () const
      {  return m_pdata ? &CIMProperty::m_pdata : 0; }
   bool operator!() const
      {  return !m_pdata; }
   CIMProperty clone() const {  return clone(WBEMFlags::E_INCLUDE_QUALIFIERS, WBEMFlags::E_INCLUDE_CLASS_ORIGIN); }
   CIMProperty clone(WBEMFlags::EIncludeQualifiersFlag includeQualifiers,
      WBEMFlags::EIncludeClassOriginFlag includeClassOrigin) const;
   CIMQualifierArray getQualifiers() const;
   CIMProperty& setQualifiers(const CIMQualifierArray& quals);
   String getOriginClass() const;
   CIMProperty& setOriginClass(const CIMName& originCls);
   CIMProperty& setValue(const CIMValue& val);
   CIMValue getValue() const;
   CIMValue getValueT() const;
   CIMProperty& setDataType(const CIMDataType& type);
   CIMProperty& setDataType(const CIMDataType::Type& type);
   CIMDataType getDataType() const;
   Int32 getSize() const;
   CIMProperty& setDataSize(Int32 size);
   CIMProperty& setOverridingProperty(const CIMName& opname);
   String getOverridingProperty() const;
   bool isReference() const;
   CIMQualifier getQualifier(const CIMName& name) const;
   CIMQualifier getQualifierT(const CIMName& name) const;
   CIMProperty& setQualifier(const CIMQualifier& qual);
   CIMProperty& addQualifier(const CIMQualifier& qual);
   bool removeQualifier(const CIMName& name);
   bool isKey() const;
   CIMProperty filter(WBEMFlags::ELocalOnlyFlag localOnly, WBEMFlags::EIncludeQualifiersFlag includeQualifiers) const;
   CIMProperty& setPropagated(bool propagated=true);
   bool getPropagated() const;
   CIMProperty& clearQualifiers();
   CIMProperty& clearNonKeyQualifiers();
   virtual String getName() const;
   virtual void setName(const CIMName& name);
   virtual void writeObject(std::ostream &ostrm) const;
   virtual void writeObject(std::ostream &ostrm,
      WBEMFlags::EIncludeQualifiersFlag includeQualifiers) const;
   
   virtual void readObject(std::istream &istrm);
   virtual String toString() const;
   
   virtual String toMOF() const;
   
   bool hasTrueQualifier(const CIMName& name) const;
private:

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

   COWIntrusiveReference<PROPData> m_pdata;

#ifdef OW_WIN32
#pragma warning (pop)
#endif

   friend OW_COMMON_API bool operator<(const CIMProperty& x, const CIMProperty& y);
};

} // end namespace OW_NAMESPACE

#endif

---