概述
工具類 就是封裝平常用的方法，不需要你重復造輪子，節省開發人員時間，提高工作效率。谷歌作為大公司，當然會從日常的工作中提取中很多高效率的方法出來。所以就誕生了guava。
guava的優點：
高效設計良好的API，被Google的開發者設計，實現和使用
遵循高效的java語法實踐
使代碼更刻度，簡潔，簡單
節約時間，資源，提高生產力
Guava工程包含了若干被Google的 Java項目廣泛依賴 的核心庫，例如：
集合 [collections]
緩存 [caching]
原生類型支持 [primitives support]
并發庫 [concurrency libraries]
通用注解 [common annotations]
字符串處理 [string processing]
I/O 等等。
引入gradle依賴（引入Jar包）
compile'com.google.guava:guava:26.0-jre'
// 普通Collection的創建
List list = Lists.newArrayList();
Set set = Sets.newHashSet();
Map map = Maps.newHashMap();
// 不變Collection的創建
ImmutableList iList = ImmutableList.of("a","b","c");
ImmutableSet iSet = ImmutableSet.of("e1","e2");
ImmutableMap iMap = ImmutableMap.of("k1","v1","k2","v2");
創建不可變集合 先理解什么是immutable(不可變)對象
在多線程操作下，是線程安全的
所有不可變集合會比可變集合更有效的利用資源
中途不可改變
ImmutableList immutableList = ImmutableList.of("1","2","3","4");
這聲明了一個不可變的List集合，List中有數據1，2，3，4。類中的 操作集合的方法（譬如add, set, sort, replace等）都被聲明過期，并且拋出異常。 而沒用guava之前是需要聲明并且加各種包裹集合才能實現這個功能
// add 方法
@Deprecated@Override
publicfinalvoidadd(intindex, E element){
thrownewUnsupportedOperationException();
? }
當我們需要一個map中包含key為String類型，value為List類型的時候，以前我們是這樣寫的
Map> map =newHashMap>();
Listlist=newArrayList();
list.add(1);
list.add(2);
map.put("aa",list);
System.out.println(map.get("aa"));//[1, 2]
而現在
Multimapmap=ArrayListMultimap.create();
map.put("aa",1);
map.put("aa",2);
System.out.println(map.get("aa"));//[1, 2]
其他的黑科技集合
MultiSet: 無序+可重復? count()方法獲取單詞的次數? 增強了可讀性+操作簡單
創建方式:? Multiset set = HashMultiset.create();
Multimap: key-value? key可以重復?
創建方式: Multimap teachers = ArrayListMultimap.create();
BiMap: 雙向Map(BidirectionalMap) 鍵與值都不能重復
創建方式:? BiMap biMap = HashBiMap.create();
Table: 雙鍵的MapMap--> Table-->rowKey+columnKey+value//和sql中的聯合主鍵有點像
創建方式: Table tables = HashBasedTable.create();
...等等(guava中還有很多java里面沒有給出的集合類型)
以前我們將list轉換為特定規則的字符串是這樣寫的:
//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集合轉換為特定規則的字符串
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轉換為map
Stringstr ="xiaoming=11,xiaohong=23";
Map map = Splitter.on(",").withKeyValueSeparator("=").split(str);
Stringinput ="aa.dd,,ff,,.";
List result = Splitter.onPattern("[.|,]").omitEmptyStrings().splitToList(input);
關于字符串的操作 都是在Splitter這個類上進行的
// 判斷匹配結果
booleanresult = CharMatcher.inRange('a','z').or(CharMatcher.inRange('A','Z')).matches('K');//true
// 保留數字文本? CharMatcher.digit() 已過時? retain 保留
//String s1 = CharMatcher.digit().retainFrom("abc 123 efg"); //123
String s1 = CharMatcher.inRange('0','9').retainFrom("abc 123 efg");// 123
// 刪除數字文本? remove 刪除
// String s2 = CharMatcher.digit().removeFrom("abc 123 efg");? ? //abc? efg
String s2 = CharMatcher.inRange('0','9').removeFrom("abc 123 efg");// abc? efg
我們對于集合的過濾，思路就是迭代，然后再具體對每一個數判斷，這樣的代碼放在程序中，難免會顯得很臃腫，雖然功能都有，但是很不好看。
guava寫法
//按照條件過濾
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]
//自定義過濾條件? 使用自定義回調方法對Map的每個Value進行操作
ImmutableMap m = ImmutableMap.of("begin",12,"code",15);
// Function<F, T> F表示apply()方法input的類型，T表示apply()方法返回類型
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);
免去了很多麻煩！并且會使你的代碼看上去更好看。而不是代碼里面充斥著!=null，!=""
檢查是否為空,不僅僅是字符串類型，其他類型的判斷，全部都封裝在 Preconditions類里，里面的方法全為靜態
其中的一個方法的源碼
@CanIgnoreReturnValue
publicstaticTcheckNotNull(T reference){
if(reference ==null) {
thrownewNullPointerException();
? ? }
returnreference;
}
方法聲明（不包括額外參數）描述檢查失敗時拋出的異常
checkArgument(boolean)檢查boolean是否為true，用來檢查傳遞給方法的參數。IllegalArgumentException
checkNotNull(T)檢查value是否為null，該方法直接返回value，因此可以內嵌使用checkNotNull。NullPointerException
checkState(boolean)用來檢查對象的某些狀態。IllegalStateException
checkElementIndex(int index, int size)檢查index作為索引值對某個列表、字符串或數組是否有效。 index > 0 && index < sizeIndexOutOfBoundsException
checkPositionIndexes(int start, int end, int size)檢查[start,end]表示的位置范圍對某個列表、字符串或數組是否有效IndexOutOfBoundsException
這個方法是在Objects過期后官方推薦使用的替代品，該類最大的好處就是不用大量的重寫toString，用一種很優雅的方式實現重寫，或者在某個場景定制使用。
Person person =newPerson("aa",11);
String str = MoreObjects.toStringHelper("Person").add("age", person.getAge()).toString();
System.out.println(str);
//輸出Person{age=11}
排序器[Ordering]是Guava流暢風格比較器[Comparator]的實現，它可以用來為構建復雜的比較器，以完成集合排序的功能。
natural()? 對可排序類型做自然排序，如數字按大小，日期按先后排序
usingToString() 按對象的字符串形式做字典排序[lexicographical ordering]
from(Comparator)? ? 把給定的Comparator轉化為排序器
reverse()? 獲取語義相反的排序器
nullsFirst()? ? 使用當前排序器，但額外把null值排到最前面。
nullsLast() 使用當前排序器，但額外把null值排到最后面。
compound(Comparator)? ? 合成另一個比較器，以處理當前排序器中的相等情況。
lexicographical()? 基于處理類型T的排序器，返回該類型的可迭代對象Iterable<T>的排序器。
onResultOf(Function)? ? 對集合中元素調用Function，再按返回值用當前排序器排序。
示例
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 可以指定時間輸出精確到多少時間
以前我們寫文件讀取的時候要定義緩沖區，各種條件判斷，各種$%#$@#
而現在我們只需要使用好guava的api 就能使代碼變得簡潔，并且不用擔心因為寫錯邏輯而背鍋了
File file =newFile("test.txt");
List list =null;
try{
? ? list = Files.readLines(file, Charsets.UTF_8);
}catch(Exception e) {
}
Files.copy(from,to);//復制文件
Files.deleteDirectoryContents(File directory);//刪除文件夾下的內容(包括文件與子文件夾)?
Files.deleteRecursively(File file);//刪除文件或者文件夾?
Files.move(File from, File to);//移動文件
URL url = Resources.getResource("abc.xml");//獲取classpath根下的abc.xml文件url
Files類中還有許多方法可以用，可以多多翻閱
guava的緩存設計的比較巧妙，可以很精巧的使用。guava緩存創建分為兩種，一種是CacheLoader,另一種則是callback方式
Cache的定時清理實現邏輯（失效時間+增加維護accessQueue,writeQueue兩個隊列用于記錄緩存順序，這樣才可以按照順序淘汰數據）：https://crossoverjie.top/2018/06/13/guava/guava-cache/
CacheLoader:
LoadingCache<String,String> cahceBuilder=CacheBuilder
? ? ? ? ? ? ? ? .newBuilder()
// 設置并發級別，并發級別是指可以同時寫緩存的線程數
.concurrencyLevel(10)
// 設置緩存過期時間
.expireAfterWrite(10, TimeUnit.MINUTES)
// 設置緩存容器的初始容量
.initialCapacity(10)
// 設置緩存最大容量，超過之后就會按照LRU最近雖少使用算法來移除緩存項
.maximumSize(500)
// 設置緩存的移除通知
.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實現緩存回調
System.out.println(cahceBuilder.apply("wen"));//hello wen!? //請求緩存值
System.out.println(cahceBuilder.apply("da"));//hello da!
cahceBuilder.put("begin","code");//設置緩存內容
System.out.println(cahceBuilder.get("begin"));//code
cahceBuilder.invalidateAll();//清除緩存
api中已經把apply聲明為過期，聲明中推薦使用get方法獲取值
callback方式: 回調之中已經實現了對數據的添加，
Cache cache = CacheBuilder.newBuilder().maximumSize(1000).build();
String resultVal = cache.get("code",newCallable() {
publicStringcall(){
String strProValue="begin "+"code"+"!";//回調實現添加入值；無需put?
returnstrProValue;
? ? }?
});?
System.out.println("value : "+ resultVal);//value : begin code!
//get回調實現源碼
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);
? ? ? ? ? ? }
? ? ? ? ? }
? ? ? ? }
// 緩存中不存在數據
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是個大的工具類，第一版guava是2010年發布的，每一版的更新和迭代都是一種創新。
jdk的升級很多都是借鑒guava里面的思想來進行的。
代碼可以在https://github.com/whirlys/elastic-example/tree/master/guava下載
細節請翻看 guava 文檔https://github.com/google/guava/wiki
