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

See Also: Charset

UNKNOWN: updated to 1.4

Constructor Summary
protected CharsetProvider()
Initialize a new charset provider.
Method Summary
abstract CharsetcharsetForName(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

See Also: availableCharsets