Package org.miaixz.bus.core.convert

Interface Converter

All Known Implementing Classes:

AbstractConverter, ArrayConverter, AtomicBooleanConverter, AtomicIntegerArrayConverter, AtomicLongArrayConverter, AtomicReferenceConverter, BeanConverter, BooleanConverter, CalendarConverter, CastConverter, CharacterConverter, CharsetConverter, ClassConverter, CollectionConverter, CompositeConverter, CurrencyConverter, DateConverter, DurationConverter, EntryConverter, EnumConverter, KotlinBeanConverter, LocaleConverter, MapConverter, NumberConverter, OptConverter, OptionalConverter, PairConverter, PathConverter, PeriodConverter, PrimitiveConverter, RecordConverter, ReferenceConverter, RegisterConverter, 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:

Java 17+

Author:

Kimi Liu

Method Summary

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

Method Details

convert

Object convert(Type targetType,
 Object value)
        throws ConvertException

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

Parameters:

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

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:

this