概述
工具類(lèi) 就是封裝平常用的方法，不需要你重復(fù)造輪子，節(jié)省開(kāi)發(fā)人員時(shí)間，提高工作效率。谷歌作為大公司，當(dāng)然會(huì)從日常的工作中提取中很多高效率的方法出來(lái)。所以就誕生了guava。
guava的優(yōu)點(diǎn)：
高效設(shè)計(jì)良好的API，被Google的開(kāi)發(fā)者設(shè)計(jì)，實(shí)現(xiàn)和使用
遵循高效的java語(yǔ)法實(shí)踐
使代碼更刻度，簡(jiǎn)潔，簡(jiǎn)單
節(jié)約時(shí)間，資源，提高生產(chǎn)力
Guava工程包含了若干被Google的 Java項(xiàng)目廣泛依賴(lài) 的核心庫(kù)，例如：
集合 [collections]
緩存 [caching]
原生類(lèi)型支持 [primitives support]
并發(fā)庫(kù) [concurrency libraries]
通用注解 [common annotations]
字符串處理 [string processing]
I/O 等等。
引入gradle依賴(lài)（引入Jar包）
compile'com.google.guava:guava:26.0-jre'
// 普通Collection的創(chuàng)建
List list = Lists.newArrayList();
Set set = Sets.newHashSet();
Map map = Maps.newHashMap();
// 不變Collection的創(chuàng)建
ImmutableList iList = ImmutableList.of("a","b","c");
ImmutableSet iSet = ImmutableSet.of("e1","e2");
ImmutableMap iMap = ImmutableMap.of("k1","v1","k2","v2");
創(chuàng)建不可變集合 先理解什么是immutable(不可變)對(duì)象
在多線程操作下，是線程安全的
所有不可變集合會(huì)比可變集合更有效的利用資源
中途不可改變
ImmutableList immutableList = ImmutableList.of("1","2","3","4");
這聲明了一個(gè)不可變的List集合，List中有數(shù)據(jù)1，2，3，4。類(lèi)中的 操作集合的方法（譬如add, set, sort, replace等）都被聲明過(guò)期，并且拋出異常。 而沒(méi)用guava之前是需要聲明并且加各種包裹集合才能實(shí)現(xiàn)這個(gè)功能
// add 方法
@Deprecated@Override
publicfinalvoidadd(intindex, E element){
thrownewUnsupportedOperationException();
? }
當(dāng)我們需要一個(gè)map中包含key為String類(lèi)型，value為L(zhǎng)ist類(lèi)型的時(shí)候，以前我們是這樣寫(xiě)的
Map> map =newHashMap>();
Listlist=newArrayList();
list.add(1);
list.add(2);
map.put("aa",list);
System.out.println(map.get("aa"));//[1, 2]
而現(xiàn)在
Multimapmap=ArrayListMultimap.create();
map.put("aa",1);
map.put("aa",2);
System.out.println(map.get("aa"));//[1, 2]
其他的黑科技集合
MultiSet: 無(wú)序+可重復(fù)? count()方法獲取單詞的次數(shù)? 增強(qiáng)了可讀性+操作簡(jiǎn)單
創(chuàng)建方式:? Multiset set = HashMultiset.create();
Multimap: key-value? key可以重復(fù)?
創(chuàng)建方式: Multimap teachers = ArrayListMultimap.create();
BiMap: 雙向Map(BidirectionalMap) 鍵與值都不能重復(fù)
創(chuàng)建方式:? BiMap biMap = HashBiMap.create();
Table: 雙鍵的MapMap--> Table-->rowKey+columnKey+value//和sql中的聯(lián)合主鍵有點(diǎn)像
創(chuàng)建方式: Table tables = HashBasedTable.create();
...等等(guava中還有很多java里面沒(méi)有給出的集合類(lèi)型)
以前我們將list轉(zhuǎn)換為特定規(guī)則的字符串是這樣寫(xiě)的:
//use java
Listlist=newArrayList();
list.add("aa");
list.add("bb");
list.add("cc");
String str ="";
for(int i=0; i
str = str +"-"+list.get(i);
}
//str 為-aa-bb-cc
//use guava
Listlist=newArrayList();
list.add("aa");
list.add("bb");
list.add("cc");
String result = Joiner.on("-").join(list);
//result為? aa-bb-cc
把map集合轉(zhuǎn)換為特定規(guī)則的字符串
Mapmap=Maps.newHashMap();
map.put("xiaoming",12);
map.put("xiaohong",13);
Stringresult =Joiner.on(",").withKeyValueSeparator("=").join(map);
// result為 xiaoming=12,xiaohong=13
//use java
List list =newArrayList();
Stringa ="1-2-3-4-5-6";
String[] strs = a.split("-");
for(int i=0; i
? ? list.add(strs[i]);
}
//use guava
Stringstr ="1-2-3-4-5-6";
List list = Splitter.on("-").splitToList(str);
//list為? [1, 2, 3, 4, 5, 6]
如果
str="1-2-3-4- 5-? 6? ";
guava還可以使用omitEmptyStrings().trimResults()去除空串與空格
Stringstr ="1-2-3-4-? 5-? 6? ";
List list = Splitter.on("-").omitEmptyStrings().trimResults().splitToList(str);
System.out.println(list);
將String轉(zhuǎn)換為map
Stringstr ="xiaoming=11,xiaohong=23";
Map map = Splitter.on(",").withKeyValueSeparator("=").split(str);
4.guava還支持多個(gè)字符切割，或者特定的正則分隔
Stringinput ="aa.dd,,ff,,.";
List result = Splitter.onPattern("[.|,]").omitEmptyStrings().splitToList(input);
關(guān)于字符串的操作 都是在Splitter這個(gè)類(lèi)上進(jìn)行的
// 判斷匹配結(jié)果
booleanresult = CharMatcher.inRange('a','z').or(CharMatcher.inRange('A','Z')).matches('K');//true
// 保留數(shù)字文本? CharMatcher.digit() 已過(guò)時(shí)? retain 保留
//String s1 = CharMatcher.digit().retainFrom("abc 123 efg"); //123
String s1 = CharMatcher.inRange('0','9').retainFrom("abc 123 efg");// 123
// 刪除數(shù)字文本? remove 刪除
// String s2 = CharMatcher.digit().removeFrom("abc 123 efg");? ? //abc? efg
String s2 = CharMatcher.inRange('0','9').removeFrom("abc 123 efg");// abc? efg
我們對(duì)于集合的過(guò)濾，思路就是迭代，然后再具體對(duì)每一個(gè)數(shù)判斷，這樣的代碼放在程序中，難免會(huì)顯得很臃腫，雖然功能都有，但是很不好看。
guava寫(xiě)法
//按照條件過(guò)濾
ImmutableList names = ImmutableList.of("begin","code","Guava","Java");
Iterable fitered = Iterables.filter(names, Predicates.or(Predicates.equalTo("Guava"), Predicates.equalTo("Java")));
System.out.println(fitered);// [Guava, Java]
//自定義過(guò)濾條件? 使用自定義回調(diào)方法對(duì)Map的每個(gè)Value進(jìn)行操作
ImmutableMap m = ImmutableMap.of("begin",12,"code",15);
// Function<F, T> F表示apply()方法input的類(lèi)型，T表示apply()方法返回類(lèi)型
Map m2 = Maps.transformValues(m,newFunction() {
publicIntegerapply(Integer input){
if(input>12){
returninput;
}else{
returninput+1;
? ? ? ? ? ? ? ? }
? ? ? ? ? ? }
? ? ? ? });
System.out.println(m2);//{begin=13, code=15}
set的交集, 并集, 差集
HashSet setA = newHashSet(1,2,3,4,5);
HashSet setB = newHashSet(4,5,6,7,8);
SetView union = Sets.union(setA, setB);? ?
System.out.println("union:");
for(Integer integer : union)
System.out.println(integer);//union 并集:12345867
SetView difference = Sets.difference(setA, setB);?
System.out.println("difference:");
for(Integer integer : difference)
System.out.println(integer);//difference 差集:123
SetView intersection = Sets.intersection(setA, setB);?
System.out.println("intersection:");
for(Integer integer : intersection)
System.out.println(integer);//intersection 交集:45
map的交集，并集，差集
HashMap<String, Integer> mapA = Maps.newHashMap();
mapA.put("a",1);mapA.put("b",2);mapA.put("c",3);
HashMap<String, Integer> mapB = Maps.newHashMap();
mapB.put("b",20);mapB.put("c",3);mapB.put("d",4);
MapDifference differenceMap = Maps.difference(mapA, mapB);
differenceMap.areEqual();
Map entriesDiffering = differenceMap.entriesDiffering();
Map entriesOnlyLeft = differenceMap.entriesOnlyOnLeft();
Map entriesOnlyRight = differenceMap.entriesOnlyOnRight();
Map entriesInCommon = differenceMap.entriesInCommon();
System.out.println(entriesDiffering);// {b=(2, 20)}
System.out.println(entriesOnlyLeft);// {a=1}
System.out.println(entriesOnlyRight);// {d=4}
System.out.println(entriesInCommon);// {c=3}
//use java
if(list!=null&& list.size()>0)
'''
if(str!=null && str.length()>0)
'''
if(str !=null&& !str.isEmpty())
//use guava
if(!Strings.isNullOrEmpty(str))
//use java
if(count <=0) {
thrownewIllegalArgumentException("must be positive: "+ count);
}? ?
//use guava
Preconditions.checkArgument(count >0,"must be positive: %s", count);
免去了很多麻煩！并且會(huì)使你的代碼看上去更好看。而不是代碼里面充斥著!=null，!=""
檢查是否為空,不僅僅是字符串類(lèi)型，其他類(lèi)型的判斷，全部都封裝在 Preconditions類(lèi)里，里面的方法全為靜態(tài)
其中的一個(gè)方法的源碼
@CanIgnoreReturnValue
publicstaticTcheckNotNull(T reference){
if(reference ==null) {
thrownewNullPointerException();
? ? }
returnreference;
}
方法聲明（不包括額外參數(shù)）描述檢查失敗時(shí)拋出的異常
checkArgument(boolean)檢查boolean是否為true，用來(lái)檢查傳遞給方法的參數(shù)。IllegalArgumentException
checkNotNull(T)檢查value是否為null，該方法直接返回value，因此可以?xún)?nèi)嵌使用checkNotNull。NullPointerException
checkState(boolean)用來(lái)檢查對(duì)象的某些狀態(tài)。IllegalStateException
checkElementIndex(int index, int size)檢查index作為索引值對(duì)某個(gè)列表、字符串或數(shù)組是否有效。 index > 0 && index < sizeIndexOutOfBoundsException
checkPositionIndexes(int start, int end, int size)檢查[start,end]表示的位置范圍對(duì)某個(gè)列表、字符串或數(shù)組是否有效IndexOutOfBoundsException
這個(gè)方法是在Objects過(guò)期后官方推薦使用的替代品，該類(lèi)最大的好處就是不用大量的重寫(xiě)toString，用一種很優(yōu)雅的方式實(shí)現(xiàn)重寫(xiě)，或者在某個(gè)場(chǎng)景定制使用。
Person person =newPerson("aa",11);
String str = MoreObjects.toStringHelper("Person").add("age", person.getAge()).toString();
System.out.println(str);
//輸出Person{age=11}
排序器[Ordering]是Guava流暢風(fēng)格比較器[Comparator]的實(shí)現(xiàn)，它可以用來(lái)為構(gòu)建復(fù)雜的比較器，以完成集合排序的功能。
natural()? 對(duì)可排序類(lèi)型做自然排序，如數(shù)字按大小，日期按先后排序
usingToString() 按對(duì)象的字符串形式做字典排序[lexicographical ordering]
from(Comparator)? ? 把給定的Comparator轉(zhuǎn)化為排序器
reverse()? 獲取語(yǔ)義相反的排序器
nullsFirst()? ? 使用當(dāng)前排序器，但額外把null值排到最前面。
nullsLast() 使用當(dāng)前排序器，但額外把null值排到最后面。
compound(Comparator)? ? 合成另一個(gè)比較器，以處理當(dāng)前排序器中的相等情況。
lexicographical()? 基于處理類(lèi)型T的排序器，返回該類(lèi)型的可迭代對(duì)象Iterable<T>的排序器。
onResultOf(Function)? ? 對(duì)集合中元素調(diào)用Function，再按返回值用當(dāng)前排序器排序。
示例
Person person =newPerson("aa",14);//String name? ,Integer age
Person ps =newPerson("bb",13);
Ordering byOrdering = Ordering.natural().nullsFirst().onResultOf(newFunction(){
publicStringapply(Person person){
returnperson.age.toString();
? ? }
});
byOrdering.compare(person, ps);
System.out.println(byOrdering.compare(person, ps));//1? ? ? person的年齡比ps大 所以輸出1
Stopwatch stopwatch = Stopwatch.createStarted();
for(inti=0; i<100000; i++){
// do some thing
}
longnanos = stopwatch.elapsed(TimeUnit.MILLISECONDS);
System.out.println(nanos);
TimeUnit 可以指定時(shí)間輸出精確到多少時(shí)間
以前我們寫(xiě)文件讀取的時(shí)候要定義緩沖區(qū)，各種條件判斷，各種$%#$@#
而現(xiàn)在我們只需要使用好guava的api 就能使代碼變得簡(jiǎn)潔，并且不用擔(dān)心因?yàn)閷?xiě)錯(cuò)邏輯而背鍋了
File file =newFile("test.txt");
List list =null;
try{
? ? list = Files.readLines(file, Charsets.UTF_8);
}catch(Exception e) {
}
Files.copy(from,to);//復(fù)制文件
Files.deleteDirectoryContents(File directory);//刪除文件夾下的內(nèi)容(包括文件與子文件夾)?
Files.deleteRecursively(File file);//刪除文件或者文件夾?
Files.move(File from, File to);//移動(dòng)文件
URL url = Resources.getResource("abc.xml");//獲取classpath根下的abc.xml文件url
Files類(lèi)中還有許多方法可以用，可以多多翻閱
guava的緩存設(shè)計(jì)的比較巧妙，可以很精巧的使用。guava緩存創(chuàng)建分為兩種，一種是CacheLoader,另一種則是callback方式
Cache的定時(shí)清理實(shí)現(xiàn)邏輯（失效時(shí)間+增加維護(hù)accessQueue,writeQueue兩個(gè)隊(duì)列用于記錄緩存順序，這樣才可以按照順序淘汰數(shù)據(jù)）：https://crossoverjie.top/2018/06/13/guava/guava-cache/
CacheLoader:
LoadingCache<String,String> cahceBuilder=CacheBuilder
? ? ? ? ? ? ? ? .newBuilder()
// 設(shè)置并發(fā)級(jí)別，并發(fā)級(jí)別是指可以同時(shí)寫(xiě)緩存的線程數(shù)
.concurrencyLevel(10)
// 設(shè)置緩存過(guò)期時(shí)間
.expireAfterWrite(10, TimeUnit.MINUTES)
// 設(shè)置緩存容器的初始容量
.initialCapacity(10)
// 設(shè)置緩存最大容量，超過(guò)之后就會(huì)按照LRU最近雖少使用算法來(lái)移除緩存項(xiàng)
.maximumSize(500)
// 設(shè)置緩存的移除通知
.removalListener(newRemovalListener() {
publicvoidonRemoval(RemovalNotification<Object, Object> notification){
LOGGER.warn(notification.getKey() +" was removed, cause is "+ notification.getCause());
? ? ? ? ? ? ? ? ? }
? ? ? ? ? ? ? ? })
.build(newCacheLoader(){
@Override
publicStringload(String key)throwsException{
String strProValue="hello "+key+"!";
returnstrProValue;
? ? ? ? ? ? ? ? ? ? }
? ? ? ? ? ? ? ? });? ? ? ?
System.out.println(cahceBuilder.apply("begincode"));//hello begincode!
System.out.println(cahceBuilder.get("begincode"));//hello begincode!
System.out.println(cahceBuilder.get("wen"));//hello wen!? ? //獲取緩存值，callable實(shí)現(xiàn)緩存回調(diào)
System.out.println(cahceBuilder.apply("wen"));//hello wen!? //請(qǐng)求緩存值
System.out.println(cahceBuilder.apply("da"));//hello da!
cahceBuilder.put("begin","code");//設(shè)置緩存內(nèi)容
System.out.println(cahceBuilder.get("begin"));//code
cahceBuilder.invalidateAll();//清除緩存
api中已經(jīng)把a(bǔ)pply聲明為過(guò)期，聲明中推薦使用get方法獲取值
callback方式: 回調(diào)之中已經(jīng)實(shí)現(xiàn)了對(duì)數(shù)據(jù)的添加，
Cache cache = CacheBuilder.newBuilder().maximumSize(1000).build();
String resultVal = cache.get("code",newCallable() {
publicStringcall(){
String strProValue="begin "+"code"+"!";//回調(diào)實(shí)現(xiàn)添加入值；無(wú)需put?
returnstrProValue;
? ? }?
});?
System.out.println("value : "+ resultVal);//value : begin code!
//get回調(diào)實(shí)現(xiàn)源碼
Vget(K key,inthash, CacheLoader loader)throwsExecutionException{
? ? ? checkNotNull(key);
? ? ? checkNotNull(loader);
try{
if(count !=0) {// read-volatile
// don't call getLiveEntry, which would ignore loading values
? ? ? ? ? ReferenceEntry<K, V> e = getEntry(key, hash);
if(e !=null) {
longnow = map.ticker.read();
? ? ? ? ? ? V value = getLiveValue(e, now);
if(value !=null) {
? ? ? ? ? ? ? recordRead(e, now);
statsCounter.recordHits(1);
returnscheduleRefresh(e, key, hash, value, now, loader);
? ? ? ? ? ? }
? ? ? ? ? ? ValueReference<K, V> valueReference = e.getValueReference();
if(valueReference.isLoading()) {
returnwaitForLoadingValue(e, key, valueReference);
? ? ? ? ? ? }
? ? ? ? ? }
? ? ? ? }
// 緩存中不存在數(shù)據(jù)
returnlockedGetOrLoad(key, hash, loader);
}catch(ExecutionException ee) {
? ? ? ? Throwable cause = ee.getCause();
if(causeinstanceofError) {
thrownewExecutionError((Error) cause);
}elseif(causeinstanceofRuntimeException) {
thrownewUncheckedExecutionException(cause);
? ? ? ? }
throwee;
}finally{
? ? ? ? postReadCleanup();
? ? ? }
? ? }
以上只是guava使用的一小部分，guava是個(gè)大的工具類(lèi)，第一版guava是2010年發(fā)布的，每一版的更新和迭代都是一種創(chuàng)新。
jdk的升級(jí)很多都是借鑒guava里面的思想來(lái)進(jìn)行的。
代碼可以在https://github.com/whirlys/elastic-example/tree/master/guava下載
細(xì)節(jié)請(qǐng)翻看 guava 文檔https://github.com/google/guava/wiki
