com.github.smartbuf.converter.Codec Maven / Gradle / Ivy

Go to download

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

SmartBuf, is a cross-language serialization and deserialization framework, and it has high performance and compression ratio like protobuf, high compatibility and scalability like json.

The newest version!

package com.github.smartbuf.converter;

import com.github.smartbuf.reflect.XType;

import java.lang.reflect.Type;

/**
 * Codec's base class.
 *
 * @author sulin
 * @since 2019-05-12 16:01:19
 */
public abstract class Codec {

    private CodecFactory factory;

    /**
     * Setup {@link CodecFactory} which owns this codec instance.
     *
     * @param factory The CodecFactory owns this
     */
    public void setFactory(CodecFactory factory) {
        this.factory = factory;
    }

    /**
     * Proxy of {@link CodecFactory#toXType(Type)}
     *
     * @param type The original java type
     * @return The parsed xtype, which contains generic info
     */
    protected final XType toXType(Type type) {
        return factory.toXType(type);
    }

    /**
     * Proxy of {@link CodecFactory#doConvert(Object, XType)}
     *
     * @param src     The source object, could be null
     * @param tgtType The target type
     * @return New object which is instance of tgtType
     */
    protected final Object convert(Object src, XType tgtType) {
        return factory.doConvert(src, tgtType);
    }

    /**
     * Proxy of {@link CodecFactory#doConvert(Object, XType)}
     *
     * @param src The source object, could be null
     * @param clz The target java class
     * @param  clz's template type
     * @return new object which is instance of clz
     */
    @SuppressWarnings("unchecked")
    protected final  T convert(Object src, Class clz) {
        return (T) factory.doConvert(src, toXType(clz));
    }

}