盘点Hutool6.0中新增的那些方法（上）

首发公众号：赵侠客

引言

在前面《使用Hutool要注意了！升级到6.0后你调用的所有方法都将报错》一文中我发现Hutool从5.0升级到6.0后有很多的不兼容，所有的包名都改了，也盘点了很多不兼容的方法，接下几篇文章中我将盘点Hutool6.0里新增加的方法。

二、MapUtil

2.1 MapUtil.ofKvs()

作用： 快速构建出HashMap

@Test
public void testOfKvs() {
    
    
    Map<String, String> hashMap = MapUtil.ofKvs(true, "name", "公众号", "userName", "赵侠客");
    Map<String, String> linkHashMap = MapUtil.ofKvs(false, "name", "公众号", "userName", "赵侠客");
    Assertions.assertInstanceOf(LinkedHashMap.class, hashMap);
    Assertions.assertInstanceOf(HashMap.class, linkHashMap);
}

注意：

• 第一个参数为true时构建出的是LinkedHashMap，false时构建出的是HashMap
• 不像Map.of()构建出的是不可变集合，Hutool的是可变的集合

2.2 MapUtil.removeByValue()

作用： 通过Value删除Map中的元素

@Test
public void  testRemoveByValue(){
    
    
    Map<String, String> hashMap = MapUtil.ofKvs(true, "name", "公众号", "userName", "赵侠客","accountName","赵侠客");
    MapUtil.removeByValue(hashMap, "赵侠客");
    Assertions.assertTrue(hashMap.size()==1);
}

注意：

• 主要解决原生Map只能通过Key删除，不能通过Value删除
• 当有多个value时所有相同的Value都会被删除
• 相比通过Key删除时间复杂为为O(1)，通过Value删除时间复杂度为O(n)

2.3 MapUtil.firstMatchValue()

作用： 通过条件找到第一个满足条件的Value

@Test
public void  testFirstMatchValue() {
    
    
    Map<String, String> hashMap = MapUtil.ofKvs(true, "name", "公众号", "userName", "赵侠客", "accountName", "赵侠客");
    String value = MapUtil.firstMatchValue(hashMap, x -> "userName".equals(x.getKey()));
    Assertions.assertEquals(value,"赵侠客");
}

注意：

• 可能是想解决Map中存储对象时，无法通过对象中的值找到该对象的问题

2.4 MapUtil.firstMatch()

作用： 通过条件找到第一个满足条件的元素

@Test
public void  testFirstMatch() {
    
    
    Map<String, String> hashMap = MapUtil.ofKvs(true, "name", "公众号", "userName", "赵侠客", "accountName", "赵侠客");
    Map.Entry<String,String> stringStringEntry = MapUtil.firstMatch(hashMap, x -> "赵侠客".equals(x.getValue()));
    Assertions.assertEquals(stringStringEntry.getKey(),"userName");
}

注意：

• 和firstMatchValue不同的是返回一个Map.Entry()

三、NumberUtil

3.1 NumberUtil.formatThousands()

作用： 按千分位格式化数字

@Test
public void testFormatThousands(){
    
    
    double num=1003.14159265358979323846;
    String formatNum= NumberUtil.formatThousands(num,2);
    Assertions.assertEquals("1,003.14",formatNum);
}

注意：

• 可以对所有数字类型按千分位格式化

3.2 NumberUtil.parseBigInteger()

作用： 将字符串转成BigInteger

@Test
public void testParseBigInteger(){
    
    
    BigInteger bigNum=new BigInteger("999999999999999999999999999999");
    Assertions.assertEquals(NumberUtil.parseBigInteger("999999999999999999999999999999"),bigNum);
    Assertions.assertEquals(NumberUtil.parseBigInteger("-999999999999999999999999999999"),bigNum.multiply(BigInteger.valueOf(-1)));
    Assertions.assertEquals(NumberUtil.parseBigInteger("0xF"),BigInteger.valueOf(15));
    Assertions.assertEquals(NumberUtil.parseBigInteger("#F"),BigInteger.valueOf(15));
    Assertions.assertEquals(NumberUtil.parseBigInteger("010"),BigInteger.valueOf(8));
}

注意：

• 支持正数及负数
• 默认是十进制，支持十六进制和八进制

3.3 NumberUtil.isZero()

作用： 判断一个数字是否为0

@Test
public void testIsZero(){
    
    
    Integer integerZero=0;
    Long    longZero=0L;
    Byte    byteZero=0;
    Short    shortZero=0;
    BigInteger    bigIntegerZero=BigInteger.valueOf(0);
    Float    floatZero=0.0f;
    Double    doubleZero=0.0d;
    Assertions.assertTrue(NumberUtil.isZero(integerZero));
    Assertions.assertTrue(NumberUtil.isZero(longZero));
    Assertions.assertTrue(NumberUtil.isZero(byteZero));
    Assertions.assertTrue(NumberUtil.isZero(shortZero));
    Assertions.assertTrue(NumberUtil.isZero(bigIntegerZero));
    Assertions.assertTrue(NumberUtil.isZero(floatZero));
    Assertions.assertTrue(NumberUtil.isZero(doubleZero));
}

注意：

• 支持所有的数字类型如Integer、Long、Byte、Short、BigInteger、Float、Double

3.4 NumberUtil.intToRoman()

作用： 将阿拉伯数字转成罗马数字

@Test
public void testIntToRoman(){
    
    
    Assertions.assertEquals(NumberUtil.intToRoman(1),"I");
    Assertions.assertEquals(NumberUtil.intToRoman(2),"II");
    Assertions.assertEquals(NumberUtil.intToRoman(3),"III");
    Assertions.assertEquals(NumberUtil.intToRoman(4),"IV");
    Assertions.assertEquals(NumberUtil.intToRoman(5),"V");
    Assertions.assertEquals(NumberUtil.intToRoman(6),"VI");
    Assertions.assertEquals(NumberUtil.intToRoman(7),"VII");
    Assertions.assertEquals(NumberUtil.intToRoman(10),"X");
    Assertions.assertEquals(NumberUtil.intToRoman(50),"L");
    Assertions.assertEquals(NumberUtil.intToRoman(100),"C");
    Assertions.assertEquals(NumberUtil.intToRoman(500),"D");
    Assertions.assertEquals(NumberUtil.intToRoman(1000),"M");
}

3.5 NumberUtil.romanToInt()

作用： 将罗马数字转成阿拉伯数字

@Test
public void testRomanToInt(){
    
    
    Assertions.assertEquals(NumberUtil.romanToInt("I"),1);
    Assertions.assertEquals(NumberUtil.romanToInt("II"),2);
    Assertions.assertEquals(NumberUtil.romanToInt("III"),3);
    Assertions.assertEquals(NumberUtil.romanToInt("IV"),4);
    Assertions.assertEquals(NumberUtil.romanToInt("V"),5);
    Assertions.assertEquals(NumberUtil.romanToInt("VI"),6);
    Assertions.assertEquals(NumberUtil.romanToInt("VII"),7);
    Assertions.assertEquals(NumberUtil.romanToInt("X"),10);
    Assertions.assertEquals(NumberUtil.romanToInt("L"),50);
    Assertions.assertEquals(NumberUtil.romanToInt("C"),100);
    Assertions.assertEquals(NumberUtil.romanToInt("D"),500);
    Assertions.assertEquals(NumberUtil.romanToInt("M"),1000);
}

四、TimeUtil

4.1 获取每月的开始结束时间

Assertions.assertEquals(TimeUtil.beginOfMonth(LocalDateTime.now()),LocalDateTime.parse("2024-08-01T00:00:00"));
Assertions.assertEquals(TimeUtil.beginOfMonth(LocalDate.now()),LocalDate.parse("2024-08-01"));
Assertions.assertEquals(TimeUtil.endOfMonth(LocalDateTime.now(),true),LocalDateTime.parse("2024-08-31T23:59:59"));
Assertions.assertEquals(TimeUtil.endOfMonth(LocalDate.now()),LocalDate.parse("2024-08-31"));

4.2 获取每年的开始结束时间

Assertions.assertEquals(TimeUtil.beginOfYear(LocalDateTime.now()),LocalDateTime.parse("2024-01-01T00:00:00"));
Assertions.assertEquals(TimeUtil.beginOfYear(LocalDate.now()),LocalDate.parse("2024-01-01"));
Assertions.assertEquals(TimeUtil.endOfYear(LocalDateTime.now(),true),LocalDateTime.parse("2024-12-31T23:59:59"));
Assertions.assertEquals(TimeUtil.endOfYear(LocalDate.now()),LocalDate.parse("2024-12-31"));

4.3 TimeUtil.ofPattern

作用： 从字符串快速生成DateTimeFormatter对象

DateTimeFormatter dateTimeFormatter=TimeUtil.ofPattern("yyyy-MM-dd HH:mm:ss");
//2024-08-05 15:04:24
String now= dateTimeFormatter.format(LocalDateTime.now());

4.4 TimeUtil.max

作用： 获取时分秒最大值

//23:59:59
System.out.println(LocalTimeUtil.max(true));
//23:59:59.999999999
System.out.println(LocalTimeUtil.max(false));

注意：

• 参数传true 毫秒归零
• 参数传false 毫秒为最大值

总结

本文主要介绍了Hutool6.0中MapUtill、NumberUtil、TimeUtil三个工具类中新添加的方法，并给出方法的作用及注意事项，每个方法都给出了详细的单元测试用例。Hutool6.0中还添加了很多其它的方法，未完待续，请关注公众号：赵侠客，持续更新中…