![]() ![]() |
![]() |
File: [Pegasus] / pegasus / src / Pegasus / Client / CIMClient.h
(download)
Revision: 1.14.2.5, Tue Nov 6 00:52:05 2001 UTC (22 years, 8 months ago) by kumpf Branch: dev CVS Tags: SNAPSHOT_1_04 Changes since 1.14.2.4: +3 -2 lines HP-YZ Fixed createInstance to return a CIMReference (instanceName). |
//%///////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2000, 2001 BMC Software, Hewlett-Packard Company, IBM, // The Open Group, Tivoli Systems // // 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. // //============================================================================== // // Author: Mike Brasher (mbrasher@bmc.com) // // Modified By: Nitin Upasani, Hewlett-Packard Company (Nitin_Upasani@hp.com) // // Modified By: Yi Zhou, Hewlett-Packard Company (yi_zhou@hp.com) // //%///////////////////////////////////////////////////////////////////////////// #ifndef Pegasus_Client_h #define Pegasus_Client_h #include <fstream> #include <Pegasus/Common/Config.h> #include <Pegasus/Common/String.h> #include <Pegasus/Common/Monitor.h> #include <Pegasus/Common/HTTPConnector.h> #include <Pegasus/Common/CIMMessage.h> #include <Pegasus/Common/CIMObject.h> #include <Pegasus/Common/Exception.h> #include <Pegasus/Client/Linkage.h> PEGASUS_NAMESPACE_BEGIN class Monitor; class CIMOperationResponseDecoder; class CIMOperationRequestEncoder; /** This class provides the interface that a client uses to communicate with a CIMOM. */ class PEGASUS_CLIENT_LINKAGE CIMClient : public MessageQueue { public: enum { DEFAULT_TIMEOUT_MILLISECONDS = 20000 }; /// CIMClient( Monitor* monitor, HTTPConnector* httpConnector, Uint32 timeOutMilliseconds = DEFAULT_TIMEOUT_MILLISECONDS); /// ~CIMClient(); /// virtual void handleEnqueue(); /** Returns the queue name. */ virtual const char* getQueueName() const; /// Uint32 getTimeOut() const { return _timeOutMilliseconds; } /// void setTimeOut(Uint32 timeOutMilliseconds) { _timeOutMilliseconds = timeOutMilliseconds; } /** connect - Creates an HTTP connection with the server defined by the URL in address. @param address - String defining the URL of the server to which the client should connect @return - No return defined. Failure to connect throws an exception @exception AlreadyConnected if connection already established @exception InvalidLocator @exception CannotCreateSocket @exception CannotConnect @exception UnexpectedFailure */ void connect(const String& address); /// virtual CIMClass getClass( const String& nameSpace, const String& className, Boolean localOnly = true, Boolean includeQualifiers = true, Boolean includeClassOrigin = false, const Array<String>& propertyList = EmptyStringArray()); /// virtual CIMInstance getInstance( const String& nameSpace, const CIMReference& instanceName, Boolean localOnly = true, Boolean includeQualifiers = false, Boolean includeClassOrigin = false, const Array<String>& propertyList = EmptyStringArray()); /// virtual void deleteClass( const String& nameSpace, const String& className); /// virtual void deleteInstance( const String& nameSpace, const CIMReference& instanceName); /// virtual void createClass( const String& nameSpace, const CIMClass& newClass); virtual CIMReference createInstance( const String& nameSpace, const CIMInstance& newInstance); /// ModifiedClass argument should be a <namedInstance>! virtual void modifyClass( const String& nameSpace, const CIMClass& modifiedClass); /// virtual void modifyInstance( const String& nameSpace, const CIMInstance& modifiedInstance); /// virtual Array<CIMClass> enumerateClasses( const String& nameSpace, const String& className = String::EMPTY, Boolean deepInheritance = false, Boolean localOnly = true, Boolean includeQualifiers = true, Boolean includeClassOrigin = false); /// virtual Array<String> enumerateClassNames( const String& nameSpace, const String& className = String::EMPTY, Boolean deepInheritance = false); /// ATTN: should return array of <namedInstance>! virtual Array<CIMInstance> enumerateInstances( const String& nameSpace, const String& className, Boolean deepInheritance = true, Boolean localOnly = true, Boolean includeQualifiers = false, Boolean includeClassOrigin = false, const Array<String>& propertyList = EmptyStringArray()); /// virtual Array<CIMReference> enumerateInstanceNames( const String& nameSpace, const String& className); /// ATTN: should return Array<CIMObject> virtual Array<CIMInstance> execQuery( const String& queryLanguage, const String& query) ; /// virtual Array<CIMObjectWithPath> associators( const String& nameSpace, const CIMReference& objectName, const String& assocClass = String::EMPTY, const String& resultClass = String::EMPTY, const String& role = String::EMPTY, const String& resultRole = String::EMPTY, Boolean includeQualifiers = false, Boolean includeClassOrigin = false, const Array<String>& propertyList = EmptyStringArray()); /// virtual Array<CIMReference> associatorNames( const String& nameSpace, const CIMReference& objectName, const String& assocClass = String::EMPTY, const String& resultClass = String::EMPTY, const String& role = String::EMPTY, const String& resultRole = String::EMPTY); /// virtual Array<CIMObjectWithPath> references( const String& nameSpace, const CIMReference& objectName, const String& resultClass = String::EMPTY, const String& role = String::EMPTY, Boolean includeQualifiers = false, Boolean includeClassOrigin = false, const Array<String>& propertyList = EmptyStringArray()); /// virtual Array<CIMReference> referenceNames( const String& nameSpace, const CIMReference& objectName, const String& resultClass = String::EMPTY, const String& role = String::EMPTY); /// virtual CIMValue getProperty( const String& nameSpace, const CIMReference& instanceName, const String& propertyName); //// virtual void setProperty( const String& nameSpace, const CIMReference& instanceName, const String& propertyName, const CIMValue& newValue = CIMValue()); /// virtual CIMQualifierDecl getQualifier( const String& nameSpace, const String& qualifierName); /// virtual void setQualifier( const String& nameSpace, const CIMQualifierDecl& qualifierDeclaration); /// virtual void deleteQualifier( const String& nameSpace, const String& qualifierName); /// virtual Array<CIMQualifierDecl> enumerateQualifiers( const String& nameSpace); /// virtual CIMValue invokeMethod( const String& nameSpace, const CIMReference& instanceName, const String& methodName, const Array<CIMParamValue>& inParameters, Array<CIMParamValue>& outParameters); private: Message* _waitForResponse( const Uint32 messageType, const String& messageId, const Uint32 timeOutMilliseconds = DEFAULT_TIMEOUT_MILLISECONDS); void _checkError(const CIMResponseMessage* responseMessage); Monitor* _monitor; HTTPConnector* _httpConnector; Uint32 _timeOutMilliseconds; Boolean _connected; CIMOperationResponseDecoder* _responseDecoder; CIMOperationRequestEncoder* _requestEncoder; }; PEGASUS_NAMESPACE_END #endif /* Pegasus_Client_h */
No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |