pegasus/src/Pegasus/Repository/Attic/Repository.h - diff

Return to Repository.h CVS log

Up to [Pegasus] / pegasus / src / Pegasus / Repository / Attic

Diff for /pegasus/src/Pegasus/Repository/Attic/Repository.h between version 1.6 and 1.10.2.3

version 1.6, 2001/02/11 05:45:33

version 1.10.2.3, 2007/11/08 23:20:50

Line 1

//BEGIN_LICENSE

//%2006////////////////////////////////////////////////////////////////////////

// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.

// IBM Corp.; EMC Corporation, The Open Group.

// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; Symantec Corporation; The Open Group.

// Permission is hereby granted, free of charge, to any person obtaining a copy

// of this software and associated documentation files (the "Software"), to

// deal in the Software without restriction, including without limitation the

// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or

// sell copies of the Software, and to permit persons to whom the Software is

// furnished to do so, subject to the following conditions:

// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN

// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED

// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT

// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR

// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN

// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

// Permission is hereby granted, free of charge, to any person obtaining a

//==============================================================================

// copy of this software and associated documentation files (the "Software"),

// to deal in the Software without restriction, including without limitation

// the rights to use, copy, modify, merge, publish, distribute, sublicense,

// and/or sell copies of the Software, and to permit persons to whom the

// Software is furnished to do so, subject to the following conditions:

// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

//%/////////////////////////////////////////////////////////////////////////////

// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL

// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

// DEALINGS IN THE SOFTWARE.

//END_LICENSE

//BEGIN_HISTORY

// Author:

// $Log$

// Revision 1.6 2001/02/11 05:45:33 mike

// Added case insensitive logic for files in Repository

// Revision 1.5 2001/02/08 00:31:51 mike

// Clean up on Operations class.

// Reformmatted documentation.

// Revision 1.4 2001/02/06 17:04:03 karl

// add documentation

// Revision 1.3 2001/01/31 08:20:51 mike

// Added dispatcher framework.

// Added enumerateInstanceNames.

// Revision 1.2 2001/01/28 04:11:03 mike

// fixed qualifier resolution

// Revision 1.1.1.1 2001/01/14 19:53:56 mike

// Pegasus import

//END_HISTORY

////////////////////////////////////////////////////////////////////////////////

#ifndef Pegasus_Repository_h

#define Pegasus_Repository_h

// Repository.h

// This interface contains a method for each operation defined in

// the "Specification for CIM Operations over HTTP".

////////////////////////////////////////////////////////////////////////////////

#ifndef PegasusRepository_Repository_h

#define PegasusRepository_Repository_h

#include <Pegasus/Common/Config.h>

#include <Pegasus/Common/ClassDecl.h>

#include <Pegasus/Common/CIMClass.h>

#include <Pegasus/Common/InstanceDecl.h>

#include <Pegasus/Common/CIMObject.h>

#include <Pegasus/Common/QualifierDecl.h>

#include <Pegasus/Common/CIMInstance.h>

#include <Pegasus/Common/Operations.h>

#include <Pegasus/Common/CIMPropertyList.h>

#include <Pegasus/Common/CIMQualifierDecl.h>

#include <Pegasus/Common/ContentLanguageList.h>

#include <Pegasus/Common/HashTable.h>

#include <Pegasus/Repository/Linkage.h>

PEGASUS_NAMESPACE_BEGIN

class RepositoryDeclContext;

/** Class Repository - This class represents the repository interfaces.

class compilerDeclContext;

This class is derived from the Pegasus Operations interface adding certain

methods specifically required for the repository.

class PEGASUS_REPOSITORY_LINKAGE Repository : public Operations

/** Virtual base class for CIMRepository implementations.

class Repository

{

public:

/// Constructor

typedef HashTable <String, String, EqualNoCaseFunc, HashLowerCaseFunc>

Repository(const String& path);

NameSpaceAttributes;

Repository();

/// Descructor

virtual ~Repository();

/// virtual class ClassDecl. From the operations class

virtual CIMClass getClass(

virtual ClassDecl getClass(

bool lock,

const String& nameSpace,

const CIMNamespaceName& nameSpace,

const String& className,

const CIMName& className,

Boolean localOnly = true,

Boolean localOnly,

Boolean includeQualifiers = true,

Boolean includeQualifiers,

Boolean includeClassOrigin = false,

Boolean includeClassOrigin,

const Array<String>& propertyList = _getStringArray());

const CIMPropertyList& propertyList) = 0;

/// getInstance

virtual CIMInstance getInstance(

virtual InstanceDecl getInstance(

bool lock,

const String& nameSpace,

const CIMNamespaceName& nameSpace,

const Reference& instanceName,

const CIMObjectPath& instanceName,

Boolean localOnly = true,

Boolean localOnly,

Boolean includeQualifiers = false,

Boolean includeQualifiers,

Boolean includeClassOrigin = false,

Boolean includeClassOrigin,

const Array<String>& propertyList = _getStringArray());

const CIMPropertyList& propertyList) = 0;

/// deleteClass

virtual void deleteClass(

const String& nameSpace,

bool lock,

const String& className);

const CIMNamespaceName& nameSpace,

const CIMName& className) = 0;

/// deleteInstance

virtual void deleteInstance(

const String& nameSpace,

bool lock,

const Reference& instanceName);

const CIMNamespaceName& nameSpace,

const CIMObjectPath& instanceName) = 0;

/// createClass

virtual void createClass(

const String& nameSpace,

bool lock,

ClassDecl& newClass);

const CIMNamespaceName& nameSpace,

const CIMClass& newClass,

/// createInstance

const ContentLanguageList& contentLangs) = 0;

virtual void createInstance(

const String& nameSpace,

virtual CIMObjectPath createInstance(

const InstanceDecl& newInstance);

bool lock,

const CIMNamespaceName& nameSpace,

const CIMInstance& newInstance,

const ContentLanguageList& contentLangs) = 0;

virtual void modifyClass(

const String& nameSpace,

bool lock,

ClassDecl& modifiedClass);

const CIMNamespaceName& nameSpace,

const CIMClass& modifiedClass,

const ContentLanguageList& contentLangs) = 0;

/// modifyInstance

virtual void modifyInstance(

const String& nameSpace,

bool lock,

const InstanceDecl& modifiedInstance);

const CIMNamespaceName& nameSpace,

const CIMInstance& modifiedInstance,

/// enumerateClasses

Boolean includeQualifiers,

virtual Array<ClassDecl> enumerateClasses(

const CIMPropertyList& propertyList,

const String& nameSpace,

const ContentLanguageList& contentLangs) = 0;

const String& className = String::EMPTY,

Boolean deepInheritance = false,

virtual Array<CIMClass> enumerateClasses(

Boolean localOnly = true,

bool lock,

Boolean includeQualifiers = true,

const CIMNamespaceName& nameSpace,

Boolean includeClassOrigin = false);

const CIMName& className,

Boolean deepInheritance,

/// enumerateClassNames

Boolean localOnly,

virtual Array<String> enumerateClassNames(

Boolean includeQualifiers,

const String& nameSpace,

Boolean includeClassOrigin) = 0;

const String& className = String::EMPTY,

Boolean deepInheritance = false);

virtual Array<CIMName> enumerateClassNames(

bool lock,

/// enumerateInstances

const CIMNamespaceName& nameSpace,

virtual Array<InstanceDecl> enumerateInstances(

const CIMName& className,

const String& nameSpace,

Boolean deepInheritance) = 0;

const String& className,

Boolean deepInheritance = true,

virtual Array<CIMInstance> enumerateInstancesForSubtree(

Boolean localOnly = true,

bool lock,

Boolean includeQualifiers = false,

const CIMNamespaceName& nameSpace,

Boolean includeClassOrigin = false,

const CIMName& className,

const Array<String>& propertyList = _getStringArray());

Boolean deepInheritance,

Boolean localOnly,

/// enumerateInstanceNames

Boolean includeQualifiers,

virtual Array<Reference> enumerateInstanceNames(

Boolean includeClassOrigin,

const String& nameSpace,

const CIMPropertyList& propertyList) = 0;

const String& className);

virtual Array<CIMInstance> enumerateInstancesForClass(

bool lock,

const CIMNamespaceName& nameSpace,

const CIMName& className,

Boolean localOnly,

Boolean includeQualifiers,

Boolean includeClassOrigin,

const CIMPropertyList& propertyList) = 0;

virtual Array<CIMObjectPath> enumerateInstanceNamesForSubtree(

bool lock,

const CIMNamespaceName& nameSpace,

const CIMName& className) = 0;

virtual Array<CIMObjectPath> enumerateInstanceNamesForClass(

bool lock,

const CIMNamespaceName& nameSpace,

const CIMName& className) = 0;

/// execQuery

virtual Array<CIMInstance> execQuery(

virtual Array<InstanceDecl> execQuery(

bool lock,

const String& queryLanguage,

const String& query) ;

const String& query) = 0;

/// associators

virtual Array<CIMObject> associators(

virtual Array<InstanceDecl> associators(

bool lock,

const String& nameSpace,

const CIMNamespaceName& nameSpace,

const Reference& objectName,

const CIMObjectPath& objectName,

const String& assocClass = String::EMPTY,

const CIMName& assocClass,

const String& resultClass = String::EMPTY,

const CIMName& resultClass,

const String& role = String::EMPTY,

const String& role,

const String& resultRole = String::EMPTY,

const String& resultRole,

Boolean includeQualifiers = false,

Boolean includeQualifiers,

Boolean includeClassOrigin = false,

Boolean includeClassOrigin,

const Array<String>& propertyList = _getStringArray());

const CIMPropertyList& propertyList) = 0;

/// associateNames

virtual Array<CIMObjectPath> associatorNames(

virtual Array<Reference> associatorNames(

bool lock,

const String& nameSpace,

const CIMNamespaceName& nameSpace,

const Reference& objectName,

const CIMObjectPath& objectName,

const String& assocClass = String::EMPTY,

const CIMName& assocClass,

const String& resultClass = String::EMPTY,

const CIMName& resultClass,

const String& role = String::EMPTY,

const String& role,

const String& resultRole = String::EMPTY);

const String& resultRole) = 0;

/// references

virtual Array<CIMObject> references(

virtual Array<InstanceDecl> references(

bool lock,

const String& nameSpace,

const CIMNamespaceName& nameSpace,

const Reference& objectName,

const CIMObjectPath& objectName,

const String& resultClass = String::EMPTY,

const CIMName& resultClass,

const String& role = String::EMPTY,

const String& role,

Boolean includeQualifiers = false,

Boolean includeQualifiers,

Boolean includeClassOrigin = false,

Boolean includeClassOrigin,

const Array<String>& propertyList = _getStringArray());

const CIMPropertyList& propertyList) = 0;

/// referenceNames

virtual Array<CIMObjectPath> referenceNames(

virtual Array<Reference> referenceNames(

bool lock,

const String& nameSpace,

const CIMNamespaceName& nameSpace,

const Reference& objectName,

const CIMObjectPath& objectName,

const String& resultClass = String::EMPTY,

const CIMName& resultClass,

const String& role = String::EMPTY);

const String& role) = 0;

/// getProperty

virtual CIMValue getProperty(

virtual Value getProperty(

bool lock,

const String& nameSpace,

const CIMNamespaceName& nameSpace,

const Reference& instanceName,

const CIMObjectPath& instanceName,

const String& propertyName);

const CIMName& propertyName) = 0;

/// setProperty

virtual void setProperty(

const String& nameSpace,

bool lock,

const Reference& instanceName,

const CIMNamespaceName& nameSpace,

const String& propertyName,

const CIMObjectPath& instanceName,

const Value& newValue = Value());

const CIMName& propertyName,

const CIMValue& newValue,

/// getQualifier

const ContentLanguageList& contentLangs) = 0;

virtual QualifierDecl getQualifier(

const String& nameSpace,

virtual CIMQualifierDecl getQualifier(

const String& qualifierName);

bool lock,

const CIMNamespaceName& nameSpace,

const CIMName& qualifierName) = 0;

/// setQualifier

virtual void setQualifier(

const String& nameSpace,

bool lock,

const QualifierDecl& qualifierDecl);

const CIMNamespaceName& nameSpace,

const CIMQualifierDecl& qualifierDecl,

const ContentLanguageList& contentLangs) = 0;

/// virtual deleteQualifier

virtual void deleteQualifier(

const String& nameSpace,

bool lock,

const String& qualifierName);

const CIMNamespaceName& nameSpace,

const CIMName& qualifierName) = 0;

/// enumerateQualifiers

virtual Array<QualifierDecl> enumerateQualifiers(

virtual Array<CIMQualifierDecl> enumerateQualifiers(

const String& nameSpace);

bool lock,

const CIMNamespaceName& nameSpace) = 0;

/// Virtual value

virtual Value invokeMethod(

virtual void createNameSpace(

const String& nameSpace,

bool lock,

const Reference& instanceName,

const CIMNamespaceName& nameSpace,

const String& methodName,

const NameSpaceAttributes& attributes) = 0;

const Array<Value>& inParameters,

Array<Value>& outParameters);

virtual void modifyNameSpace(

bool lock,

/** Method createNameSpace - Creates a new namespace in the repository

const CIMNamespaceName& nameSpace,

@param String with the name of the namespace

const NameSpaceAttributes& attributes) = 0;

@exception - ???

ATTN: What happens if the namespace already exists.

virtual Array<CIMNamespaceName> enumerateNameSpaces(

bool lock) const = 0;

void createNameSpace(const String& nameSpace);

virtual void deleteNameSpace(

/** Method enumerateNameSpaces - Get all of the namespaces in the

bool lock,

repository. \Ref{NAMESPACE}

const CIMNamespaceName& nameSpace) = 0;

@return Array of strings with the namespaces

virtual Boolean getNameSpaceAttributes(

virtual Array<String> enumerateNameSpaces() const;

bool lock,

const CIMNamespaceName& nameSpace,

/** Method createMetaQualifiers - ATTN:

NameSpaceAttributes& attributes) = 0;

This method must be invoked to create the appropriate meta-qualifiers

required by CIM (they are not part of the CIM schema; rather they are

virtual void setDeclContext(

part of the meta-schema).

bool lock,

RepositoryDeclContext* context) = 0;

void createMetaQualifiers(const String& nameSpace);

virtual Boolean isDefaultInstanceProvider(

private:

bool lock) = 0;

static Array<String> _getStringArray()

virtual void getSubClassNames(

{

bool lock,

return Array<String>();

const CIMNamespaceName& nameSpace,

}

const CIMName& className,

Boolean deepInheritance,

String _root;

Array<CIMName>& subClassNames) const = 0;

RepositoryDeclContext* _context;

virtual void getSuperClassNames(

bool lock,

const CIMNamespaceName& nameSpace,

const CIMName& className,

Array<CIMName>& superClassNames) const = 0;

virtual Boolean isRemoteNameSpace(

bool lock,

const CIMNamespaceName& nameSpace,

String& remoteInfo) = 0;

#ifdef PEGASUS_DEBUG

virtual void DisplayCacheStatistics(

bool lock) = 0;

#endif

};

PEGASUS_NAMESPACE_END

#endif /* PegasusRepository_Repository_h */

#endif /* Pegasus_Repository_h */

Legend:

Removed from v.1.6
changed lines
	Added in v.1.10.2.3

No CVS admin address has been configured