Guava - 拯救垃圾代碼,寫出優(yōu)雅高效,效率提升N倍
可以點(diǎn)擊?“未讀代碼” ,關(guān)注公眾號(hào),文章每周更新

杭州-夢想小鎮(zhèn)
最近在看一個(gè)同學(xué)代碼的時(shí)候,發(fā)現(xiàn)代碼中大量使用了 Google 開源的 Guava 核心庫中的內(nèi)容,讓代碼簡單清晰了不少,故學(xué)習(xí)分享出 Guava 中我認(rèn)為最實(shí)用的功能。
Guava 項(xiàng)目是 Google 公司開源的 Java 核心庫,它主要是包含一些在 Java 開發(fā)中經(jīng)常使用到的功能,如數(shù)據(jù)校驗(yàn)、不可變集合、計(jì)數(shù)集合,集合增強(qiáng)操作、I/O、緩存、字符串操作等。并且 Guava 廣泛用于 Google 內(nèi)部的 Java 項(xiàng)目中,也被其他公司廣泛使用,甚至在新版 JDK 中直接引入了 Guava 中的優(yōu)秀類庫,所以質(zhì)量毋庸置疑。
使用方式直接 mavan 依賴引入。
<dependency>
????<groupId>com.google.guavagroupId>
????<artifactId>guavaartifactId>
????<version>30.0-jreversion>
dependency>
數(shù)據(jù)校驗(yàn)
數(shù)據(jù)校驗(yàn)說來十分簡單,一是非空判斷,二是預(yù)期值判斷。非空判斷我想每一個(gè) Java 開發(fā)者都很熟悉,一開始都經(jīng)常和 NullPointException 打交道。處理的方式我們自然是一個(gè) if( xx == null) 就能輕松解決。預(yù)期值判斷也是類似,檢查數(shù)據(jù)值是不是自己想要的結(jié)果即可。
即使這么簡單的操作,我們是不是還經(jīng)常出錯(cuò)呢?而且寫起來的代碼總是一行判斷一行異常拋出,怎么看都覺得那么優(yōu)雅。還好,現(xiàn)在就來嘗試第一次使用 Guava 吧。
非空判斷
String?param?=?"未讀代碼";
String?name?=?Preconditions.checkNotNull(param);
System.out.println(name);?//?未讀代碼
String?param2?=?null;
String?name2?=?Preconditions.checkNotNull(param2);?//?NullPointerException
System.out.println(name2);
引入了 Guava 后可以直接使用 Preconditions.checkNotNull 進(jìn)行非空判斷,好處為覺得有兩個(gè),一是語義清晰代碼優(yōu)雅;二是你也可以自定義報(bào)錯(cuò)信息,這樣如果參數(shù)為空,報(bào)錯(cuò)的信息清晰,可以直接定位到具體參數(shù)。
String?param2?=?null;
String?name2?=?Preconditions.checkNotNull(param2,"param2?is?null");
//?java.lang.NullPointerException:?param2?is?null
預(yù)期值判斷
和非空判斷類似,可以比較當(dāng)前值和預(yù)期值,如果不相等可以自定義報(bào)錯(cuò)信息拋出。
String?param?=?"www.wdbyte.com2";
String?wdbyte?=?"www.wdbyte.com";
Preconditions.checkArgument(wdbyte.equals(param),?"[%s]?404?NOT?FOUND",?param);
//?java.lang.IllegalArgumentException:?[www.wdbyte.com2]?404?NOT?FOUND
是否越界
Preconditions 類還可以用來檢查數(shù)組和集合的元素獲取是否越界。
//?Guava?中快速創(chuàng)建ArrayList
List?list?=?Lists.newArrayList("a",?"b",?"c",?"d");
//?開始校驗(yàn)
int?index?=?Preconditions.checkElementIndex(5,?list.size());
//?java.lang.IndexOutOfBoundsException:?index?(5)?must?be?less?than?size?(4)
代碼中快速創(chuàng)建 List 的方式也是 Guava 提供的,后面會(huì)詳細(xì)介紹 Guava 中集合創(chuàng)建的超多姿勢。
不可變的集合
創(chuàng)建不可變集合是我個(gè)人最喜歡 Guava 的一個(gè)原因,因?yàn)閯?chuàng)建一個(gè)不能刪除、不能修改、不能增加元素的集合實(shí)在是太實(shí)用了。這樣的集合你完全不用擔(dān)心發(fā)生什么問題,總的來說有下面幾個(gè)優(yōu)點(diǎn):
- 線程安全,因?yàn)椴荒苄薷娜魏卧兀梢噪S意多線程使用且沒有并發(fā)問題。
- 可以無憂的提供給第三方使用,反正修改不了。
- 減少內(nèi)存占用,因?yàn)椴荒芨淖儯詢?nèi)部實(shí)現(xiàn)可以最大程度節(jié)約內(nèi)存占用。
- 可以用作常量集合。
創(chuàng)建方式
說了那么多,那么到底怎么使用呢?趕緊擼起代碼來。
//?創(chuàng)建方式1:of
ImmutableSet?immutableSet?=?ImmutableSet.of("a",?"b",?"c");
immutableSet.forEach(System.out::println);
//?a
//?b
//?c
//?創(chuàng)建方式2:builder
ImmutableSet?immutableSet2?=?ImmutableSet.builder()
????.add("hello")
????.add(new?String("未讀代碼"))
????.build();
immutableSet2.forEach(System.out::println);
//?hello
//?未讀代碼
//?創(chuàng)建方式3:從其他集合中拷貝創(chuàng)建
ArrayList?arrayList?=?new?ArrayList();
arrayList.add("www.wdbyte.com");
arrayList.add("https");
ImmutableSet?immutableSet3?=?ImmutableSet.copyOf(arrayList);
immutableSet3.forEach(System.out::println);
//?www.wdbyte.com
//?https
都可以正常打印遍歷結(jié)果,但是如果進(jìn)行增刪改,會(huì)直接報(bào) UnsupportedOperationException .
其實(shí) JDK 中也提供了一個(gè)不可變集合,可以像下面這樣創(chuàng)建。
ArrayList?arrayList?=?new?ArrayList();
arrayList.add("www.wdbyte.com");
arrayList.add("https");
//?JDK?Collections?創(chuàng)建不可變?List
List?list?=?Collections.unmodifiableList(arrayList);
list.forEach(System.out::println);//?www.wdbyte.com?https
list.add("未讀代碼");?//?java.lang.UnsupportedOperationException
注意事項(xiàng)
使用 Guava 創(chuàng)建的不可變集合是拒絕
null值的,因?yàn)樵?Google 內(nèi)部調(diào)查中,95% 的情況下都不需要放入null值。使用 JDK 提供的不可變集合創(chuàng)建成功后,原集合添加元素會(huì)體現(xiàn)在不可變集合中,而 Guava 的不可變集合不會(huì)有這個(gè)問題。
???List?arrayList?=?new?ArrayList<>();
???arrayList.add("a");
???arrayList.add("b");
???List?jdkList?=?Collections.unmodifiableList(arrayList);
???ImmutableList?immutableList?=?ImmutableList.copyOf(arrayList);
???arrayList.add("ccc");
???jdkList.forEach(System.out::println);//?result:?a?b?ccc
???System.out.println("-------");
???immutableList.forEach(System.out::println);//?result:?a?b
- 如果不可變集合的元素是引用對(duì)象,那么引用對(duì)象的屬性是可以更改的。
其他不可變集合
不可變集合除了上面演示的 set 之外,還有很多不可變集合,下面是 Guava 中不可變集合和其他集合的對(duì)應(yīng)關(guān)系。
| 可變集合接口 | 屬于JDK還是Guava | 不可變版本 |
|---|---|---|
| Collection | JDK | ImmutableCollection |
| List | JDK | ImmutableList |
| Set | JDK | ImmutableSet |
| SortedSet/NavigableSet | JDK | ImmutableSortedSet |
| Map | JDK | ImmutableMap |
| SortedMap | JDK | ImmutableSortedMap |
| Multiset | Guava | ImmutableMultiset |
| SortedMultiset | Guava | ImmutableSortedMultiset |
| Multimap | Guava | ImmutableMultimap |
| ListMultimap | Guava | ImmutableListMultimap |
| SetMultimap | Guava | ImmutableSetMultimap |
| BiMap | Guava | ImmutableBiMap |
| ClassToInstanceMap | Guava | ImmutableClassToInstanceMap |
| Table | Guava | ImmutableTable |
集合操作工廠
其實(shí)這里只會(huì)介紹一個(gè)創(chuàng)建方法,但是為什么還是單獨(dú)拿出來介紹了呢?看下去你就會(huì)大呼好用。雖然 JDK 中已經(jīng)提供了大量的集合相關(guān)的操作方法,用起來也是非常的方便,但是 Guava 還是增加了一些十分好用的方法,保證讓你用上一次就愛不釋手,
創(chuàng)建集合。
//?創(chuàng)建一個(gè)?ArrayList?集合
List?list1?=?Lists.newArrayList();
//?創(chuàng)建一個(gè)?ArrayList?集合,同時(shí)塞入3個(gè)數(shù)據(jù)
List?list2?=?Lists.newArrayList("a",?"b",?"c");
//?創(chuàng)建一個(gè)?ArrayList?集合,容量初始化為10
List?list3?=?Lists.newArrayListWithCapacity(10);
LinkedList?linkedList1?=?Lists.newLinkedList();
CopyOnWriteArrayList?cowArrayList?=?Lists.newCopyOnWriteArrayList();
HashMap Guava 為每一個(gè)集合都添加了工廠方法創(chuàng)建方式,上面已經(jīng)展示了部分集合的工廠方法創(chuàng)建方式。是不是十分的好用呢。而且可以在創(chuàng)建時(shí)直接扔進(jìn)去幾個(gè)元素,這個(gè)簡直太贊了,再也不用一個(gè)個(gè) add 了。
集合交集并集差集
過于簡單,直接看代碼和輸出結(jié)果吧。
Set?newHashSet1?=?Sets.newHashSet("a",?"a",?"b",?"c");
Set?newHashSet2?=?Sets.newHashSet("b",?"b",?"c",?"d");
//?交集
SetView?intersectionSet?=?Sets.intersection(newHashSet1,?newHashSet2);
System.out.println(intersectionSet);?//?[b,?c]
//?并集
SetView?unionSet?=?Sets.union(newHashSet1,?newHashSet2);
System.out.println(unionSet);?//?[a,?b,?c,?d]
//?newHashSet1?中存在,newHashSet2?中不存在
SetView?setView?=?Sets.difference(newHashSet1,?newHashSet2);
System.out.println(setView);?//?[a]
有數(shù)量的集合
這個(gè)真的太有用了,因?yàn)槲覀兘?jīng)常會(huì)需要設(shè)計(jì)可以計(jì)數(shù)的集合,或者 value 是 List 的 Map 集合,如果說你不太明白,看下面這段代碼,是否某天夜里你也這樣寫過。
統(tǒng)計(jì)相同元素出現(xiàn)的次數(shù)(下面的代碼我已經(jīng)盡可能精簡寫法了)。
JDK 原生寫法:
???//?Java?統(tǒng)計(jì)相同元素出現(xiàn)的次數(shù)。
???List?words?=?Lists.newArrayList("a",?"b",?"c",?"d",?"a",?"c");
???Map?countMap?=?new?HashMap();
???for?(String?word?:?words)?{
???????Integer?count?=?countMap.get(word);
???????count?=?(count?==?null)???1?:?++count;
???????countMap.put(word,?count);
???}
???countMap.forEach((k,?v)?->?System.out.println(k?+?":"?+?v));
???/**
????*?result:
????*?a:2
????*?b:1
????*?c:2
????*?d:1
????*/
盡管已經(jīng)盡量優(yōu)化代碼,代碼量還是不少的,那么在 Guava 中有什么不一樣呢?在 Guava. 中主要是使用 HashMultiset 類,看下面。
???ArrayList?arrayList?=?Lists.newArrayList("a",?"b",?"c",?"d",?"a",?"c");
???HashMultiset?multiset?=?HashMultiset.create(arrayList);
???multiset.elementSet().forEach(s?->?System.out.println(s?+?":"?+?multiset.count(s)));
???/**
????*?result:
????*?a:2
????*?b:1
????*?c:2
????*?d:1
????*/
是的,只要把元素添加進(jìn)去就行了,不用在乎是否重復(fù),最后都可以使用 count 方法統(tǒng)計(jì)重復(fù)元素?cái)?shù)量。看著舒服,寫著優(yōu)雅,HashMultiset 是 Guava 中實(shí)現(xiàn)的 Collection 類,可以輕松統(tǒng)計(jì)元素?cái)?shù)量。
一對(duì)多,value 是
List的Map集合。假設(shè)一個(gè)場景,需要把很多動(dòng)物按照種類進(jìn)行分類,我相信最后你會(huì)寫出類似的代碼。
JDK 原生寫法:
???HashMap>?animalMap?=?new?HashMap<>();
???HashSet?dogSet?=?new?HashSet<>();
???dogSet.add("旺財(cái)");
???dogSet.add("大黃");
???animalMap.put("狗",?dogSet);
???HashSet?catSet?=?new?HashSet<>();
???catSet.add("加菲");
???catSet.add("湯姆");
???animalMap.put("貓",?catSet);
???System.out.println(animalMap.get("貓"));?//?[加菲,?湯姆]
最后一行查詢貓得到了貓類的 "加菲" 和 ”湯姆“。這個(gè)代碼簡直太煩做了,如果使用 Guava 呢?
???//?use?guava
???HashMultimap?multimap?=?HashMultimap.create();
???multimap.put("狗",?"大黃");
???multimap.put("狗",?"旺財(cái)");
???multimap.put("貓",?"加菲");
???multimap.put("貓",?"湯姆");
???System.out.println(multimap.get("貓"));?//?[加菲,?湯姆]
HashMultimap 可以扔進(jìn)去重復(fù)的 key 值,最后獲取時(shí)可以得到所有的 value 值,可以看到輸出結(jié)果和 JDK 寫法上是一樣的,但是代碼已經(jīng)無比清爽。
字符串操作
作為開發(fā)中最長使用的數(shù)據(jù)類型,字符串操作的增強(qiáng)可以讓開發(fā)更加高效。
字符拼接
JDK 8 中其實(shí)已經(jīng)內(nèi)置了字符串拼接方法,但是它只是簡單的拼接,沒有額外操作,比如過濾掉 null 元素,去除前后空格等。先看一下 JDK 8 中字符串拼接的幾種方式。
//?JDK?方式一
ArrayList?list?=?Lists.newArrayList("a",?"b",?"c",?null);
String?join?=?String.join(",",?list);
System.out.println(join);?//?a,b,c,null
//?JDK?方式二
String?result?=?list.stream().collect(Collectors.joining(","));
System.out.println(result);?//?a,b,c,null
//?JDK?方式三
StringJoiner?stringJoiner?=?new?StringJoiner(",");
list.forEach(stringJoiner::add);
System.out.println(stringJoiner.toString());?//?a,b,c,null
可以看到 null 值也被拼接到了字符串里,這有時(shí)候不是我們想要的,那么使用 Guava 有什么不一樣呢?
ArrayList?list?=?Lists.newArrayList("a",?"b",?"c",?null);
String?join?=?Joiner.on(",").skipNulls().join(list);
System.out.println(join);?//?a,b,c
String?join1?=?Joiner.on(",").useForNull("空值").join("旺財(cái)",?"湯姆",?"杰瑞",?null);
System.out.println(join1);?//?旺財(cái),湯姆,杰瑞,空值
可以看到使用 skipNulls() 可以跳過空值,使用 useFornull(String) 可以為空值自定義顯示文本。
字符串分割
JDK 中是自帶字符串分割的,我想你也一定用過,那就是 String 的 split 方法,但是這個(gè)方法有一個(gè)問題,就是如果最后一個(gè)元素為空,那么就會(huì)丟棄,奇怪的是第一個(gè)元素為空卻不會(huì)丟棄,這就十分迷惑,下面通過一個(gè)例子演示這個(gè)問題。
String?str?=?",a,,b,";
String[]?splitArr?=?str.split(",");
Arrays.stream(splitArr).forEach(System.out::println);
System.out.println("------");
/**
?*
?*?a
?*?
?*?b
?*?------
?*/
你也可以自己測試下,最后一個(gè)元素不是空,直接消失了。
如果使用 Guava 是怎樣的操作方式呢?Guava 提供了 Splitter 類,并且有一系列的操作方式可以直觀的控制分割邏輯。
String?str?=?",a?,,b?,";
Iterable?split?=?Splitter.on(",")
????.omitEmptyStrings()?//?忽略空值
????.trimResults()?//?過濾結(jié)果中的空白
????.split(str);
split.forEach(System.out::println);
/**
?*?a
?*?b
?*/
緩存
在開發(fā)中我們可能需要使用小規(guī)模的緩存,來提高訪問速度。這時(shí)引入專業(yè)的緩存中間件可能又覺得浪費(fèi)。現(xiàn)在可以了, Guava 中提供了簡單的緩存類,且可以根據(jù)預(yù)計(jì)容量、過期時(shí)間等自動(dòng)過期已經(jīng)添加的元素。即使這樣我們也要預(yù)估好可能占用的內(nèi)存空間,以防內(nèi)存占用過多。
現(xiàn)在看一下在 Guava 中緩存該怎么用。
@Test
public?void?testCache()?throws?ExecutionException,?InterruptedException?{
????CacheLoader?cacheLoader?=?new?CacheLoader()?{
????????//?如果找不到元素,會(huì)調(diào)用這里
????????@Override
????????public?Animal?load(String?s)?{
????????????return?null;
????????}
????};
????LoadingCache?loadingCache?=?CacheBuilder.newBuilder()
????????.maximumSize(1000)?//?容量
????????.expireAfterWrite(3,?TimeUnit.SECONDS)?//?過期時(shí)間
????????.removalListener(new?MyRemovalListener())?//?失效監(jiān)聽器
????????.build(cacheLoader);?//
????loadingCache.put("狗",?new?Animal("旺財(cái)",?1));
????loadingCache.put("貓",?new?Animal("湯姆",?3));
????loadingCache.put("狼",?new?Animal("灰太狼",?4));
????loadingCache.invalidate("貓");?//?手動(dòng)失效
????Animal?animal?=?loadingCache.get("狼");
????System.out.println(animal);
????Thread.sleep(4?*?1000);
????//?狼已經(jīng)自動(dòng)過去,獲取為?null?值報(bào)錯(cuò)
????System.out.println(loadingCache.get("狼"));
????/**
?????*?key=貓,value=Animal{name='湯姆',?age=3},reason=EXPLICIT
?????*?Animal{name='灰太狼',?age=4}
?????*?key=狗,value=Animal{name='旺財(cái)',?age=1},reason=EXPIRED
?????*?key=狼,value=Animal{name='灰太狼',?age=4},reason=EXPIRED
?????*
?????*?com.google.common.cache.CacheLoader$InvalidCacheLoadException:?CacheLoader?returned?null?for?key?狼.
?????*/
}
/**
?*?緩存移除監(jiān)聽器
?*/
class?MyRemovalListener?implements?RemovalListener<String,?Animal>?{
????@Override
????public?void?onRemoval(RemovalNotification?notification) ?{
????????String?reason?=?String.format("key=%s,value=%s,reason=%s",?notification.getKey(),?notification.getValue(),?notification.getCause());
????????System.out.println(reason);
????}
}
class?Animal?{
????private?String?name;
????private?Integer?age;
????@Override
????public?String?toString()?{
????????return?"Animal{"?+
????????????"name='"?+?name?+?'\''?+
????????????",?age="?+?age?+
????????????'}';
????}
????public?Animal(String?name,?Integer?age)?{
????????this.name?=?name;
????????this.age?=?age;
????}
}
這個(gè)例子中主要分為 CacheLoader、MyRemovalListener、LoadingCache。
CacheLoader 中重寫了 load 方法,這個(gè)方法會(huì)在查詢緩存沒有命中時(shí)被調(diào)用,我這里直接返回了 null,其實(shí)這樣會(huì)在沒有命中時(shí)拋出 CacheLoader returned null for key 異常信息。
MyRemovalListener 作為緩存元素失效時(shí)的監(jiān)聽類,在有元素緩存失效時(shí)會(huì)自動(dòng)調(diào)用 onRemoval 方法,這里需要注意的是這個(gè)方法是同步方法,如果這里耗時(shí)較長,會(huì)阻塞直到處理完成。
LoadingCache 就是緩存的主要操作對(duì)象了,常用的就是其中的 put 和 get 方法了。
總結(jié)
上面介紹了我認(rèn)為最常用的 Guava 功能,Guava 作為 Google 公司開源的 Java 開發(fā)核心庫,個(gè)人覺得實(shí)用性還是很高的。引入后不僅能快速的實(shí)現(xiàn)一些開發(fā)中常用的功能,而且還可以讓代碼更加的優(yōu)雅簡潔。我覺得適用于每一個(gè) Java 項(xiàng)目。Guava 的其他的功能你也可以自己去發(fā)現(xiàn)。它的 Github 地址是:https://github.com/google/guava.
參考
- https://github.com/google/guava/wiki
訂閱
文章有幫助可以點(diǎn)個(gè)「在看」或「分享」,都是支持,我都喜歡!
文章每周持續(xù)更新,要實(shí)時(shí)關(guān)注我更新的文章以及分享的干貨,可以關(guān)注「?未讀代碼?」公眾號(hào)。
---- END ----
"未讀代碼,一線技術(shù)工具人的學(xué)習(xí)、生活與見聞"
不用一鍵三連,只求一個(gè)在看?
