提交 8ce152f3 编写于 作者: 如梦技术's avatar 如梦技术 🐛

📝 完善 javadoc,方便生成文档.

上级 0df1332a
...@@ -421,7 +421,7 @@ public class DateUtil { ...@@ -421,7 +421,7 @@ public class DateUtil {
} }
/** /**
* 时间转 Instant * LocalDateTime 转 Instant
* *
* @param dateTime 时间 * @param dateTime 时间
* @return Instant * @return Instant
...@@ -431,7 +431,7 @@ public class DateUtil { ...@@ -431,7 +431,7 @@ public class DateUtil {
} }
/** /**
* Instant 转 时间 * Instant 转 LocalDateTime
* *
* @param instant Instant * @param instant Instant
* @return Instant * @return Instant
...@@ -451,7 +451,7 @@ public class DateUtil { ...@@ -451,7 +451,7 @@ public class DateUtil {
} }
/** /**
* 转换成 date * LocalDateTime 转换成 date
* *
* @param dateTime LocalDateTime * @param dateTime LocalDateTime
* @return Date * @return Date
...@@ -461,7 +461,7 @@ public class DateUtil { ...@@ -461,7 +461,7 @@ public class DateUtil {
} }
/** /**
* 转换成 date * LocalDate 转换成 date
* *
* @param localDate LocalDate * @param localDate LocalDate
* @return Date * @return Date
...@@ -471,7 +471,7 @@ public class DateUtil { ...@@ -471,7 +471,7 @@ public class DateUtil {
} }
/** /**
* Converts local date time to Calendar. * LocalDateTime 转换成 Calendar.
*/ */
public static Calendar toCalendar(final LocalDateTime localDateTime) { public static Calendar toCalendar(final LocalDateTime localDateTime) {
return GregorianCalendar.from(ZonedDateTime.of(localDateTime, ZoneId.systemDefault())); return GregorianCalendar.from(ZonedDateTime.of(localDateTime, ZoneId.systemDefault()));
......
...@@ -38,18 +38,42 @@ public class DecimalNum extends Number { ...@@ -38,18 +38,42 @@ public class DecimalNum extends Number {
this.value = decimal; this.value = decimal;
} }
/**
* 构造 DecimalNum
*
* @param decimal decimal
* @return DecimalNum
*/
public static DecimalNum of(BigDecimal decimal) { public static DecimalNum of(BigDecimal decimal) {
return new DecimalNum(decimal); return new DecimalNum(decimal);
} }
/**
* 构造 DecimalNum
*
* @param decimal decimal
* @return DecimalNum
*/
public static DecimalNum of(String decimal) { public static DecimalNum of(String decimal) {
return of(new BigDecimal(decimal)); return of(new BigDecimal(decimal));
} }
/**
* 构造 DecimalNum
*
* @param decimal decimal
* @return DecimalNum
*/
public static DecimalNum of(double decimal) { public static DecimalNum of(double decimal) {
return of(BigDecimal.valueOf(decimal)); return of(BigDecimal.valueOf(decimal));
} }
/**
* 构造 DecimalNum
*
* @param decimal decimal
* @return DecimalNum
*/
public static DecimalNum of(long decimal) { public static DecimalNum of(long decimal) {
return of(BigDecimal.valueOf(decimal)); return of(BigDecimal.valueOf(decimal));
} }
...@@ -285,26 +309,51 @@ public class DecimalNum extends Number { ...@@ -285,26 +309,51 @@ public class DecimalNum extends Number {
return this; return this;
} }
/**
* intValue
*
* @return 转为 int 值
*/
@Override @Override
public int intValue() { public int intValue() {
return value.intValue(); return value.intValue();
} }
/**
* longValue
*
* @return 转为 long 值
*/
@Override @Override
public long longValue() { public long longValue() {
return value.longValue(); return value.longValue();
} }
/**
* floatValue
*
* @return 转为 float 值
*/
@Override @Override
public float floatValue() { public float floatValue() {
return value.floatValue(); return value.floatValue();
} }
/**
* doubleValue
*
* @return 转为 double 值
*/
@Override @Override
public double doubleValue() { public double doubleValue() {
return value.doubleValue(); return value.doubleValue();
} }
/**
* toString
*
* @return 转为字符串
*/
@Override @Override
public String toString() { public String toString() {
return value.toString(); return value.toString();
......
...@@ -484,6 +484,11 @@ public class JsonUtil { ...@@ -484,6 +484,11 @@ public class JsonUtil {
return getInstance().valueToTree(fromValue); return getInstance().valueToTree(fromValue);
} }
/**
* 获取 ObjectMapper 实例
*
* @return ObjectMapper
*/
public static ObjectMapper getInstance() { public static ObjectMapper getInstance() {
return JacksonHolder.INSTANCE; return JacksonHolder.INSTANCE;
} }
......
...@@ -39,39 +39,66 @@ import java.util.function.Supplier; ...@@ -39,39 +39,66 @@ import java.util.function.Supplier;
@UtilityClass @UtilityClass
public class Unchecked { public class Unchecked {
public static <T, R> Function<T, R> function(CheckedFunction<T, R> mapper) { /**
Objects.requireNonNull(mapper); * 构造受检的 function
*
* @param function CheckedFunction
* @param <T> 泛型
* @return Function
*/
public static <T, R> Function<T, R> function(CheckedFunction<T, R> function) {
Objects.requireNonNull(function);
return t -> { return t -> {
try { try {
return mapper.apply(t); return function.apply(t);
} catch (Throwable e) { } catch (Throwable e) {
throw Exceptions.unchecked(e); throw Exceptions.unchecked(e);
} }
}; };
} }
public static <T> Consumer<T> consumer(CheckedConsumer<T> mapper) { /**
Objects.requireNonNull(mapper); * 构造受检的 supplier
*
* @param consumer CheckedConsumer
* @param <T> 泛型
* @return Consumer
*/
public static <T> Consumer<T> consumer(CheckedConsumer<T> consumer) {
Objects.requireNonNull(consumer);
return t -> { return t -> {
try { try {
mapper.accept(t); consumer.accept(t);
} catch (Throwable e) { } catch (Throwable e) {
throw Exceptions.unchecked(e); throw Exceptions.unchecked(e);
} }
}; };
} }
public static <T> Supplier<T> supplier(CheckedSupplier<T> mapper) { /**
Objects.requireNonNull(mapper); * 构造受检的 supplier
*
* @param supplier CheckedSupplier
* @param <T> 泛型
* @return Supplier
*/
public static <T> Supplier<T> supplier(CheckedSupplier<T> supplier) {
Objects.requireNonNull(supplier);
return () -> { return () -> {
try { try {
return mapper.get(); return supplier.get();
} catch (Throwable e) { } catch (Throwable e) {
throw Exceptions.unchecked(e); throw Exceptions.unchecked(e);
} }
}; };
} }
/**
* 构造受检的 runnable
*
* @param runnable CheckedRunnable
* @return Runnable
*/
public static Runnable runnable(CheckedRunnable runnable) { public static Runnable runnable(CheckedRunnable runnable) {
Objects.requireNonNull(runnable); Objects.requireNonNull(runnable);
return () -> { return () -> {
...@@ -83,6 +110,13 @@ public class Unchecked { ...@@ -83,6 +110,13 @@ public class Unchecked {
}; };
} }
/**
* 构造受检的 callable
*
* @param callable CheckedCallable
* @param <T> 泛型
* @return Callable
*/
public static <T> Callable<T> callable(CheckedCallable<T> callable) { public static <T> Callable<T> callable(CheckedCallable<T> callable) {
Objects.requireNonNull(callable); Objects.requireNonNull(callable);
return () -> { return () -> {
...@@ -94,6 +128,13 @@ public class Unchecked { ...@@ -94,6 +128,13 @@ public class Unchecked {
}; };
} }
/**
* 构造受检的 comparator
*
* @param comparator CheckedComparator
* @param <T> 泛型
* @return Comparator
*/
public static <T> Comparator<T> comparator(CheckedComparator<T> comparator) { public static <T> Comparator<T> comparator(CheckedComparator<T> comparator) {
Objects.requireNonNull(comparator); Objects.requireNonNull(comparator);
return (T o1, T o2) -> { return (T o1, T o2) -> {
......
...@@ -73,11 +73,23 @@ public class XmlHelper { ...@@ -73,11 +73,23 @@ public class XmlHelper {
} }
} }
/**
* 构造 XmlHelper,安全模式
*
* @param is InputStream
* @return XmlHelper
*/
public static XmlHelper safe(InputStream is) { public static XmlHelper safe(InputStream is) {
InputSource inputSource = new InputSource(is); InputSource inputSource = new InputSource(is);
return createSafe(inputSource); return createSafe(inputSource);
} }
/**
* 构造 XmlHelper,安全模式
*
* @param xmlStr xml字符串
* @return XmlHelper
*/
public static XmlHelper safe(String xmlStr) { public static XmlHelper safe(String xmlStr) {
StringReader sr = new StringReader(xmlStr.trim()); StringReader sr = new StringReader(xmlStr.trim());
InputSource inputSource = new InputSource(sr); InputSource inputSource = new InputSource(sr);
...@@ -86,11 +98,23 @@ public class XmlHelper { ...@@ -86,11 +98,23 @@ public class XmlHelper {
return xmlHelper; return xmlHelper;
} }
/**
* 构造 XmlHelper,非安全模式
*
* @param is InputStream
* @return XmlHelper
*/
public static XmlHelper unsafe(InputStream is) { public static XmlHelper unsafe(InputStream is) {
InputSource inputSource = new InputSource(is); InputSource inputSource = new InputSource(is);
return createUnsafe(inputSource); return createUnsafe(inputSource);
} }
/**
* 构造 XmlHelper,非安全模式
*
* @param xmlStr xml字符串
* @return XmlHelper
*/
public static XmlHelper unsafe(String xmlStr) { public static XmlHelper unsafe(String xmlStr) {
StringReader sr = new StringReader(xmlStr.trim()); StringReader sr = new StringReader(xmlStr.trim());
InputSource inputSource = new InputSource(sr); InputSource inputSource = new InputSource(sr);
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册