干货分享 | HZERO系列组件之辅助开发核心包，一招搞定开发！

在项目实施过程中，我们经常遇到这些需求：

场景一：前端页面展示的金额字段格式使用两位小数或千分位表示；

场景二：录入特定字段信息时需要进行校验，如手机、邮箱、IP地址、是否是数字等；

场景三：涉及数据安全的字段，插入数据库时需要加密，读取时解密；

以上举例需求均有以下特点：

在大部分项目中十分常见，即普遍性；

需求都比较简单；

实现方式大同小异，即通用性；

我们在实施HZERO企业级PaaS平台项目中，如果每个项目都需要重新实现且各个项目实现方式均不相同，会带来人力资源浪费、成本高、开发效率低、项目不规范、项目管理混乱等一系列问题；为了解决以上痛点问题，我们推荐使用HZERO的辅助核心开发包。

HZERO辅助开发核心包

简介及作用

该组件主要针对技术开发中进行技术支持，定义了基础实现类，异常封装，常用工具等。

减少重复造轮子
提升开发效率
使项目实施规范化标准化

组件坐标

<dependency>     <groupId>org.hzero.starter</groupId>    <artifactId>hzero-starter-core</artifactId></dependency>

开发者指南

下图是辅助开发核心包的总体支持功能概览，让开发者可以通过该图了解到辅助开发核心包提供的一系列能力。需要大家去发现⇥学习⇥使用

在项目实施交付过程中，优先考虑辅助开发包是否提供所需常量类和工具类，建议形成一套自己的思维习惯。

接下来介绍一些常用的常量类和工具类的使用。

常用常量类使用

基础常量

下图列举了辅助开发核心包已有的基础常量以及对应的类，便于开发者索引。

Hzero-starter-core 基础包中提供了很多常用的常量类和常量定义，在开发中就无需重复定义常量。

常用的如用户、语言常量，符号常量，日期格式常量，错误编码常量，请求头常量等等。

常用数字格式

针对前言中的场景一『前端页面展示的金额字段格式使用两位小数或千分位表示』，使用辅助开发核心包的数字格式常量，可以快速实现需求。

public void demo() {    // 格式化保留两位小数    DecimalFormat format = new DecimalFormat(BaseConstants.Pattern.TWO_DECIMAL);    BigDecimal num = new BigDecimal("10.0001");    String numStr = format.format(num); // 10.00}

public interface BaseConstants {    interface Pattern {        /**         * 无小数位 0         */        String NONE_DECIMAL = "0";        /**         * 一位小数 0.0         */        String ONE_DECIMAL = "0.0";        /**         * 两位小数 0.00         */        String TWO_DECIMAL = "0.00";        /**         * 千分位表示 无小数 #,##0         */        String TB_NONE_DECIMAL = "#,##0";        /**         * 千分位表示 一位小数 #,##0.0         */        String TB_ONE_DECIMAL = "#,##0.0";        /**         * 千分位表示 两位小数 #,##0.00         */        String TB_TWO_DECIMAL = "#,##0.00";    }}

▲常用数字格式

常用时间日期格式

另外列举一些项目常见的格式化场景『格式化时间和解析字符串』和简单Demo。

// SimpleDateFormat 是非线程安全的，可以定义在 ThreadLocal 中final ThreadLocal<SimpleDateFormat> local = ThreadLocal.withInitial(        () -> new SimpleDateFormat(BaseConstants.Pattern.DATETIME));public void demo() throws ParseException {    Date date = new Date();    // Date 格式化成 字符串    String dateStr = local.get().format(date);    // 字符串格式化成 Date    date = local.get().parse(dateStr);}

▲格式化场景使用

public interface BaseConstants {    interface Pattern {        /**         * yyyy-MM-dd         */        String DATE = "yyyy-MM-dd";        /**         * yyyy-MM-dd HH:mm:ss         */        String DATETIME = "yyyy-MM-dd HH:mm:ss";        /**         * yyyy-MM-dd HH:mm         */        String DATETIME_MM = "yyyy-MM-dd HH:mm";        /**         * yyyy-MM-dd HH:mm:ss.SSS         */        String DATETIME_SSS = "yyyy-MM-dd HH:mm:ss.SSS";        /**         * HH:mm         */        String TIME = "HH:mm";        /**         * HH:mm:ss         */        String TIME_SS = "HH:mm:ss";    }}

▲常用时间日期格式

常用工具类使用

Hzero-starter-core 提供了一些常用工具类，下面列举几个例子，建议技术人员先提前了解熟悉，避免重复造轮子。大部分的工具包都在 Org.hzero.core.util包下。

正则Regexs

针对前言中的场景二『录入特定字段信息时需要进行校验，如手机、邮箱、IP地址、是否是数字等』，使用辅助开发核心包的常用工具类(正则Regexs)，可以快速实现需求。

Regexs下提供了一些常用的正则表达式以及正则校验方法，例如数字类、字母类、邮箱、URL、中文、IP地址、图片、日期等等，更多的可自行查看。

public void test() {    // 正则表达式    String integer = Regexs.INTEGER; // 整数    String email = Regexs.EMAIL; // 邮件    String url = Regexs.URL; // URL    String chinese = Regexs.CHINESE; // 中文    // 正则匹配方法    // 判断是否是手机号    boolean isPhone = Regexs.is("185666444", Regexs.MOBILE);    // 判断是否是中文    boolean isChinese = Regexs.is("是否中文", Regexs.CHINESE);    // 判断是否是数字    boolean isNumber = Regexs.isNumber("12345");    // 判断是否是邮箱    boolean isEmail = Regexs.isEmail("[email protected]");    // 判断是否是IP地址    boolean isIp = Regexs.isIP("192.168.12.101");    // 判断是否是URL地址    boolean isUrl = Regexs.isUrl("www.baidu.com");    // 判断是否是移动手机号    boolean isMobile = Regexs.isMobile("18523226666", "+86");}

JsonUtils

JsonUtils提供了几个转换Json字符串和对象的工具方法。

注意：JsonUtils转换的Json对象中如果带有日期类型，转换的结果会带有时区。

public static void main(String[] args) {
    User user = new User();
    // 对象转为json字符串
    String json = JsonUtils.toJson(user);
    // json字符串转为对象
    user = JsonUtils.fromJson(json, User.class);
    List<User> list = new ArrayList<>();
    // 集合转json字符串
    String jsonList = JsonUtils.toJson(list);
    // json字符串转集合
    list = JsonUtils.fromJsonList(jsonList, User.class);
}

Util工具包

针对前言中的场景三『涉及数据安全的字段，插入数据库时需要加密，读取时解密』，使用辅助开发核心包的常用注解(@DataSecurity)+BaseMapper，可以快速实现需求。