java.nio.charset.spi
Class CharsetProvider

java.lang.Object
  extended by java.nio.charset.spi.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

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.
 
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:
SecurityException - if building a new set is not allowed
Method Detail

charsets

public abstract Iterator<Charset> charsets()
Returns an iterator over the charsets defined by this provider.

Returns:
the iterator
See Also:
Charset.availableCharsets()

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