CIMClass Class Reference
#include <CIMClass.h>
Public Member Functions
CIMClass () CIMClass (const CIMClass &x) CIMClass (const CIMObject &x) CIMClass (const CIMName &className, const CIMName &superClassName=CIMName()) CIMClass & operator= (const CIMClass &x) ~CIMClass () Boolean isAssociation () const Boolean isAbstract () const const CIMName & getClassName () const const CIMObjectPath & getPath () const void setPath (const CIMObjectPath &path) const CIMName & getSuperClassName () const void setSuperClassName (const CIMName &superClassName) CIMClass & addQualifier (const CIMQualifier &qualifier) Uint32 findQualifier (const CIMName &name) const CIMQualifier getQualifier (Uint32 index) CIMConstQualifier getQualifier (Uint32 index) const void removeQualifier (Uint32 index) Uint32 getQualifierCount () const CIMClass & addProperty (const CIMProperty &x) Uint32 findProperty (const CIMName &name) const CIMProperty getProperty (Uint32 index) CIMConstProperty getProperty (Uint32 index) const void removeProperty (Uint32 index) Uint32 getPropertyCount () const CIMClass & addMethod (const CIMMethod &x) Uint32 findMethod (const CIMName &name) const CIMMethod getMethod (Uint32 index) CIMConstMethod getMethod (Uint32 index) const void removeMethod (Uint32 index) Uint32 getMethodCount () const void getKeyNames (Array< CIMName > &keyNames) const Boolean hasKeys () const CIMClass clone () const Boolean identical (const CIMConstClass &x) const Boolean isUninitialized () const CIMInstance buildInstance (Boolean includeQualifiers, Boolean includeClassOrigin, const CIMPropertyList &propertyList) const Detailed Description
The CIMClass class represents the DMTF standard CIM class definition.
The CIMClass class uses a shared representation model, such that multiple CIMClass objects may refer to the same data copy. Assignment and copy operators create new references to the same data, not distinct copies. An update to a CIMClass object affects all the CIMClass objects that refer to the same data copy. The data remains valid until all the CIMClass objects that refer to it are destructed. A separate copy of the data may be created using the clone method.
Constructor & Destructor Documentation
◆ CIMClass() [1/4]
CIMClass::CIMClass ( ) Constructs an uninitialized CIMClass object. A method invocation on an uninitialized object will result in the throwing of an UninitializedObjectException. An uninitialized object may be converted into an initialized object only by using the assignment operator with an initialized object.
◆ CIMClass() [2/4]
CIMClass::CIMClass ( const CIMClass & x ) ◆ CIMClass() [3/4]
CIMClass::CIMClass ( const CIMObject & x ) explicit Constructs a CIMClass object from the value of a specified CIMObject object, so that both objects refer to the same data copy.
- Exceptions
DynamicCastFailedException If a CIMClass can not be created from the given CIMObject. ◆ CIMClass() [4/4]
◆ ~CIMClass()
CIMClass::~CIMClass ( ) Destructs the CIMClass object.
Member Function Documentation
◆ addMethod()
Adds a method to the class.
- Parameters
x The CIMMethod to be added.
- Returns
- A reference to this CIMClass object.
- Exceptions
AlreadyExistsException If a method with the same name already exists in the CIMClass. UninitializedObjectException If the object is not initialized. ◆ addProperty()
CIMClass& CIMClass::addProperty ( const CIMProperty & x ) Adds a property to the class.
- Parameters
x The CIMProperty to be added.
- Returns
- A reference to this CIMClass object.
- Exceptions
AlreadyExistsException If a property with the same name already exists in the CIMClass. UninitializedObjectException If the object is not initialized. ◆ addQualifier()
CIMClass& CIMClass::addQualifier ( const CIMQualifier & qualifier ) Adds a qualifier to the class.
- Parameters
qualifier The CIMQualifier to be added.
- Returns
- A reference to this CIMClass object.
- Exceptions
AlreadyExistsException If a qualifier with the same name already exists in the CIMClass. UninitializedObjectException If the object is not initialized. ◆ buildInstance()
CIMInstance CIMClass::buildInstance ( Boolean includeQualifiers, Boolean includeClassOrigin, const CIMPropertyList & propertyList ) const Builds a CIMInstance based on this CIMClass. Properties in the instance are initialized to the default values (if any) specified in the class definition. The method arguments determine whether qualifiers are included, the class origin attributes are included, and which properties are included in the new instance. This method is designed specifically for providers to allow them to easily build instance objects using the parameters provided with the CIM instance operations such as getInstance and enumerateInstances.
Example:
CIMClass myClass .. a defined and complete CIMClass. // create instance with qualifiers, class origin and all properties CIMInstance myInstance = myClass.buildInstance(true, true, CIMPropertyList());
- Parameters
includeQualifiers A Boolean indicating whether qualifiers in the class definition (and its properties) are to be added to the instance. If false, no qualifiers are added to the instance or its properties. The TOINSTANCE flavor is ignored. Because the CIM specification is unclear on the meaning of this parameter and its relationship to instance operations, the behavior when this parameter is true MAY change in the future based on clarifications of the CIM specification. includeClassOrigin A Boolean indicating whether ClassOrigin attributes are to be transferred from the class object to the instance. propertyList A CIMPropertyList defining the properties that are to be added to the created instance. If the propertyList is not NULL, properties defined in the class and in this propertyList are added to the new instance. If the propertyList is NULL, all properties are added to the instance. If the propertyList is empty, no properties are added. Note that this function does NOT generate an error if a property name is supplied that is NOT in the class; it simply does not add that property to the instance.
- Returns
- CIMInstance of this class appropriately initialized.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ clone()
CIMClass CIMClass::clone ( ) const Makes a deep copy of the class. This creates a new copy of all the class attributes including qualifiers, properties, and methods.
- Returns
- A new copy of the CIMClass object.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ findMethod()
Uint32 CIMClass::findMethod ( const CIMName & name ) const Finds a method by name.
- Parameters
name A CIMName specifying the name of the method to be found.
- Returns
- Index of the method if found or PEG_NOT_FOUND if not found.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ findProperty()
Uint32 CIMClass::findProperty ( const CIMName & name ) const Finds a property by name.
- Parameters
name A CIMName specifying the name of the property to be found.
- Returns
- Index of the property if found or PEG_NOT_FOUND if not found.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ findQualifier()
Uint32 CIMClass::findQualifier ( const CIMName & name ) const Finds a qualifier by name.
- Parameters
name A CIMName specifying the name of the qualifier to be found.
- Returns
- Index of the qualifier if found or PEG_NOT_FOUND if not found.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ getClassName()
const CIMName& CIMClass::getClassName ( ) const Gets the name of the class.
- Returns
- A CIMName containing the class name.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ getKeyNames()
Gets the list of key properties in this class. The Key qualifier on CIMProperty objects is used to locate key properties.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ getMethod() [1/2]
CIMMethod CIMClass::getMethod ( Uint32 index ) Gets the method at the specified index.
- Parameters
index The index of the method to be retrieved.
- Returns
- The CIMMethod at the specified index.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of methods available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ getMethod() [2/2]
CIMConstMethod CIMClass::getMethod ( Uint32 index ) const Gets the method at the specified index.
- Parameters
index The index of the method to be retrieved.
- Returns
- The CIMConstMethod at the specified index.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of methods available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ getMethodCount()
Uint32 CIMClass::getMethodCount ( ) const Gets the number of methods in the class.
- Returns
- An integer count of the methods in the CIMClass.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ getPath()
const CIMObjectPath& CIMClass::getPath ( ) const Gets the object path for the class.
- Returns
- A CIMObjectPath containing the object path.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ getProperty() [1/2]
CIMProperty CIMClass::getProperty ( Uint32 index ) Gets the property at the specified index.
- Parameters
index The index of the property to be retrieved.
- Returns
- The CIMProperty at the specified index.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of properties available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ getProperty() [2/2]
CIMConstProperty CIMClass::getProperty ( Uint32 index ) const Gets the property at the specified index.
- Parameters
index The index of the property to be retrieved.
- Returns
- The CIMConstProperty at the specified index.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of properties available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ getPropertyCount()
Uint32 CIMClass::getPropertyCount ( ) const Gets the number of properties in the class.
- Returns
- An integer count of the properties in the CIMClass.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ getQualifier() [1/2]
CIMQualifier CIMClass::getQualifier ( Uint32 index ) Gets the qualifier at the specified index.
- Parameters
index The index of the qualifier to be retrieved.
- Returns
- The CIMQualifier at the specified index.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of qualifiers available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ getQualifier() [2/2]
CIMConstQualifier CIMClass::getQualifier ( Uint32 index ) const Gets the qualifier at the specified index.
- Parameters
index The index of the qualifier to be retrieved.
- Returns
- The CIMConstQualifier at the specified index.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of qualifiers available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ getQualifierCount()
Uint32 CIMClass::getQualifierCount ( ) const Gets the number of qualifiers in the class.
- Returns
- An integer count of the qualifiers in the CIMClass.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ getSuperClassName()
const CIMName& CIMClass::getSuperClassName ( ) const Gets the name of the parent class of this class.
- Returns
- A CIMName containing parent class name.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ hasKeys()
Boolean CIMClass::hasKeys ( ) const Indicates whether this class contains key properties. The Key qualifier on CIMProperty objects is used to make this determination.
- Returns
- True if this class contains key properties, false otherwise.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ identical()
Boolean CIMClass::identical ( const CIMConstClass & x ) const Compares the CIMClass with a specified CIMConstClass.
- Parameters
x The CIMConstClass to be compared.
- Returns
- True if this class is identical to the one specified, false otherwise.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ isAbstract()
Boolean CIMClass::isAbstract ( ) const Indicates whether this class is an abstract class. The Abstract qualifier is used to make this determination.
- Returns
- True if this class is an abstract class, false otherwise.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ isAssociation()
Boolean CIMClass::isAssociation ( ) const Indicates whether this class is an association class. An association is a relationship between two (or more) classes or instances. The Association qualifier is used to make this determination.
- Returns
- True if this class is an association class, false otherwise.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ isUninitialized()
Boolean CIMClass::isUninitialized ( ) const Determines whether the object has been initialized.
- Returns
- True if the object has not been initialized, false otherwise.
◆ operator=()
◆ removeMethod()
void CIMClass::removeMethod ( Uint32 index ) Removes a method from the class.
- Parameters
index The index of the method to remove.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of methods available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ removeProperty()
void CIMClass::removeProperty ( Uint32 index ) Removes a property from the class.
- Parameters
index The index of the property to remove.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of properties available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ removeQualifier()
void CIMClass::removeQualifier ( Uint32 index ) Removes a qualifier from the class.
- Parameters
index The index of the qualifier to remove.
- Exceptions
IndexOutOfBoundsException If the index is outside the range of qualifiers available for the CIMClass. UninitializedObjectException If the object is not initialized. ◆ setPath()
void CIMClass::setPath ( const CIMObjectPath & path ) Sets the object path for the class.
- Parameters
path A CIMObjectPath containing the object path.
- Exceptions
UninitializedObjectException If the object is not initialized. ◆ setSuperClassName()
void CIMClass::setSuperClassName ( const CIMName & superClassName ) Sets the name of the parent class.
- Parameters
superClassName A CIMName specifying the parent class name.
- Exceptions
UninitializedObjectException If the object is not initialized.
The documentation for this class was generated from the following file:
- /home/loongson/rpmbuild/BUILD/pegasus/src/Pegasus/Common/CIMClass.h