java.nio.charset.spi
類別 CharsetProvider

java.lang.Object
  java.nio.charset.spi.CharsetProvider

public abstract class CharsetProvider
extends Object

Charset 服務提供者類別。

charset 提供者是此類別的一個具體子類別，具有零參數的建構子和一些相關的 charset 實作類別。Charset 提供者可以作為擴展裝入到 Java 平臺的實例中，也就是把 jar 檔案放入任意常用的擴展目錄中。通過把提供者加入到 applet 或應用程序類別路徑中，或者通過某些特定於平臺的其他方式來使提供者可用。通過當前執行緒的上下文類別載入器來尋找 Charset 提供者。

charset 提供者使用資源目錄 META-INF/services 下的名稱為 java.nio.charset.spi.CharsetProvider 的提供者配置檔案標識它自己。該檔案應該套件含一個完全限定的具體 charset 提供者類別名的列表，每行一個類別名。通過下列字元之一表示某行已終止：換行 ('\n')、回車(Enter) ('\r') 或回車(Enter)後直接跟著換行。忽略各名稱周圍的空格字元和製表符以及空行。註釋字元為 '#' ('\u0023')；將忽略每行的第一個註釋字元後面的所有字元。檔案必須使用 UTF-8 編碼。

如果在多個配置檔案中命名了一個特定的具體 charset 提供者類別，或在同一配置檔案中多次對其命名，則忽略重複的命名。命名特定提供者的配置檔案不必像提供者本身一樣位於同一個 jar 檔案或其他的分佈式單元中。提供者必須是從同一個類別載入器可存取的，為了尋找配置檔案而在開始時查詢該類別載入器；這不必是裝載檔案的類別載入器。

從以下版本開始：

1.4

另請參見：

Charset

建構子摘要

protected

CharsetProvider() 初始化新的 charset 提供者。

方法摘要

abstract Charset	charsetForName(String charsetName) 用給定的 charset 名稱獲取 charset。
abstract Iterator<Charset>	charsets() 創建在此提供者所支持的 charset 上進行迭代的迭代器。

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

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

建構子詳細資訊

CharsetProvider

protected CharsetProvider()

初始化新的 charset 提供者。

拋出：

SecurityException - 如果已安裝安全管理器並且它拒絕 RuntimePermission("charsetProvider")

方法詳細資訊

charsets

public abstract Iterator<Charset> charsets()

創建在此提供者所支持的 charset 上進行迭代的迭代器。在 Charset.availableCharsets 方法的實作中使用此方法。

返回：

新迭代器

charsetForName

public abstract Charset charsetForName(String charsetName)

用給定的 charset 名稱獲取 charset。

參數：

charsetName - 請求的 charset 的名稱；可以是規範名稱或別名

返回：

指定 charset 的 charset 物件；如果此提供者不支持該指定 charset，則返回 null