Compare commits

..
Author SHA1 Message Date
minglipro d12fbe0cce no message 2025-09-11 23:59:32 +08:00
minglipro 9d118ed98d no message 2025-09-11 21:32:01 +08:00
minglipro 6b7555d727 no message 2025-09-11 20:49:33 +08:00
8 changed files with 249 additions and 35 deletions
+1 -1
View File
@@ -22,4 +22,4 @@
JDKVERSIONS=1.8
GROUPSID=com.mingliqiye.utils
ARTIFACTID=mingli-utils
VERSIONS=3.2.3
VERSIONS=3.2.6
@@ -0,0 +1,7 @@
/**
*
* AES 加密
* @author MingLiPro
*
*/
package com.mingliqiye.utils.aes;
@@ -23,13 +23,14 @@
package com.mingliqiye.utils.collection;
import com.mingliqiye.utils.stream.SuperStream;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import java.util.function.Predicate;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
/**
* 集合工具类,提供对列表和数组的常用操作方法。
@@ -337,4 +338,10 @@ public class Collection {
) {
return new ArrayList<>(collection);
}
public static <T> SuperStream<T> toSuperStream(
@NotNull java.util.Collection<T> list
) {
return SuperStream.of(list);
}
}
@@ -25,11 +25,9 @@ package com.mingliqiye.utils.collection;
import com.mingliqiye.utils.functions.P1Function;
import com.mingliqiye.utils.functions.P2Function;
import com.mingliqiye.utils.functions.P3Function;
import com.mingliqiye.utils.stream.SuperStream;
import java.util.*;
import java.util.Collection;
import java.util.concurrent.ConcurrentMap;
import java.util.function.Function;
/**
* 集合和映射的增强遍历功能
@@ -46,33 +44,33 @@ import java.util.function.Function;
public class ForEach {
/**
* 对给定的集合执行指定的操作,操作包含元素值和索引。
* 根据集合类型选择最优的遍历方式以提高性能。
* 对给定的可迭代对象执行指定的操作,操作包含元素值和索引。
* 根据可迭代对象类型选择最优的遍历方式以提高性能。
*
* @param collection 要遍历的集合,可以是 List 或其他 Collection 实现
* @param iterable 要遍历的可迭代对象
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
* @param <T> 集合中元素的类型
* @param <T> 可迭代对象中元素的类型
*/
public static <T> void forEach(
Collection<T> collection,
Iterable<T> iterable,
P2Function<? super T, Integer> action
) {
// 参数校验:如果集合或操作为空,则直接返回
if (collection == null || action == null) {
if (iterable == null || action == null) {
return;
}
// 如果集合实现了 RandomAccess 接口(如 ArrayList),使用索引访问优化性能
if (collection instanceof RandomAccess && collection instanceof List) {
List<T> list = (List<T>) collection;
if (iterable instanceof RandomAccess && iterable instanceof List) {
List<T> list = (List<T>) iterable;
for (int i = 0; i < list.size(); i++) {
action.call(list.get(i), i);
}
}
// 如果是普通 List,使用迭代器遍历并手动维护索引
else if (collection instanceof List) {
else if (iterable instanceof List) {
int index = 0;
Iterator<T> it = collection.iterator();
Iterator<T> it = iterable.iterator();
while (it.hasNext()) {
action.call(it.next(), index);
index++;
@@ -81,7 +79,7 @@ public class ForEach {
// 其他类型的集合使用增强 for 循环,并手动维护索引
else {
int index = 0;
for (T element : collection) {
for (T element : iterable) {
action.call(element, index);
index++;
}
@@ -89,37 +87,75 @@ public class ForEach {
}
/**
* 对给定的集合执行指定的操作,仅处理元素值。
* 根据集合是否实现 RandomAccess 接口选择最优的遍历方式。
* 对给定的可迭代对象执行指定的操作,仅处理元素值。
* 根据可迭代对象是否实现 RandomAccess 接口选择最优的遍历方式。
*
* @param collection 要遍历的集合
* @param iterable 要遍历的可迭代对象
* @param action 要对每个元素执行的操作,只接收元素值作为参数
* @param <T> 集合中元素的类型
* @param <T> 可迭代对象中元素的类型
*/
public static <T> void forEach(
Collection<T> collection,
Iterable<T> iterable,
P1Function<? super T> action
) {
// 参数校验:如果集合或操作为空,则直接返回
if (collection == null || action == null) {
if (iterable == null || action == null) {
return;
}
// 如果集合实现了 RandomAccess 接口,使用索引访问提升性能
if (collection instanceof RandomAccess) {
List<T> list = (List<T>) collection;
if (iterable instanceof RandomAccess) {
List<T> list = (List<T>) iterable;
for (int i = 0; i < list.size(); i++) {
action.call(list.get(i));
}
}
// 否则使用增强 for 循环进行遍历
else {
for (T element : collection) {
for (T element : iterable) {
action.call(element);
}
}
}
/**
* 对给定的迭代器执行指定的操作,仅处理元素值。
* @param iterator 要遍历的迭代器
* @param action 要对每个元素执行的操作,只接收元素值作为参数
* @param <T> 迭代器中元素的类型
*/
public static <T> void forEach(
Iterator<T> iterator,
P2Function<? super T, Integer> action
) {
if (iterator == null || action == null) {
return;
}
int index = 0;
while (iterator.hasNext()) {
action.call(iterator.next(), index);
index++;
}
}
/**
* 对给定的迭代器执行指定的操作,处理元素值和索引。
* @param iterator 要遍历的迭代器
* @param action 要对每个元素执行的操作,只接收元素值作为参数
* @param <T> 迭代器中元素的类型
*/
public static <T> void forEach(
Iterator<T> iterator,
P1Function<? super T> action
) {
if (iterator == null || action == null) {
return;
}
while (iterator.hasNext()) {
action.call(iterator.next());
}
}
/**
* 对给定的映射执行指定的操作,操作包含键、值和索引。
* 根据映射类型选择不同的遍历策略。
@@ -25,6 +25,7 @@ package com.mingliqiye.utils.collection;
import com.mingliqiye.utils.functions.P1RFunction;
import com.mingliqiye.utils.functions.P2RFunction;
import com.mingliqiye.utils.functions.P3RFunction;
import java.util.*;
import java.util.Collection;
import java.util.concurrent.ConcurrentMap;
@@ -202,8 +203,7 @@ public class ForEachBreaked {
// 如果是 ConcurrentMap 或 LinkedHashMap,使用其内置的 forEach 方法
else if (map instanceof ConcurrentMap || map instanceof LinkedHashMap) {
forEach(map.entrySet(), i -> {
if (action.call(i.getKey(), i.getValue())) return true;
return false;
return action.call(i.getKey(), i.getValue());
});
}
// 遍历其他类型映射的条目集合
@@ -244,6 +244,48 @@ public class ForEachBreaked {
forEach(action, objects);
}
/**
* 对迭代器执行指定的操作,操作包含元素值和索引
* 当操作返回 true 时,遍历将提前终止。
*
* @param iterator 要遍历的迭代器
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 值决定是否继续遍历
* @param <T> 数组中元素的类型
*/
public static <T> void forEach(
Iterator<T> iterator,
P2RFunction<? super T, Integer, Boolean> action
) {
if (iterator == null || action == null) {
return;
}
int index = 0;
while (iterator.hasNext()) {
if (action.call(iterator.next(), index)) return;
index++;
}
}
/**
* 对迭代器执行指定的操作,操作包含元素值
* 当操作返回 true 时,遍历将提前终止。
*
* @param iterator 要遍历的迭代器
* @param action 要对每个元素执行的操作,接收元素值作为参数,返回 Boolean 值决定是否继续遍历
* @param <T> 数组中元素的类型
*/
public static <T> void forEach(
Iterator<T> iterator,
P1RFunction<? super T, Boolean> action
) {
if (iterator == null || action == null) {
return;
}
while (iterator.hasNext()) {
if (action.call(iterator.next())) return;
}
}
/**
* 对数组执行指定的操作,仅处理元素值
* 当操作返回 true 时,遍历将提前终止。
@@ -272,8 +314,7 @@ public class ForEachBreaked {
T... objects
) {
forEach(Lists.toList(objects), (t, i) -> {
if (action.call(t)) return true;
return false;
return action.call(t);
});
}
@@ -0,0 +1,117 @@
package com.mingliqiye.utils.iterator;
import lombok.Getter;
import org.jetbrains.annotations.NotNull;
import java.util.Iterator;
/**
* 范围 Range<br>
* 类似 KT的 {@code 0..10 = Range.of(0,10)}
* @author MingLiPro
* @since 3.2.6
*/
@Getter
public class Range implements Iterable<Integer> {
private final int start;
private final int end;
private int current;
/**
* 创建一个范围 <br>
* 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
* 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
* @param start 开始 (包含)
* @param end 完毕 (包含)
* @see Integer
*/
public Range(int start, int end) {
this.start = start;
this.current = start;
this.end = end + 1;
}
/**
* 创建一个范围 {@code 0 - range}<br>
* 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
* 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
* @param range 完毕 (包含)
* @see Integer
*/
public Range(int range) {
this(0, range);
}
/**
* 创建一个范围 {@code 0 - range}<br>
* 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
* 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
* @param range 完毕 (包含)
* @see Integer
* @return Range 对象
*/
public static Range of(int range) {
return new Range(range);
}
/**
* 创建一个范围 <br>
* 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
* 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
* @param start 开始 (包含)
* @param end 完毕 (包含)
* @see Integer
* @return Range 对象
*/
public static Range of(int start, int end) {
return new Range(start, end);
}
/**
* 创建一个范围 {@code 0 - range}<br>
* 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
* 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
* @param range 完毕 (包含)
* @see Integer
* @return Range 对象
*/
public static Range range(int range) {
return new Range(range);
}
/**
* 创建一个范围 <br>
* 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
* 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
* @param start 开始 (包含)
* @param end 完毕 (包含)
* @see Integer
* @return Range 对象
*/
public static Range range(int start, int end) {
return new Range(start, end);
}
/**
* 获取迭代器
* @return 迭代器
*/
@Override
public @NotNull Iterator<Integer> iterator() {
return new Iterator<Integer>() {
@Override
public boolean hasNext() {
return current < end;
}
@Override
public Integer next() {
if (current >= end) {
return null;
}
return current++;
}
};
}
}
@@ -1,10 +1,13 @@
package com.mingliqiye.utils.stream;
import java.io.*;
import java.util.List;
import lombok.Getter;
import org.jetbrains.annotations.NotNull;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.List;
public class InputStreanWrapper extends InputStream implements AutoCloseable {
@Getter
@@ -72,9 +75,9 @@ public class InputStreanWrapper extends InputStream implements AutoCloseable {
* jdk8 兼容实现 jdk9+ <br>
* 请使用 InputStream.transferTo()
*
* @param outputStream
* @param outputStream 输出流
* @return 转换的字节数
* @throws IOException
* @throws IOException IO错误
*/
public long transferToOutputStream(OutputStream outputStream)
throws IOException {
@@ -295,8 +295,9 @@ public class SuperStream<T> implements Stream<T> {
*
* @param predicate 谓词函数
* @return SuperStream 实例
* @since 3.2.5
*/
public SuperStream<T> filter(Function<T, Boolean> predicate) {
public SuperStream<T> filterBoolean(Function<T, Boolean> predicate) {
return new SuperStream<>(stream.filter(predicate::apply));
}
@@ -1430,6 +1431,8 @@ public class SuperStream<T> implements Stream<T> {
* 返回一个收集器,将元素收集到 List 中。
*
* @param <T> 元素类型
* @param <K> Map.Key
* @param <V> Map.Value
* @return 收集器
*/
public static <T extends Map.Entry<K, V>, K, V> Collector<