javax.wbem.provider
Interface MethodProvider

All Superinterfaces:

Provider

public interface MethodProvider

extends Provider

This interface is implemented by method providers. A method provider is a provider that implements one or more methods for a CIM class.

Since:

JSR48 1.0.0

Method Summary

java.lang.Object

invokeMethod(CIMObjectPath op, java.lang.String methodName, CIMArgument[] inArgs, CIMArgument[] outArgs) This method is invoked in order to perform the Extrinsic Method Invocation operation as defined by the CIM operations over HTTP spec at

Methods inherited from interface javax.wbem.provider.Provider

close, initialize

Method Detail

invokeMethod

public java.lang.Object invokeMethod(CIMObjectPath op,
                                     java.lang.String methodName,
                                     CIMArgument[] inArgs,
                                     CIMArgument[] outArgs)
                              throws WBEMException

This method is invoked in order to perform the Extrinsic Method Invocation operation as defined by the CIM operations over HTTP spec at

Parameters:

op - Contains the path to the instance or class (if static) whose method must be invoked.

methodName - The name of the extrinsic method even if only one extrinsic method is supported.

inArgs - An array of CIMArgument which are the input parameters for methodName. If methodName has no input parameters then inArgs will be a zero-length array.

outArgs - An array of CIMArgument which are the output values for methodName returned by the Provider. If methodName has no output parameters then it is assumed that the client has allocated a zero-length array that the Provider need not modify.

Returns:

The return value of the extrinsic method. If the extrinsic method has no return value, it must return NULL. NOTE: The actual data the extrinsic method may return is found in outArgs.

Throws:

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

• CIM_ERR_ACCESS_DENIED
• 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 (The provider does nto support the method)
• CIM_ERR_FAILED (some other unspecified erroroccurred)