java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<K,V>

java.util.LinkedHashMap<String,Object>

org.aoju.bus.core.lang.Dict

All Implemented Interfaces:: Serializable, Cloneable, Map<String,Object>, BasicType<String>

public class Dict extends LinkedHashMap<String,Object> implements BasicType<String>

字典对象,扩充了HashMap中的方法

Since:

Java 17+

Author:

Kimi Liu

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap
AbstractMap.SimpleEntry<K extends Object,V extends Object>, AbstractMap.SimpleImmutableEntry<K extends Object,V extends Object>
Constructor Summary

Constructors

Constructor

Description

Dict()

构造

Dict(boolean caseInsensitive)

构造

Dict(int initialCapacity)

构造

Dict(int initialCapacity, boolean caseInsensitive)

构造

Dict(int initialCapacity, float loadFactor)

构造

Dict(int initialCapacity, float loadFactor, boolean caseInsensitive)

构造

Dict(Map<String,Object> map)

构造
Method Summary

Modifier and Type

Method

Description

Dict

clone()

static Dict

create()

创建Dict

Dict

filter(String... keys)

过滤Map保留指定键值对，如果键不存在跳过

Object

get(Object key)

<T> T

get(String attr, T defaultValue)

获得特定类型值

<T> T

getBean(String attr)

获得特定类型值

BigDecimal

getBigDecimal(String attr)

获取BigDecimal型属性值

BigInteger

getBigInteger(String attr)

获取BigInteger型属性值

Boolean

getBool(String attr)

获取boolean型属性值

<T> T

getByPath(String expression)

通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值

<T> T

getByPath(String expression, Class<T> resultType)

通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值

Byte

getByte(String attr)

获取byte型属性值

byte[]

getBytes(String attr)

Character

getChar(String attr)

获取char型属性值

Date

getDate(String attr)

获取Date类型值

Double

getDouble(String attr)

获取double型属性值

<E extends Enum<E>> E

getEnum(Class<E> clazz, String key)

获得Enum类型的值

Float

getFloat(String attr)

获取float型属性值

Integer

getInt(String attr)

获取int型属性值

Long

getLong(String attr)

获取long型属性值

Number

getNumber(String attr)

Object

getObj(String key)

获取Object属性值

Short

getShort(String attr)

获取short型属性值

String

getStr(String attr)

获取字符串型属性值

Time

getTime(String attr)

Timestamp

getTimestamp(String attr)

static Dict

of(Object... keysAndValues)

根据给定的键值对数组创建Dict对象，传入参数必须为key,value,key,value...

static Dict

of(Pair<String,Object>... pairs)

根据给定的Pair数组创建Dict对象

static <T> Dict

parse(T bean)

将PO对象转为Dict

<T> Dict

parseBean(T bean)

将值对象转换为Dict 类名会被当作表名，小写第一个字母

<T> Dict

parseBean(T bean, boolean isToUnderlineCase, boolean ignoreNullValue)

将值对象转换为Dict 类名会被当作表名，小写第一个字母

Object

put(String key, Object value)

void

putAll(Map<? extends String,?> m)

<T extends Dict> void

removeEqual(T dict, String... withoutNames)

与给定实体对比并去除相同的部分此方法用于在更新操作时避免所有字段被更新，跳过不需要更新的字段 version from 2.0.0

Dict

set(String attr, Object value)

设置列

Dict

setFields(Func0<?>... fields)

通过lambda批量设置值实际使用时，可以使用getXXX的方法引用来完成键值对的赋值：

Dict

setIgnoreNull(String attr, Object value)

设置列，当键或值为null时忽略

<T> T

toBean(T bean)

转换为Bean对象

<T> T

toBean(T bean, boolean isToCamelCase)

转换为Bean对象

<T> T

toBeanIgnoreCase(Class<T> clazz)

填充Value Object对象，忽略大小写

<T> T

toBeanIgnoreCase(T bean)

转换为Bean对象

<T> T

toBeanWithCamelCase(T bean)

转换为Bean对象,并使用驼峰法模式转换

Methods inherited from class java.util.LinkedHashMap
clear, containsValue, entrySet, forEach, getOrDefault, keySet, removeEldestEntry, replaceAll, values

Methods inherited from class java.util.HashMap
compute, computeIfAbsent, computeIfPresent, containsKey, isEmpty, merge, putIfAbsent, remove, remove, replace, replace, size

Methods inherited from class java.util.AbstractMap
equals, hashCode, toString

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, containsKey, equals, hashCode, isEmpty, merge, putIfAbsent, remove, remove, replace, replace, size

Constructor Details
- Dict
  
  public Dict()
  
  构造
- Dict
  
  public Dict(boolean caseInsensitive)
  
  构造
  
  Parameters:
  
  caseInsensitive - 是否大小写不敏感
- Dict
  
  public Dict(int initialCapacity)
  
  构造
  
  Parameters:
  
  initialCapacity - 初始容量
- Dict
  
  public Dict(Map<String,Object> map)
  
  构造
  
  Parameters:
  
  map - Map
- Dict
  
  public Dict(int initialCapacity, boolean caseInsensitive)
  
  构造
  
  Parameters:
  
  initialCapacity - 初始容量
  
  caseInsensitive - 是否大小写不敏感
- Dict
  
  public Dict(int initialCapacity, float loadFactor)
  
  构造
  
  Parameters:
  
  initialCapacity - 初始容量
  
  loadFactor - 容量增长因子，0~1，即达到容量的百分之多少时扩容
- Dict
  
  public Dict(int initialCapacity, float loadFactor, boolean caseInsensitive)
  
  构造
  
  Parameters:
  
  initialCapacity - 初始容量
  
  loadFactor - 容量增长因子，0~1，即达到容量的百分之多少时扩容
  
  caseInsensitive - 是否大小写不敏感
Method Details
- create
  
  public static Dict create()
  
  创建Dict
  
  Returns:
  
  Dict
- parse
  
  public static <T> Dict parse(T bean)
  
  将PO对象转为Dict
  
  Type Parameters:
  
  T - Bean类型
  
  Parameters:
  
  bean - Bean对象
  
  Returns:
  
  Vo
- of
  
  public static Dict of(Pair<String,Object>... pairs)
  
  根据给定的Pair数组创建Dict对象
  
  Parameters:
  
  pairs - 键值对
  
  Returns:
  
  Dict
- of
  
  public static Dict of(Object... keysAndValues)
  根据给定的键值对数组创建Dict对象，传入参数必须为key,value,key,value... 奇数参数必须为key，key最后会转换为String类型奇数参数必须为value，可以为任意类型
  Dict dict = Dict.of( "RED", "#FF0000", "GREEN", "#00FF00", "BLUE", "#0000FF" );
  Parameters:
  
  keysAndValues - 键值对列表，必须奇数参数为key，偶数参数为value
  
  Returns:
  
  Dict
- get
  
  public Object get(Object key)
  
  Specified by:
  
  get in interface Map<String,Object>
  
  Overrides:
  
  get in class LinkedHashMap<String,Object>
- put
  
  public Object put(String key, Object value)
  
  Specified by:
  
  put in interface Map<String,Object>
  
  Overrides:
  
  put in class HashMap<String,Object>
- clone
  
  public Dict clone()
  
  Overrides:
  
  clone in class HashMap<String,Object>
- getObj
  
  public Object getObj(String key)
  
  Description copied from interface: BasicType
  
  获取Object属性值
  
  Specified by:
  
  getObj in interface BasicType<String>
  
  Parameters:
  
  key - 属性名
  
  Returns:
  
  属性值
- getStr
  
  public String getStr(String attr)
  
  Description copied from interface: BasicType
  
  获取字符串型属性值
  
  Specified by:
  
  getStr in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getInt
  
  public Integer getInt(String attr)
  
  Description copied from interface: BasicType
  
  获取int型属性值
  
  Specified by:
  
  getInt in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getLong
  
  public Long getLong(String attr)
  
  Description copied from interface: BasicType
  
  获取long型属性值
  
  Specified by:
  
  getLong in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getFloat
  
  public Float getFloat(String attr)
  
  Description copied from interface: BasicType
  
  获取float型属性值
  
  Specified by:
  
  getFloat in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getShort
  
  public Short getShort(String attr)
  
  Description copied from interface: BasicType
  
  获取short型属性值
  
  Specified by:
  
  getShort in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getChar
  
  public Character getChar(String attr)
  
  Description copied from interface: BasicType
  
  获取char型属性值
  
  Specified by:
  
  getChar in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getDouble
  
  public Double getDouble(String attr)
  
  Description copied from interface: BasicType
  
  获取double型属性值
  
  Specified by:
  
  getDouble in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getByte
  
  public Byte getByte(String attr)
  
  Description copied from interface: BasicType
  
  获取byte型属性值
  
  Specified by:
  
  getByte in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getBool
  
  public Boolean getBool(String attr)
  
  Description copied from interface: BasicType
  
  获取boolean型属性值
  
  Specified by:
  
  getBool in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getBigDecimal
  
  public BigDecimal getBigDecimal(String attr)
  
  Description copied from interface: BasicType
  
  获取BigDecimal型属性值
  
  Specified by:
  
  getBigDecimal in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getBigInteger
  
  public BigInteger getBigInteger(String attr)
  
  Description copied from interface: BasicType
  
  获取BigInteger型属性值
  
  Specified by:
  
  getBigInteger in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  属性值
- getEnum
  
  public <E extends Enum<E>> E getEnum(Class<E> clazz, String key)
  
  Description copied from interface: BasicType
  
  获得Enum类型的值
  
  Specified by:
  
  getEnum in interface BasicType<String>
  
  Type Parameters:
  
  E - 枚举类型
  
  Parameters:
  
  clazz - Enum的Class
  
  key - KEY
  
  Returns:
  
  Enum类型的值, 无则返回Null
- getDate
  
  public Date getDate(String attr)
  
  Description copied from interface: BasicType
  
  获取Date类型值
  
  Specified by:
  
  getDate in interface BasicType<String>
  
  Parameters:
  
  attr - 属性名
  
  Returns:
  
  Date类型属性值
- putAll
  
  public void putAll(Map<? extends String,?> m)
  
  Specified by:
  
  putAll in interface Map<String,Object>
  
  Overrides:
  
  putAll in class HashMap<String,Object>
- getBytes
  
  public byte[] getBytes(String attr)
  
  Parameters:
  
  attr - 字段名
  
  Returns:
  
  字段值
- getTime
  
  public Time getTime(String attr)
  
  Parameters:
  
  attr - 字段名
  
  Returns:
  
  字段值
- getTimestamp
  
  public Timestamp getTimestamp(String attr)
  
  Parameters:
  
  attr - 字段名
  
  Returns:
  
  字段值
- getNumber
  
  public Number getNumber(String attr)
  
  Parameters:
  
  attr - 字段名
  
  Returns:
  
  字段值
- getByPath
  
  public <T> T getByPath(String expression)
  通过表达式获取JSON中嵌套的对象
  
  .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
  
  []表达式，可以获取集合等对象中对应index的值
  
  表达式栗子：
  persion persion.name persons[3] person.friends[5].name
  Type Parameters:
  
  T - 泛型对象
  
  Parameters:
  
  expression - 表达式
  
  Returns:
  
  对象
  
  See Also:
  
  PathExpression.get(Object)
- getByPath
  
  public <T> T getByPath(String expression, Class<T> resultType)
  通过表达式获取JSON中嵌套的对象
  
  .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
  
  []表达式，可以获取集合等对象中对应index的值
  
  表达式栗子：
  persion persion.name persons[3] person.friends[5].name
  
  获取表达式对应值后转换为对应类型的值
  Type Parameters:
  
  T - 返回值类型
  
  Parameters:
  
  expression - 表达式
  
  resultType - 返回值类型
  
  Returns:
  
  对象
  
  See Also:
  
  PathExpression.get(Object)
- toBean
  
  public <T> T toBean(T bean)
  
  转换为Bean对象
  
  Type Parameters:
  
  T - Bean类型
  
  Parameters:
  
  bean - Bean
  
  Returns:
  
  Bean
- toBean
  
  public <T> T toBean(T bean, boolean isToCamelCase)
  
  转换为Bean对象
  
  Type Parameters:
  
  T - Bean类型
  
  Parameters:
  
  bean - Bean
  
  isToCamelCase - 是否转换为驼峰模式
  
  Returns:
  
  Bean
- toBeanIgnoreCase
  
  public <T> T toBeanIgnoreCase(T bean)
  
  转换为Bean对象
  
  Type Parameters:
  
  T - Bean类型
  
  Parameters:
  
  bean - Bean
  
  Returns:
  
  Bean
- toBeanWithCamelCase
  
  public <T> T toBeanWithCamelCase(T bean)
  
  转换为Bean对象,并使用驼峰法模式转换
  
  Type Parameters:
  
  T - Bean类型
  
  Parameters:
  
  bean - Bean
  
  Returns:
  
  Bean
- toBeanIgnoreCase
  
  public <T> T toBeanIgnoreCase(Class<T> clazz)
  
  填充Value Object对象，忽略大小写
  
  Type Parameters:
  
  T - Bean类型
  
  Parameters:
  
  clazz - Value Object(或者POJO)的类
  
  Returns:
  
  vo
- parseBean
  
  public <T> Dict parseBean(T bean)
  
  将值对象转换为Dict 类名会被当作表名，小写第一个字母
  
  Type Parameters:
  
  T - Bean类型
  
  Parameters:
  
  bean - 值对象
  
  Returns:
  
  自己
- parseBean
  
  public <T> Dict parseBean(T bean, boolean isToUnderlineCase, boolean ignoreNullValue)
  
  将值对象转换为Dict 类名会被当作表名，小写第一个字母
  
  Type Parameters:
  
  T - Bean类型
  
  Parameters:
  
  bean - 值对象
  
  isToUnderlineCase - 是否转换为下划线模式
  
  ignoreNullValue - 是否忽略值为空的字段
  
  Returns:
  
  自己
- removeEqual
  
  public <T extends Dict> void removeEqual(T dict, String... withoutNames)
  
  与给定实体对比并去除相同的部分此方法用于在更新操作时避免所有字段被更新，跳过不需要更新的字段 version from 2.0.0
  
  Type Parameters:
  
  T - 字典对象类型
  
  Parameters:
  
  dict - 字典对象
  
  withoutNames - 不需要去除的字段名
- filter
  
  public Dict filter(String... keys)
  
  过滤Map保留指定键值对，如果键不存在跳过
  
  Parameters:
  
  keys - 键列表
  
  Returns:
  
  Dict 结果
- getBean
  
  public <T> T getBean(String attr)
  
  获得特定类型值
  
  Type Parameters:
  
  T - 值类型
  
  Parameters:
  
  attr - 字段名
  
  Returns:
  
  字段值
- setIgnoreNull
  
  public Dict setIgnoreNull(String attr, Object value)
  
  设置列，当键或值为null时忽略
  
  Parameters:
  
  attr - 属性
  
  value - 值
  
  Returns:
  
  本身
- set
  
  public Dict set(String attr, Object value)
  
  设置列
  
  Parameters:
  
  attr - 属性
  
  value - 值
  
  Returns:
  
  本身
- get
  
  public <T> T get(String attr, T defaultValue)
  
  获得特定类型值
  
  Type Parameters:
  
  T - 值类型
  
  Parameters:
  
  attr - 字段名
  
  defaultValue - 默认值
  
  Returns:
  
  字段值
- setFields
  
  public Dict setFields(Func0<?>... fields)
  通过lambda批量设置值实际使用时，可以使用getXXX的方法引用来完成键值对的赋值：
  User user = GenericBuilder.of(User::new).with(User::setUsername, "bus").build(); Dict.create().setFields(user::getNickname, user::getUsername);
  Parameters:
  
  fields - lambda,不能为空
  
  Returns:
  
  this

Class Dict

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

Constructor Summary

Method Summary

Methods inherited from class java.util.LinkedHashMap

Methods inherited from class java.util.HashMap

Methods inherited from class java.util.AbstractMap

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Constructor Details

Dict

Dict

Dict

Dict

Dict

Dict

Dict

Method Details

create

parse

of

of

get

put

clone

getObj

getStr

getInt

getLong

getFloat

getShort

getChar

getDouble

getByte

getBool

getBigDecimal

getBigInteger

getEnum

getDate

putAll

getBytes

getTime

getTimestamp

getNumber

getByPath

getByPath

toBean

toBean

toBeanIgnoreCase

toBeanWithCamelCase

toBeanIgnoreCase

parseBean

parseBean

removeEqual

filter

getBean

setIgnoreNull

set

get

setFields