java.nio.charset.spi

Class CharsetProvider

java.lang.Object

java.nio.charset.spi.CharsetProvider

public abstract class CharsetProvider
extends java.lang.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

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CharsetProvider() Initialize a new charset provider.

Method Summary

Methods

Modifier and Type	Method and Description
abstract java.nio.charset.Charset	charsetForName(java.lang.String name) Returns the named charset, by canonical name or alias.
abstract java.util.Iterator<java.nio.charset.Charset>	charsets() Returns an iterator over the charsets defined by this provider.

Methods inherited from class java.lang.Object

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

Constructor Detail

CharsetProvider

protected CharsetProvider()

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

Throws:

java.lang.SecurityException - if building a new set is not allowed

Method Detail

charsets

public abstract java.util.Iterator<java.nio.charset.Charset> charsets()

Returns an iterator over the charsets defined by this provider.

Returns:

the iterator

See Also:

Charset.availableCharsets()

charsetForName

public abstract java.nio.charset.Charset charsetForName(java.lang.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