java.sql
類別 SQLClientInfoException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.sql.SQLException
              java.sql.SQLClientInfoException

所有已實作的介面：

Serializable, Iterable<Throwable>

public class SQLClientInfoException
extends SQLException

當無法在 Connection 上設置一個或多個客戶端資訊屬性時，拋出此 SQLException 的子類別。除了 SQLException 提供的資訊外，SQLClientInfoException 還提供未設置的客戶端資訊屬性列表。 某些資料庫不允許一次設置多個客戶端資訊屬性。對於這些資料庫，即使 Connection.setClientInfo 方法拋出異常，可能也已經設置了一些客戶端資訊屬性。應用程序可以使用 getFailedProperties 方法獲取未設置的客戶端資訊屬性列表。通過將 Map<String,ClientInfoStatus> 傳遞給適當的 SQLClientInfoException 建構子來標識屬性。

從以下版本開始：

1.6

另請參見：

ClientInfoStatus, Connection.setClientInfo(java.lang.String, java.lang.String), 序列化表格

建構子摘要

SQLClientInfoException()
建構一個 SQLClientInfoException 物件。

SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)
建構一個使用給定 failedProperties 初始化的 SQLClientInfoException 物件。

SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties, Throwable cause)
建構一個使用給定 cause 和 failedProperties 初始化的 SQLClientInfoException 物件。

SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties)
建構一個使用給定 reason 和 failedProperties 初始化的 SQLClientInfoException 物件。

SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
建構一個使用給定 reason、cause 和 failedProperties 初始化的 SQLClientInfoException 物件。

SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties)
建構一個使用給定 reason、SQLState、vendorCode 和 failedProperties 初始化的 SQLClientInfoException 物件。

SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
建構一個使用給定 reason、SQLState、cause、vendorCode 和 failedProperties 初始化的 SQLClientInfoException 物件。

SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties)
建構一個使用給定 reason、SQLState 和 failedProperties 初始化的 SQLClientInfoException 物件。

SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
建構一個使用給定 reason、SQLState、cause 和 failedProperties 初始化的 SQLClientInfoException 物件。

方法摘要

Map<String,ClientInfoStatus>

getFailedProperties() 返回無法設置的客戶端資訊屬性列表。

從類別 java.sql.SQLException 繼承的方法

getErrorCode, getNextException, getSQLState, iterator, setNextException

從類別 java.lang.Throwable 繼承的方法

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

SQLClientInfoException

public SQLClientInfoException()

建構一個 SQLClientInfoException 物件。reason、SQLState 和 failedProperties 列表初始化為 null，供應商程式碼初始化為 0。cause 沒有初始化，隨後可以通過調用 Throwable.initCause(java.lang.Throwable) 方法來初始化。

從以下版本開始：

1.6

SQLClientInfoException

public SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)

建構一個使用給定 failedProperties 初始化的 SQLClientInfoException 物件。reason 和 SQLState 初始化為 null，供應商程式碼初始化為 0。 cause 沒有初始化，隨後可以通過調用 Throwable.initCause(java.lang.Throwable) 方法來初始化。

參數：

failedProperties - 套件含無法設置的屬性值的 Map。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

從以下版本開始：

1.6

SQLClientInfoException

public SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties,
                              Throwable cause)

建構一個使用給定 cause 和 failedProperties 初始化的 SQLClientInfoException 物件。 如果 cause==null，則 reason 初始化為 null；如果 cause!=null，則 reason 初始化為 cause.toString()，供應商程式碼初始化為 0。

參數：

failedProperties - 套件含無法設置的屬性值的 Map。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

cause - 此 SQLClientInfoException 的底層原因（保存此 cause，以供以後通過 getCause() 方法獲取）；可以為 null，表示 cause 不存在或未知。

從以下版本開始：

1.6

SQLClientInfoException

public SQLClientInfoException(String reason,
                              Map<String,ClientInfoStatus> failedProperties)

建構一個使用給定 reason 和 failedProperties 初始化的 SQLClientInfoException 物件。SQLState 初始化為 null，供應商程式碼初始化為 0。 cause 沒有初始化，隨後可以通過調用 Throwable.initCause(java.lang.Throwable) 方法來初始化。

參數：

reason - 對異常的描述

failedProperties - 套件含無法設置的屬性值的 Map。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

從以下版本開始：

1.6

SQLClientInfoException

public SQLClientInfoException(String reason,
                              Map<String,ClientInfoStatus> failedProperties,
                              Throwable cause)

建構一個使用給定 reason、cause 和 failedProperties 初始化的 SQLClientInfoException 物件。SQLState 初始化為 null，供應商程式碼初始化為 0。

參數：

reason - 對異常的描述

failedProperties - 套件含無法設置的屬性值的 Map。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

cause - 此 SQLException 的底層原因（保存此原因，以供以後通過 getCause() 方法獲取）；可以為 null，表示 cause 不存在或未知。

從以下版本開始：

1.6

SQLClientInfoException

public SQLClientInfoException(String reason,
                              String SQLState,
                              Map<String,ClientInfoStatus> failedProperties)

建構一個使用給定 reason、SQLState 和 failedProperties 初始化的 SQLClientInfoException 物件。cause 沒有初始化，隨後可以通過調用 Throwable.initCause(java.lang.Throwable) 方法來初始化。供應商程式碼初始化為 0。

參數：

reason - 對異常的描述

SQLState - 標識異常的 XOPEN 或 SQL:2003 程式碼

failedProperties - 套件含無法設置的屬性值的 Map。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

從以下版本開始：

1.6

SQLClientInfoException

public SQLClientInfoException(String reason,
                              String SQLState,
                              Map<String,ClientInfoStatus> failedProperties,
                              Throwable cause)

建構一個使用給定 reason、SQLState、cause 和 failedProperties 初始化的 SQLClientInfoException 物件。供應商程式碼初始化為 0。

參數：

reason - 對異常的描述

SQLState - 標識異常的 XOPEN 或 SQL:2003 程式碼

failedProperties - 套件含無法設置的屬性值的 Map。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

cause - 此 SQLException 的底層原因（保存此原因，以供以後通過 getCause() 方法獲取）；可以為 null，表示 cause 不存在或未知。

從以下版本開始：

1.6

SQLClientInfoException

public SQLClientInfoException(String reason,
                              String SQLState,
                              int vendorCode,
                              Map<String,ClientInfoStatus> failedProperties)

建構一個使用給定 reason、SQLState、vendorCode 和 failedProperties 初始化的 SQLClientInfoException 物件。cause 沒有初始化，隨後可以通過調用 Throwable.initCause(java.lang.Throwable) 方法來初始化。

參數：

reason - 對異常的描述

SQLState - 標識異常的 XOPEN 或 SQL:2003 程式碼

vendorCode - 特定於資料庫供應商的異常程式碼

failedProperties - 套件含無法設置的屬性值的 Map。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

從以下版本開始：

1.6

SQLClientInfoException

public SQLClientInfoException(String reason,
                              String SQLState,
                              int vendorCode,
                              Map<String,ClientInfoStatus> failedProperties,
                              Throwable cause)

建構一個使用給定 reason、SQLState、cause、vendorCode 和 failedProperties 初始化的 SQLClientInfoException 物件。

參數：

reason - 對異常的描述

SQLState - 標識異常的 XOPEN 或 SQL:2003 程式碼

vendorCode - 特定於資料庫供應商的異常程式碼

failedProperties - 套件含無法設置的屬性值的 Map。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

cause - 此 SQLException 的底層原因（保存此原因，以供以後通過 getCause() 方法獲取）；可以為 null，表示 cause 不存在或未知。

從以下版本開始：

1.6

方法詳細資訊

getFailedProperties

public Map<String,ClientInfoStatus> getFailedProperties()

返回無法設置的客戶端資訊屬性列表。Map 中的鍵包含無法設置的客戶端資訊屬性名稱，值包含 ClientInfoStatus 中定義的某一原因程式碼

返回：

包含無法設置的客戶端資訊屬性的 Map 列表

從以下版本開始：

1.6