java.nio.charset.spi

Class CharsetProvider

public abstract class CharsetProvider extends Object

This class allows an implementor to provide additional character sets. The subclass must have a nullary constructor, and be attached to charset implementation classes. These extensions are loaded via the context class loader. To provide the charset extension, all files named META-INF/services/java.nio.charset.spi.CharsetProvider are read from the classpath. Each one should be a UTF-8 encoded list of fully-qualified names of concrete subclasses of this class; whitespace is ignored, and '#' starts comments. Duplicates are ignored. The implementations must be accessible to the classloader that requests them.

Since: 1.4

Constructor Summary
protected	CharsetProvider() Initialize a new charset provider.

Method Summary
abstract Charset	charsetForName(String name) Returns the named charset, by canonical name or alias.
abstract Iterator<Charset>	charsets() Returns an iterator over the charsets defined by this provider.

Constructor Detail

CharsetProvider

protected CharsetProvider()

Initialize a new charset provider. This performs a security check on RuntimePermission("charsetProvider").

Throws: SecurityException if building a new set is not allowed

Method Detail

charsetForName

public abstract Charset charsetForName(String name)

Returns the named charset, by canonical name or alias.

Parameters: name the name of the character

Returns: the charset, or null if not supported

charsets

public abstract Iterator<Charset> charsets()

Returns an iterator over the charsets defined by this provider.

Returns: the iterator