Skip to content

Most visited

Recently visited



public abstract class CharsetProvider
extends Object

   ↳ java.nio.charset.spi.CharsetProvider

Charset service-provider class.

A charset provider is a concrete subclass of this class that has a zero-argument constructor and some number of associated charset implementation classes. Charset providers may be installed in an instance of the Java platform as extensions, that is, jar files placed into any of the usual extension directories. Providers may also be made available by adding them to the applet or application class path or by some other platform-specific means. Charset providers are looked up via the current thread's context class loader.

A charset provider identifies itself with a provider-configuration file named java.nio.charset.spi.CharsetProvider in the resource directory META-INF/services. The file should contain a list of fully-qualified concrete charset-provider class names, one per line. A line is terminated by any one of a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a line feed. Space and tab characters surrounding each name, as well as blank lines, are ignored. The comment character is '#' ('\u0023'); on each line all characters following the first comment character are ignored. The file must be encoded in UTF-8.

If a particular concrete charset provider class is named in more than one configuration file, or is named in the same configuration file more than once, then the duplicates will be ignored. The configuration file naming a particular provider need not be in the same jar file or other distribution unit as the provider itself. The provider must be accessible from the same class loader that was initially queried to locate the configuration file; this is not necessarily the class loader that loaded the file.

See also:


Protected constructors


Initializes a new charset provider.

Public methods

abstract Charset charsetForName(String charsetName)

Retrieves a charset for the given charset name.

abstract Iterator<Charset> charsets()

Creates an iterator that iterates over the charsets supported by this provider.

Inherited methods

Protected constructors


added in API level 1
CharsetProvider ()

Initializes a new charset provider.

SecurityException If a security manager has been installed and it denies RuntimePermission("charsetProvider")

Public methods


added in API level 1
Charset charsetForName (String charsetName)

Retrieves a charset for the given charset name.

charsetName String: The name of the requested charset; may be either a canonical name or an alias

Charset A charset object for the named charset, or null if the named charset is not supported by this provider


added in API level 1
Iterator<Charset> charsets ()

Creates an iterator that iterates over the charsets supported by this provider. This method is used in the implementation of the Charset.availableCharsets method.

Iterator<Charset> The new iterator

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)