com.feilong.lib.xstream.converters.extended.NamedCollectionConverter 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) 2013, 2018 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 19. September 2013 by Joerg Schaible
 */
package com.feilong.lib.xstream.converters.extended;

import com.feilong.lib.xstream.converters.MarshallingContext;
import com.feilong.lib.xstream.converters.UnmarshallingContext;
import com.feilong.lib.xstream.converters.collections.CollectionConverter;
import com.feilong.lib.xstream.core.util.HierarchicalStreams;
import com.feilong.lib.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.feilong.lib.xstream.io.HierarchicalStreamReader;
import com.feilong.lib.xstream.io.HierarchicalStreamWriter;
import com.feilong.lib.xstream.mapper.Mapper;

/**
 * A collection converter that uses predefined names for its items.
 * 
 * To be used as local converter. Note, suppress the usage of the implicit type argument, if
 * registered with annotation.
 * 
 * 
 * @author Jörg Schaible
 * @since 1.4.5
 */
public class NamedCollectionConverter extends CollectionConverter{

    private final String name;

    private final Class  type;

    /**
     * Constructs a NamedCollectionConverter.
     * 
     * @param mapper
     *            the mapper
     * @param itemName
     *            the name of the items
     * @param itemType
     *            the base type of the items
     * @since 1.4.5
     */
    public NamedCollectionConverter(Mapper mapper, String itemName, Class itemType){
        this(null, mapper, itemName, itemType);
    }

    /**
     * Constructs a NamedCollectionConverter handling an explicit Collection type.
     * 
     * @param type
     *            the Collection type to handle
     * @param mapper
     *            the mapper
     * @param itemName
     *            the name of the items
     * @param itemType
     *            the base type of the items
     * @since 1.4.5
     */
    public NamedCollectionConverter(Class type, Mapper mapper, String itemName, Class itemType){
        super(mapper, type);
        this.name = itemName;
        this.type = itemType;
    }

    @Override
    protected void writeCompleteItem(final Object item,final MarshallingContext context,final HierarchicalStreamWriter writer){
        writeItem(item, context, writer);
    }

    /**
     * @deprecated As of 1.4.11 use {@link #writeCompleteItem(Object, MarshallingContext, HierarchicalStreamWriter)}
     *             instead.
     */
    @Deprecated
    @Override
    protected void writeItem(Object item,MarshallingContext context,HierarchicalStreamWriter writer){
        final Class itemType = item == null ? Mapper.Null.class : item.getClass();
        ExtendedHierarchicalStreamWriterHelper.startNode(writer, name, itemType);
        if (!itemType.equals(type)){
            String attributeName = mapper().aliasForSystemAttribute("class");
            if (attributeName != null){
                writer.addAttribute(attributeName, mapper().serializedClass(itemType));
            }
        }
        if (item != null){
            context.convertAnother(item);
        }
        writer.endNode();
    }

    @Override
    protected Object readBareItem(final HierarchicalStreamReader reader,final UnmarshallingContext context,final Object current){
        final String className = HierarchicalStreams.readClassAttribute(reader, mapper());
        final Class itemType = className == null ? type : mapper().realClass(className);
        if (Mapper.Null.class.equals(itemType)){
            return null;
        }else{
            return context.convertAnother(current, itemType);
        }
    }
}