Class BeanMap<T>

java.lang.Object

java.util.AbstractMap<String,Object>

cloud.opencode.base.reflect.bean.BeanMap<T>

Type Parameters:

T - the bean type | bean类型

All Implemented Interfaces:

Map<String,Object>

public class BeanMap<T>
extends AbstractMap<String,Object>

Bean Map Bean映射

Provides Map interface view of a bean's properties.

提供bean属性的Map接口视图。

Features | 主要功能:

• Map interface view of bean properties - bean属性的Map接口视图
• Read/write through Map operations - 通过Map操作读写
• Cross-bean property copying - 跨bean属性复制

Usage Examples | 使用示例:

BeanMap<User> map = BeanMap.from(user);
Object name = map.get("name");
map.put("name", "Alice");
Map<String, Object> plain = map.toMap();

Security | 安全性:

• Thread-safe: No (not synchronized) - 线程安全: 否（未同步）
• Null-safe: No (bean must be non-null) - 空值安全: 否（bean须非空）

Since:

JDK 25, opencode-base-reflect V1.0.0

Author:

Leon Soo www.LeonSoo.com

See Also:

• OpenCode.cloud

Nested Class Summary

Nested classes/interfaces inherited from class AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor	Description
BeanMap(T bean, Map<String, PropertyDescriptor> descriptors)	Creates a BeanMap 创建BeanMap
BeanMap(T bean, Map<String, PropertyDescriptor> descriptors, boolean ignoreUnknownProperties)	Creates a BeanMap with configuration 创建带配置的BeanMap

Method Summary

Modifier and Type	Method	Description
boolean	containsKey(Object key)
void	copyFrom(Map<String,?> source)	Copies properties from a Map 从Map复制属性
<U> void	copyTo(U target)	Copies all properties to another bean 复制所有属性到另一个bean
Set<Map.Entry<String,Object>>	entrySet()
static <T> BeanMap<T>	from(T bean)	Creates a BeanMap from a bean 从bean创建BeanMap
Object	get(Object key)
T	getBean()	Gets the underlying bean 获取底层bean
PropertyDescriptor	getPropertyDescriptor(String name)	Gets property descriptor by name 按名称获取属性描述符
Map<String,Object>	getReadableProperties()	Gets only readable properties as Map 仅获取可读属性为Map
Set<String>	keySet()
Object	put(String key, Object value)
int	size()
Map<String,Object>	toMap()	Converts to a regular Map 转换为普通Map

Methods inherited from class AbstractMap

clear, clone, containsValue, equals, hashCode, isEmpty, putAll, remove, toString, values

Methods inherited from class Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Details

BeanMap

public BeanMap(T bean,
 Map<String, PropertyDescriptor> descriptors)

Creates a BeanMap 创建BeanMap

Parameters:

bean - the bean | bean

descriptors - the property descriptors | 属性描述符

BeanMap

public BeanMap(T bean,
 Map<String, PropertyDescriptor> descriptors,
 boolean ignoreUnknownProperties)

Creates a BeanMap with configuration 创建带配置的BeanMap

Parameters:

bean - the bean | bean

descriptors - the property descriptors | 属性描述符

ignoreUnknownProperties - whether to ignore unknown properties | 是否忽略未知属性

Method Details

from

public static <T> BeanMap<T> from(T bean)

Creates a BeanMap from a bean 从bean创建BeanMap

Type Parameters:

T - the bean type | bean类型

Parameters:

bean - the bean | bean

Returns:

the BeanMap | BeanMap

getBean

public T getBean()

Gets the underlying bean 获取底层bean

Returns:

the bean | bean

get

public Object get(Object key)

Specified by:

get in interface Map<String,Object>

Overrides:

get in class AbstractMap<String,Object>

put

public Object put(String key,
 Object value)

Specified by:

put in interface Map<String,Object>

Overrides:

put in class AbstractMap<String,Object>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<String,Object>

Overrides:

containsKey in class AbstractMap<String,Object>

keySet

public Set<String> keySet()

Specified by:

keySet in interface Map<String,Object>

Overrides:

keySet in class AbstractMap<String,Object>

entrySet

public Set<Map.Entry<String,Object>> entrySet()

Specified by:

entrySet in interface Map<String,Object>

Specified by:

entrySet in class AbstractMap<String,Object>

size

public int size()

Specified by:

size in interface Map<String,Object>

Overrides:

size in class AbstractMap<String,Object>

copyTo

public <U> void copyTo(U target)

Copies all properties to another bean 复制所有属性到另一个bean

Type Parameters:

U - the target type | 目标类型

Parameters:

target - the target bean | 目标bean

copyFrom

public void copyFrom(Map<String,?> source)

Copies properties from a Map 从Map复制属性

Parameters:

source - the source map | 源映射

toMap

public Map<String,Object> toMap()

Converts to a regular Map 转换为普通Map

Returns:

the map | 映射

getReadableProperties

public Map<String,Object> getReadableProperties()

Gets only readable properties as Map 仅获取可读属性为Map

Returns:

the map | 映射

getPropertyDescriptor

public PropertyDescriptor getPropertyDescriptor(String name)

Gets property descriptor by name 按名称获取属性描述符

Parameters:

name - the property name | 属性名

Returns:

the descriptor or null | 描述符或null