程序包 cn.taketoday.util

类 PropertyMapper

java.lang.Object

cn.taketoday.util.PropertyMapper

public final class PropertyMapper
extends Object

Utility that can be used to map values from a supplied source to a destination.

Can filter values based on predicates and adapt values if needed. For example:

 PropertyMapper map = PropertyMapper.get();
 map.from(source::getName)
   .to(destination::setName);
 map.from(source::getTimeout)
   .whenNonNull()
   .asInt(Duration::getSeconds)
   .to(destination::setTimeoutSecs);
 map.from(source::isEnabled)
   .whenFalse().
   .toCall(destination::disable);
 

Mappings can ultimately be applied to a setter, trigger a method call or create a new instance.

从以下版本开始:

4.0 2022/1/16 17:01

作者:

Phillip Webb, Artsiom Yudovin, Harry Yang

嵌套类概要

嵌套类

修饰符和类型	类	说明
private static final record	PropertyMapper.NullPointerExceptionSafeSupplier<T>	Supplier that will catch and ignore any NullPointerException.
static final class	PropertyMapper.Source<T>	A source that is in the process of being mapped.
static interface	PropertyMapper.SourceOperator	An operation that can be applied to a PropertyMapper.Source.

字段概要

字段

修饰符和类型	字段	说明
private static final Predicate<?>	ALWAYS
private static final PropertyMapper	INSTANCE
private final PropertyMapper	parent
private final PropertyMapper.SourceOperator	sourceOperator

构造器概要

构造器

限定符	构造器	说明
private	PropertyMapper(PropertyMapper parent, PropertyMapper.SourceOperator sourceOperator)

方法概要

修饰符和类型	方法	说明
PropertyMapper	alwaysApplying(PropertyMapper.SourceOperator operator)	Return a new PropertyMapper instance that applies the given PropertyMapper.SourceOperator to every source.
PropertyMapper	alwaysApplyingWhenNonNull()	Return a new PropertyMapper instance that applies whenNonNull to every source.
<T> PropertyMapper.Source<T>	from(Supplier<T> supplier)	Return a new PropertyMapper.Source from the specified value supplier that can be used to perform the mapping.
<T> PropertyMapper.Source<T>	from(T value)	Return a new PropertyMapper.Source from the specified value that can be used to perform the mapping.
static PropertyMapper	get()	Return the property mapper.
private <T> PropertyMapper.Source<T>	getSource(Supplier<T> supplier)
private <T> PropertyMapper.Source<T>	whenNonNull(PropertyMapper.Source<T> source)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

ALWAYS

private static final Predicate<?> ALWAYS

INSTANCE

private static final PropertyMapper INSTANCE

parent

@Nullable
private final PropertyMapper parent

sourceOperator

@Nullable
private final PropertyMapper.SourceOperator sourceOperator

构造器详细资料

PropertyMapper

private PropertyMapper(@Nullable
 PropertyMapper parent,
 @Nullable
 PropertyMapper.SourceOperator sourceOperator)

方法详细资料

alwaysApplyingWhenNonNull

public PropertyMapper alwaysApplyingWhenNonNull()

Return a new PropertyMapper instance that applies whenNonNull to every source.

返回:

a new property mapper instance

whenNonNull

private <T> PropertyMapper.Source<T> whenNonNull(PropertyMapper.Source<T> source)

alwaysApplying

public PropertyMapper alwaysApplying(PropertyMapper.SourceOperator operator)

Return a new PropertyMapper instance that applies the given PropertyMapper.SourceOperator to every source.

参数:

operator - the source operator to apply

返回:

a new property mapper instance

from

public <T> PropertyMapper.Source<T> from(Supplier<T> supplier)

Return a new PropertyMapper.Source from the specified value supplier that can be used to perform the mapping.

类型参数:

T - the source type

参数:

supplier - the value supplier

返回:

a PropertyMapper.Source that can be used to complete the mapping

另请参阅:

• from(Object)

from

public <T> PropertyMapper.Source<T> from(@Nullable
 T value)

Return a new PropertyMapper.Source from the specified value that can be used to perform the mapping.

类型参数:

T - the source type

参数:

value - the value

返回:

a PropertyMapper.Source that can be used to complete the mapping

getSource

private <T> PropertyMapper.Source<T> getSource(Supplier<T> supplier)

get

public static PropertyMapper get()

Return the property mapper.

返回:

the property mapper