org.nutz.lang.util

接口 NutBean

所有超级接口:

Map<String,Object>

所有已知实现类:

NutMap, RelationObjectMap, ViewModel

public interface NutBean
extends Map<String,Object>

嵌套类概要

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

Map.Entry<K,V>

方法概要

限定符和类型	方法和说明
NutBean	addv(String key, Object value)
Object	get(String key, Object dft)
<T> T[]	getArray(String key, Class<T> eleType)
<T> T[]	getArray(String key, Class<T> eleType, T[] dft) 将一个字段转换成数组。
<T> T	getAs(String key, Class<T> classOfT)
<T> T	getAs(String key, Class<T> classOfT, T dft)
boolean	getBoolean(String key)
boolean	getBoolean(String key, boolean dft)
double	getDouble(String key)
double	getDouble(String key, double dft)
<T extends Enum<T>> T	getEnum(String key, Class<T> classOfEnum)
float	getFloat(String key)
float	getFloat(String key, float dft)
int	getInt(String key)
int	getInt(String key, int dft)
<T> List<T>	getList(String key, Class<T> eleType)
<T> List<T>	getList(String key, Class<T> eleType, List<T> dft) 将一个字段转换成列表。
long	getLong(String key)
long	getLong(String key, long dft)
<T> T	getOrBorn(String key, Borning<T> factory) 获取对应的值,若不存在,用factory创建一个,然后设置进去,返回之
String	getString(String key)
String	getString(String key, String dft)
Date	getTime(String key)
Date	getTime(String key, Date dft)
boolean	has(String key)
boolean	is(String key, Object val)
boolean	isEnum(String key, Enum<?>... eus)
boolean	match(Map<String,Object> map) 将自身作为一个条件，看看给定的 Map 是否全部满足这个条件 注意，字符串型的值有下列意义 "^xxxxx" : 正则表达式 "" : 相当于 Blank
NutBean	mergeWith(Map<String,Object> map) 相当于 mergeWith(map, false)
NutBean	mergeWith(Map<String,Object> map, boolean onlyAbsent) 与一个给定的 Map 融合，如果有子 Map 递归
NutBean	omit(String... keys) 从 Map 里将指定的键过滤，生成一个新的 Map
NutBean	pick(String... keys) 从 Map 里挑选一些键生成一个新的 Map
NutBean	pickAndRemove(String... keys) 从 Map 里挑选一些键生成一个新的 Map，自己同时删除这些键
NutBean	pickAndRemoveBy(Pattern p, boolean isNot) 从 Map 里挑选一些键生成一个新的 Map，自己同时删除这些键
NutBean	pickBy(Pattern p, boolean isNot) 从 Map 里挑选一些键生成一个新的 Map
NutBean	pickBy(String regex) 从 Map 里挑选一些键生成一个新的 Map
NutBean	putDefault(String key, Object dft) 如果一个键的值无效（has(key) 返回 false)，那么为其设置默认值
NutBean	setAll(Map<String,Object> map)
NutBean	setMap(Map<?,?> map, boolean ignoreNullValue)
NutBean	setnx(String key, Object val) 与JDK8+的 putIfAbsent(key, val)一致, 当且仅当值不存在时设置进去,但与putIfAbsent返回值有不一样
NutBean	setnxAll(Map<String,Object> map) 将一个集合与自己补充（相当于针对每个 key 调用 setnx)
void	setOrRemove(String key, Object v) 设置一个字段，如果值为 null 则表示移除
NutBean	setv(String key, Object value)
void	unset(String key)

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

clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

方法详细资料

has

boolean has(String key)

is

boolean is(String key,
           Object val)

setOrRemove

void setOrRemove(String key,
                 Object v)

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

参数:

key - 键

v - 值

get

Object get(String key,
           Object dft)

getInt

int getInt(String key)

getInt

int getInt(String key,
           int dft)

getFloat

float getFloat(String key)

getFloat

float getFloat(String key,
               float dft)

getLong

long getLong(String key)

getLong

long getLong(String key,
             long dft)

getDouble

double getDouble(String key)

getDouble

double getDouble(String key,
                 double dft)

getBoolean

boolean getBoolean(String key)

getBoolean

boolean getBoolean(String key,
                   boolean dft)

getString

String getString(String key)

getString

String getString(String key,
                 String dft)

getTime

Date getTime(String key)

getTime

Date getTime(String key,
             Date dft)

getEnum

<T extends Enum<T>> T getEnum(String key,
                              Class<T> classOfEnum)

isEnum

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

getAs

<T> T getAs(String key,
            Class<T> classOfT)

getAs

<T> T getAs(String key,
            Class<T> classOfT,
            T dft)

getList

<T> List<T> getList(String key,
                    Class<T> eleType,
                    List<T> dft)

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

类型参数:

T -

参数:

key - 键

eleType - 列表元素类型

dft - 默认值

返回:

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

getList

<T> List<T> getList(String key,
                    Class<T> eleType)

另请参阅:

getList(String, Class, List)

getArray

<T> T[] getArray(String key,
                 Class<T> eleType,
                 T[] dft)

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

类型参数:

T -

参数:

key - 键

eleType - 数组元素类型

dft - 默认值

返回:

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

getArray

<T> T[] getArray(String key,
                 Class<T> eleType)

另请参阅:

getArray(String, Class, Object[])

addv

NutBean addv(String key,
             Object value)

setv

NutBean setv(String key,
             Object value)

unset

void unset(String key)

setAll

NutBean setAll(Map<String,Object> map)

pick

NutBean pick(String... keys)

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

参数:

keys - 键

返回:

新 Map

pickAndRemove

NutBean pickAndRemove(String... keys)

从 Map 里挑选一些键生成一个新的 Map，自己同时删除这些键

参数:

keys - 键

返回:

新 Map

pickBy

NutBean pickBy(String regex)

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

参数:

regex - 匹配键的正则表达式，"!" 开头，表示取反

返回:

新 Map

pickBy

NutBean pickBy(Pattern p,
               boolean isNot)

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

参数:

p - 匹配键的正则表达式，null 不会匹配任何一个键

isNot - true 表示被匹配上的会被忽略，false 表示被匹配上的才加入到返回的集合里

返回:

新 Map

pickAndRemoveBy

NutBean pickAndRemoveBy(Pattern p,
                        boolean isNot)

从 Map 里挑选一些键生成一个新的 Map，自己同时删除这些键

参数:

p - 匹配键的正则表达式，null 不会匹配任何一个键

isNot - true 表示被匹配上的会被忽略，false 表示被匹配上的才加入到返回的集合里

返回:

新 Map

omit

NutBean omit(String... keys)

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

参数:

keys - 键

返回:

新 Map

putDefault

NutBean putDefault(String key,
                   Object dft)

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

参数:

key - 键

dft - 值

返回:

自身以便链式赋值

setMap

NutBean setMap(Map<?,?> map,
               boolean ignoreNullValue)

mergeWith

NutBean mergeWith(Map<String,Object> map)

相当于 mergeWith(map, false)

另请参阅:

mergeWith(Map, boolean)

mergeWith

NutBean mergeWith(Map<String,Object> map,
                  boolean onlyAbsent)

与一个给定的 Map 融合，如果有子 Map 递归

参数:

map - 要合并进来的 Map

onlyAbsent - true 表示只有没有 key 才设置值

返回:

自身以便链式赋值

setnx

NutBean setnx(String key,
              Object val)

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

参数:

key - 键

val - 值

返回:

当前实例

setnxAll

NutBean setnxAll(Map<String,Object> map)

将一个集合与自己补充（相当于针对每个 key 调用 setnx)

参数:

map - 集合

返回:

自身

另请参阅:

setnx(String, Object)

getOrBorn

<T> T getOrBorn(String key,
                Borning<T> factory)

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

参数:

key - 键

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

返回:

已存在的值或新的值

match

boolean match(Map<String,Object> map)

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

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

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

参数:

map - 给定的 Map

返回:

是否匹配