Package javax.wbem
Class WBEMException
java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.wbem.WBEMException
- All Implemented Interfaces:
Serializable
WBEMException
is returned when there is a WBEM Operations error.
WBEMException
includes the following:ID
- TheID
of the exceptionDescription
- Brief description of the exceptionCIMInstance[]
- Optional array ofCIM_Error
instances
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
Access Denied Exception.static final int
Element already exists.static final int
Class has subclasses.static final int
Class has instances.static final int
The WBEM Server does not support continuation on error.static final int
General Exception.static final int
Using a filter in the enumeration is not supported by the WBEM Server.static final int
Invalid class specified.static final int
The enumeration identified by the specified context cannot be found, is in a closed state, does not exist, or is otherwise invalid.static final int
Invalid namespace Exception.static final int
The specified operation timeout is not supported by the WBEM Server.static final int
Invalid parameter is passed to a method.static final int
Invalid query.static final int
The destination is invalid.static final int
The super class does not exist.static final int
The method is not available.static final int
The method is not found.static final int
The namespace is not empty.static final int
The property does not exist in the class/instance being manipulated.static final int
Element cannot be found.static final int
The action is not supported.static final int
The attempt to abandon a concurrent Pull operation on the same enumeration failed, the concurrent Pull operation proceeds normally.static final int
The Pull operation has been abandoned due to execution of a concurrent CloseEnumeration operation on the same enumeration.static final int
The requested query language is not recognized.static final int
The WBEM Server is in the process of shutting down and cannot process the operation at this time.static final int
The WBEM Server has failed the operation based upon exceeding server limits. -
Constructor Summary
ConstructorsConstructorDescriptionWBEMException
(int pID) Constructs a new exception using the specified ID.WBEMException
(int pID, String pMessage) Constructs a new exception using the specified ID and detailed message.WBEMException
(int pID, String pMessage, CIMInstance[] pErrors) Constructs a new exception using the specified ID, detailed message and CIM_Error instances.WBEMException
(int pID, String pMessage, CIMInstance[] pErrors, Throwable pCause) Constructs a new exception using the specified ID, detailed message, CIM_Error instances and cause.WBEMException
(String pMessage) Constructs a new exception using the specified detailed message. -
Method Summary
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
Field Details
-
CIM_ERR_ACCESS_DENIED
public static final int CIM_ERR_ACCESS_DENIEDAccess Denied Exception. Thrown when the principal is not authenticated or authorized.- See Also:
-
CIM_ERR_ALREADY_EXISTS
public static final int CIM_ERR_ALREADY_EXISTSElement already exists.- See Also:
-
CIM_ERR_CLASS_HAS_CHILDREN
public static final int CIM_ERR_CLASS_HAS_CHILDRENClass has subclasses. The exception is thrown by the WBEM Server to disallow invalidation of the subclasses by the super class deletion. Clients must explicitly delete the subclasses first. The check for subclasses is made before the check for class instances.- See Also:
-
CIM_ERR_CLASS_HAS_INSTANCES
public static final int CIM_ERR_CLASS_HAS_INSTANCESClass has instances. The exception is thrown by the WBEM Server to disallow invalidation of the instances by the class deletion. Clients must explicitly delete the instances first. The check for subclasses is made before the check for class instances i.e.CIM_ERR_CLASS_HAS_CHILDREN
is thrown beforeCIM_ERR_CLASS_HAS_INSTANCES
- See Also:
-
CIM_ERR_CONTINUATION_ON_ERROR_NOT_SUPPORTED
public static final int CIM_ERR_CONTINUATION_ON_ERROR_NOT_SUPPORTEDThe WBEM Server does not support continuation on error.- See Also:
-
CIM_ERR_FAILED
public static final int CIM_ERR_FAILEDGeneral Exception. If no other error IDs match the error, this one should be returned.- See Also:
-
CIM_ERR_FILTERED_ENUMERATION_NOT_SUPPORTED
public static final int CIM_ERR_FILTERED_ENUMERATION_NOT_SUPPORTEDUsing a filter in the enumeration is not supported by the WBEM Server.- See Also:
-
CIM_ERR_INVALID_CLASS
public static final int CIM_ERR_INVALID_CLASSInvalid class specified. For e.g. when one tries to add an instance for a class that does not exist. This error message uses one parameter, the invalid class name.- See Also:
-
CIM_ERR_INVALID_ENUMERATION_CONTEXT
public static final int CIM_ERR_INVALID_ENUMERATION_CONTEXTThe enumeration identified by the specified context cannot be found, is in a closed state, does not exist, or is otherwise invalid.- See Also:
-
CIM_ERR_INVALID_NAMESPACE
public static final int CIM_ERR_INVALID_NAMESPACEInvalid namespace Exception. Thrown when the specified namespace does not exist.- See Also:
-
CIM_ERR_INVALID_OPERATION_TIMEOUT
public static final int CIM_ERR_INVALID_OPERATION_TIMEOUTThe specified operation timeout is not supported by the WBEM Server.- See Also:
-
CIM_ERR_INVALID_PARAMETER
public static final int CIM_ERR_INVALID_PARAMETERInvalid parameter is passed to a method. This error message uses one parameter, the parameter which caused the exception.- See Also:
-
CIM_ERR_INVALID_QUERY
public static final int CIM_ERR_INVALID_QUERYInvalid query. This error message has two parameters, the invalid snippet of the query, and additional info with the actual error in the query.- See Also:
-
CIM_ERR_INVALID_RESPONSE_DESTINATION
public static final int CIM_ERR_INVALID_RESPONSE_DESTINATIONThe destination is invalid.- See Also:
-
CIM_ERR_INVALID_SUPERCLASS
public static final int CIM_ERR_INVALID_SUPERCLASSThe super class does not exist.- See Also:
-
CIM_ERR_METHOD_NOT_AVAILABLE
public static final int CIM_ERR_METHOD_NOT_AVAILABLEThe method is not available.- See Also:
-
CIM_ERR_METHOD_NOT_FOUND
public static final int CIM_ERR_METHOD_NOT_FOUNDThe method is not found.- See Also:
-
CIM_ERR_NAMESPACE_NOT_EMPTY
public static final int CIM_ERR_NAMESPACE_NOT_EMPTYThe namespace is not empty.- See Also:
-
CIM_ERR_NO_SUCH_PROPERTY
public static final int CIM_ERR_NO_SUCH_PROPERTYThe property does not exist in the class/instance being manipulated. This error message uses one parameter, the name of the property that does not exist.- See Also:
-
CIM_ERR_NOT_FOUND
public static final int CIM_ERR_NOT_FOUNDElement cannot be found. This error message uses one parameter, the element that cannot be found.- See Also:
-
CIM_ERR_NOT_SUPPORTED
public static final int CIM_ERR_NOT_SUPPORTEDThe action is not supported. This can be thrown by a provider or the WBEM Server itself when it does not support a particular method.- See Also:
-
CIM_ERR_PULL_CANNOT_BE_ABANDONED
public static final int CIM_ERR_PULL_CANNOT_BE_ABANDONEDThe attempt to abandon a concurrent Pull operation on the same enumeration failed, the concurrent Pull operation proceeds normally.- See Also:
-
CIM_ERR_PULL_HAS_BEEN_ABANDONED
public static final int CIM_ERR_PULL_HAS_BEEN_ABANDONEDThe Pull operation has been abandoned due to execution of a concurrent CloseEnumeration operation on the same enumeration.- See Also:
-
CIM_ERR_QUERY_LANGUAGE_NOT_SUPPORTED
public static final int CIM_ERR_QUERY_LANGUAGE_NOT_SUPPORTEDThe requested query language is not recognized. This error message has one parameter, the invalid query language string.- See Also:
-
CIM_ERR_SERVER_IS_SHUTTING_DOWN
public static final int CIM_ERR_SERVER_IS_SHUTTING_DOWNThe WBEM Server is in the process of shutting down and cannot process the operation at this time.- See Also:
-
CIM_ERR_SERVER_LIMITS_EXCEEDED
public static final int CIM_ERR_SERVER_LIMITS_EXCEEDEDThe WBEM Server has failed the operation based upon exceeding server limits.- See Also:
-
-
Constructor Details
-
WBEMException
public WBEMException(int pID) Constructs a new exception using the specified ID. The detailed message will benull
.- Parameters:
pID
- The Error ID to use.- Throws:
IllegalArgumentException
- If the pID does not match one of the predefined messages.
-
WBEMException
Constructs a new exception using the specified ID and detailed message.- Parameters:
pID
- The error ID.pMessage
- The detailed message.- Throws:
IllegalArgumentException
- If the pID does not match one of the predefined messages.
-
WBEMException
Constructs a new exception using the specified ID, detailed message and CIM_Error instances.- Parameters:
pID
- The error ID.pMessage
- The detailed message.pErrors
- Array of CIM_Error instances.- Throws:
IllegalArgumentException
- If the pID does not match one of the predefined messages.
-
WBEMException
Constructs a new exception using the specified ID, detailed message, CIM_Error instances and cause.- Parameters:
pID
- The error ID.pMessage
- The detailed message.pErrors
- Array of CIM_Error instances.pCause
-Throwable
cause.- Throws:
IllegalArgumentException
- If the pID does not match one of the predefined messages.
-
WBEMException
Constructs a new exception using the specified detailed message. TheID
will beCIM_ERR_FAILED
.- Parameters:
pMessage
- The detailed message.
-
-
Method Details
-
getCIMErrors
Get the CIM Error Instances.- Returns:
- Any CIM Error instances associated with this exception;
null
if none.
-
getID
public int getID()Returns the ID of the error.- Returns:
- The ID of the error.
-
toString
Prints out the ID and the optional detailed message.
-