|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
*/ |
|
|
|
package java.nio.charset.spi; |
|
|
|
import java.nio.charset.Charset; |
|
import java.util.Iterator; |
|
|
|
|
|
/** |
|
* Charset service-provider class. |
|
* |
|
* <p> 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 |
|
* thread's {@link java.lang.Thread#getContextClassLoader() context class |
|
* loader}. |
|
* |
|
* <p> A charset provider identifies itself with a provider-configuration file |
|
* named <tt>java.nio.charset.spi.CharsetProvider</tt> in the resource |
|
* directory <tt>META-INF/services</tt>. 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 (<tt>'\n'</tt>), a carriage return |
|
* (<tt>'\r'</tt>), 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 <tt>'#'</tt> (<tt>'\u0023'</tt>); on |
|
* each line all characters following the first comment character are ignored. |
|
* The file must be encoded in UTF-8. |
|
* |
|
* <p> 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. </p> |
|
* |
|
* |
|
* @author Mark Reinhold |
|
* @author JSR-51 Expert Group |
|
* @since 1.4 |
|
* |
|
* @see java.nio.charset.Charset |
|
*/ |
|
|
|
public abstract class CharsetProvider { |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
*/ |
|
protected CharsetProvider() { |
|
SecurityManager sm = System.getSecurityManager(); |
|
if (sm != null) |
|
sm.checkPermission(new RuntimePermission("charsetProvider")); |
|
} |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
*/ |
|
public abstract Iterator<Charset> charsets(); |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
*/ |
|
public abstract Charset charsetForName(String charsetName); |
|
|
|
} |