Java开发基础工具包

Java常用工具类整合

一、引入依赖

<dependency>
  <groupId>cn.gjing</groupId>
  <artifactId>tools-common</artifactId>
  <version>1.6.2</version>
</dependency>

二、允许跨域:

开启全局允许跨域, 在启动类或者任意类使用@EnableCors注解即可，会走默认配置，也可以自定义配置，配置示例如下：

• yml方式

tools:
  common:
    cors:
      # 支持的方法类型
      allowed-methods: POST,GET,DELETE,PUT,OPTIONS
      # 支持的请求头
      allowed-headers:
      # 支持的域名
      allowed-origins:
      # 方法路径
      path: /**
      max-age: 1800

• javaBean方式

/**
 * @author Gjing
 **/
@Configuration
public class CorsConfiguration {
    @Bean
    public CorsBean corsBean() {
        CorsBean corsBean = new CorsBean();
        corsBean.setAllowedMethods(new String[]{"POST"});
        return corsBean;
    }
}

三、结果bean:

1、ResultVO

通用返回结果模板

2、PageResult

分页查询返回结果集

3、ErrorResult

错误返回模板

四、参数校验工具类：

主要提供参数校验、处理,匹配等等， 使用时通过ParamUtils.xxx()使用，以下为该工具的所有方法介绍 :

1、isEmpty

判断给定参数是否为空，可以是字符串、包装类型、数组、集合等

2、isNotEmpty

判断给定是否不为空，可以是字符串、包装类型、数组、集合等

3、requireNotNull

该参数不能为空，为空抛出NPE，否则返回原值

4、ListHasEmpty

判断集合里是否含有空值

5、multiEmpty

检查多个参数里面是否有空值

6、equals

判断两个参数是否相等

7、trim

去除字符串的空格

8、trim

去除集合中的空元素

9、removeSymbol

移除字符串两边的指定符号

10、removeStartSymbol

移除字符串开始的指定符号

11、removeEndSymbol

移除字符串末尾的指定符号

12、split

根据符号截取

13、removeAllSymbol

移除字符串里的所有指定符号

14、contains

判断数组里是否包含指定的值

15、isEmail

判断是否为email

16、isMobileNumber

判断是否是手机号码

17、isTelPhone

判断是不是电话号码

18、isPostCode

判断是否为邮编

五、时间工具类：

对时间进行操作，使用时通过TimeUtils.xxx()调用，该工具的所有方法介绍如下 :

六、加密工具类

1、EncryptionUtils：

• EncryptionUtils.encodeMd5()：MD5加密
• EncryptionUtils.encodeBase64()：Base64加密
• EncryptionUtils.decodeBase64()：Base64解密

2、ShaUtils:

• ShaUtils.encodeSha256Hmac()：Sha356Hmac加密
• ShaUtils.sha1Hmac()：sha1Hmac加密

3、AesUtils:

• AesUtils.encode()：AES加密
• AesUtils.decode()：AES解密

七、随机数工具类

用于随机生成数字或字符串，使用时通过RandomUtils.xxx()调用，该工具包含的所有方法如下 :

• RandomUtils.randomInt()：获取随机整数，可设置最大值和最小值
• RandomUtils.getRandom()：获取一个Random实例
• RandomUtils.generateMixString()：生成混合指定长度字符串（数字、字母大小写）
• RandomUtils.generateString()：获取指定长度纯字符串（字母大小写）
• RandomUtils.generateNumber()：获取指定长度数字字符串

八、Bean工具类

使用时通过BeanUtils.xxx()调用

1、copyProperties

属性复制，用于将一个对象的属性赋值到另一个对象，两个对象间的参数名和数据类型必须相同
参数说明

2、toBean

将map转为bean对象
参数说明

3、findMethod

查找类中的方法
参数说明

4、findDeclaredMethod

查找类中声明的方法
参数说明

5、setFieldValue

给类中的某个字段设置值
参数说明

6、getFieldValue

获取某个字段的值
参数说明

7、toMap

将bean对象转为map
参数说明

8、getInterfaceType

获取泛型接口中某个泛型的真实对象class
参数说明

9、getGenericType

获取某个泛型字段的真实对象class
参数说明

九、唯一ID生成工具类

**项目中使用可以将IdUtils注册为一个bean以在其他地方进行依赖注入, 或者将其设置为静态的, 不要出现重复的IdUtils对象, 否则并发情况下会出现重复,
如果要调用snowId, 必须通过带参数的构造方法进行创建实例**

1、uuid

获取去除-符号的uuid

public class Test{
    public static void main(String[] args){
      IdUtils idUtils = new IdUtils();
      System.out.println(idUtils.uuid());
    }
}

2、snowId

得到一个唯一的ID，在多服务需要操作同一个数据表的情况下, 需要保证每个服务的centerId和machineId唯一

public class Test{
    public static void main(String[] args){
      IdUtils idUtils = new IdUtils(1,2);
      for(int i = 0; i < 100; i++) {
        System.out.println(idUtils.snowId());
      }
    }
}

十、邮件工具类

用于发送邮件，支持普通邮件和带附件邮件,支持html格式文本,支持群发和抄送,返回true为发送成功，使用时通过EmailUtils.of()生成实例之后在进行其中的方法，of()方法参数如下 :

该工具包含的所有方法如下 :

1、sendEmail

发送邮件，参数如下：

完整示例如下 :

public class Test{
    public static void main(String[] args) {
        boolean b = EmailUtil.of("smtp.qq.com", "发送人密码或者授权码", "发送人邮箱")
                .sendEmail("主题", "内容",new String[]{"附件物理地址"},"收件人邮箱地址", "抄送人邮箱地址");
        if (b) {
            System.out.println("发送成功");
        }
    }
}

十一、二维码工具类

二维码工具类, 包含的所有方法如下 :

1、create()

根据文本内容，自定义宽度高度，自定义图片格式，自定义配置信息，生成所需要的二维码图片，所有参数如下

2、createWithLogo()

自定义生成带logo的二维码图片，所有参数如下：

3、read(String filePath)

解析二维码,获取其中文本信息

参数说明

4、read(InputStream inputStream)

解析二维码,获取其中的文本信息

参数说明

5、read(String filePath, Map decodeHints)

自定义配置解析二维码,获取其中的文本信息

参数说明

6、read(InputStream inputStream, Map decodeHints)

自定义配置解析二维码,获取其中的文本信息

参数说明

十二、验证码工具类

用于生成英文和数字混合的验证码，使用时通过构造AuthCodeUtils在进行调用其中的方法，构造时参数如下 :

该工具下的所有方法如下:

1、writeToLocal

生成验证码到本地，案例如下

public class Test{
    public static void main(String[] args) {
        AuthCodeUtil authCodeUtil = new AuthCodeUtil(160,40,5,150);
        try {
            String path="/文件夹路径/code.png";
            //写入到本地时可以通过getCode()方法获取生成的验证码
            String code = authCodeUtil.writeToLocal(path).getCode();
            System.out.println(code);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

2、getCode

获取生成的验证码字符

public class Test{
    public static void main(String[] args){
      String code = authCodeUtil.writeToLocal(xxx).getCode;
      System.out.println(code);
    }
}

3、write

以流的方式返回给前端，案例如下

public class Test{
    @GetMapping("/code")
    public void getCode(HttpServletResponse response, HttpServletRequest request) throws IOException {
        AuthCodeUtil authCodeUtil = new AuthCodeUtil(100, 50, 4, 50);
        response.setContentType("image/jpeg");
        //禁止图像缓存
        response.setHeader("param", "no-cache");
        response.setDateHeader("Expires", 0);
        authCodeUtil.write(response.getOutputStream());
    }
}

十三、Spring Bean工具类

获取Spring Bean和ApplicationContext

1、获取Bean

public class Test{
    @GetMapping("/test")
    public void test(){
        //通过class获取
        Test test = SpringBeanUtils.getBean(Test.class);
        //通过bean name获取
        Object o = SpringBeanUtils.getBean("test");
    }
}

2、获取ApplicationContext

public class Test{
    private ApplicationContext applicationContext;
    
    public Test(){
        this.applicationContext = SpringBeanUtils.getApplicationContext();
    }
}

工具源码地址：tools-common