APIdia Launch Partner
Top Description Fields Constructors Methods
java.sql

public Class SQLRecoverableException

extends SQLException
Class Inheritance

The subclass of SQLException thrown in situations where a previously failed operation might be able to succeed if the application performs some recovery steps and retries the entire transaction or in the case of a distributed transaction, the transaction branch. At a minimum, the recovery operation must include closing the current connection and getting a new connection.
Since
1.6

Field Summary

Modifier and TypeField and Description
private static final long

Constructor Summary

AccessConstructor and Description
public
SQLRecoverableException()

Constructs a SQLRecoverableException object.

public
SQLRecoverableException(String
a description of the exception
reason
)

Constructs a SQLRecoverableException object with a given reason.

public
SQLRecoverableException(String
a description of the exception
reason
,
String
an XOPEN or SQL:2003 code identifying the exception
SQLState
)

Constructs a SQLRecoverableException object with a given reason and SQLState.

public
SQLRecoverableException(String
a description of the exception
reason
,
String
an XOPEN or SQL:2003 code identifying the exception
SQLState
,
int
a database vendor specific exception code
vendorCode
)

Constructs a SQLRecoverableException object with a given reason, SQLState and vendorCode.

public
SQLRecoverableException(Throwable
the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
cause
)

Constructs a SQLRecoverableException object with a given cause.

public
SQLRecoverableException(String
a description of the exception.
reason
,
Throwable
the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
cause
)

Constructs a SQLRecoverableException object with a given reason and cause.

public
SQLRecoverableException(String
a description of the exception.
reason
,
String
an XOPEN or SQL:2003 code identifying the exception
SQLState
,
Throwable
the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
cause
)

Constructs a SQLRecoverableException object with a given reason, SQLState and cause.

public
SQLRecoverableException(String
a description of the exception
reason
,
String
an XOPEN or SQL:2003 code identifying the exception
SQLState
,
int
a database vendor-specific exception code
vendorCode
,
Throwable
the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
cause
)

Constructs a SQLRecoverableException object with a given reason, SQLState, vendorCode and cause.

Method Summary

Inherited from java.sql.SQLException:
getErrorCodegetNextExceptiongetSQLStateiteratorsetNextException

Field Detail

serialVersionUIDback to summary
private static final long serialVersionUID

Hides java.sql.SQLException.serialVersionUID.

Constructor Detail

SQLRecoverableExceptionback to summary
public SQLRecoverableException()

Constructs a SQLRecoverableException object. The reason, SQLState are initialized to null and the vendor code is initialized to 0. The cause is not initialized, and may subsequently be initialized by a call to the Throwable#initCause(java.lang.Throwable) method.

Since
1.6
SQLRecoverableExceptionback to summary
public SQLRecoverableException(String reason)

Constructs a SQLRecoverableException object with a given reason. The SQLState is initialized to null and the vendor code is initialized to 0. The cause is not initialized, and may subsequently be initialized by a call to the Throwable#initCause(java.lang.Throwable) method.

Parameters
reason:String

a description of the exception

Since
1.6
SQLRecoverableExceptionback to summary
public SQLRecoverableException(String reason, String SQLState)

Constructs a SQLRecoverableException object with a given reason and SQLState. The cause is not initialized, and may subsequently be initialized by a call to the Throwable#initCause(java.lang.Throwable) method. The vendor code is initialized to 0.

Parameters
reason:String

a description of the exception

SQLState:String

an XOPEN or SQL:2003 code identifying the exception

Since
1.6
SQLRecoverableExceptionback to summary
public SQLRecoverableException(String reason, String SQLState, int vendorCode)

Constructs a SQLRecoverableException object with a given reason, SQLState and vendorCode. The cause is not initialized, and may subsequently be initialized by a call to the Throwable#initCause(java.lang.Throwable) method.

Parameters
reason:String

a description of the exception

SQLState:String

an XOPEN or SQL:2003 code identifying the exception

vendorCode:int

a database vendor specific exception code

Since
1.6
SQLRecoverableExceptionback to summary
public SQLRecoverableException(Throwable cause)

Constructs a SQLRecoverableException object with a given cause. The SQLState is initialized to null and the vendor code is initialized to 0. The reason is initialized to null if cause==null or to cause.toString() if cause!=null.

Parameters
cause:Throwable

the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.

Since
1.6
SQLRecoverableExceptionback to summary
public SQLRecoverableException(String reason, Throwable cause)

Constructs a SQLRecoverableException object with a given reason and cause. The SQLState is initialized to null and the vendor code is initialized to 0.

Parameters
reason:String

a description of the exception.

cause:Throwable

the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.

Since
1.6
SQLRecoverableExceptionback to summary
public SQLRecoverableException(String reason, String SQLState, Throwable cause)

Constructs a SQLRecoverableException object with a given reason, SQLState and cause. The vendor code is initialized to 0.

Parameters
reason:String

a description of the exception.

SQLState:String

an XOPEN or SQL:2003 code identifying the exception

cause:Throwable

the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.

Since
1.6
SQLRecoverableExceptionback to summary
public SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause)

Constructs a SQLRecoverableException object with a given reason, SQLState, vendorCode and cause.

Parameters
reason:String

a description of the exception

SQLState:String

an XOPEN or SQL:2003 code identifying the exception

vendorCode:int

a database vendor-specific exception code

cause:Throwable

the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.

Since
1.6