Json源码翻译

package javax.json;

import javax.json.spi.JsonProvider;
import javax.json.stream.JsonGenerator;
import javax.json.stream.JsonGeneratorFactory;
import javax.json.stream.JsonParser;
import javax.json.stream.JsonParserFactory;
import java.io.*;
import java.util.Map;

/**
 * 目的：处理JSON的工厂类
 * 
 * <p>创建JSON处理的工厂类。该类创建JSON使用的方法并与这些对象对应的工厂。工厂类
 * 提供不同的方式创建这些对象。
 * 
 * <p>类中使用方法创建{@link JsonProvider#provider()}实例。用provider
 * 实例创建JSON处理对象。
 * 
 * <p>以下示例创建JSON解析器解析一个空JSON数组：
 * 	 StringReader reader = new StringReader("[]");
 *   JsonParser parser = Json.createParser(reader);
 *   
 * <p>该类所有的方法都是线程安全的，使用在多并发线程。
 * @author TCM
 * @create 2017年11月6日上午10:25:48
 */
public class Json {

    private Json() {}

    //从字符流中创建JSON解析器
    public static JsonParser createParser(Reader reader) {
        return JsonProvider.provider().createParser(reader);
    }
    //从字节流中创建JSON解析器
    public static JsonParser createParser(InputStream in) {
        return JsonProvider.provider().createParser(in);
    }

    //创建JSON生成器写入字符流中
    public static JsonGenerator createGenerator(Writer writer) {
        return JsonProvider.provider().createGenerator(writer);
    }
    //创建JSON生成器写入直接流中
    public static JsonGenerator createGenerator(OutputStream out) {
        return JsonProvider.provider().createGenerator(out);
    }

    public static JsonParserFactory createParserFactory(Map<String, ?> config) {
        return JsonProvider.provider().createParserFactory(config);
    }
    public static JsonGeneratorFactory createGeneratorFactory(
            Map<String, ?> config) {
        return JsonProvider.provider().createGeneratorFactory(config);
    }
    public static JsonWriter createWriter(Writer writer) {
        return JsonProvider.provider().createWriter(writer);
    }
    public static JsonWriter createWriter(OutputStream out) {
        return JsonProvider.provider().createWriter(out);
    }
    public static JsonReader createReader(Reader reader) {
        return JsonProvider.provider().createReader(reader);
    }
    public static JsonReader createReader(InputStream in) {
        return JsonProvider.provider().createReader(in);
    }
    public static JsonReaderFactory createReaderFactory(Map<String, ?> config) {
        return JsonProvider.provider().createReaderFactory(config);
    }
    public static JsonWriterFactory createWriterFactory(Map<String, ?> config) {
        return JsonProvider.provider().createWriterFactory(config);
    }
    public static JsonArrayBuilder createArrayBuilder() {
        return JsonProvider.provider().createArrayBuilder();
    }
    public static JsonObjectBuilder createObjectBuilder() {
        return JsonProvider.provider().createObjectBuilder();
    }
    public static JsonBuilderFactory createBuilderFactory(
            Map<String, ?> config) {
        return JsonProvider.provider().createBuilderFactory(config);
    }

}