com.cloudpos

Class DeviceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.cloudpos.DeviceException

All Implemented Interfaces:

java.io.Serializable

public class DeviceException
extends java.lang.Exception

The DeviceException class represents exceptions that occur when access problems are detected by service controls in the device handling logic. It is designed to be lightweight and suitable for dynamic creation and disposal, even in resource-constrained environments.

This exception class does not provide "set" methods for its fields; the cause of the exception is set exclusively by constructors. Each DeviceException instance has an associated error code that indicates the reason for the exception. The descriptions of these codes provide context for their occurrence.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	ARGUMENT_EXCEPTION Parameter error
static int	BAD_CONTROL_MODE Indicates that the device object is not in the appropriate mode to perform the requested action.
static int	DUPLICATE_USER_KEY Duplicate user key
static int	GENERAL_EXCEPTION Other undefined exception
static int	LEVEL_3_HALTED Level 3 halted
static int	NO_IMPLEMENT Device doesn't support the request
static int	NO_PERMISSION No permissions associated
static int	NO_REQUEST_PENDING No request was pending when cancelRequest() was invoked
static int	REQUEST_PENDING Indicates that a previous request made by this device object has not been completed.
static int	TIMEOUT_EXCEPTION Time out

Constructor Summary

Constructors

Constructor and Description
DeviceException(int code) Constructs an DeviceException with the given detail message code.
DeviceException(int code, java.lang.String message)
DeviceException(int code, java.lang.String message, java.lang.Throwable throwable)
DeviceException(java.lang.String message) Constructs an DeviceException with the given detail message.
DeviceException(java.lang.Throwable throwable)

Method Summary

Modifier and Type	Method and Description
int	getCode() Retrieves the error code associated with this exception.
java.lang.String	toString() Returns a short description of this exception, including the error code and message.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

BAD_CONTROL_MODE

public static final int BAD_CONTROL_MODE

Indicates that the device object is not in the appropriate mode to perform the requested action. This error code is triggered in several situations:

• When open() is called while the device is already open.
• When any method other than open() is called while the device is not open.
• In certain specific cases where method calls are only permitted when the device is in a particular state. Refer to the specifications of individual controls for more details.

See Also:

Constant Field Values

NO_IMPLEMENT

public static final int NO_IMPLEMENT

Device doesn't support the request

See Also:

Constant Field Values

REQUEST_PENDING

public static final int REQUEST_PENDING

Indicates that a previous request made by this device object has not been completed. This error code is used in the following situation:

• When any method is called while another asynchronous operation initiated by the same device object is still pending.

See Also:

Constant Field Values

NO_REQUEST_PENDING

public static final int NO_REQUEST_PENDING

No request was pending when cancelRequest() was invoked

See Also:

Constant Field Values

NO_PERMISSION

public static final int NO_PERMISSION

No permissions associated

See Also:

Constant Field Values

GENERAL_EXCEPTION

public static final int GENERAL_EXCEPTION

Other undefined exception

See Also:

Constant Field Values

ARGUMENT_EXCEPTION

public static final int ARGUMENT_EXCEPTION

Parameter error

See Also:

Constant Field Values

DUPLICATE_USER_KEY

public static final int DUPLICATE_USER_KEY

Duplicate user key

See Also:

Constant Field Values

TIMEOUT_EXCEPTION

public static final int TIMEOUT_EXCEPTION

Time out

See Also:

Constant Field Values

LEVEL_3_HALTED

public static final int LEVEL_3_HALTED

Level 3 halted

See Also:

Constant Field Values

Constructor Detail

DeviceException

public DeviceException(int code)

Constructs an DeviceException with the given detail message code.

Parameters:

code - a constant, defined in DeviceException, identifying the cause of the exception

DeviceException

public DeviceException(java.lang.String message)

Constructs an DeviceException with the given detail message.

Parameters:

message -

DeviceException

public DeviceException(int code,
                       java.lang.String message)

DeviceException

public DeviceException(java.lang.Throwable throwable)

DeviceException

public DeviceException(int code,
                       java.lang.String message,
                       java.lang.Throwable throwable)

Method Detail

getCode

public final int getCode()

Retrieves the error code associated with this exception.

Returns:

The error code indicating the cause of the exception.

toString

public java.lang.String toString()

Returns a short description of this exception, including the error code and message.

Overrides:

toString in class java.lang.Throwable

Returns:

A string representation of the exception.