ZhouXY108
/
plusone-commons
forked from plusone/plusone-commons
1
0
Fork 0
Code Pull Requests Activity

first commit.

feature/net-util
ZhouXY108 2022-11-07 17:49:27 +08:00
commit 0d5eef24e3
9 changed files with 349 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
.gitignore vendored 100644
View File

@ -0,0 +1,35 @@
target/
!.mvn/wrapper/maven-wrapper.jar
!**/src/main/**/target/
!**/src/test/**/target/
### IntelliJ IDEA ###
.idea
*.iws
*.iml
*.ipr
### Eclipse ###
.apt_generated
.classpath
.factorypath
.project
.settings
.springBeans
.sts4-cache
### NetBeans ###
/nbproject/private/
/nbbuild/
/dist/
/nbdist/
/.nb-gradle/
build/
!**/src/main/**/build/
!**/src/test/**/build/
### VS Code ###
.vscode/
### Mac OS ###
.DS_Store

30
pom.xml 100644
View File

@ -0,0 +1,30 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>xyz.zhouxy.plusone</groupId>
<artifactId>plusone-commons</artifactId>
<version>0.0.1-SNAPSHOT</version>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.24</version>
<optional>true</optional>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.13.4</version>
</dependency>
</dependencies>
</project>

13
src/main/java/xyz/zhouxy/plusone/exception/IWithCode.java 100644
View File

@ -0,0 +1,13 @@
package xyz.zhouxy.plusone.exception;
/**
* 规定实现类带有 {@code getCode} 方法。
* 用于像自定义异常等需要带有 {@code code} 字段的类，
* 方便其它地方的程序判断该类的是否实现了此接口，以此获取其实例的 {@code code} 字段的值。
*
* @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
* @see PlusoneException
*/
public interface IWithCode {
int getCode();
}

33
src/main/java/xyz/zhouxy/plusone/exception/PlusoneException.java 100644
View File

@ -0,0 +1,33 @@
package xyz.zhouxy.plusone.exception;
/**
* 项目的基础异常，默认错误码为 9999999
*
* @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
*/
public class PlusoneException extends RuntimeException implements IWithCode {
private static final long serialVersionUID = -2546365325001947203L;
private final int code;
protected PlusoneException(int code, String msg) {
super(msg);
this.code = code;
}
protected PlusoneException(int code, Throwable cause) {
super(cause);
this.code = code;
}
protected PlusoneException(int code, String msg, Throwable cause) {
super(msg, cause);
this.code = code;
}
@Override
public int getCode() {
return this.code;
}
}

91
src/main/java/xyz/zhouxy/plusone/util/EnumUtil.java 100644
View File

@ -0,0 +1,91 @@
package xyz.zhouxy.plusone.util;
import java.util.Objects;
/**
* 枚举工具类
*
* @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
*/
public final class EnumUtil {
private EnumUtil() {
throw new IllegalStateException("Utility class");
}
/**
* 通过 ordinal 获取枚举实例
*
* @param <E> 枚举的类型
* @param clazz 枚举的类型信息
* @param ordinal 数据库中对应的数值
* @return 枚举对象
*/
public static <E extends Enum<?>> E valueOf(Class<E> clazz, int ordinal) {
E[] values = clazz.getEnumConstants();
try {
return values[ordinal];
} catch (IndexOutOfBoundsException e) {
throw new EnumConstantNotPresentException(clazz, Integer.toString(ordinal));
}
}
/**
* 通过 ordinal 获取枚举实例
*
* @param <E> 枚举的类型
* @param clazz 枚举的类型信息
* @param ordinal 数据库中对应的数值
* @return 枚举对象
*/
public static <E extends Enum<?>> E getValueOrDefault(Class<E> clazz, Integer ordinal) {
E[] values = clazz.getEnumConstants();
try {
return Objects.nonNull(ordinal) ? values[ordinal] : values[0];
} catch (IndexOutOfBoundsException e) {
throw new EnumConstantNotPresentException(clazz, Integer.toString(ordinal));
}
}
/**
* 通过 ordinal 获取枚举实例
*
* @param <E> 枚举的类型
* @param clazz 枚举的类型信息
* @param ordinal 数据库中对应的数值
* @return 枚举对象
*/
public static <E extends Enum<?>> E getValueNullable(Class<E> clazz, Integer ordinal) {
E[] values = clazz.getEnumConstants();
try {
return Objects.nonNull(ordinal) ? values[ordinal] : null;
} catch (IndexOutOfBoundsException e) {
throw new EnumConstantNotPresentException(clazz, Integer.toString(ordinal));
}
}
public static <E extends Enum<?>> Integer checkOrdinal(Class<E> clazz, Integer ordinal) {
if (ordinal == null) {
throw new IllegalArgumentException("ordinal 不能为空");
}
E[] values = clazz.getEnumConstants();
if (ordinal >= 0 && ordinal < values.length) {
return ordinal;
}
throw new EnumConstantNotPresentException(clazz, Integer.toString(ordinal));
}
public static <E extends Enum<?>> Integer checkOrdinalNullable(Class<E> clazz, Integer ordinal) {
if (Objects.isNull(ordinal)) {
return null;
}
return checkOrdinal(clazz, ordinal);
}
public static <E extends Enum<?>> Integer checkOrdinalOrDefault(Class<E> clazz, Integer ordinal) {
if (Objects.isNull(ordinal)) {
return 0;
}
return checkOrdinal(clazz, ordinal);
}
}

38
src/main/java/xyz/zhouxy/plusone/util/Enumeration.java 100644
View File

@ -0,0 +1,38 @@
package xyz.zhouxy.plusone.util;
import java.util.Objects;
public abstract class Enumeration<T extends Enumeration<T>> {
protected final int value;
protected final String name;
protected Enumeration(int value, String name) {
this.value = value;
this.name = name;
}
public int getValue() {
return value;
}
public String getName() {
return name;
}
@Override
public int hashCode() {
return Objects.hash(value);
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (getClass() != obj.getClass())
return false;
Enumeration<?> other = (Enumeration<?>) obj;
return value == other.value;
}
}

22
src/main/java/xyz/zhouxy/plusone/util/EnumerationValuesHolder.java 100644
View File

@ -0,0 +1,22 @@
package xyz.zhouxy.plusone.util;
import java.util.HashMap;
import java.util.Map;
public final class EnumerationValuesHolder<T extends Enumeration<T>> {
private final Map<Integer, T> constants = new HashMap<>();
public EnumerationValuesHolder(T[] values) {
for (T value : values) {
put(value);
}
}
private void put(T constant) {
this.constants.put(constant.getValue(), constant);
}
public T get(int value) {
return this.constants.get(value);
}
}

29
src/main/java/xyz/zhouxy/plusone/util/NumberUtil.java 100644
View File

@ -0,0 +1,29 @@
package xyz.zhouxy.plusone.util;
/**
* NumberUtil
*
* @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
*/
public class NumberUtil {
private NumberUtil() {
throw new IllegalStateException("Utility class");
}
public static int sum(int... numbers) {
int result = 0;
for (int number : numbers) {
result += number;
}
return result;
}
public static long sum(long... numbers) {
long result = 0;
for (long number : numbers) {
result += number;
}
return result;
}
}

58
src/main/java/xyz/zhouxy/plusone/util/RestfulResult.java 100644
View File

@ -0,0 +1,58 @@
package xyz.zhouxy.plusone.util;
import com.fasterxml.jackson.annotation.JsonInclude;
import lombok.AccessLevel;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.ToString;
/**
* 对返回给前端的数据进行封装
*
* @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
*/
@JsonInclude(JsonInclude.Include.NON_NULL)
@ToString
@Getter
@AllArgsConstructor(access = AccessLevel.PRIVATE)
public class RestfulResult {
public static final int SUCCESS_STATUS = 2000000;
private final Object status;
private final String message;
private final Object data;
private RestfulResult(Object status, String message) {
this(status, message, null);
}
public static RestfulResult success() {
return new RestfulResult(SUCCESS_STATUS, "操作成功");
}
public static RestfulResult success(String message) {
return new RestfulResult(SUCCESS_STATUS, message);
}
public static RestfulResult success(String message, Object data) {
return new RestfulResult(SUCCESS_STATUS, message, data);
}
public static RestfulResult error() {
return new RestfulResult(500000, "未知错误");
}
public static RestfulResult error(Object status, String message) {
return new RestfulResult(status, message);
}
public static RestfulResult error(Object status, String message, Object data) {
return new RestfulResult(status, message, data);
}
public static RestfulResult error(Object status, Throwable e) {
return new RestfulResult(status, e.getMessage());
}
}