com.feilong.lib.xstream.io.AbstractWriter Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of feilong Show documentation

feilong is a suite of core and expanded libraries that include utility classes, http, excel,cvs, io classes, and much much more.

There is a newer version: 4.0.8

Show newest version

/*
 * Copyright (C) 2009, 2011 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 17. August 2009 by Joerg Schaible
 */
package com.feilong.lib.xstream.io;

import com.feilong.lib.xstream.core.util.Cloneables;
import com.feilong.lib.xstream.io.naming.NameCoder;
import com.feilong.lib.xstream.io.naming.NoNameCoder;

/**
 * Abstract base class for all HierarchicalStreamWriter implementations. Implementations of
 * {@link HierarchicalStreamWriter} should rather be derived from this class then implementing
 * the interface directly.
 * 
 * @author Jörg Schaible
 * @since 1.4
 */
public abstract class AbstractWriter implements ExtendedHierarchicalStreamWriter{

    private NameCoder nameCoder;

    /**
     * Creates an AbstractWriter with a NameCoder that does nothing.
     * 
     * @since 1.4
     */
    protected AbstractWriter(){
        this(new NoNameCoder());
    }

    /**
     * Creates an AbstractWriter with a provided {@link NameCoder}.
     * 
     * @param nameCoder
     *            the name coder used to write names in the target format
     * @since 1.4
     */
    protected AbstractWriter(NameCoder nameCoder){
        this.nameCoder = (NameCoder) Cloneables.cloneIfPossible(nameCoder);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public void startNode(String name,Class clazz){
        startNode(name);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public HierarchicalStreamWriter underlyingWriter(){
        return this;
    }

    /**
     * Encode the node name into the name of the target format.
     * 
     * @param name
     *            the original name
     * @return the name in the target format
     * @since 1.4
     */
    public String encodeNode(String name){
        return nameCoder.encodeNode(name);
    }

    /**
     * Encode the attribute name into the name of the target format.
     * 
     * @param name
     *            the original name
     * @return the name in the target format
     * @since 1.4
     */
    public String encodeAttribute(String name){
        return nameCoder.encodeAttribute(name);
    }
}