MapUtils (noark-core 3.4.2.Final API)

java.lang.Object
- xyz.noark.core.util.MapUtils

```
public class MapUtils
extends java.lang.Object
```
Map类型的工具类.

从以下版本开始:

3.1

作者:

小流氓[176543888@qq.com]

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static <K> void`	`addByIntValue(java.util.Map<K,java.lang.Integer> source, java.util.Map<K,java.lang.Integer> value)` 将第二个Map加到第一个Map上.
`static <K> void`	`addByLongValue(java.util.Map<K,java.lang.Long> source, java.util.Map<K,java.lang.Long> value)` 将第二个Map加到第一个Map上.
`static <K> java.lang.Double`	`addValue(java.util.Map<K,java.lang.Double> source, K key, double value)` 给Map指定Key的值上加一个double值.
`static <K> java.lang.Float`	`addValue(java.util.Map<K,java.lang.Float> source, K key, float value)` 给Map指定Key的值上加一个float值.
`static <K> java.lang.Integer`	`addValue(java.util.Map<K,java.lang.Integer> source, K key, int value)` 给Map指定Key的值上加一个int值.
`static <K> java.lang.Long`	`addValue(java.util.Map<K,java.lang.Long> source, K key, long value)` 给Map指定Key的值上加一个long值.
`static <V> V`	`getOrMaxKey(java.util.Map<java.lang.Integer,V> map, java.lang.Integer key)` 从map中获取指定的Key，如果Key对应的值不存在，那就获取最大的Key所对应的值.
`static <K> double`	`getPercentageValue(java.util.Map<K,java.lang.Long> map, K... keys)` 从Map中获取指定Key的值所转化的百分比的和.
`static <K> double`	`getPermillageValue(java.util.Map<K,java.lang.Long> map, K... keys)` 从Map中获取指定Key的值所转化的千分比的和.
`static <K> double`	`getRatioValue(java.util.Map<K,java.lang.Long> map, double ratio, K... keys)` 从Map中获取指定Key的值所转化的比率和.
`static boolean`	`isEmpty(java.util.Map<?,?> map)` 检测集合是否为`null`或长度为0
`static boolean`	`isNotEmpty(java.util.Map<?,?> map)` 检测集合是否不为`null`或长度大于0
`static <K,V> java.util.concurrent.ConcurrentHashMap<K,V>`	`newConcurrentHashMap(int size)` 创建一个将要存放Size个KV的ConcurrentHashMap.
`static <K,V> java.util.HashMap<K,V>`	`newHashMap(int size)` 创建一个将要存放Size个KV的HashMap.
`static <K,V> java.util.HashMap<K,V>`	`of(K key, V value)` 使用Key与Value直接构建一个HashMap.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - newHashMap
```
public static <K,V> java.util.HashMap<K,V> newHashMap(int size)
```
    创建一个将要存放Size个KV的HashMap.
    初始化容量=(需要存储个数 / 负载因子) + 1
    如果你无法确认要存多少，那就估一个值吧，估不了就直接new一个HashMap
    
    类型参数:
    
    K - 存储Key类型
    
    V - 存储Value类型
    
    参数:
    
    size - 需要存储个数
    
    返回:
    
    返回一个已计算好存储容量的HashMap
  - newConcurrentHashMap
```
public static <K,V> java.util.concurrent.ConcurrentHashMap<K,V> newConcurrentHashMap(int size)
```
    创建一个将要存放Size个KV的ConcurrentHashMap.
    初始化容量=(需要存储个数 / 负载因子) + 1
    
    类型参数:
    
    K - 存储Key类型
    
    V - 存储Value类型
    
    参数:
    
    size - 需要存储个数
    
    返回:
    
    返回一个已计算好存储容量的ConcurrentHashMap
  - isEmpty
```
public static boolean isEmpty(java.util.Map<?,?> map)
```
    检测集合是否为null或长度为0
    
    参数:
    
    map - 被检测集合
    
    返回:
    
    如果字符为null或长度为0则返回true,否则返回false.
  - isNotEmpty
```
public static boolean isNotEmpty(java.util.Map<?,?> map)
```
    检测集合是否不为null或长度大于0
    
    参数:
    
    map - 被检测集合
    
    返回:
    
    如果字符不为null或长度大于0则返回true,否则返回false.
  - of
```
public static <K,V> java.util.HashMap<K,V> of(K key,
                                              V value)
```
    使用Key与Value直接构建一个HashMap.
    
    类型参数:
    
    K - 键的类型
    
    V - 值的类型
    
    参数:
    
    key - 键
    
    value - 值
    
    返回:
    
    HashMap对象
  - getOrMaxKey
```
public static <V> V getOrMaxKey(java.util.Map<java.lang.Integer,V> map,
                                java.lang.Integer key)
```
    从map中获取指定的Key，如果Key对应的值不存在，那就获取最大的Key所对应的值.
    常用于策划配置次数，比如获取20次所对应的资源，如果只配置到15，那就使用15对应的资源
    1=10
    2=15
    3=20
    4=25
    5=30
    10=100
    如此配置，如果参数为6，应该返回是30，如果参数是12，应该返回100
    
    类型参数:
    
    V - 值的类型
    
    参数:
    
    map - 配置Map
    
    key - 指定Key
    
    返回:
    
    只要配置了值肯定会返回一个最近的值...
  - addByIntValue
```
public static <K> void addByIntValue(java.util.Map<K,java.lang.Integer> source,
                                     java.util.Map<K,java.lang.Integer> value)
```
    将第二个Map加到第一个Map上.
    如果K为对象注意要重写HashCode与Equips方法
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    source - 存结果的Map对象.
    
    value - 要加的Map对象，此对象可以为空或null
  - addByLongValue
```
public static <K> void addByLongValue(java.util.Map<K,java.lang.Long> source,
                                      java.util.Map<K,java.lang.Long> value)
```
    将第二个Map加到第一个Map上.
    如果K为对象注意要重写HashCode与Equips方法
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    source - 存结果的Map对象.
    
    value - 要加的Map对象，此对象可以为空或null
  - addValue
```
public static <K> java.lang.Integer addValue(java.util.Map<K,java.lang.Integer> source,
                                             K key,
                                             int value)
```
    给Map指定Key的值上加一个int值.
    如果Key不存在，则直接Put，这个方法就是留给不了解J8的人使用的
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    source - Map对象
    
    key - 指定Key
    
    value - 要添加的值
    
    返回:
    
    返回添加指定值以后的Value
  - addValue
```
public static <K> java.lang.Long addValue(java.util.Map<K,java.lang.Long> source,
                                          K key,
                                          long value)
```
    给Map指定Key的值上加一个long值.
    如果Key不存在，则直接Put，这个方法就是留给不了解J8的人使用的
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    source - Map对象
    
    key - 指定Key
    
    value - 要添加的值
    
    返回:
    
    返回添加指定值以后的Value
  - addValue
```
public static <K> java.lang.Float addValue(java.util.Map<K,java.lang.Float> source,
                                           K key,
                                           float value)
```
    给Map指定Key的值上加一个float值.
    如果Key不存在，则直接Put，这个方法就是留给不了解J8的人使用的
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    source - Map对象
    
    key - 指定Key
    
    value - 要添加的值
    
    返回:
    
    返回添加指定值以后的Value
  - addValue
```
public static <K> java.lang.Double addValue(java.util.Map<K,java.lang.Double> source,
                                            K key,
                                            double value)
```
    给Map指定Key的值上加一个double值.
    如果Key不存在，则直接Put，这个方法就是留给不了解J8的人使用的
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    source - Map对象
    
    key - 指定Key
    
    value - 要添加的值
    
    返回:
    
    返回添加指定值以后的Value
  - getRatioValue
```
@SafeVarargs
public static <K> double getRatioValue(java.util.Map<K,java.lang.Long> map,
                                                     double ratio,
                                                     K... keys)
```
    从Map中获取指定Key的值所转化的比率和.
    如果Key对应的值不存在返回值就是0,相当于没有加成
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    map - Map对象
    
    ratio - 比率
    
    keys - 键列表
    
    返回:
    
    返回对应比率值的和
  - getPermillageValue
```
@SafeVarargs
public static <K> double getPermillageValue(java.util.Map<K,java.lang.Long> map,
                                                          K... keys)
```
    从Map中获取指定Key的值所转化的千分比的和.
    如果Key对应的值不存在返回值就是0,相当于没有加成
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    map - Map对象
    
    keys - 键列表
    
    返回:
    
    返回千分比的和
  - getPercentageValue
```
@SafeVarargs
public static <K> double getPercentageValue(java.util.Map<K,java.lang.Long> map,
                                                          K... keys)
```
    从Map中获取指定Key的值所转化的百分比的和.
    如果Key对应的值不存在返回值就是0,相当于没有加成
    
    类型参数:
    
    K - 键的类型
    
    参数:
    
    map - Map对象
    
    keys - 键列表
    
    返回:
    
    返回百分比的和

类 MapUtils

方法概要

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

方法详细资料

newHashMap

newConcurrentHashMap

isEmpty

isNotEmpty

of

getOrMaxKey

addByIntValue

addByLongValue

addValue

addValue

addValue

addValue

getRatioValue

getPermillageValue

getPercentageValue