Package com.vmware.vapi.std.errors
Class Canceled
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.lang.RuntimeException
-
- com.vmware.vapi.bindings.ApiError
-
- com.vmware.vapi.std.errors.Error
-
- com.vmware.vapi.std.errors.Canceled
-
- All Implemented Interfaces:
StaticStructure
,Structure
,java.io.Serializable
public class Canceled extends Error implements java.io.Serializable, StaticStructure
TheCanceled
exception indicates that the method canceled itself in response to an explicit request to do so. Methods being "canceled" for other reasons (for example the client connection was closed, a time out occured, or due to excessive resource consumption) should not report this exception.Examples:
- A user is monitoring the progress of the method in a GUI and sees that it is likely to take longer than he is willing to wait and clicks the cancel button.
- A user invokes the method using a command-line tool and decides that she didn't really want to invoke that method, and presses CTRL-c.
Counterexamples:
- The client's connection to the server was closed. Reporting an exception is pointless since the client will not receive the error response because the connection has been closed.
- The request is taking longer than some amount of time. The
TimedOut
exception would be reported if the time was specified as part of the input or is documented in the API contract.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Canceled.Builder
Builder class forCanceled
.-
Nested classes/interfaces inherited from class com.vmware.vapi.std.errors.Error
Error.Type
-
-
Field Summary
-
Fields inherited from class com.vmware.vapi.std.errors.Error
__dynamicStructureFields
-
-
Constructor Summary
Constructors Modifier Constructor Description Canceled()
Default constructor.protected
Canceled(StructValue __dynamicStructureFields)
protected
Canceled(StructValue __dynamicStructureFields, Error.Type errorType)
Canceled(java.util.List<LocalizableMessage> messages, Structure data)
This constructor is provided for backwards compatibility purposes only.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description <T extends Structure>
T_convertTo(java.lang.Class<T> clazz)
Converts this structure into an instance of the provided class structure if possible.java.lang.String
_getCanonicalName()
Returns the canonical name of the structure.static java.lang.String
_getCanonicalTypeName()
Returns the canonical type name.static com.vmware.vapi.bindings.type.ErrorType
_getClassType()
WARNING: Internal method, subject to change in future versions.StructValue
_getDataValue()
Returns thisStructure
represented in the dynamicDataValue
model.DataValue
_getDynamicField(java.lang.String fieldName)
Get a dynamic field value, doesn't allow access to static fields (which have getters/setters).java.util.Set<java.lang.String>
_getDynamicFieldNames()
Get the names of the dynamic fields in the structure.com.vmware.vapi.bindings.type.ErrorType
_getType()
WARNING: Internal method, subject to change in future versions.boolean
_hasTypeNameOf(java.lang.Class<? extends Structure> clazz)
Checks if the runtime type name of this structure matches the type represented by the specified binding class.static Canceled
_newInstance(StructValue structValue)
WARNING: Internal method, subject to change in future versions.
Returns new instance of this binding class and injects the provided data value.
WARNING: The returned object is not fully initialized.static Canceled
_newInstance2(StructValue structValue)
WARNING: Internal method, subject to change in future versions.
Serves as a versioning mechanism.void
_setDynamicField(java.lang.String fieldName, DataValue fieldValue)
Sets a dynamic field value.protected void
_updateDataValue(StructValue structValue)
void
_validate()
Validates the state of the discriminated unions and HasFieldsOf restrictions (if any) in this Java language bindingStructure
.boolean
equals(java.lang.Object obj)
java.lang.String
getMessage()
int
hashCode()
-
Methods inherited from class com.vmware.vapi.std.errors.Error
getData, getErrorType, getMessages, setData, setMessages
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.vmware.vapi.bindings.StaticStructure
toString
-
-
-
-
Constructor Detail
-
Canceled
public Canceled(java.util.List<LocalizableMessage> messages, Structure data)
This constructor is provided for backwards compatibility purposes only. Please use the Builder class instead.
-
Canceled
public Canceled()
Default constructor.
-
Canceled
protected Canceled(StructValue __dynamicStructureFields)
-
Canceled
protected Canceled(StructValue __dynamicStructureFields, Error.Type errorType)
-
-
Method Detail
-
_getType
public com.vmware.vapi.bindings.type.ErrorType _getType()
Description copied from interface:StaticStructure
WARNING: Internal method, subject to change in future versions. ReturnsStructType
instance representing the static bindings type for thisStructure
.- Specified by:
_getType
in interfaceStaticStructure
- Overrides:
_getType
in classError
- Returns:
- the static bindings
StructType
-
_getDataValue
public StructValue _getDataValue()
Description copied from interface:Structure
Returns thisStructure
represented in the dynamicDataValue
model.Attempts to change the returned
StructValue
representation are not required to change the state of this structure. Actually the behavior is implementation dependent and is unspecified. In general the returned value shouldn't be changed.- Specified by:
_getDataValue
in interfaceStructure
- Overrides:
_getDataValue
in classError
- Returns:
StructValue
representing this structure
-
_updateDataValue
protected void _updateDataValue(StructValue structValue)
- Overrides:
_updateDataValue
in classError
-
_validate
public void _validate()
Description copied from interface:StaticStructure
Validates the state of the discriminated unions and HasFieldsOf restrictions (if any) in this Java language bindingStructure
.More precisely, for each union: given value of the discriminant/tag field (
@UnionTag
in the IDL) of an union in this structure, validates that:- all fields of the union required for that value of the discriminant are set
- fields of the union that are not allowed for that value of the discriminant are not set
- any other fields of the structure (not participating in the union) do not affect the validation result
- Specified by:
_validate
in interfaceStaticStructure
- Overrides:
_validate
in classError
-
getMessage
public java.lang.String getMessage()
- Overrides:
getMessage
in classError
-
_hasTypeNameOf
public boolean _hasTypeNameOf(java.lang.Class<? extends Structure> clazz)
Description copied from interface:Structure
Checks if the runtime type name of this structure matches the type represented by the specified binding class.This can be used as efficient check to determine if this instance can be successfully
converted
to the target type.- Specified by:
_hasTypeNameOf
in interfaceStructure
- Overrides:
_hasTypeNameOf
in classError
- Parameters:
clazz
- bindings class for the target structure; must not benull
- Returns:
- true if this structures type name matches exactly the specified class' type name.
-
_convertTo
public <T extends Structure> T _convertTo(java.lang.Class<T> clazz)
Description copied from interface:Structure
Converts this structure into an instance of the provided class structure if possible. A conversion will be possible if the requested structure's fields are all present in this structure.- Specified by:
_convertTo
in interfaceStructure
- Overrides:
_convertTo
in classError
- Parameters:
clazz
- type of the result structure. cannot be null.- Returns:
- an instance of the requested type if conversion is possible.
CoreException
is thrown otherwise.
-
_setDynamicField
public void _setDynamicField(java.lang.String fieldName, DataValue fieldValue)
Description copied from interface:StaticStructure
Sets a dynamic field value. The dynamic filed is extra filed that is not part of the static structure definition, i.e. not represented with getter/setter.- Specified by:
_setDynamicField
in interfaceStaticStructure
- Overrides:
_setDynamicField
in classError
- Parameters:
fieldName
- canonical name of the dynamic field to setfieldValue
- the value of the field
-
_getDynamicField
public DataValue _getDynamicField(java.lang.String fieldName)
Description copied from interface:StaticStructure
Get a dynamic field value, doesn't allow access to static fields (which have getters/setters).- Specified by:
_getDynamicField
in interfaceStaticStructure
- Overrides:
_getDynamicField
in classError
- Parameters:
fieldName
- the canonical name of the dynamic field- Returns:
- the
DataValue
of the dynamic field
-
_getDynamicFieldNames
public java.util.Set<java.lang.String> _getDynamicFieldNames()
Description copied from interface:StaticStructure
Get the names of the dynamic fields in the structure.- Specified by:
_getDynamicFieldNames
in interfaceStaticStructure
- Overrides:
_getDynamicFieldNames
in classError
- Returns:
- set of the canonical field names for the dynamic fields
-
_getClassType
public static com.vmware.vapi.bindings.type.ErrorType _getClassType()
WARNING: Internal method, subject to change in future versions.- Returns:
ErrorType
instance representing the static bindings type for thisError
.
-
_getCanonicalName
public java.lang.String _getCanonicalName()
Description copied from interface:Structure
Returns the canonical name of the structure. By default the canonical name is derived from the fully-qualified IDL name by converting to lower case and inserting underscores between words. For exampleorg.example.FooBar
would turn intoorg.example.foo_bar
.- Specified by:
_getCanonicalName
in interfaceStructure
- Overrides:
_getCanonicalName
in classError
- Returns:
- canonical name
-
_getCanonicalTypeName
public static java.lang.String _getCanonicalTypeName()
Returns the canonical type name. See_getCanonicalName()
.- Returns:
- canonical type name
-
_newInstance
public static Canceled _newInstance(StructValue structValue)
WARNING: Internal method, subject to change in future versions.
Returns new instance of this binding class and injects the provided data value.
WARNING: The returned object is not fully initialized.- Parameters:
structValue
- the source of the data contained in the binding object. Could contain more data than fields of this class can describe i.e. newer version of the binding object. Could be null.- Returns:
- the static bindings
StructType
-
_newInstance2
public static Canceled _newInstance2(StructValue structValue)
WARNING: Internal method, subject to change in future versions.
Serves as a versioning mechanism.
-
-