模块 iofairy.falcon

程序包 com.iofairy.falcon.iterable

类 CollectorUtils

java.lang.Object

com.iofairy.falcon.iterable.CollectorUtils

已过时。

Since falcon version 0.3.5, replaced by CollectionKit

public class CollectorUtils
extends Object

Collection Utils

从以下版本开始:

0.0.1

构造器概要

构造器

构造器	说明
CollectorUtils()	已过时。

方法概要

限定符和类型	方法	说明
static <E> List<List<E>>	balance(int partitions, E[]... arrays)	已过时。 将多个数组中的元素尽可能均匀分配在指定数量（partitions）的 List 中。
static <E> List<List<E>>	balance(int partitions, Collection<? extends Collection<E>> collections)	已过时。 将多个 List 中的元素尽可能均匀分配在指定数量（partitions）的 List 中。
static <E> List<List<E>>	balance(int partitions, Collection<E>... listArray)	已过时。 将多个 List 中的元素尽可能均匀分配在指定数量（partitions）的 List 中。
static <T> List<List<T>>	divide(List<T> list, int perBatchSize)	已过时。 Divide list to multi lists by per batch size.
static <K,V> List<Map<K,V>>	divide(Map<K,V> map, int perBatchSize)	已过时。 Divide map to multi maps by per batch size.
static <T> List<Set<T>>	divide(Set<T> set, int perBatchSize)	已过时。 Divide set to multi sets by per batch size.
static <T> List<T[]>	divide(T[] arr, int perBatchSize)	已过时。 Divide array to multi arrays by per batch size.
private static <E> void	fastSortForBalance(List<Map.Entry<Integer,List<E>>> sortedEntries)	已过时。 Fast Sort For balance(int, Collection) 针对 balance(int, Collection) 方法的快速排序
static <T> T	findNth(Collection<T> ts, Predicate<? super T> filter, int nth)	已过时。 从过滤后的集合中获取第n个元素，超出元素范围，则返回 null
static <T> com.iofairy.tuple.Tuple2<T,Integer>	findNth(List<T> ts, Predicate<? super T> filter, int nth)	已过时。 从过滤后的列表中获取第n个元素及在原列表中的序号，超出元素范围，则返回 null
static <T> com.iofairy.tuple.Tuple2<T,Integer>	findNth(T[] ts, Predicate<? super T> filter, int nth)	已过时。 从获取过滤后的数组中获取第n个元素及在原数组中的序号，超出元素范围，则返回 null
static <T> T	findRandom(Collection<T> ts, Predicate<? super T> filter)	已过时。 从过滤后的集合中随机获取元素
static <T> com.iofairy.tuple.Tuple2<T,Integer>	findRandom(List<T> ts, Predicate<? super T> filter)	已过时。 从过滤后的列表中随机获取元素及在原列表中的序号
static <T> com.iofairy.tuple.Tuple2<T,Integer>	findRandom(T[] ts, Predicate<? super T> filter)	已过时。 从过滤后的数组中随机获取元素及在原数组中的序号

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

CollectorUtils

public CollectorUtils()

已过时。

方法详细资料

divide

public static <T> List<T[]> divide(T[] arr,
                                   int perBatchSize)

已过时。

Divide array to multi arrays by per batch size.
限定每个数组存放的最大元素个数，将一个数组分成多个数组，并存放在List中。
Examples:

 Integer[] intArr = {0, 1, 2, 3, 4, 5, 6, 7};
 List<Integer[]> divided = divide(intArr, 3);
 

divided result:

 [[0, 1, 2], [3, 4, 5], [6, 7]]
 

类型参数:

T - type of array

参数:

arr - array

perBatchSize - per batch size

返回:

divided multi arrays

divide

public static <T> List<List<T>> divide(List<T> list,
                                       int perBatchSize)

已过时。

Divide list to multi lists by per batch size.
限定每个List存放的最大元素个数，将一个List分成多个List，并存放在List中。
Examples:

 List<String> strList = Arrays.asList("a", "b", "c", "d", "e");
 List<List<String>> divided = divide(strList, 2);
 

divided result:

 [[a, b], [c, d], [e]]
 

类型参数:

T - type of list

参数:

list - list

perBatchSize - per batch size

返回:

divided multi lists

divide

public static <T> List<Set<T>> divide(Set<T> set,
                                      int perBatchSize)

已过时。

Divide set to multi sets by per batch size.
限定每个Set存放的最大元素个数，将一个Set分成多个Set，并存放在List中。
Examples:

 Set<Integer> intSet = new HashSet<>();
 intSet.add(1);
 intSet.add(2);
 intSet.add(3);
 List<Set<Integer>> divided = divide(intSet, 2);
 

divided result:

 [[1, 2], [3]]
 

类型参数:

T - type of set

参数:

set - set

perBatchSize - per batch size

返回:

divided multi sets

divide

public static <K,V> List<Map<K,V>> divide(Map<K,V> map,
                                          int perBatchSize)

已过时。

Divide map to multi maps by per batch size.
限定每个Map存放的最大Key的个数，将一个Map分成多个Map，并存放在List中。
Examples:

 Map<String, Integer> map = new HashMap<>();
 map.put("a", 1);
 map.put("b", 2);
 map.put("c", 3);

 List<Map<String, Integer>> divided = divide(map, 2);
 

divided result:

 [{a=1, b=2}, {c=3}]
 

类型参数:

K - type of key

V - type of value

参数:

map - map

perBatchSize - per batch size

返回:

divided multi maps

balance

public static <E> List<List<E>> balance(int partitions,
                                        Collection<? extends Collection<E>> collections)

已过时。

将多个 List 中的元素尽可能均匀分配在指定数量（partitions）的 List 中。 但原来在同一个 List 中的元素，分配以后，依然在同一个 List 中。 Examples:

 List<Integer> list0 = Arrays.asList(11, 12, 13, 14, 15);
 List<Integer> list1 = Arrays.asList(26);
 List<Integer> list2 = Arrays.asList(57, 58, 59);
 List<Integer> list3 = Arrays.asList(30, 31);
 List<Integer> list4 = Arrays.asList(83, 84, 85);
 List<Integer> list5 = Arrays.asList(71, 72);

 List<List<Integer>> lists = Arrays.asList(list0, list1, list2, list3, list4, list5);

 List<List<Integer>> balance1 = CollectorUtils.balance(3, lists);
 //-- balance1: [[57, 58, 59, 30, 31], [11, 12, 13, 14, 15], [83, 84, 85, 71, 72, 26]]

 List<List<Integer>> balance2 = CollectorUtils.balance(4, lists);
 //-- balance2: [[83, 84, 85], [57, 58, 59, 26], [30, 31, 71, 72], [11, 12, 13, 14, 15]]
 

类型参数:

E - 元素类型

参数:

partitions - 分配后 List 的数量

collections - 待分配的 List 列表

返回:

分配后 List 列表

从以下版本开始:

0.0.2

balance

@SafeVarargs
public static <E> List<List<E>> balance(int partitions,
                                        Collection<E>... listArray)

已过时。

将多个 List 中的元素尽可能均匀分配在指定数量（partitions）的 List 中。 但原来在同一个 List 中的元素，分配以后，依然在同一个 List 中。

类型参数:

E - 元素类型

参数:

partitions - 分配后 List 的数量

listArray - 待分配的 List 数组

返回:

分配后 List 列表

从以下版本开始:

0.0.2

另请参阅:

balance(int, Collection)

balance

@SafeVarargs
public static <E> List<List<E>> balance(int partitions,
                                        E[]... arrays)

已过时。

将多个数组中的元素尽可能均匀分配在指定数量（partitions）的 List 中。 但原来在同一个数组中的元素，分配以后，会在同一个 List 中。

类型参数:

E - 元素类型

参数:

partitions - 分配后 List 的数量

arrays - 待分配的数组

返回:

分配后 List 列表

从以下版本开始:

0.0.2

另请参阅:

balance(int, Collection)

fastSortForBalance

private static <E> void fastSortForBalance(List<Map.Entry<Integer,List<E>>> sortedEntries)

已过时。

Fast Sort For balance(int, Collection)
针对 balance(int, Collection) 方法的快速排序

类型参数:

E - elements type in List

参数:

sortedEntries - sortedEntries

从以下版本开始:

0.0.2

另请参阅:

balance(int, Collection)

findNth

public static <T> T findNth(Collection<T> ts,
                            Predicate<? super T> filter,
                            int nth)

已过时。

从过滤后的集合中获取第n个元素，超出元素范围，则返回 null

类型参数:

T - 集合元素类型

参数:

ts - 集合

filter - 对集合过滤，为 null 时，不过滤

nth - 第n个元素，从 0 开始， 负数 则从最后一个元素开始往前面索引，-1 代表最后一个元素

返回:

过滤后的集合的第n个元素

从以下版本开始:

0.2.2

findNth

public static <T> com.iofairy.tuple.Tuple2<T,Integer> findNth(List<T> ts,
                                                              Predicate<? super T> filter,
                                                              int nth)

已过时。

从过滤后的列表中获取第n个元素及在原列表中的序号，超出元素范围，则返回 null

类型参数:

T - 列表元素类型

参数:

ts - 列表

filter - 对列表过滤，为 null 时，不过滤

nth - 第n个元素，从 0 开始，负数 则从最后一个元素开始往前面索引，-1 代表最后一个元素

返回:

过滤后的列表的第n个元素及序号

从以下版本开始:

0.2.2

findNth

public static <T> com.iofairy.tuple.Tuple2<T,Integer> findNth(T[] ts,
                                                              Predicate<? super T> filter,
                                                              int nth)

已过时。

从获取过滤后的数组中获取第n个元素及在原数组中的序号，超出元素范围，则返回 null

类型参数:

T - 数组元素类型

参数:

ts - 数组

filter - 对数组过滤，为 null 时，不过滤

nth - 第n个元素，从 0 开始，负数 则从最后一个元素开始往前面索引，-1 代表最后一个元素

返回:

过滤后的数组的第n个元素及序号

从以下版本开始:

0.2.2

findRandom

public static <T> T findRandom(Collection<T> ts,
                               Predicate<? super T> filter)

已过时。

从过滤后的集合中随机获取元素

类型参数:

T - 集合元素类型

参数:

ts - 集合

filter - 对集合过滤，为 null 时，不过滤

返回:

过滤后的集合中随机一个元素

从以下版本开始:

0.2.2

findRandom

public static <T> com.iofairy.tuple.Tuple2<T,Integer> findRandom(List<T> ts,
                                                                 Predicate<? super T> filter)

已过时。

从过滤后的列表中随机获取元素及在原列表中的序号

类型参数:

T - 列表元素类型

参数:

ts - 列表

filter - 对列表过滤，为 null 时，不过滤

返回:

过滤后的列表中随机一个元素及序号

从以下版本开始:

0.2.2

findRandom

public static <T> com.iofairy.tuple.Tuple2<T,Integer> findRandom(T[] ts,
                                                                 Predicate<? super T> filter)

已过时。

从过滤后的数组中随机获取元素及在原数组中的序号

类型参数:

T - 数组元素类型

参数:

ts - 数组

filter - 对数组过滤，为 null 时，不过滤

返回:

过滤后的数组中随机一个元素及序号

从以下版本开始:

0.2.2