org.dromara.hutool.core.convert

Interface Converter

All Known Subinterfaces:

MatcherConverter

All Known Implementing Classes:

AbstractConverter, ArrayConverter, AtomicBooleanConverter, AtomicIntegerArrayConverter, AtomicLongArrayConverter, AtomicReferenceConverter, BeanConverter, BooleanConverter, CalendarConverter, CastConverter, CharacterConverter, CharsetConverter, ClassConverter, CollectionConverter, CompositeConverter, ConverterWithRoot, CurrencyConverter, DateConverter, DurationConverter, EmptyBeanConverter, EntryConverter, EnumConverter, KBeanConverter, LocaleConverter, MapConverter, NumberConverter, OptConverter, OptionalConverter, PairConverter, PathConverter, PeriodConverter, PrimitiveConverter, RecordConverter, ReferenceConverter, RegisterConverter, SpecialConverter, StackTraceElementConverter, StringConverter, TemporalAccessorConverter, TimeZoneConverter, TripleConverter, TupleConverter, URIConverter, URLConverter, UUIDConverter, XMLGregorianCalendarConverter, ZoneIdConverter

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface Converter

类型转换接口函数，根据给定的值和目标类型，由用户自定义转换规则。

Since:

6.0.0

Author:

looly

Method Summary

Modifier and Type	Method and Description
default <T> T	convert(Class<T> targetType, Object value) 转换为指定类型 如果类型无法确定，将读取默认值的类型做为目标类型
Object	convert(Type targetType, Object value) 转换为指定类型 如果类型无法确定，将读取默认值的类型做为目标类型
default <T> T	convert(Type targetType, Object value, T defaultValue) 转换值为指定类型，可选是否不抛异常转换 当转换失败时返回默认值
static Converter	identity() 返回原值的转换器，不做转换

Method Detail

convert

Object convert(Type targetType,
               Object value)
        throws ConvertException

转换为指定类型
如果类型无法确定，将读取默认值的类型做为目标类型

Parameters:

targetType - 目标Type，非泛型类使用

value - 原始值，如果对象实现了此接口，则value为this

Returns:

转换后的值

Throws:

ConvertException - 转换无法正常完成或转换异常时抛出此异常

convert

default <T> T convert(Class<T> targetType,
                      Object value)
               throws ConvertException

转换为指定类型
如果类型无法确定，将读取默认值的类型做为目标类型

Type Parameters:

T - 目标类型

Parameters:

targetType - 目标类型

value - 原始值，如果对象实现了此接口，则value为this

Returns:

转换后的值

Throws:

ConvertException - 转换无法正常完成或转换异常时抛出此异常

convert

default <T> T convert(Type targetType,
                      Object value,
                      T defaultValue)

转换值为指定类型，可选是否不抛异常转换
当转换失败时返回默认值

Type Parameters:

T - 目标类型

Parameters:

targetType - 目标类型

value - 值

defaultValue - 默认值

Returns:

转换后的值

identity

static Converter identity()

返回原值的转换器，不做转换

Returns:

Converter