- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.sql.SQLException
-
- java.sql.SQLClientInfoException
-
- All Implemented Interfaces:
- Serializable, Iterable<Throwable>
public class SQLClientInfoException extends SQLException
The subclass ofSQLException
is thrown when one or more client info properties could not be set on aConnection
. In addition to the information provided bySQLException
, aSQLClientInfoException
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 theConnection.setClientInfo
method threw an exception. An application can use thegetFailedProperties
method to retrieve a list of client info properties that were not set. The properties are identified by passing aMap<String,ClientInfoStatus>
to the appropriateSQLClientInfoException
constructor.- Since:
- 1.6
- See Also:
ClientInfoStatus
,Connection.setClientInfo(java.lang.String, java.lang.String)
, Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description SQLClientInfoException()
Constructs aSQLClientInfoException
Object.SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)
Constructs aSQLClientInfoException
object initialized with a givenfailedProperties
.SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties, Throwable cause)
Constructs aSQLClientInfoException
object initialized with a givencause
andfailedProperties
.SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties)
Constructs aSQLClientInfoException
object initialized with a givenreason
andfailedProperties
.SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
Constructs aSQLClientInfoException
object initialized with a givenreason
,cause
andfailedProperties
.SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties)
Constructs aSQLClientInfoException
object initialized with a givenreason
,SQLState
,vendorCode
andfailedProperties
.SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
Constructs aSQLClientInfoException
object initialized with a givenreason
,SQLState
,cause
,vendorCode
andfailedProperties
.SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties)
Constructs aSQLClientInfoException
object initialized with a givenreason
,SQLState
andfailedProperties
.SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
Constructs aSQLClientInfoException
object initialized with a givenreason
,SQLState
,cause
andfailedProperties
.
-
Method Summary
Methods Modifier and Type Method and Description Map<String,ClientInfoStatus>
getFailedProperties()
Returns the list of client info properties that could not be set.-
Methods inherited from class java.sql.SQLException
getErrorCode, getNextException, getSQLState, iterator, setNextException
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
SQLClientInfoException
public SQLClientInfoException()
Constructs aSQLClientInfoException
Object. Thereason
,SQLState
, and failedProperties list are initialized tonull
and the vendor code is initialized to 0. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method.- Since:
- 1.6
-
SQLClientInfoException
public SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)
Constructs aSQLClientInfoException
object initialized with a givenfailedProperties
. Thereason
andSQLState
are initialized tonull
and the vendor code is initialized to 0. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method.- Parameters:
failedProperties
- 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 inClientInfoStatus
- Since:
- 1.6
-
SQLClientInfoException
public SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties, Throwable cause)
Constructs aSQLClientInfoException
object initialized with a givencause
andfailedProperties
. Thereason
is initialized tonull
ifcause==null
or tocause.toString()
ifcause!=null
and the vendor code is initialized to 0.- Parameters:
failedProperties
- 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 inClientInfoStatus
cause
- the (which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown.- Since:
- 1.6
-
SQLClientInfoException
public SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties)
Constructs aSQLClientInfoException
object initialized with a givenreason
andfailedProperties
. TheSQLState
is initialized tonull
and the vendor code is initialized to 0. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method.- Parameters:
reason
- a description of the exceptionfailedProperties
- 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 inClientInfoStatus
- Since:
- 1.6
-
SQLClientInfoException
public SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
Constructs aSQLClientInfoException
object initialized with a givenreason
,cause
andfailedProperties
. TheSQLState
is initialized tonull
and the vendor code is initialized to 0.- Parameters:
reason
- a description of the exceptionfailedProperties
- 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 inClientInfoStatus
cause
- the underlying reason for thisSQLException
(which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown.- Since:
- 1.6
-
SQLClientInfoException
public SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties)
Constructs aSQLClientInfoException
object initialized with a givenreason
,SQLState
andfailedProperties
. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method. The vendor code is initialized to 0.- Parameters:
reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exceptionfailedProperties
- 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 inClientInfoStatus
- Since:
- 1.6
-
SQLClientInfoException
public SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
Constructs aSQLClientInfoException
object initialized with a givenreason
,SQLState
,cause
andfailedProperties
. The vendor code is initialized to 0.- Parameters:
reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exceptionfailedProperties
- 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 inClientInfoStatus
cause
- the underlying reason for thisSQLException
(which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown.- Since:
- 1.6
-
SQLClientInfoException
public SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties)
Constructs aSQLClientInfoException
object initialized with a givenreason
,SQLState
,vendorCode
andfailedProperties
. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method.- Parameters:
reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exceptionvendorCode
- a database vendor-specific exception codefailedProperties
- 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 inClientInfoStatus
- Since:
- 1.6
-
SQLClientInfoException
public SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
Constructs aSQLClientInfoException
object initialized with a givenreason
,SQLState
,cause
,vendorCode
andfailedProperties
.- Parameters:
reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exceptionvendorCode
- a database vendor-specific exception codefailedProperties
- 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 inClientInfoStatus
cause
- the underlying reason for thisSQLException
(which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown.- Since:
- 1.6
-
-
Method Detail
-
getFailedProperties
public Map<String,ClientInfoStatus> getFailedProperties()
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 inClientInfoStatus
- Returns:
- Map list containing the client info properties that could not be set
- Since:
- 1.6
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/sql/sqlclientinfoexception.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.