version 1.26, 2006/02/08 20:59:53
|
version 1.32, 2008/12/02 09:00:52
|
|
|
//%2006//////////////////////////////////////////////////////////////////////// |
//%LICENSE//////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
// Licensed to The Open Group (TOG) under one or more contributor license |
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
// agreements. Refer to the OpenPegasusNOTICE.txt file distributed with |
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
// this work for additional information regarding copyright ownership. |
// IBM Corp.; EMC Corporation, The Open Group. |
// Each contributor licenses this file to you under the OpenPegasus Open |
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
// Source License; you may not use this file except in compliance with the |
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
// License. |
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; Symantec Corporation; The Open Group. |
|
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a copy |
// Permission is hereby granted, free of charge, to any person obtaining a |
// of this software and associated documentation files (the "Software"), to |
// copy of this software and associated documentation files (the "Software"), |
// deal in the Software without restriction, including without limitation the |
// to deal in the Software without restriction, including without limitation |
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or |
// the rights to use, copy, modify, merge, publish, distribute, sublicense, |
// sell copies of the Software, and to permit persons to whom the Software is |
// and/or sell copies of the Software, and to permit persons to whom the |
// furnished to do so, subject to the following conditions: |
// Software is furnished to do so, subject to the following conditions: |
// | // |
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN |
// The above copyright notice and this permission notice shall be included |
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED |
// in all copies or substantial portions of the Software. |
// "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. |
|
// | // |
//============================================================================== |
// 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. |
|
// |
|
////////////////////////////////////////////////////////////////////////// |
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
|
|
*/ | */ |
virtual void complete() = 0; | virtual void complete() = 0; |
| |
#ifdef PEGASUS_USE_EXPERIMENTAL_INTERFACES |
/** |
/** <I><B>Experimental Interface</B></I><BR> |
|
Sets the context for operation responses delivered to the CIM Server. | Sets the context for operation responses delivered to the CIM Server. |
This method allows a provider to communicate context information | This method allows a provider to communicate context information |
(such as content language) along with an operation response. The | (such as content language) along with an operation response. The |
|
|
delivered to this ResponseHandler object. The context information | delivered to this ResponseHandler object. The context information |
is applied at the time the complete() method is called. | is applied at the time the complete() method is called. |
*/ | */ |
#ifdef PEGASUS_OS_OS400 |
|
virtual |
|
#endif |
|
void setContext(const OperationContext & context); | void setContext(const OperationContext & context); |
#endif // PEGASUS_USE_EXPERIMENTAL_INTERFACES |
|
| |
protected: | protected: |
| |
|
/** |
|
The default constructor is not available for the ResponseHandler class. |
|
*/ |
ResponseHandler(); | ResponseHandler(); |
| |
|
/** |
|
The copy constructor is not available for the ResponseHandler class. |
|
*/ |
ResponseHandler(const ResponseHandler& handler); | ResponseHandler(const ResponseHandler& handler); |
| |
|
/** |
|
The assignment operator is not available for the ResponseHandler class. |
|
*/ |
ResponseHandler& operator=(const ResponseHandler& handler); | ResponseHandler& operator=(const ResponseHandler& handler); |
| |
/** | /** |
|
|
delivered. An Array form of this method is also available to | delivered. An Array form of this method is also available to |
deliver multiple results. | deliver multiple results. |
@param instance The instance to deliver to the CIM Server. | @param instance The instance to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const CIMInstance & instance) = 0; | virtual void deliver(const CIMInstance & instance) = 0; |
| |
|
|
Delivers multiple instance results to the CIM Server. This method | Delivers multiple instance results to the CIM Server. This method |
may be invoked multiple times, if necessary. | may be invoked multiple times, if necessary. |
@param instances The instances to deliver to the CIM Server. | @param instances The instances to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const Array<CIMInstance> & instances) = 0; | virtual void deliver(const Array<CIMInstance> & instances) = 0; |
}; | }; |
|
|
delivered. An Array form of this method is also available to | delivered. An Array form of this method is also available to |
deliver multiple results. | deliver multiple results. |
@param objectPath The object path to deliver to the CIM Server. | @param objectPath The object path to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const CIMObjectPath & objectPath) = 0; | virtual void deliver(const CIMObjectPath & objectPath) = 0; |
| |
|
|
Delivers multiple object path results to the CIM Server. This method | Delivers multiple object path results to the CIM Server. This method |
may be invoked multiple times, if necessary. | may be invoked multiple times, if necessary. |
@param objectPaths The object paths to deliver to the CIM Server. | @param objectPaths The object paths to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const Array<CIMObjectPath> & objectPaths) = 0; | virtual void deliver(const Array<CIMObjectPath> & objectPaths) = 0; |
}; | }; |
|
|
needs to be delivered. An Array form of this method is also | needs to be delivered. An Array form of this method is also |
available to deliver multiple results. | available to deliver multiple results. |
@param outParamValue The output parameter to deliver to the CIM Server. | @param outParamValue The output parameter to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliverParamValue(const CIMParamValue & outParamValue) = 0; | virtual void deliverParamValue(const CIMParamValue & outParamValue) = 0; |
| |
|
|
may be invoked multiple times, if necessary. | may be invoked multiple times, if necessary. |
@param outParamValues An Array of method output parameters to deliver | @param outParamValues An Array of method output parameters to deliver |
to the CIM Server. | to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliverParamValue( | virtual void deliverParamValue( |
const Array<CIMParamValue> & outParamValues) = 0; | const Array<CIMParamValue> & outParamValues) = 0; |
|
|
/** | /** |
Delivers an extrinsic method return value to the CIM Server. | Delivers an extrinsic method return value to the CIM Server. |
@param returnValue The return value to deliver to the CIM Server. | @param returnValue The return value to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const CIMValue & returnValue) = 0; | virtual void deliver(const CIMValue & returnValue) = 0; |
}; | }; |
|
|
Another form is also available to specify the context for the | Another form is also available to specify the context for the |
delivery. | delivery. |
@param indication The indication instance to deliver to the CIM Server. | @param indication The indication instance to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const CIMIndication & indication) = 0; | virtual void deliver(const CIMIndication & indication) = 0; |
| |
|
|
this method is available to specify the context for the delivery. | this method is available to specify the context for the delivery. |
@param indications An Array of indication instances to deliver to the | @param indications An Array of indication instances to deliver to the |
CIM Server. | CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const Array<CIMIndication> & indications) = 0; | virtual void deliver(const Array<CIMIndication> & indications) = 0; |
| |
|
|
with the indication, such as the content language. | with the indication, such as the content language. |
@param context A context associated with the indication delivery. | @param context A context associated with the indication delivery. |
@param indication The indication instance to deliver to the CIM Server. | @param indication The indication instance to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver( | virtual void deliver( |
const OperationContext & context, | const OperationContext & context, |
|
|
@param context A context associated with the indication delivery. | @param context A context associated with the indication delivery. |
@param indications An Array of indication instances to deliver to the | @param indications An Array of indication instances to deliver to the |
CIM Server. | CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver( | virtual void deliver( |
const OperationContext & context, | const OperationContext & context, |
|
|
delivered. An Array form of this method is also available to | delivered. An Array form of this method is also available to |
deliver multiple results. | deliver multiple results. |
@param object The object to deliver to the CIM Server. | @param object The object to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const CIMObject & object) = 0; | virtual void deliver(const CIMObject & object) = 0; |
| |
|
|
Delivers multiple object results to the CIM Server. This method | Delivers multiple object results to the CIM Server. This method |
may be invoked multiple times, if necessary. | may be invoked multiple times, if necessary. |
@param objects The objects to deliver to the CIM Server. | @param objects The objects to deliver to the CIM Server. |
|
@exception Exception May be thrown if the data that is delivered is |
|
not consistent with the corresponding request or associated schema. |
*/ | */ |
virtual void deliver(const Array<CIMObject> & objects) = 0; | virtual void deliver(const Array<CIMObject> & objects) = 0; |
}; | }; |