XomDriver.java

/*
 * Copyright (C) 2006 Joe Walnes.
 * Copyright (C) 2006, 2007, 2009, 2011, 2014, 2016, 2020 XStream Committers.
 * All rights reserved.
 *
 * The software in this package is published under the terms of the BSD
 * style license a copy of which has been included with this distribution in
 * the LICENSE.txt file.
 *
 * Created on 12. April 2006 by Joerg Schaible
 */
package com.thoughtworks.xstream.io.xml;

import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.Writer;
import java.net.URL;

import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;

import nu.xom.Builder;
import nu.xom.Document;
import nu.xom.ParsingException;
import nu.xom.ValidityException;


public class XomDriver extends AbstractXmlDriver {

    private final Builder builder;

    public XomDriver() {
        this(new XmlFriendlyNameCoder());
    }

    /**
     * @deprecated As of 1.4.9, use {@link #XomDriver()} and overload {@link #createBuilder()} instead
     */
    @Deprecated
    public XomDriver(final Builder builder) {
        this(builder, new XmlFriendlyNameCoder());
    }

    /**
     * @since 1.4
     */
    public XomDriver(final NameCoder nameCoder) {
        super(nameCoder);
        builder = null;
    }

    /**
     * @since 1.4
     * @deprecated As of 1.4.9, use {@link #XomDriver(NameCoder)} and overload {@link #createBuilder()} instead
     */
    @Deprecated
    public XomDriver(final Builder builder, final NameCoder nameCoder) {
        super(nameCoder);
        this.builder = builder;
    }

    /**
     * @since 1.2
     * @deprecated As of 1.4, use {@link #XomDriver(NameCoder)} instead
     */
    @Deprecated
    public XomDriver(final XmlFriendlyReplacer replacer) {
        this((NameCoder)replacer);
    }

    /**
     * @since 1.2
     * @deprecated As of 1.4, use {@link #XomDriver(NameCoder)} and overload {@link #createBuilder()} instead
     */
    @Deprecated
    public XomDriver(final Builder builder, final XmlFriendlyReplacer replacer) {
        this(builder, (NameCoder)replacer);
    }

    /**
     * @deprecated As of 1.4.9, overload {@link #createBuilder()} instead
     */
    @Deprecated
    protected Builder getBuilder() {
        return builder;
    }

    /**
     * Create the Builder instance. A XOM builder is a wrapper around a {@link org.xml.sax.XMLReader} instance which is
     * not thread-safe by definition. Therefore each reader should use its own builder instance to avoid concurrency
     * problems. Overload this method to configure the generated builder instances e.g. to activate validation.
     *
     * @return the new builder
     * @since 1.4.9
     */
    protected Builder createBuilder() {
        final Builder builder = getBuilder();
        return builder != null ? builder : new Builder();
    }

    @Override
    public HierarchicalStreamReader createReader(final Reader text) {
        try {
            final Document document = createBuilder().build(text);
            return new XomReader(document, getNameCoder());
        } catch (final ValidityException e) {
            throw new StreamException(e);
        } catch (final ParsingException | IOException e) {
            throw new StreamException(e);
        }
    }

    @Override
    public HierarchicalStreamReader createReader(final InputStream in) {
        try {
            final Document document = createBuilder().build(in);
            return new XomReader(document, getNameCoder());
        } catch (final ValidityException e) {
            throw new StreamException(e);
        } catch (final ParsingException | IOException e) {
            throw new StreamException(e);
        }
    }

    @Override
    public HierarchicalStreamReader createReader(final URL in) {
        try {
            final Document document = createBuilder().build(in.toExternalForm());
            return new XomReader(document, getNameCoder());
        } catch (final ValidityException e) {
            throw new StreamException(e);
        } catch (final ParsingException | IOException e) {
            throw new StreamException(e);
        }
    }

    @Override
    public HierarchicalStreamReader createReader(final File in) {
        try {
            final Document document = createBuilder().build(in);
            return new XomReader(document, getNameCoder());
        } catch (final ValidityException e) {
            throw new StreamException(e);
        } catch (final ParsingException | IOException e) {
            throw new StreamException(e);
        }
    }

    @Override
    public HierarchicalStreamWriter createWriter(final Writer out) {
        return new PrettyPrintWriter(out, getNameCoder());
    }

    @Override
    public HierarchicalStreamWriter createWriter(final OutputStream out) {
        return new PrettyPrintWriter(new OutputStreamWriter(out), getNameCoder());
    }
}