javax.wbem.provider
Interface MethodProvider

All Superinterfaces:

CIMProvider

public interface MethodProvider

extends CIMProvider

This method is invoked in order to do the Extrinsic Method Invocation operation as defined by the CIM operations over HTTP spec at http://www.dmtf.org/. This is the interface implemented by method providers. These providers are used to provide implementation for all extrinsic methods of CIM classes.

Since:

WBEM 1.0

Method Summary

CIMValue

invokeMethod(CIMObjectPath op, java.lang.String methodName, CIMArgument[] inParams, CIMArgument[] outParams) This method contains the implementation for all defined extrinsic methods.

Methods inherited from interface javax.wbem.provider.CIMProvider

cleanup, initialize

Method Detail

invokeMethod

public CIMValue invokeMethod(CIMObjectPath op,
                             java.lang.String methodName,
                             CIMArgument[] inParams,
                             CIMArgument[] outParams)
                      throws CIMException

This method contains the implementation for all defined extrinsic methods. The CIMOM calls this method when the extrinsic method specified in the parameters is to be invoked.

Parameters:

op - Contains the path to the instance whose extrinsic method must be invoked. It must include all of the keys.

methodName - The name of the extrinsic method (where the provider supports more than one extrinsic method).

inParams - An array of CIMArgument which are the input parameters for methodName. If methodName has no input parameters then inParams must be NULL.

outParams - An array of CIMArgument which are the output values for methodName. If methodName has no output parameters then outParams must be NULL.

Returns:

CIMValue The return value of the extrinsic method. If the extrinsic method has no return value, it must return NULL.

Throws:

CIMException - If unsuccessful, one of the following status codes MUST be returned. The ORDERED list is:

 
   CIM_ERR_ACCESS_DENIED,
   CIM_ERR_NOT_SUPPORTED (provider does not support this method),
   CIM_ERR_INVALID_NAMESPACE,
   CIM_ERR_INVALID_PARAMETER (for this method),
   CIM_ERR_NOT_FOUND (if instance does not exist),
   CIM_ERR_METHOD_NOT_FOUND,
   CIM_ERR_METHOD_NOT_AVAILABLE,
   CIM_ERR_FAILED (some other unspecified error occurred)