开发背景
在国内,有很多企业,也有很多种开发规范。正如,一千个人心中有一千个哈姆雷特。我也是一个开发人员,曾经我在维护一个老项目,里面有一个名为utils的包,里面躺着几个commonUtils、StringUtils 维护它们的都是老员工,大部分都已经离职了。我刚开始入手的时候,大概就是下面这种情况。
同事维护起来,由于看不懂人家的骚操作。于是又自己创建了一个StringUtil 就因为没有复数的s。然后慢慢的,这个项目的工具类这一块,基本就是非常混乱!!!!再加上小公司是没有这些maven私服这种东西,到后面有引入以下包。
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
</dependency>
<!-- https://mvnrepository.com/artifact/com.google.guava/guava -->
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>28.2-jre</version>
</dependency>
这个项目越来越大,冗余的东西也越来越多!为了解决这个问题,所以开发这款工具包。
正片
1、如何使用?
这款jar包已经发布到maven中心仓库。maven地址 https://mvnrepository.com/artifact/cn.minsin/mutils-core
目前最新版本为0.1.6.RELEASE,只需要添加如下依赖即可使用
<dependency>
<groupId>cn.minsin</groupId>
<artifactId>mutils-core</artifactId>
<version>0.1.6.RELEASE</version>
</dependency>
2、特色亮点(采用物以类聚、人以群分,顾名思义的理念)
1.在constant包中
(1)CronConstant,提供了常用的定时器格式,并支持拓展。
public interface CronConstant {
String EVERY_SECOND = "0/1 * * * * ?";
String EVERY_FIVE_SECOND = "0/5 * * * * ?";
String EVERY_HOUR = "0 0 0/1 * * ?";
String EVERY_MINUTE = "0 */1 * * * ?";
String EVERY_FIVE_MINUTE = "0 */5 * * * ?";
String EVERY_MONTH_FIRST_DAY = "0 0 0 1 * ?";
String EVERY_YEAR = "0 0 1 1 * ?";
String EVERY_DAY = "0 0 0 */1 * ?";
String EVERY_EARLY_MORNING_3 = "0 0 0 */3 * ?";
String EVERY_EARLY_MORNING_4 = "0 0 0 */4 * ?";
}
(2)StringConstant, 提供大量常用的常量字符串,用于帮助判断,并支持拓展。
//提供大量常用的常量字符串,用于帮助判断
public interface StringConstant {
String AMPERSAND = "&";
String AND = "and";
String AT = "@";
String ASTERISK = "*";
String STAR = "*";
String BACK_SLASH = "\\";
String COLON = ":";
String COMMA = ",";
String DASH = "-";
String DOLLAR = "$";
String DOT = ".";
String DOT_DOT = "..";
String DOT_CLASS = ".class";
String DOT_JAVA = ".java";
String DOT_XML = ".xml";
String EMPTY = "";
String EQUALS = "=";
String FALSE = "false";
String SLASH = "/";
String HASH = "#";
String HAT = "^";
String LEFT_BRACE = "{";
String LEFT_BRACKET = "(";
String LEFT_CHEV = "<";
String NEWLINE = "\n";
String N = "n";
String NO = "no";
String NULL = null;
String NULL_STRING = "null";
String OFF = "off";
String ON = "on";
String PERCENT = "%";
String PIPE = "|";
String PLUS = "+";
String QUESTION_MARK = "?";
String EXCLAMATION_MARK = "!";
String QUOTE = "\"";
String RETURN = "\r";
String TAB = "\t";
String RIGHT_BRACE = "}";
String RIGHT_BRACKET = ")";
String RIGHT_CHEV = ">";
String SEMICOLON = ";";
String SINGLE_QUOTE = "'";
String BACKTICK = "`";
String SPACE = " ";
String TILDA = "~";
String LEFT_SQ_BRACKET = "[";
String RIGHT_SQ_BRACKET = "]";
String TRUE = "true";
String UNDERSCORE = "_";
String UTF_8 = "UTF-8";
String US_ASCII = "US-ASCII";
String ISO_8859_1 = "ISO-8859-1";
String Y = "y";
String YES = "yes";
String ONE = "1";
String ZERO = "0";
String DOLLAR_LEFT_BRACE = "${";
String HASH_LEFT_BRACE = "#{";
String CRLF = "\r\n";
String HTML_NBSP = " ";
String HTML_AMP = "&";
String HTML_QUOTE = """;
String HTML_LT = "<";
String HTML_GT = ">";
String[] EMPTY_ARRAY = new String[0];
byte[] BYTES_NEW_LINE = "\n".getBytes();
}
2.在override包中
(1)AutoCloneable 是使用fastjson 用于快速实现Object#clone方法。使用起来只需要将所需要的的类实现该接口即可拥有深浅拷贝功能
//源代码
public interface AutoCloneable<T> extends Serializable, JsonString {
default T deepClone() {
return JSON.parseObject(this.toJsonString(), this.getClass(), new Feature[0]);
}
default T shallowClone() {
return this;
}
}
public class Test implements AutoCloneable<Test>{
//即可实现深浅拷贝 不需要实现
}
(2)FieldCheck 结合cn.minsin.annotation.NotNull注解 实现字段检查。
(3)JsonModel 继承该类后,会将toString()方法重写,之后调用该方法将会变成json字符串
(4)JsonString 实现该类后,将获得一个名为toJsonString()的方法,效果和继承了JsonModel#toString()后相同。
3.在tools包中
(1) ChinaAreaUtil#initProvinceWithChildren 将调用阿里云的省市区经纬度接口 参考 https://blog.csdn.net/jimlong/article/details/84585057
然后生成返回全国地区的级联实体类(一般用于初始化数据库省市区调用一次消耗时间大概在1m左右)
(2) data包下大部分都是时间转换的相关操作(没有做LocalDate、LocalDateTime等jdk8时间相关封装) DateUtil如下
(3) LunarUtil(农历类),该类提供日期转农历,星期的操作,甚至使用该方法后,加以处理即可实现万年历功能
(4) math包中类不建议使用,后期将会标注过期,再次不多做介绍。
(5)ArrayUtil 继承common-lang3 下的org.apache.commons.lang3.ArrayUtils 提供list的相关操作,比如isEmpty,add等
(6)ColorUtil 提供 16进制Color代码转Color类和isColor类
(7)EmojiUtil 提供emoji表情过滤和判断是否包含的相关方法
(8) FileUtil 提供递归删除文件/文件夹,将文件夹复制到另外一个文件夹相关操作
(9)HttpClientUtil 封装了post请求和get请求方法
(10)
未完待续 .......
GitHub地址:https://github.com/mintonzhang/mutils-spring-boot-starter
如果对您的工作有帮助,能帮我点一下小星星(Star)吗?如果对此感兴趣,欢迎fork!
以上内容如果您有兴趣参与或者提出宝贵的意见,请在github中提出issue!