JsonProvider源码翻译

package javax.json.spi;

import javax.json.*;
import javax.json.stream.JsonGenerator;
import javax.json.stream.JsonGeneratorFactory;
import javax.json.stream.JsonParser;
import javax.json.stream.JsonParserFactory;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.Reader;
import java.io.Writer;
import java.util.Iterator;
import java.util.Map;
import java.util.ServiceLoader;

/**
 * 目的：处理JSON的Service provider
 * 
 * <p>该类所有的方法都是线程安全的，使用在多并发线程。
 * @author TCM
 * @create 2017年11月7日上午9:25:24
 * @see    ServiceLoader
 */
public abstract class JsonProvider {

	//常量名，默认{@code JsonProvider}的实现类
    private static final String DEFAULT_PROVIDER
            = "org.glassfish.json.JsonProviderImpl";

    protected JsonProvider() {}

    /**
     * 创建JsonProvider对象。使用{@link ServiceLoader#load(Class)}方法
     * 创建该对象。如果没有可用的服务供应商（service provider），该方法返回默认。
     * @see ServiceLoader
     * @return a JSON provider
     */
    public static JsonProvider provider() {
        ServiceLoader<JsonProvider> loader = ServiceLoader.load(JsonProvider.class);
        Iterator<JsonProvider> it = loader.iterator();
        if (it.hasNext()) {
            return it.next();//若有，则返回
        }

        try {
        	//若没有，则返回默认："org.glassfish.json.JsonProviderImpl"
            Class<?> clazz = Class.forName(DEFAULT_PROVIDER);
            return (JsonProvider)clazz.newInstance();
        } catch (ClassNotFoundException x) {
            throw new JsonException(
                    "Provider " + DEFAULT_PROVIDER + " not found", x);
        } catch (Exception x) {
            throw new JsonException(
                    "Provider " + DEFAULT_PROVIDER + " could not be instantiated: " + x,
                    x);
        }
    }

    public abstract JsonParser createParser(Reader reader);
    public abstract JsonParser createParser(InputStream in);
    public abstract JsonParserFactory createParserFactory(Map<String, ?> config);

    public abstract JsonGenerator createGenerator(Writer writer);
    public abstract JsonGenerator createGenerator(OutputStream out);
    public abstract JsonGeneratorFactory createGeneratorFactory(Map<String, ?> config);

    public abstract JsonReader createReader(Reader reader);
    public abstract JsonReader createReader(InputStream in);
    public abstract JsonReaderFactory createReaderFactory(Map<String,?> config);

    public abstract JsonWriter createWriter(Writer writer);
    public abstract JsonWriter createWriter(OutputStream out);
    public abstract JsonWriterFactory createWriterFactory(Map<String,?> config);
   
    public abstract JsonObjectBuilder createObjectBuilder();
    public abstract JsonArrayBuilder createArrayBuilder();

    public abstract JsonBuilderFactory createBuilderFactory(Map<String,?> config);

}