您好,登錄后才能下訂單哦!
這篇文章主要介紹“如何使用Guava”,在日常操作中,相信很多人在如何使用Guava問(wèn)題上存在疑惑,小編查閱了各式資料,整理出簡(jiǎn)單好用的操作方法,希望對(duì)大家解答”如何使用Guava”的疑惑有所幫助!接下來(lái),請(qǐng)跟著小編一起來(lái)學(xué)習(xí)吧!
最近在看一個(gè)同學(xué)代碼的時(shí)候,發(fā)現(xiàn)代碼中大量使用了 Google 開(kāi)源的 Guava 核心庫(kù)中的內(nèi)容,讓代碼簡(jiǎn)單清晰了不少,故學(xué)習(xí)分享出 Guava 中我認(rèn)為最實(shí)用的功能。
Guava 項(xiàng)目是 Google 公司開(kāi)源的 Java 核心庫(kù),它主要是包含一些在 Java 開(kāi)發(fā)中經(jīng)常使用到的功能,如數(shù)據(jù)校驗(yàn)、不可變集合、計(jì)數(shù)集合,集合增強(qiáng)操作、I/O、緩存、字符串操作等。并且 Guava 廣泛用于 Google 內(nèi)部的 Java 項(xiàng)目中,也被其他公司廣泛使用,甚至在新版 JDK 中直接引入了 Guava 中的優(yōu)秀類庫(kù),所以質(zhì)量毋庸置疑。
使用方式直接 mavan 依賴引入。
<!-- https://mvnrepository.com/artifact/com.google.guava/guava --> <dependency> <groupId>com.google.guava</groupId> <artifactId>guava</artifactId> <version>30.0-jre</version> </dependency>
數(shù)據(jù)校驗(yàn)說(shuō)來(lái)十分簡(jiǎn)單,一是非空判斷,二是預(yù)期值判斷。非空判斷我想每一個(gè) Java 開(kāi)發(fā)者都很熟悉,一開(kāi)始都經(jīng)常和 NullPointException 打交道。處理的方式我們自然是一個(gè) if( xx == null) 就能輕松解決。預(yù)期值判斷也是類似,檢查數(shù)據(jù)值是不是自己想要的結(jié)果即可。
即使這么簡(jiǎn)單的操作,我們是不是還經(jīng)常出錯(cuò)呢?而且寫(xiě)起來(lái)的代碼總是一行判斷一行異常拋出,怎么看都覺(jué)得那么優(yōu)雅。還好,現(xiàn)在就來(lái)嘗試第一次使用 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)行非空判斷,好處為覺(jué)得有兩個(gè),一是語(yǔ)義清晰代碼優(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 類還可以用來(lái)檢查數(shù)組和集合的元素獲取是否越界。
// Guava 中快速創(chuàng)建ArrayList List<String> list = Lists.newArrayList("a", "b", "c", "d"); // 開(kāi)始校驗(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)建的超多姿勢(shì)。
創(chuàng)建不可變集合是我個(gè)人最喜歡 Guava 的一個(gè)原因,因?yàn)閯?chuàng)建一個(gè)不能刪除、不能修改、不能增加元素的集合實(shí)在是太實(shí)用了。這樣的集合你完全不用擔(dān)心發(fā)生什么問(wèn)題,總的來(lái)說(shuō)有下面幾個(gè)優(yōu)點(diǎn):
鴻蒙官方戰(zhàn)略合作共建——HarmonyOS技術(shù)社區(qū)
線程安全,因?yàn)椴荒苄薷娜魏卧?,可以隨意多線程使用且沒(méi)有并發(fā)問(wèn)題。
可以無(wú)憂的提供給第三方使用,反正修改不了。
減少內(nèi)存占用,因?yàn)椴荒芨淖?,所以?nèi)部實(shí)現(xiàn)可以最大程度節(jié)約內(nèi)存占用。
可以用作常量集合。
創(chuàng)建方式
說(shuō)了那么多,那么到底怎么使用呢?趕緊擼起代碼來(lái)。
// 創(chuàng)建方式1:of ImmutableSet<String> immutableSet = ImmutableSet.of("a", "b", "c"); immutableSet.forEach(System.out::println); // a // b // c // 創(chuàng)建方式2:builder ImmutableSet<String> immutableSet2 = ImmutableSet.<String>builder() .add("hello") .add(new String("未讀代碼")) .build(); immutableSet2.forEach(System.out::println); // hello // 未讀代碼 // 創(chuàng)建方式3:從其他集合中拷貝創(chuàng)建 ArrayList<String> arrayList = new ArrayList(); arrayList.add("www.wdbyte.com"); arrayList.add("https"); ImmutableSet<String> 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<String> arrayList = new ArrayList(); arrayList.add("www.wdbyte.com"); arrayList.add("https"); // JDK Collections 創(chuàng)建不可變 List List<String> list = Collections.unmodifiableList(arrayList); list.forEach(System.out::println);// www.wdbyte.com https list.add("未讀代碼"); // java.lang.UnsupportedOperationException
注意事項(xiàng)
1.使用 Guava 創(chuàng)建的不可變集合是拒絕 null 值的,因?yàn)樵?Google 內(nèi)部調(diào)查中,95% 的情況下都不需要放入 null 值。
2.使用 JDK 提供的不可變集合創(chuàng)建成功后,原集合添加元素會(huì)體現(xiàn)在不可變集合中,而 Guava 的不可變集合不會(huì)有這個(gè)問(wèn)題。
List<String> arrayList = new ArrayList<>(); arrayList.add("a"); arrayList.add("b"); List<String> jdkList = Collections.unmodifiableList(arrayList); ImmutableList<String> 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
3.如果不可變集合的元素是引用對(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ú)拿出來(lái)介紹了呢?看下去你就會(huì)大呼好用。雖然 JDK 中已經(jīng)提供了大量的集合相關(guān)的操作方法,用起來(lái)也是非常的方便,但是 Guava 還是增加了一些十分好用的方法,保證讓你用上一次就愛(ài)不釋手,
創(chuàng)建集合。
// 創(chuàng)建一個(gè) ArrayList 集合 List<String> list1 = Lists.newArrayList(); // 創(chuàng)建一個(gè) ArrayList 集合,同時(shí)塞入3個(gè)數(shù)據(jù) List<String> list2 = Lists.newArrayList("a", "b", "c"); // 創(chuàng)建一個(gè) ArrayList 集合,容量初始化為10 List<String> list3 = Lists.newArrayListWithCapacity(10); LinkedList<String> linkedList1 = Lists.newLinkedList(); CopyOnWriteArrayList<String> cowArrayList = Lists.newCopyOnWriteArrayList(); HashMap<Object, Object> hashMap = Maps.newHashMap(); ConcurrentMap<Object, Object> concurrentMap = Maps.newConcurrentMap(); TreeMap<Comparable, Object> treeMap = Maps.newTreeMap(); HashSet<Object> hashSet = Sets.newHashSet(); HashSet<String> newHashSet = Sets.newHashSet("a", "a", "b", "c");
Guava 為每一個(gè)集合都添加了工廠方法創(chuàng)建方式,上面已經(jīng)展示了部分集合的工廠方法創(chuàng)建方式。是不是十分的好用呢。而且可以在創(chuàng)建時(shí)直接扔進(jìn)去幾個(gè)元素,這個(gè)簡(jiǎn)直太贊了,再也不用一個(gè)個(gè) add 了。
集合交集并集差集
過(guò)于簡(jiǎn)單,直接看代碼和輸出結(jié)果吧。
Set<String> newHashSet1 = Sets.newHashSet("a", "a", "b", "c"); Set<String> newHashSet2 = Sets.newHashSet("b", "b", "c", "d"); // 交集 SetView<String> intersectionSet = Sets.intersection(newHashSet1, newHashSet2); System.out.println(intersectionSet); // [b, c] // 并集 SetView<String> unionSet = Sets.union(newHashSet1, newHashSet2); System.out.println(unionSet); // [a, b, c, d] // newHashSet1 中存在,newHashSet2 中不存在 SetView<String> setView = Sets.difference(newHashSet1, newHashSet2); System.out.println(setView); // [a]
這個(gè)真的太有用了,因?yàn)槲覀兘?jīng)常會(huì)需要設(shè)計(jì)可以計(jì)數(shù)的集合,或者 value 是 List 的 Map 集合,如果說(shuō)你不太明白,看下面這段代碼,是否某天夜里你也這樣寫(xiě)過(guò)。
1.統(tǒng)計(jì)相同元素出現(xiàn)的次數(shù)(下面的代碼我已經(jīng)盡可能精簡(jiǎn)寫(xiě)法了)。
JDK 原生寫(xiě)法:
// Java 統(tǒng)計(jì)相同元素出現(xiàn)的次數(shù)。 List<String> words = Lists.newArrayList("a", "b", "c", "d", "a", "c"); Map<String, Integer> countMap = new HashMap<String, Integer>(); 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)盡量?jī)?yōu)化代碼,代碼量還是不少的,那么在 Guava 中有什么不一樣呢?在 Guava. 中主要是使用 HashMultiset 類,看下面。
ArrayList<String> arrayList = Lists.newArrayList("a", "b", "c", "d", "a", "c"); HashMultiset<String> 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ù)量??粗娣?,寫(xiě)著優(yōu)雅,HashMultiset 是 Guava 中實(shí)現(xiàn)的 Collection 類,可以輕松統(tǒng)計(jì)元素?cái)?shù)量。
2.一對(duì)多,value 是 List 的 Map 集合。
假設(shè)一個(gè)場(chǎng)景,需要把很多動(dòng)物按照種類進(jìn)行分類,我相信最后你會(huì)寫(xiě)出類似的代碼。
JDK 原生寫(xiě)法:
HashMap<String, Set<String>> animalMap = new HashMap<>(); HashSet<String> dogSet = new HashSet<>(); dogSet.add("旺財(cái)"); dogSet.add("大黃"); animalMap.put("狗", dogSet); HashSet<String> catSet = new HashSet<>(); catSet.add("加菲"); catSet.add("湯姆"); animalMap.put("貓", catSet); System.out.println(animalMap.get("貓")); // [加菲, 湯姆]
最后一行查詢貓得到了貓類的 "加菲" 和 ”湯姆“。這個(gè)代碼簡(jiǎn)直太煩做了,如果使用 Guava 呢?
// use guava HashMultimap<String, String> 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 寫(xiě)法上是一樣的,但是代碼已經(jīng)無(wú)比清爽。
作為開(kāi)發(fā)中最長(zhǎng)使用的數(shù)據(jù)類型,字符串操作的增強(qiáng)可以讓開(kāi)發(fā)更加高效。
字符拼接
JDK 8 中其實(shí)已經(jīng)內(nèi)置了字符串拼接方法,但是它只是簡(jiǎn)單的拼接,沒(méi)有額外操作,比如過(guò)濾掉 null 元素,去除前后空格等。先看一下 JDK 8 中字符串拼接的幾種方式。
// JDK 方式一 ArrayList<String> 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<String> 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() 可以跳過(guò)空值,使用 useFornull(String) 可以為空值自定義顯示文本。
字符串分割
JDK 中是自帶字符串分割的,我想你也一定用過(guò),那就是 String 的 split 方法,但是這個(gè)方法有一個(gè)問(wèn)題,就是如果最后一個(gè)元素為空,那么就會(huì)丟棄,奇怪的是第一個(gè)元素為空卻不會(huì)丟棄,這就十分迷惑,下面通過(guò)一個(gè)例子演示這個(gè)問(wèn)題。
String str = ",a,,b,"; String[] splitArr = str.split(","); Arrays.stream(splitArr).forEach(System.out::println); System.out.println("------"); /** * * a * * b * ------ */
你也可以自己測(cè)試下,最后一個(gè)元素不是空,直接消失了。
如果使用 Guava 是怎樣的操作方式呢?Guava 提供了 Splitter 類,并且有一系列的操作方式可以直觀的控制分割邏輯。
String str = ",a ,,b ,"; Iterable<String> split = Splitter.on(",") .omitEmptyStrings() // 忽略空值 .trimResults() // 過(guò)濾結(jié)果中的空白 .split(str); split.forEach(System.out::println); /** * a * b */
在開(kāi)發(fā)中我們可能需要使用小規(guī)模的緩存,來(lái)提高訪問(wèn)速度。這時(shí)引入專業(yè)的緩存中間件可能又覺(jué)得浪費(fèi)?,F(xiàn)在可以了, Guava 中提供了簡(jiǎn)單的緩存類,且可以根據(jù)預(yù)計(jì)容量、過(guò)期時(shí)間等自動(dòng)過(guò)期已經(jīng)添加的元素。即使這樣我們也要預(yù)估好可能占用的內(nèi)存空間,以防內(nèi)存占用過(guò)多。
現(xiàn)在看一下在 Guava 中緩存該怎么用。
@Test public void testCache() throws ExecutionException, InterruptedException { CacheLoader cacheLoader = new CacheLoader<String, Animal>() { // 如果找不到元素,會(huì)調(diào)用這里 @Override public Animal load(String s) { return null; } }; LoadingCache<String, Animal> loadingCache = CacheBuilder.newBuilder() .maximumSize(1000) // 容量 .expireAfterWrite(3, TimeUnit.SECONDS) // 過(guò)期時(shí)間 .removalListener(new MyRemovalListener()) // 失效監(jiān)聽(tīng)器 .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)過(guò)去,獲取為 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)聽(tīng)器 */ class MyRemovalListener implements RemovalListener<String, Animal> { @Override public void onRemoval(RemovalNotification<String, Animal> 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 中重寫(xiě)了 load 方法,這個(gè)方法會(huì)在查詢緩存沒(méi)有命中時(shí)被調(diào)用,我這里直接返回了 null,其實(shí)這樣會(huì)在沒(méi)有命中時(shí)拋出 CacheLoader returned null for key 異常信息。
MyRemovalListener 作為緩存元素失效時(shí)的監(jiān)聽(tīng)類,在有元素緩存失效時(shí)會(huì)自動(dòng)調(diào)用 onRemoval 方法,這里需要注意的是這個(gè)方法是同步方法,如果這里耗時(shí)較長(zhǎng),會(huì)阻塞直到處理完成。
LoadingCache 就是緩存的主要操作對(duì)象了,常用的就是其中的 put 和 get 方法了。
到此,關(guān)于“如何使用Guava”的學(xué)習(xí)就結(jié)束了,希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí),快去試試吧!若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí),請(qǐng)繼續(xù)關(guān)注億速云網(wǎng)站,小編會(huì)繼續(xù)努力為大家?guī)?lái)更多實(shí)用的文章!
免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。