spring.turbo.databinding.AbstractConverter Maven / Gradle / Ivy

Go to download
package spring.turbo.databinding;

import org.springframework.core.convert.converter.Converter;
import spring.turbo.exception.DataBindingException;
import spring.turbo.util.ThreadSharedObjects;

/**
 * {@link Converter} 辅助工具 

 * 本类型将尝试转换{@link RuntimeException} 转换成 {@link org.springframework.context.MessageSourceResolvable}。
 *
 * @param  源类型泛型
 * @param  目标类型
 * @author 应卓
 * @since 3.2.2
 */
public abstract class AbstractConverter implements Converter {

    /**
     * {@inheritDoc}
     */
    @Override
    public final T convert(S source) {
        try {
            return doConvert(source);
        } catch (RuntimeException e) {
            throw InternalConverterUtils.transform(e);
        }
    }

    /**
     * 转换数据
     *
     * @param source 源数据
     * @return 转换结果
     * @throws DataBindingException 数据转换失败或数据非法
     */
    protected abstract T doConvert(S source) throws DataBindingException;

    /**
     * 加入一个线程安全的共享对象。在线程的其他地方可以取出这个共享对象。
     *
     * @param objectType 共享对象类型
     * @param object     共享对象
     * @param         共享对象类型实例
     * @see ThreadSharedObjects#put(Class, Object)
     */
    protected final  void setSharedObject(Class objectType, O object) {
        ThreadSharedObjects.put(objectType, object);
    }

    /**
     * 加入一个线程安全的共享对象。在线程的其他地方可以取出这个共享对象。
     *
     * @param objectName 共享对象名称
     * @param object     共享对象
     * @see ThreadSharedObjects#put(String, Object)
     */
    protected final void setSharedObject(String objectName, Object object) {
        ThreadSharedObjects.put(objectName, object);
    }

}