public abstract class CharsetProvider extends Object
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
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.
|Modifier||Constructor and Description|
Initializes a new charset provider.
|Modifier and Type||Method and Description|
Retrieves a charset for the given charset name.
Creates an iterator that iterates over the charsets supported by this provider.
charsetName- The name of the requested charset; may be either a canonical name or an alias
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2023, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.