package com.fasterxml.jackson.dataformat.javaprop;

import java.io.*;
import java.net.URL;
import java.util.*;

import com.fasterxml.jackson.core.*;
import com.fasterxml.jackson.core.format.InputAccessor;
import com.fasterxml.jackson.core.format.MatchStrength;
import com.fasterxml.jackson.core.io.IOContext;

import com.fasterxml.jackson.dataformat.javaprop.impl.PropertiesBackedGenerator;
import com.fasterxml.jackson.dataformat.javaprop.impl.WriterBackedGenerator;
import com.fasterxml.jackson.dataformat.javaprop.io.Latin1Reader;

@SuppressWarnings("resource")
public class JavaPropsFactory extends JsonFactory
{
    private static final long serialVersionUID = 1L;

    public final static String FORMAT_NAME_JAVA_PROPERTIES = "java_properties";

    protected final static String CHARSET_ID_LATIN1 = "ISO-8859-1";

    /*
    /**********************************************************
    /* Factory construction, configuration
    /**********************************************************
     */
    
    public JavaPropsFactory() { }

    public JavaPropsFactory(ObjectCodec codec) {
        super(codec);
    }

    protected JavaPropsFactory(JavaPropsFactory src, ObjectCodec oc)
    {
        super(src, oc);
    }

    
Constructors used by JavaPropsFactoryBuilder for instantiation.
Since:2.9
/** * Constructors used by {@link JavaPropsFactoryBuilder} for instantiation. * * @since 2.9 */
protected JavaPropsFactory(JavaPropsFactoryBuilder b) { super(b, false); } @Override public JavaPropsFactoryBuilder rebuild() { return new JavaPropsFactoryBuilder(this); }
Main factory method to use for constructing JavaPropsFactory instances with different configuration.
/** * Main factory method to use for constructing {@link JavaPropsFactory} instances with * different configuration. */
public static JavaPropsFactoryBuilder builder() { return new JavaPropsFactoryBuilder(); } @Override public JavaPropsFactory copy() { _checkInvalidCopy(JavaPropsFactory.class); return new JavaPropsFactory(this, null); } /* /********************************************************** /* Versioned /********************************************************** */ @Override public Version version() { return PackageVersion.VERSION; } /* /********************************************************** /* Format detection functionality /********************************************************** */ @Override public String getFormatName() { return FORMAT_NAME_JAVA_PROPERTIES; }
Sub-classes need to override this method
/** * Sub-classes need to override this method */
@Override public MatchStrength hasFormat(InputAccessor acc) throws IOException { // TODO, if possible... probably isn't? return MatchStrength.INCONCLUSIVE; } /* /********************************************************** /* Capability introspection /********************************************************** */ // Not positional @Override public boolean requiresPropertyOrdering() { return false; } // Can not handle raw binary data @Override public boolean canHandleBinaryNatively() { return false; } // Not using char[] internally @Override public boolean canUseCharArrays() { return false; } // No format-specific configuration, yet: /* @Override public Class<? extends FormatFeature> getFormatReadFeatureType() { return null; } @Override public Class<? extends FormatFeature> getFormatWriteFeatureType() { return null; } */ @Override public boolean canUseSchema(FormatSchema schema) { return schema instanceof JavaPropsSchema; } /* /********************************************************** /* Extended parser/generator factory methods /********************************************************** */
Convenience method to allow feeding a pre-parsed Properties instance as input.
Since:2.10
/** * Convenience method to allow feeding a pre-parsed {@link Properties} * instance as input. * * @since 2.10 */
public JavaPropsParser createParser(Map<?,?> content) { return new JavaPropsParser(_createContext(content, true), _parserFeatures, content, _objectCodec, content); } @Deprecated // since 2.10 public JavaPropsParser createParser(Properties props) { return new JavaPropsParser(_createContext(props, true), _parserFeatures, props, _objectCodec, props); } @Deprecated // since 2.10 public JavaPropsGenerator createGenerator(Properties props) { IOContext ctxt = _createContext(props, true); return new PropertiesBackedGenerator(ctxt, props, _generatorFeatures, _objectCodec); }
Convenience method to allow using a pre-constructed Map instance as output target, so that serialized property values are added.
Since:2.10
/** * Convenience method to allow using a pre-constructed {@link Map} * instance as output target, so that serialized property values * are added. * * @since 2.10 */
public JavaPropsGenerator createGenerator(Map<?,?> target, JavaPropsSchema schema) { IOContext ctxt = _createContext(target, true); return new PropertiesBackedGenerator(ctxt, target, _generatorFeatures, _objectCodec); } /* /********************************************************** /* Overridden parser factory methods /********************************************************** */ @Override public JsonParser createParser(File f) throws IOException { IOContext ctxt = _createContext(f, true); return _createParser(_decorate(new FileInputStream(f), ctxt), ctxt); } @Override public JsonParser createParser(URL url) throws IOException { IOContext ctxt = _createContext(url, true); return _createParser(_decorate(_optimizedStreamFromURL(url), ctxt), ctxt); } @Override public JsonParser createParser(InputStream in) throws IOException { IOContext ctxt = _createContext(in, false); return _createParser(_decorate(in, ctxt), ctxt); } @Override public JsonParser createParser(byte[] data) throws IOException { IOContext ctxt = _createContext(data, true); if (_inputDecorator != null) { InputStream in = _inputDecorator.decorate(ctxt, data, 0, data.length); if (in != null) { return _createParser(in, ctxt); } } return _createParser(data, 0, data.length, ctxt); } @Override public JsonParser createParser(byte[] data, int offset, int len) throws IOException { IOContext ctxt = _createContext(data, true); if (_inputDecorator != null) { InputStream in = _inputDecorator.decorate(ctxt, data, offset, len); if (in != null) { return _createParser(in, ctxt); } } return _createParser(data, offset, len, ctxt); } /* /********************************************************** /* Overridden generator factory methods /********************************************************** */ @Override public JsonGenerator createGenerator(OutputStream out, JsonEncoding enc) throws IOException { IOContext ctxt = _createContext(out, false); ctxt.setEncoding(enc); return _createJavaPropsGenerator(ctxt, _generatorFeatures, _objectCodec, _decorate(out, ctxt)); }
Method for constructing JsonGenerator for generating CBOR-encoded output.

Since CBOR format always uses UTF-8 internally, no encoding need to be passed to this method.

/** * Method for constructing {@link JsonGenerator} for generating * CBOR-encoded output. *<p> * Since CBOR format always uses UTF-8 internally, no encoding need * to be passed to this method. */
@Override public JsonGenerator createGenerator(OutputStream out) throws IOException { IOContext ctxt = _createContext(out, false); return _createJavaPropsGenerator(ctxt, _generatorFeatures, _objectCodec, _decorate(out, ctxt)); } /* /****************************************************** /* Overridden internal factory methods, parser /****************************************************** */ /* // fine as-is: @Override protected IOContext _createContext(Object srcRef, boolean resourceManaged) { return super._createContext(srcRef, resourceManaged); } */ /* public JavaPropsParser(IOContext ctxt, int parserFeatures, Object inputSource, ObjectCodec codec, Map<?,?> sourceMap) */ @Override protected JsonParser _createParser(InputStream in, IOContext ctxt) throws IOException { Properties props = _loadProperties(in, ctxt); return new JavaPropsParser(ctxt, _parserFeatures, in, _objectCodec, props); } @Override protected JsonParser _createParser(Reader r, IOContext ctxt) throws IOException { Properties props = _loadProperties(r, ctxt); return new JavaPropsParser(ctxt, _parserFeatures, r, _objectCodec, props); } @Override protected JsonParser _createParser(char[] data, int offset, int len, IOContext ctxt, boolean recyclable) throws IOException { return _createParser(new CharArrayReader(data, offset, len), ctxt); } @Override protected JsonParser _createParser(byte[] data, int offset, int len, IOContext ctxt) throws IOException { return _createParser(new Latin1Reader(data, offset, len), ctxt); } /* /****************************************************** /* Overridden internal factory methods, generator /****************************************************** */ @Override protected JsonGenerator _createGenerator(Writer out, IOContext ctxt) throws IOException { return new WriterBackedGenerator(ctxt, out, _generatorFeatures, _objectCodec); } @Override protected JsonGenerator _createUTF8Generator(OutputStream out, IOContext ctxt) throws IOException { return _createJavaPropsGenerator(ctxt, _generatorFeatures, _objectCodec, out); } @Override protected Writer _createWriter(OutputStream out, JsonEncoding enc, IOContext ctxt) throws IOException { // 27-Jan-2016, tatu: Properties javadoc is quite clear on Latin-1 (ISO-8859-1) being // the default, so let's actually override return new OutputStreamWriter(out, CHARSET_ID_LATIN1); } /* /****************************************************** /* Low-level methods for reading/writing Properties; currently /* we simply delegate to `java.util.Properties` /****************************************************** */ protected Properties _loadProperties(InputStream in, IOContext ctxt) throws IOException { // NOTE: Properties default to ISO-8859-1 (aka Latin-1), NOT UTF-8; this // as per JDK documentation return _loadProperties(new Latin1Reader(ctxt, in), ctxt); } protected Properties _loadProperties(Reader r0, IOContext ctxt) throws IOException { Properties props = new Properties(); // May or may not want to close the reader, so... if (ctxt.isResourceManaged() || isEnabled(StreamReadFeature.AUTO_CLOSE_SOURCE)) { try (Reader r = r0) { props.load(r); } } else { props.load(r0); } return props; } private final JsonGenerator _createJavaPropsGenerator(IOContext ctxt, int stdFeat, ObjectCodec codec, OutputStream out) throws IOException { return new WriterBackedGenerator(ctxt, _createWriter(out, null, ctxt), stdFeat, _objectCodec); } /* public static void main(String[] args) throws Exception { args = new String[] { "test.properties" }; Properties props = new Properties(); // props.load(new FileInputStream(args[0])); props.load(new ByteArrayInputStream(new byte[0])); System.out.printf("%d entries:\n", props.size()); int i = 1; for (Map.Entry<?,?> entry : props.entrySet()) { System.out.printf("#%d: %s -> %s\n", i++, entry.getKey(), entry.getValue()); } }*/ }