SQLException is thrown when one or more client info properties
could not be set on a Connection. In addition to the information provided
by SQLException, a SQLClientInfoException provides a list of client info
properties that were not set.
Some databases do not allow multiple client info properties to be set
atomically. For those databases, it is possible that some of the client
info properties had been set even though the Connection.setClientInfo
method threw an exception. An application can use the getFailedProperties
method to retrieve a list of client info properties that were not set. The
properties are identified by passing a
Map<String,ClientInfoStatus> to
the appropriate SQLClientInfoException constructor.
ClientInfoStatus, Connection#setClientInfo
| Modifier and Type | Field and Description |
|---|---|
| private Map | |
| private static final long |
| Access | Constructor and Description |
|---|---|
| public | |
| public | SQLClientInfoException(Map<String, ClientInfoStatus>
A Map containing the property values that could not
be set. The keys in the Map
contain the names of the client info
properties that could not be set and
the values contain one of the reason codes
defined in failedProperties)ClientInfoStatusConstructs a |
| public | SQLClientInfoException(Map<String, ClientInfoStatus>
A Map containing the property values that could not
be set. The keys in the Map
contain the names of the client info
properties that could not be set and
the values contain one of the reason codes
defined in failedProperties, Throwable ClientInfoStatusthe (which is saved for later retrieval by the cause)getCause() method); may be null indicating
the cause is non-existent or unknown.Constructs a |
| public | SQLClientInfoException(String
a description of the exception reason, Map<String, ClientInfoStatus> A Map containing the property values that could not
be set. The keys in the Map
contain the names of the client info
properties that could not be set and
the values contain one of the reason codes
defined in failedProperties)ClientInfoStatusConstructs a |
| public | SQLClientInfoException(String
a description of the exception reason, Map<String, ClientInfoStatus> A Map containing the property values that could not
be set. The keys in the Map
contain the names of the client info
properties that could not be set and
the values contain one of the reason codes
defined in failedProperties, Throwable ClientInfoStatusthe underlying reason for this cause)SQLException (which is saved for later retrieval by the getCause() method); may be null indicating
the cause is non-existent or unknown.Constructs a |
| public | SQLClientInfoException(String
a description of the exception reason, String an XOPEN or SQL:2003 code identifying the exception SQLState, Map<String, ClientInfoStatus> A Map containing the property values that could not
be set. The keys in the Map
contain the names of the client info
properties that could not be set and
the values contain one of the reason codes
defined in failedProperties)ClientInfoStatusConstructs a |
| public | SQLClientInfoException(String
a description of the exception reason, String an XOPEN or SQL:2003 code identifying the exception SQLState, Map<String, ClientInfoStatus> A Map containing the property values that could not
be set. The keys in the Map
contain the names of the client info
properties that could not be set and
the values contain one of the reason codes
defined in failedProperties, Throwable ClientInfoStatusthe underlying reason for this cause)SQLException (which is saved for later retrieval by the getCause() method); may be null indicating
the cause is non-existent or unknown.Constructs a |
| public | SQLClientInfoException(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, Map<String, ClientInfoStatus> A Map containing the property values that could not
be set. The keys in the Map
contain the names of the client info
properties that could not be set and
the values contain one of the reason codes
defined in failedProperties)ClientInfoStatusConstructs a |
| public | SQLClientInfoException(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, Map<String, ClientInfoStatus> A Map containing the property values that could not
be set. The keys in the Map
contain the names of the client info
properties that could not be set and
the values contain one of the reason codes
defined in failedProperties, Throwable ClientInfoStatusthe underlying reason for this cause)SQLException (which is saved for later retrieval by the getCause() method); may be null indicating
the cause is non-existent or unknown.Constructs a |
| Modifier and Type | Method and Description |
|---|---|
| public Map | Returns: Map list containing the client info properties that could not be setReturns the list of client info properties that could not be set. |
| failedProperties | back to summary |
|---|---|
private Map<String, ClientInfoStatus> failedProperties
| |
| serialVersionUID | back to summary |
|---|---|
| private static final long serialVersionUID | |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException() Constructs a
| |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException(Map<String, ClientInfoStatus> failedProperties) Constructs a
| |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException(Map<String, ClientInfoStatus> failedProperties, Throwable cause) Constructs a
| |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException(String reason, Map<String, ClientInfoStatus> failedProperties) Constructs a
| |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException(String reason, Map<String, ClientInfoStatus> failedProperties, Throwable cause) Constructs a
| |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException(String reason, String SQLState, Map<String, ClientInfoStatus> failedProperties) Constructs a
| |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException(String reason, String SQLState, Map<String, ClientInfoStatus> failedProperties, Throwable cause) Constructs a
| |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String, ClientInfoStatus> failedProperties) Constructs a
| |
| SQLClientInfoException | back to summary |
|---|---|
| public SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String, ClientInfoStatus> failedProperties, Throwable cause) Constructs a
| |
| getFailedProperties | back to summary |
|---|---|
| public Map Returns the list of client info properties that could not be set. The
keys in the Map contain the names of the client info
properties that could not be set and the values contain one of the
reason codes defined in
| |