package cn.zhxu.bs;

import cn.zhxu.bs.implement.DefaultBeanReflector;
import cn.zhxu.bs.implement.DefaultMapSearcher;

/**
 * @author Troy.Zhou @ 2017-04-07
 * <p>
 * 数据库字段值转换接口
 * 用于把 数据库查出的字段值 型转为 另外一种值
 * 为提高字段转换效能，v3.1.0 把字段转换器拆为两类：{@link BFieldConvertor } 与 {@link MFieldConvertor }
 * 以降低 {@link #supports(FieldMeta, Class)} 方法判断次数
 */
public interface FieldConvertor {

    /**
     * @since v3.0.0
     * 是否支持 valueType 转成 targetType
     * v3.2.0 后移除冗余参数 targetType，该参数可通过 meta.getType() 获取
     * @param meta 需要转换的字段元信息（非空）
     * @param valueType 数据库值的类型（非空）
     * @return 是否支持
     */
    boolean supports(FieldMeta meta, Class<?> valueType);

    /**
     * 把 value 转换为 targetType 类型的数据
     * v3.2.0 后移除冗余参数 targetType，该参数可通过 meta.getType() 获取
     * @param meta 需要转换的字段元信息（非空）
     * @param value 从数据库取出的待转换的值（非空）
     * @return 转换目标值
     * */
    default Object convert(FieldMeta meta, Object value) {
        return value;
    }

    /**
     * 只在 {@link DefaultBeanReflector } 中使用
     * @author Troy.Zhou @ 2021-11-09
     * @since v3.1.0
     */
    interface BFieldConvertor extends FieldConvertor { }

    /**
     * 只在 {@link DefaultMapSearcher } 中使用
     * @author Troy.Zhou @ 2021-11-09
     * @since v3.1.0
     */
    interface MFieldConvertor extends FieldConvertor { }

    /**
     * 参数值转换器（重构自 ParamResolver.Convertor）
     * @author Troy.Zhou @ 2023-02-27
     * @since v4.1.0
     */
    interface ParamConvertor extends FieldConvertor { }

}