From 77aee971a588b776a4e2cabf8d81db6fcfdf2527 Mon Sep 17 00:00:00 2001 From: Looly Date: Fri, 20 Mar 2020 10:44:11 +0800 Subject: [PATCH] add method for ChineseDate --- CHANGELOG.md | 2 + .../java/cn/hutool/core/date/ChineseDate.java | 48 ++++++- .../java/cn/hutool/core/util/ObjectUtil.java | 42 ++++++ .../cn/hutool/core/date/ChineseDateTest.java | 14 ++ .../src/main/java/cn/hutool/http/Header.java | 121 +++++++++++++----- .../main/java/cn/hutool/http/HttpRequest.java | 16 ++- .../java/cn/hutool/setting/AbsSetting.java | 34 +++-- 7 files changed, 229 insertions(+), 48 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 26d6b3f27..a74bde6e0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,12 +15,14 @@ * 【core 】 增加CallerUtil.getCallerMethodName方法 * 【core 】 Tree增加getParent方法，可以获取父节点，抽象Node接口 * 【core 】 增加社会信用代码工具CreditCodeUtil（pr#112@Gitee） +* 【core 】 ChineseDate增加构造重载，增加toStringNormal（issue#792@Github） ### Bug修复 * 【core 】 修复TypeUtil无法获取泛型接口的泛型参数问题（issue#I1BRFI@Gitee） * 【core 】 修复MySQL中0000报错问题 * 【core 】 修复BeanPath从Map取值为空的问题（issue#790@Github） * 【poi 】 修复添加图片尺寸的单位问题（issue#I1C2ER@Gitee） +* 【setting】 修复getStr中逻辑问题（pr#113@Gitee） ------------------------------------------------------------------------------------------------------------- ## 5.2.3 diff --git a/hutool-core/src/main/java/cn/hutool/core/date/ChineseDate.java b/hutool-core/src/main/java/cn/hutool/core/date/ChineseDate.java index 3af7343d5..09655aa72 100644 --- a/hutool-core/src/main/java/cn/hutool/core/date/ChineseDate.java +++ b/hutool-core/src/main/java/cn/hutool/core/date/ChineseDate.java @@ -131,6 +131,20 @@ public class ChineseDate { day = offset + 1; } + /** + * 构造方法传入日期 + * + * @param chineseYear 农历年 + * @param chineseMonth 农历月，1表示一月（正月） + * @param chineseDay 农历日，1表示初一 + * @since 5.2.4 + */ + public ChineseDate(int chineseYear, int chineseMonth, int chineseDay) { + this.day = chineseDay; + this.month = chineseMonth; + this.year = chineseYear; + this.leap = DateUtil.isLeapYear(chineseYear); + } /** * 获得农历年份 @@ -142,7 +156,17 @@ public class ChineseDate { } /** - * 获得农历月份 + * 获取农历的月，从1开始计数 + * + * @return 农历的月 + * @since 5.2.4 + */ + public int getMonth() { + return this.month; + } + + /** + * 获得农历月份（中文，例如二月，十二月，或者润一月） * * @return 返回农历月份 */ @@ -151,7 +175,7 @@ public class ChineseDate { } /** - * 获得农历月称呼 + * 获得农历月称呼（中文，例如二月，腊月，或者润正月） * * @return 返回农历月份称呼 */ @@ -159,6 +183,16 @@ public class ChineseDate { return (leap ? "闰" : "") + chineseNumberName[month - 1] + "月"; } + /** + * 获取农历的日，从1开始计数 + * + * @return 农历的日，从1开始计数 + * @since 5.2.4 + */ + public int getDay() { + return this.day; + } + /** * 获得农历日 * @@ -230,6 +264,16 @@ public class ChineseDate { return (cyclicalm(num)); } + /** + * 转换为标准的日期格式来表示农历日期，例如2020-01-13 + * + * @return 标准的日期格式 + * @since 5.2.4 + */ + public String toStringNormal(){ + return String.format("%04d-%02d-%02d", this.year, this.month, this.day); + } + @Override public String toString() { return String.format("%s%s年 %s%s", getCyclical(), getChineseZodiac(), getChineseMonthName(), getChineseDay()); diff --git a/hutool-core/src/main/java/cn/hutool/core/util/ObjectUtil.java b/hutool-core/src/main/java/cn/hutool/core/util/ObjectUtil.java index 71edcedb9..69085986d 100644 --- a/hutool-core/src/main/java/cn/hutool/core/util/ObjectUtil.java +++ b/hutool-core/src/main/java/cn/hutool/core/util/ObjectUtil.java @@ -275,6 +275,48 @@ public class ObjectUtil { return (null != object) ? object : defaultValue; } + /** + * 如果给定对象为{@code null}或者 "" 返回默认值 + * + * 
+	 * ObjectUtil.defaultIfEmpty(null, null)      = null
+	 * ObjectUtil.defaultIfEmpty(null, "")        = ""
+	 * ObjectUtil.defaultIfEmpty("", "zz")      = "zz"
+	 * ObjectUtil.defaultIfEmpty(" ", "zz")      = " "
+	 * ObjectUtil.defaultIfEmpty("abc", *)        = "abc"
+	 *
+ * + * @param 对象类型（必须实现CharSequence接口） + * @param str 被检查对象，可能为{@code null} + * @param defaultValue 被检查对象为{@code null}或者 ""返回的默认值，可以为{@code null}或者 "" + * @return 被检查对象为{@code null}或者 ""返回默认值，否则返回原值 + * @since 5.0.4 + */ + public static T defaultIfEmpty(final T str, final T defaultValue) { + return StrUtil.isEmpty(str) ? defaultValue : str; + } + + /** + * 如果给定对象为{@code null}或者""或者空白符返回默认值 + * + * 
+	 * ObjectUtil.defaultIfEmpty(null, null)      = null
+	 * ObjectUtil.defaultIfEmpty(null, "")        = ""
+	 * ObjectUtil.defaultIfEmpty("", "zz")      = "zz"
+	 * ObjectUtil.defaultIfEmpty(" ", "zz")      = "zz"
+	 * ObjectUtil.defaultIfEmpty("abc", *)        = "abc"
+	 *
+ * + * @param 对象类型（必须实现CharSequence接口） + * @param str 被检查对象，可能为{@code null} + * @param defaultValue 被检查对象为{@code null}或者 ""或者空白符返回的默认值，可以为{@code null}或者 ""或者空白符 + * @return 被检查对象为{@code null}或者 ""或者空白符返回默认值，否则返回原值 + * @since 5.0.4 + */ + public static T defaultIfBlank(final T str, final T defaultValue) { + return StrUtil.isBlank(str) ? defaultValue : str; + } + /** * 克隆对象
* 如果对象实现Cloneable接口，调用其clone方法
diff --git a/hutool-core/src/test/java/cn/hutool/core/date/ChineseDateTest.java b/hutool-core/src/test/java/cn/hutool/core/date/ChineseDateTest.java index e7a9dcafb..90ca8bb4b 100644 --- a/hutool-core/src/test/java/cn/hutool/core/date/ChineseDateTest.java +++ b/hutool-core/src/test/java/cn/hutool/core/date/ChineseDateTest.java @@ -9,9 +9,15 @@ public class ChineseDateTest { public void chineseDateTest() { ChineseDate date = new ChineseDate(DateUtil.parseDate("2020-01-25")); Assert.assertEquals(2020, date.getChineseYear()); + + Assert.assertEquals(1, date.getMonth()); Assert.assertEquals("一月", date.getChineseMonth()); Assert.assertEquals("正月", date.getChineseMonthName()); + + + Assert.assertEquals(1, date.getDay()); Assert.assertEquals("初一", date.getChineseDay()); + Assert.assertEquals("庚子", date.getCyclical()); Assert.assertEquals("鼠", date.getChineseZodiac()); Assert.assertEquals("春节", date.getFestivals()); @@ -21,5 +27,13 @@ public class ChineseDateTest { Assert.assertEquals("己亥猪年 腊月二十", date.toString()); date = new ChineseDate(DateUtil.parseDate("2020-01-24")); Assert.assertEquals("己亥猪年 腊月三十", date.toString()); + + Assert.assertEquals("2019-12-30", date.toStringNormal()); + } + + @Test + public void toStringNormalTest(){ + ChineseDate date = new ChineseDate(DateUtil.parseDate("2020-03-1")); + Assert.assertEquals("2020-02-08", date.toStringNormal()); } } diff --git a/hutool-http/src/main/java/cn/hutool/http/Header.java b/hutool-http/src/main/java/cn/hutool/http/Header.java index e0f785c7d..3ff1ef0f3 100644 --- a/hutool-http/src/main/java/cn/hutool/http/Header.java +++ b/hutool-http/src/main/java/cn/hutool/http/Header.java @@ -2,72 +2,131 @@ package cn.hutool.http; /** * Http 头域 - * @author Looly * + * @author Looly */ public enum Header { - + //------------------------------------------------------------- 通用头域 - /**提供日期和时间标志,说明报文是什么时间创建的*/ + /** + * 提供验证头 + */ + AUTHORIZATION("Authorization"), + /** + * 提供日期和时间标志,说明报文是什么时间创建的 + */ DATE("Date"), - /**允许客户端和服务器指定与请求/响应连接有关的选项*/ + /** + * 允许客户端和服务器指定与请求/响应连接有关的选项 + */ CONNECTION("Connection"), - /**给出发送端使用的MIME版本*/ + /** + * 给出发送端使用的MIME版本 + */ MIME_VERSION("MIME-Version"), - /**如果报文采用了分块传输编码(chunked transfer encoding) 方式,就可以用这个首部列出位于报文拖挂(trailer)部分的首部集合*/ + /** + * 如果报文采用了分块传输编码(chunked transfer encoding) 方式,就可以用这个首部列出位于报文拖挂(trailer)部分的首部集合 + */ TRAILER("Trailer"), - /**告知接收端为了保证报文的可靠传输,对报文采用了什么编码方式*/ + /** + * 告知接收端为了保证报文的可靠传输,对报文采用了什么编码方式 + */ TRANSFER_ENCODING("Transfer-Encoding"), - /**给出了发送端可能想要"升级"使用的新版本和协议*/ + /** + * 给出了发送端可能想要"升级"使用的新版本和协议 + */ UPGRADE("Upgrade"), - /**显示了报文经过的中间节点*/ + /** + * 显示了报文经过的中间节点 + */ VIA("Via"), - /**指定请求和响应遵循的缓存机制*/ + /** + * 指定请求和响应遵循的缓存机制 + */ CACHE_CONTROL("Cache-Control"), - /**用来包含实现特定的指令，最常用的是Pragma:no-cache。在HTTP/1.1协议中，它的含义和Cache- Control:no-cache相同*/ + /** + * 用来包含实现特定的指令，最常用的是Pragma:no-cache。在HTTP/1.1协议中，它的含义和Cache- Control:no-cache相同 + */ PRAGMA("Pragma"), - /**请求表示提交内容类型或返回返回内容的MIME类型*/ + /** + * 请求表示提交内容类型或返回返回内容的MIME类型 + */ CONTENT_TYPE("Content-Type"), - + //------------------------------------------------------------- 请求头域 - /**指定请求资源的Intenet主机和端口号，必须表示请求url的原始服务器或网关的位置。HTTP/1.1请求必须包含主机头域，否则系统会以400状态码返回*/ + /** + * 指定请求资源的Intenet主机和端口号，必须表示请求url的原始服务器或网关的位置。HTTP/1.1请求必须包含主机头域，否则系统会以400状态码返回 + */ HOST("Host"), - /**允许客户端指定请求uri的源资源地址，这可以允许服务器生成回退链表，可用来登陆、优化cache等。他也允许废除的或错误的连接由于维护的目的被 追踪。如果请求的uri没有自己的uri地址，Referer不能被发送。如果指定的是部分uri地址，则此地址应该是一个相对地址*/ + /** + * 允许客户端指定请求uri的源资源地址，这可以允许服务器生成回退链表，可用来登陆、优化cache等。他也允许废除的或错误的连接由于维护的目的被 追踪。如果请求的uri没有自己的uri地址，Referer不能被发送。如果指定的是部分uri地址，则此地址应该是一个相对地址 + */ REFERER("Referer"), - /** 指定请求的域 */ + /** + * 指定请求的域 + */ ORIGIN("Origin"), - /**HTTP客户端运行的浏览器类型的详细信息。通过该头部信息，web服务器可以判断到当前HTTP请求的客户端浏览器类别*/ + /** + * HTTP客户端运行的浏览器类型的详细信息。通过该头部信息，web服务器可以判断到当前HTTP请求的客户端浏览器类别 + */ USER_AGENT("User-Agent"), - /**指定客户端能够接收的内容类型，内容类型中的先后次序表示客户端接收的先后次序*/ + /** + * 指定客户端能够接收的内容类型，内容类型中的先后次序表示客户端接收的先后次序 + */ ACCEPT("Accept"), - /**指定HTTP客户端浏览器用来展示返回信息所优先选择的语言*/ + /** + * 指定HTTP客户端浏览器用来展示返回信息所优先选择的语言 + */ ACCEPT_LANGUAGE("Accept-Language"), - /**指定客户端浏览器可以支持的web服务器返回内容压缩编码类型*/ + /** + * 指定客户端浏览器可以支持的web服务器返回内容压缩编码类型 + */ ACCEPT_ENCODING("Accept-Encoding"), - /**浏览器可以接受的字符编码集*/ + /** + * 浏览器可以接受的字符编码集 + */ ACCEPT_CHARSET("Accept-Charset"), - /**HTTP请求发送时，会把保存在该请求域名下的所有cookie值一起发送给web服务器*/ + /** + * HTTP请求发送时，会把保存在该请求域名下的所有cookie值一起发送给web服务器 + */ COOKIE("Cookie"), - /**请求的内容长度*/ + /** + * 请求的内容长度 + */ CONTENT_LENGTH("Content-Length"), - + //------------------------------------------------------------- 响应头域 - /**Cookie*/ + /** + * 提供WWW验证响应头 + */ + WWW_AUTHENTICATE("WWW-Authenticate"), + /** + * Cookie + */ SET_COOKIE("Set-Cookie"), - /**Content-Encoding*/ + /** + * Content-Encoding + */ CONTENT_ENCODING("Content-Encoding"), - /**Content-Disposition*/ + /** + * Content-Disposition + */ CONTENT_DISPOSITION("Content-Disposition"), - /**ETag*/ + /** + * ETag + */ ETAG("ETag"), - /** 重定向指示到的URL */ + /** + * 重定向指示到的URL + */ LOCATION("Location"); - + private String value; + Header(String value) { this.value = value; } - + @Override public String toString() { return value; diff --git a/hutool-http/src/main/java/cn/hutool/http/HttpRequest.java b/hutool-http/src/main/java/cn/hutool/http/HttpRequest.java index 74b39ee33..d8ffbdbfd 100644 --- a/hutool-http/src/main/java/cn/hutool/http/HttpRequest.java +++ b/hutool-http/src/main/java/cn/hutool/http/HttpRequest.java @@ -957,12 +957,20 @@ public class HttpRequest extends HttpBase { public HttpRequest basicAuth(String username, String password) { final String data = username.concat(":").concat(password); final String base64 = Base64.encode(data, charset); - - header("Authorization", "Basic " + base64, true); - - return this; + return auth("Basic " + base64); } + /** + * 验证，简单插入Authorization头 + * + * @param content 验证内容 + * @return HttpRequest + * @since 5.2.4 + */ + public HttpRequest auth(String content) { + header(Header.AUTHORIZATION, content, true); + return this; + } // ---------------------------------------------------------------- Private method start /** diff --git a/hutool-setting/src/main/java/cn/hutool/setting/AbsSetting.java b/hutool-setting/src/main/java/cn/hutool/setting/AbsSetting.java index 508ee45f8..8e6e7b350 100644 --- a/hutool-setting/src/main/java/cn/hutool/setting/AbsSetting.java +++ b/hutool-setting/src/main/java/cn/hutool/setting/AbsSetting.java @@ -8,6 +8,7 @@ import cn.hutool.core.bean.copier.CopyOptions; import cn.hutool.core.bean.copier.ValueProvider; import cn.hutool.core.convert.Convert; import cn.hutool.core.getter.OptNullBasicTypeFromStringGetter; +import cn.hutool.core.util.ObjectUtil; import cn.hutool.core.util.ReflectUtil; import cn.hutool.core.util.StrUtil; import cn.hutool.log.Log; @@ -42,14 +43,25 @@ public abstract class AbsSetting implements OptNullBasicTypeFromStringGetter * 只支持基本类型的转换 * - * @param Bean类型 + * @param Bean类型 * @param group 分组 * @param bean Bean对象 * @return Bean @@ -292,9 +304,9 @@ public abstract class AbsSetting implements OptNullBasicTypeFromStringGetter * 只支持基本类型的转换 * - * @param Bean类型 - * @param group 分组 - * @param beanClass Bean类型 + * @param Bean类型 + * @param group 分组 + * @param beanClass Bean类型 * @return Bean * @since 5.0.6 */ @@ -306,7 +318,7 @@ public abstract class AbsSetting implements OptNullBasicTypeFromStringGetter * 只支持基本类型的转换 * - * @param bean类型 + * @param bean类型 * @param bean Bean * @return Bean */ @@ -318,7 +330,7 @@ public abstract class AbsSetting implements OptNullBasicTypeFromStringGetter * 只支持基本类型的转换 * - * @param bean类型 + * @param bean类型 * @param beanClass Bean类型 * @return Bean * @since 5.0.6