org.nutz.lang.util

类 NutMap

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<K,V>

java.util.LinkedHashMap<java.lang.String,java.lang.Object>

org.nutz.lang.util.NutMap

所有已实现的接口:

java.io.Serializable, java.lang.Cloneable, java.util.Map<java.lang.String,java.lang.Object>, NutBean

直接已知子类:

RelationObjectMap, ViewModel

public class NutMap
extends java.util.LinkedHashMap<java.lang.String,java.lang.Object>
implements NutBean

对于 LinkedHashMap 的一个友好封装

同 TreeMap 不同的是，如果 get(null)，它不会抛错，就是返回 null 或默认值

另请参阅:

序列化表格

嵌套类概要

从类继承的嵌套类/接口 java.util.AbstractMap

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

从接口继承的嵌套类/接口 java.util.Map

java.util.Map.Entry<K,V>

构造器概要

构造器

构造器和说明
NutMap()
NutMap(java.util.Map<java.lang.String,java.lang.Object> map)
NutMap(java.lang.String json)
NutMap(java.lang.String key, java.lang.Object value)

方法概要

限定符和类型	方法和说明
NutMap	addv(java.lang.String key, java.lang.Object value) 为 Map 增加一个名值对。
NutMap	attach(NutMap map)
void	clear()
boolean	containsKey(java.lang.Object key)
boolean	containsValue(java.lang.Object value)
NutMap	detach()
java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>>	entrySet()
java.lang.Object	get(java.lang.Object key)
java.lang.Object	get(java.lang.String key, java.lang.Object dft)
<T> T[]	getArray(java.lang.String key, java.lang.Class<T> eleType)
<T> T[]	getArray(java.lang.String key, java.lang.Class<T> eleType, T[] dft) 将一个字段转换成数组。
<T> T	getAs(java.lang.String key, java.lang.Class<T> classOfT)
<T> T	getAs(java.lang.String key, java.lang.Class<T> classOfT, T dft)
boolean	getBoolean(java.lang.String key)
boolean	getBoolean(java.lang.String key, boolean dft)
double	getDouble(java.lang.String key)
double	getDouble(java.lang.String key, double dft)
<T extends java.lang.Enum<T>> T	getEnum(java.lang.String key, java.lang.Class<T> classOfEnum)
float	getFloat(java.lang.String key)
float	getFloat(java.lang.String key, float dft)
int	getInt(java.lang.String key)
int	getInt(java.lang.String key, int dft)
<T> java.util.List<T>	getList(java.lang.String key, java.lang.Class<T> eleType)
<T> java.util.List<T>	getList(java.lang.String key, java.lang.Class<T> eleType, java.util.List<T> dft) 将一个字段转换成列表。
long	getLong(java.lang.String key)
long	getLong(java.lang.String key, long dft)
<T> T	getOrBorn(java.lang.String key, Borning<T> factory) 获取对应的值,若不存在,用factory创建一个,然后设置进去,返回之
java.lang.String	getString(java.lang.String key)
java.lang.String	getString(java.lang.String key, java.lang.String dft)
java.util.Date	getTime(java.lang.String key)
java.util.Date	getTime(java.lang.String key, java.util.Date dft)
boolean	has(java.lang.String key)
boolean	isEnum(java.lang.String key, java.lang.Enum<?>... eus)
java.util.Set<java.lang.String>	keySet()
boolean	match(java.util.Map<java.lang.String,java.lang.Object> map) 将自身作为一个条件，看看给定的 Map 是否全部满足这个条件 注意，字符串型的值有下列意义 "^xxxxx" : 正则表达式 "" : 相当于 Blank
NutMap	mergeWith(java.util.Map<java.lang.String,java.lang.Object> map)
static NutMap	NEW()
NutMap	omit(java.lang.String... keys) 从 Map 里将指定的键过滤，生成一个新的 Map
NutMap	pick(java.lang.String... keys) 从 Map 里挑选一些键生成一个新的 Map
NutMap	putDefault(java.lang.String key, java.lang.Object dft) 如果一个键的值无效（has(key) 返回 false)，那么为其设置默认值
NutMap	putv(java.lang.String key, java.lang.Object value) 已过时。 本函数意义容易发生混淆，已经改名成 addv，下个版将被删除
NutBean	setAll(java.util.Map<java.lang.String,java.lang.Object> map)
NutMap	setMap(java.util.Map<?,?> map, boolean ignoreNullValue)
NutMap	setnx(java.lang.String key, java.lang.Object val) 与JDK8+的 putIfAbsent(key, val)一致, 当且仅当值不存在时设置进去,但与putIfAbsent返回值有不一样
void	setOrRemove(java.lang.String key, java.lang.Object v) 设置一个字段，如果值为 null 则表示移除
NutMap	setv(java.lang.String key, java.lang.Object value)
void	unset(java.lang.String key)
java.util.Collection<java.lang.Object>	values()
static NutMap	WRAP(java.util.Map<java.lang.String,java.lang.Object> map)
static NutMap	WRAP(java.lang.String json)

从类继承的方法 java.util.LinkedHashMap

forEach, getOrDefault, removeEldestEntry, replaceAll

从类继承的方法 java.util.HashMap

clone, compute, computeIfAbsent, computeIfPresent, isEmpty, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, size

从类继承的方法 java.util.AbstractMap

equals, hashCode, toString

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

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

从接口继承的方法 java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, isEmpty, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size

构造器详细资料

NutMap

public NutMap()

NutMap

public NutMap(java.util.Map<java.lang.String,java.lang.Object> map)

NutMap

public NutMap(java.lang.String json)

NutMap

public NutMap(java.lang.String key,
              java.lang.Object value)

方法详细资料

WRAP

public static NutMap WRAP(java.util.Map<java.lang.String,java.lang.Object> map)

setOrRemove

public void setOrRemove(java.lang.String key,
                        java.lang.Object v)

设置一个字段，如果值为 null 则表示移除

指定者:

setOrRemove 在接口中 NutBean

参数:

key - 键

v - 值

NEW

public static NutMap NEW()

WRAP

public static NutMap WRAP(java.lang.String json)

has

public boolean has(java.lang.String key)

指定者:

has 在接口中 NutBean

pick

public NutMap pick(java.lang.String... keys)

从 Map 里挑选一些键生成一个新的 Map

参数:

keys - 键

返回:

新 Map

omit

public NutMap omit(java.lang.String... keys)

从 Map 里将指定的键过滤，生成一个新的 Map

参数:

keys - 键

返回:

新 Map

putDefault

public NutMap putDefault(java.lang.String key,
                         java.lang.Object dft)

如果一个键的值无效（has(key) 返回 false)，那么为其设置默认值

参数:

key - 键

dft - 值

返回:

自身以便链式赋值

containsValue

public boolean containsValue(java.lang.Object value)

指定者:

containsValue 在接口中 java.util.Map<java.lang.String,java.lang.Object>

覆盖:

containsValue 在类中 java.util.LinkedHashMap<java.lang.String,java.lang.Object>

containsKey

public boolean containsKey(java.lang.Object key)

指定者:

containsKey 在接口中 java.util.Map<java.lang.String,java.lang.Object>

覆盖:

containsKey 在类中 java.util.HashMap<java.lang.String,java.lang.Object>

keySet

public java.util.Set<java.lang.String> keySet()

指定者:

keySet 在接口中 java.util.Map<java.lang.String,java.lang.Object>

覆盖:

keySet 在类中 java.util.LinkedHashMap<java.lang.String,java.lang.Object>

values

public java.util.Collection<java.lang.Object> values()

指定者:

values 在接口中 java.util.Map<java.lang.String,java.lang.Object>

覆盖:

values 在类中 java.util.LinkedHashMap<java.lang.String,java.lang.Object>

entrySet

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

指定者:

entrySet 在接口中 java.util.Map<java.lang.String,java.lang.Object>

覆盖:

entrySet 在类中 java.util.LinkedHashMap<java.lang.String,java.lang.Object>

clear

public void clear()

指定者:

clear 在接口中 java.util.Map<java.lang.String,java.lang.Object>

覆盖:

clear 在类中 java.util.LinkedHashMap<java.lang.String,java.lang.Object>

attach

public NutMap attach(NutMap map)

detach

public NutMap detach()

get

public java.lang.Object get(java.lang.Object key)

指定者:

get 在接口中 java.util.Map<java.lang.String,java.lang.Object>

覆盖:

get 在类中 java.util.LinkedHashMap<java.lang.String,java.lang.Object>

get

public java.lang.Object get(java.lang.String key,
                            java.lang.Object dft)

指定者:

get 在接口中 NutBean

getInt

public int getInt(java.lang.String key)

指定者:

getInt 在接口中 NutBean

getInt

public int getInt(java.lang.String key,
                  int dft)

指定者:

getInt 在接口中 NutBean

getFloat

public float getFloat(java.lang.String key)

指定者:

getFloat 在接口中 NutBean

getFloat

public float getFloat(java.lang.String key,
                      float dft)

指定者:

getFloat 在接口中 NutBean

getLong

public long getLong(java.lang.String key)

指定者:

getLong 在接口中 NutBean

getLong

public long getLong(java.lang.String key,
                    long dft)

指定者:

getLong 在接口中 NutBean

getDouble

public double getDouble(java.lang.String key)

指定者:

getDouble 在接口中 NutBean

getDouble

public double getDouble(java.lang.String key,
                        double dft)

指定者:

getDouble 在接口中 NutBean

getBoolean

public boolean getBoolean(java.lang.String key)

指定者:

getBoolean 在接口中 NutBean

getBoolean

public boolean getBoolean(java.lang.String key,
                          boolean dft)

指定者:

getBoolean 在接口中 NutBean

getString

public java.lang.String getString(java.lang.String key)

指定者:

getString 在接口中 NutBean

getString

public java.lang.String getString(java.lang.String key,
                                  java.lang.String dft)

指定者:

getString 在接口中 NutBean

getTime

public java.util.Date getTime(java.lang.String key)

指定者:

getTime 在接口中 NutBean

getTime

public java.util.Date getTime(java.lang.String key,
                              java.util.Date dft)

指定者:

getTime 在接口中 NutBean

getEnum

public <T extends java.lang.Enum<T>> T getEnum(java.lang.String key,
                                               java.lang.Class<T> classOfEnum)

指定者:

getEnum 在接口中 NutBean

isEnum

public boolean isEnum(java.lang.String key,
                      java.lang.Enum<?>... eus)

指定者:

isEnum 在接口中 NutBean

getAs

public <T> T getAs(java.lang.String key,
                   java.lang.Class<T> classOfT)

指定者:

getAs 在接口中 NutBean

getAs

public <T> T getAs(java.lang.String key,
                   java.lang.Class<T> classOfT,
                   T dft)

指定者:

getAs 在接口中 NutBean

getList

public <T> java.util.List<T> getList(java.lang.String key,
                                     java.lang.Class<T> eleType)

指定者:

getList 在接口中 NutBean

另请参阅:

NutBean.getList(String, Class, List)

getList

public <T> java.util.List<T> getList(java.lang.String key,
                                     java.lang.Class<T> eleType,
                                     java.util.List<T> dft)

从接口复制的说明: NutBean

将一个字段转换成列表。因为返回的是容器，所以本函数永远不会返回 null

指定者:

getList 在接口中 NutBean

参数:

key - 键

eleType - 列表元素类型

dft - 默认值

返回:

列表对象，如果字段不存在或者为空，则返回一个空列表

getArray

public <T> T[] getArray(java.lang.String key,
                        java.lang.Class<T> eleType)

指定者:

getArray 在接口中 NutBean

另请参阅:

NutBean.getArray(String, Class, Object[])

getArray

public <T> T[] getArray(java.lang.String key,
                        java.lang.Class<T> eleType,
                        T[] dft)

从接口复制的说明: NutBean

将一个字段转换成数组。因为返回的是容器，所以本函数永远不会返回 null

指定者:

getArray 在接口中 NutBean

参数:

key - 键

eleType - 数组元素类型

dft - 默认值

返回:

数组对象，如果字段不存在或者为空，则返回一个空数组

addv

public NutMap addv(java.lang.String key,
                   java.lang.Object value)

为 Map 增加一个名值对。如果同名已经有值了，那么会将两个值合并成一个列表

参数:

key -

value -

putv

public NutMap putv(java.lang.String key,
                   java.lang.Object value)

已过时。 本函数意义容易发生混淆，已经改名成 addv，下个版将被删除

从以下版本开始:

1.b.51

setv

public NutMap setv(java.lang.String key,
                   java.lang.Object value)

指定者:

setv 在接口中 NutBean

unset

public void unset(java.lang.String key)

指定者:

unset 在接口中 NutBean

setAll

public NutBean setAll(java.util.Map<java.lang.String,java.lang.Object> map)

指定者:

setAll 在接口中 NutBean

setMap

public NutMap setMap(java.util.Map<?,?> map,
                     boolean ignoreNullValue)

mergeWith

public NutMap mergeWith(java.util.Map<java.lang.String,java.lang.Object> map)

setnx

public NutMap setnx(java.lang.String key,
                    java.lang.Object val)

与JDK8+的 putIfAbsent(key, val)一致, 当且仅当值不存在时设置进去,但与putIfAbsent返回值有不一样

参数:

key - 键

val - 值

返回:

当前的NutMap实例

getOrBorn

public <T> T getOrBorn(java.lang.String key,
                       Borning<T> factory)

获取对应的值,若不存在,用factory创建一个,然后设置进去,返回之

参数:

key - 键

factory - 若不存在的话用于生成实例

返回:

已存在的值或新的值

match

public boolean match(java.util.Map<java.lang.String,java.lang.Object> map)

将自身作为一个条件，看看给定的 Map 是否全部满足这个条件

注意，字符串型的值有下列意义

• "^xxxxx" : 正则表达式
• "" : 相当于 Blank

参数:

map - 给定的 Map

返回:

是否匹配