Apache-Commons-* 字元串 判斷字元串是否為空白字元串 以前判斷字元串是否為空: if ((name == null) || (name.isEmpty())){} 使用 apache-common-lang3 的 StringUtils: void testIsBlank() { / ...
Apache-Commons-*
字元串
判斷字元串是否為空白字元串
以前判斷字元串是否為空:
if ((name == null) || (name.isEmpty())){}
使用 apache-common-lang3
的 StringUtils
:
void testIsBlank() {
// true
Assertions.assertTrue(StringUtils.isBlank(" "));
// true
Assertions.assertTrue(StringUtils.isBlank(""));
// true
Assertions.assertTrue(StringUtils.isBlank(null));
// false
Assertions.assertFalse(StringUtils.isBlank("foo"));
// true
Assertions.assertTrue(StringUtils.isAnyBlank(null, " "));
// false
Assertions.assertFalse(StringUtils.isAnyBlank("foo", " bar "));
}
左邊填充字元串
有時候我們需要生成流水號,例如4位數的流水號,從1
開始其餘用字元'0'
填充,就可以使用 leftPad
方法,示例如下:
@Test
void testLeftPad() {
// 0001
Assertions.assertEquals("0001", StringUtils.leftPad("1", 4, '0'));
}
右邊填充字元串
@Test
void testRightPad() {
// 1000
Assertions.assertEquals("1000", StringUtils.rightPad("1", 4, '0'));
}
分割字元串
// ["a","b","c"]
Assertions.assertEquals(Arrays.toString(new String[]{"a", "b", "c"}), Arrays.toString(StringUtils.split("a,b,c", ",")));
字元串比較
// true
Assertions.assertTrue(StringUtils.equals(null, null));
// false
Assertions.assertFalse(StringUtils.equals("null", null));
字元串已指定子字元串開頭
@Test
void testStartWith() {
// true
Assertions.assertTrue(StringUtils.startsWith("hello,world", "hello"));
// false
Assertions.assertFalse(StringUtils.startsWith("你好,世界", "世界"));
}
數值工具類
轉換為 int 類型
將字元串轉換為 int
類型,toInt(String str)
在轉換失敗的時候會返回預設值 0
,如果需要指定預設值那麼可以使用 toInt(final String str, final int defaultValue)
:
@Test
void testToInt() {
// 0
Assertions.assertEquals(0, NumberUtils.toInt("abc"));
// 0
Assertions.assertEquals(0, NumberUtils.toInt("01c"));
// 0
Assertions.assertEquals(0, NumberUtils.toInt("1a3"));
// 1
Assertions.assertEquals(1, NumberUtils.toInt("foo", 1));
// 11
Assertions.assertEquals(11, NumberUtils.toInt("11"));
// 11
Assertions.assertEquals(11, NumberUtils.toInt("011", 3));
}
數組
判斷數組是否為空
@Test
void testIsEmpty() {
// true
Assertions.assertTrue(ArrayUtils.isEmpty(new Object[]{}));
// false
Assertions.assertFalse(ArrayUtils.isEmpty(new String[]{"foo"}));
}
日期
增加指定天數
除了增加指定的天數,common-lang3
還提供了:
addHours
:增加指定小時addMonths
:增加指定月數- 等...
@Test
void testAddDay() {
Date now = new Date();
Date tomorrow = DateUtils.addDays(now, 1);
Assertions.assertEquals(1, Duration.ofMillis(tomorrow.getTime() - now.getTime()).toDays());
Assertions.assertEquals(Duration.ofDays(1).toMillis(), Duration.ofMillis(tomorrow.getTime() - now.getTime()).toMillis());
}
格式化日期
tring pattern = "yyyy-MM-dd HH:mm:ss";
Date d1 = DateUtils.parseDate("2022-10-22 00:00:00", pattern);
Assertions.assertEquals("2022-10-22 00:00:00", DateFormatUtils.format(d1, pattern));
判斷是否為同一天
String parsePattern = "yyyy-MM-dd HH:mm:ss";
Date d1 = DateUtils.parseDate("2022-10-22 00:00:00", parsePattern);
Date d2 = DateUtils.parseDate("2022-10-22 23:59:59", parsePattern);
// true
Assertions.assertTrue(DateUtils.isSameDay(d1, d2));
d1 = DateUtils.parseDate("2022-10-23 00:00:00", parsePattern);
d2 = DateUtils.parseDate("2022-10-22 00:00:00", parsePattern);
// false
Assertions.assertFalse(DateUtils.isSameDay(d1, d2));
枚舉
@Test
void testGetEnum() {
Assertions.assertThrowsExactly(IllegalArgumentException.class, () -> Season.valueOf("Spring"));
// 預設返回null,不拋出異常
Assertions.assertNull(EnumUtils.getEnum(Season.class, "spring"));
// 指定預設值
Assertions.assertEquals(Season.SPRING, EnumUtils.getEnumIgnoreCase(Season.class, "spring"));
// 忽略大小寫匹配
Assertions.assertEquals(Season.SPRING, EnumUtils.getEnum(Season.class, "spring", Season.SPRING));
}
enum Season {
SPRING,
}
Guava
分割字元串
在瞭解 Guava
提供的字元串分割器之前,我們先來看看 Java
提供的字元串分隔有什麼缺點,如下所示,輸出的結果為:
",a,,b,".split(",")
"", "a", "", "b", ""
null, "a", null, "b", null
"a", null, "b"
"a", "b"
- 以上都不對
正確輸出結果是 [, a, , b]
,答案是選項5:“以上都不對”。Splitter
不僅實現了字元串分隔,還提供了對應的修飾符,即對拆分結果進行處理,例如:
String str = "foo, bar ,,,baz";
// ["foo","bar","baz"]
Splitter.on(",")
.trimResults()
.omitEmptyStrings()
.splitToList(str);
// [上下上下左, 左, 右右]
str = "baba上下上下左a左b右右";
res = Splitter.on(CharMatcher.inRange('a', 'b'))
.trimResults()
.omitEmptyStrings()
.splitToList(str);
// [上下上下左, 左, 右右]
log.info("{}", res);
拆分器工廠
方法 | 描述 | 示例 |
---|---|---|
Splitter.on(char) |
按單個字元拆分 | Splitter.on(','); |
Splitter.on(CharMatcher) |
按字元匹配器拆分 | Splitter.on(CharMatcher.inRange('a', 'b')) |
Splitter.on(String) |
按字元串拆分 | Splitter.on(", ") |
Splitter.on(Pattern)或onPattern(String) |
按正則表達式拆分 | Splitter.on("\r?\n ") |
Splitter.fixedLength(int) |
按固定長度拆分;最後一段可能比給定長度短,但不會為空。 | Splitter.fixedLength(3) |
拆分器修飾符
方法 | 描述 |
---|---|
omitEmptyStrings() |
從結果中自動忽略空白字元串 |
trimResults() |
移除結果字元串的首位空白字元 |
trimResults(CharMatcher) |
給定匹配器,移除結果字元串的首位匹配字元 |
limit(int) |
限制拆分出的字元串數量 |
不可變集合
public static final ImmutableSet<String> COLOR_NAMES = ImmutableSet.of(
"red",
"orange",
"yellow",
"green",
"blue",
"purple");
class Foo {
Set<Bar> bars;
Foo(Set<Bar> bars) {
this.bars = ImmutableSet.copyOf(bars); // defensive copy!
}
}
不可變對象有很多的優點:
- 當對象被不可信的庫調用時,不可變形式是安全的;
- 不可變對象被多個線程調用時,不存在競態條件問題
- 不可變集合不需要考慮變化,因此可以節省時間和空間。所有不可變的集合都比它們的可變形式有更好的記憶體利用率(分析和測試細節);
- 不可變對象因為有固定不變,可以作為常量來安全使用。
使用不可變集合
不可變集合可以用如下多種方式創建:
copyOf
:ImmutableList.copyOf
of
:ImmutableList.of("a","b","c")
Builder
工具,例如:
public static final ImmutableSet<Color> GOOGLE_COLORS =
ImmutableSet.<Color>builder()
.addAll(WEBSAFE_COLORS)
.add(new Color(0, 191, 255))
.build();
連接字元串
@Test
void testJoin() {
// foo,bar
Assertions.assertEquals("foo,bar", Joiner.on(',').join(ImmutableList.of("foo", "bar")));
// foo
Assertions.assertEquals("foo", Joiner.on(',').skipNulls().join("foo", null));
// foo,empty
Assertions.assertEquals("foo,empty", Joiner.on(',').useForNull("empty").join("foo", null));
// 拋出空指針異常
Assertions.assertThrowsExactly(NullPointerException.class, () -> Joiner.on(',').join("foo", null));
}
警告:joiner實例總是不可變的。用來定義joiner目標語義的配置方法總會返回一個新的joiner實例。這使得joiner實例都是線程安全的,你可以將其定義為static final常量。
Strings
將 null
轉換為空字元串:
Assertions.assertEquals("", Strings.nullToEmpty(null));
將空字元串轉換為 null
:
Assertions.assertEquals(null, Strings.emptyToNull(""));
Assertions.assertEquals(null, Strings.emptyToNull(null));
CharMatcher
String noControl = CharMatcher.JAVA_ISO_CONTROL.removeFrom(string); //移除control字元
String theDigits = CharMatcher.DIGIT.retainFrom(string); //只保留數字字元
String spaced = CharMatcher.WHITESPACE.trimAndCollapseFrom(string, ' ');
//去除兩端的空格,並把中間的連續空格替換成單個空格
String noDigits = CharMatcher.JAVA_DIGIT.replaceFrom(string, "*"); //用*號替換所有數字
String lowerAndDigit = CharMatcher.JAVA_DIGIT.or(CharMatcher.JAVA_LOWER_CASE).retainFrom(string);
// 只保留數字和小寫字母
Spring
判斷集合是否為空
@Test
void testIsEmpty() {
Assertions.assertTrue(CollectionUtils.isEmpty((List<?>) null));
Assertions.assertTrue(CollectionUtils.isEmpty((Set<?>) null));
Assertions.assertTrue(CollectionUtils.isEmpty((Map<?, ?>) null));
Assertions.assertTrue(CollectionUtils.isEmpty(Collections.emptyList()));
Assertions.assertTrue(CollectionUtils.isEmpty(Collections.emptySet()));
Assertions.assertTrue(CollectionUtils.isEmpty(Collections.emptyMap()));
Assertions.assertTrue(CollectionUtils.isEmpty(List.of()));
Assertions.assertTrue(CollectionUtils.isEmpty(Set.of()));
Assertions.assertTrue(CollectionUtils.isEmpty(Map.of()));
List<Object> list = new LinkedList<>();
list.add(new Object());
Assertions.assertFalse(CollectionUtils.isEmpty(list));
Assertions.assertFalse(CollectionUtils.isEmpty(List.of("foo")));
Map<String, String> map = new HashMap<>();
map.put("foo", "bar");
Assertions.assertFalse(CollectionUtils.isEmpty(map));
Assertions.assertFalse(CollectionUtils.isEmpty(Map.of("foo", "bar")));
}
獲取集合的第一個元素
@Test
void testFirstElement() {
Assertions.assertNull(CollectionUtils.firstElement((Set<?>) null));
Assertions.assertNull(CollectionUtils.firstElement((List<?>) null));
List<String> list = new ArrayList<>();
list.add(null);
// null
Assertions.assertNull(CollectionUtils.firstElement(list));
list = new ArrayList<>();
list.add("foo");
// foo
Assertions.assertEquals("foo", CollectionUtils.firstElement(list));
list = List.of("foo", "bar");
// foo
Assertions.assertEquals("foo", CollectionUtils.firstElement(list));
Set<String> set = new TreeSet<>();
set.add("b");
set.add("a");
// a
Assertions.assertEquals("a", CollectionUtils.firstElement(set));
// b
set = new TreeSet<>(Comparator.reverseOrder());
set.add("b");
set.add("a");
Assertions.assertEquals("b", CollectionUtils.firstElement(set));
}
獲取集合的最後一個元素
@Test
void testLastElement() {
Assertions.assertNull(CollectionUtils.lastElement((Set<?>) null));
Assertions.assertNull(CollectionUtils.lastElement((List<?>) null));
List<String> list = new ArrayList<>();
list.add(null);
Assertions.assertNull(CollectionUtils.lastElement(list));
list = new ArrayList<>();
list.add("foo");
list.add("bar");
// bar
Assertions.assertEquals("bar", CollectionUtils.lastElement(list));
list = List.of("foo", "bar");
Assertions.assertEquals("bar", CollectionUtils.lastElement(list));
Set<String> set = new TreeSet<>();
set.add("b");
set.add("a");
// b
Assertions.assertEquals("b", CollectionUtils.lastElement(set));
set = new TreeSet<>(Comparator.reverseOrder());
set.add("b");
set.add("a");
// a
Assertions.assertEquals("a", CollectionUtils.lastElement(set));
}
對象屬性拷貝
添加一個測試對象:
class User {
private String name;
private String email;
// 忽略getXxx和setXxx方法
@Test
void testCopyProperties() {
User user = new User();
user.setName("foo");
user.setEmail("bar");
User target = new User();
// 拷貝屬性
BeanUtils.copyProperties(user, target, "email");
Assertions.assertEquals("foo", target.getName());
Assertions.assertNull(target.getEmail());
}
命名的 ThreadLocal
@Test
void testNamedThreadLocal() {
NamedThreadLocal<String> threadLocal = new NamedThreadLocal<>("task");
Assertions.assertEquals("task", threadLocal.toString());
}
判斷對象是否相等
@Test
void testNullSafeEquals() {
Assertions.assertTrue(ObjectUtils.nullSafeEquals(null, null));
Assertions.assertTrue(ObjectUtils.nullSafeEquals("a", "a"));
Assertions.assertTrue(ObjectUtils.nullSafeEquals(Optional.of("a"), Optional.of("a")));
}
判斷對象是否為空
@Test
void testIsEmpty() {
Assertions.assertTrue(ObjectUtils.isEmpty((Object) null));
Assertions.assertTrue(ObjectUtils.isEmpty(Optional.empty()));
Assertions.assertTrue(ObjectUtils.isEmpty(""));
Assertions.assertTrue(ObjectUtils.isEmpty(new String[]{}));
Assertions.assertTrue(ObjectUtils.isEmpty(Collections.emptyList()));
Assertions.assertTrue(ObjectUtils.isEmpty(Collections.emptyMap()));
}
資源工具類
有時候我們需要載入 classpath
目錄下的資源,例如:
File file = new File(ResourceUtilsTests.class.getClassLoader().getResource("log4j2.xml").toURI());
Assertions.assertEquals("log4j2.xml", file.getName());
使用 Spring
的 ResourceUtils
只需要這麼寫:
File file = ResourceUtils.getFile(ResourceUtils.CLASSPATH_URL_PREFIX + "log4j2.xml");
Assertions.assertEquals("log4j2.xml", file.getName());
計時器
@Test
void testStopWatch() throws InterruptedException {
// 創建一個計時器(秒錶)
StopWatch stopWatch = new StopWatch();
// 開始計時
stopWatch.start();
Thread.sleep(Duration.ofSeconds(1).toMillis());
// 停止計時
stopWatch.stop();
// 獲取總耗時(毫秒)
// 1005ms.
log.info("{}ms.", stopWatch.getTotalTimeMillis());
// 1s.
log.info("{}s.", Duration.ofMillis(stopWatch.getTotalTimeMillis()).toSeconds());
}
UriComponentsBuilder
有時候我們需要在服務端手動發送請求,在請求 url
我們使用字元串拼接的方式,Spring
提供了UriComponentsBuilder
能讓我們更加語意化來構建一個請求url
,而且還會自動對url
進行編碼:
@Test
void testFromUriString() {
String uri = UriComponentsBuilder
.fromUriString("/coffee/{foo}/{id}/like")
.build("aa", "bb")
.toString();
Assertions.assertEquals("/coffee/aa/bb/like", uri);
uri = UriComponentsBuilder
.fromUriString("http://localhost:8080/coffe/{id}")
.encode()
.build(1).toString();
Assertions.assertEquals("http://localhost:8080/coffe/1", uri);
uri = UriComponentsBuilder
.fromUriString("http://localhost:8080/coffee?name={name}")
.build(" ").toString();
Assertions.assertEquals("http://localhost:8080/coffee?name=%20",uri);
}
hutool
校驗
@Test
void testIsCitizenId() {
// 校驗是否為身份證
Assertions.assertTrue(Validator.isCitizenId("110101199003074477"));
// 15位身份證號碼驗證
Assertions.assertTrue(Validator.isCitizenId("410001910101123"));
// 10位身份證號碼驗證
Assertions.assertTrue(Validator.isCitizenId("U193683453"));
}
@Test
void testIsMobile() {
// 校驗是否為手機號
Assertions.assertTrue(Validator.isMobile("13900221432"));
Assertions.assertTrue(Validator.isMobile("015100221432"));
Assertions.assertTrue(Validator.isMobile("+8618600221432"));
}
@Test
void testIsPlateNumber() {
// 校驗是否為車牌號
Assertions.assertTrue(Validator.isPlateNumber("粵BA03205"));
Assertions.assertTrue(Validator.isPlateNumber("閩20401領"));
}
emoji
@Test
void testToUnicode() {
String unicode = EmojiUtil.toUnicode(":smile:");
Assertions.assertEquals("