当前位置:   article > 正文

一篇让你熟练掌握Google Guava包

google guava

Google Guava

guava开源库的地址:github.com/google/guava

这个工具的介绍,搜集自网络,自己整理一下格式,感觉不错,分享一下。最近读源码碰到的有趣工具类挺多,分享大家都学习一下。

概述

工具类 就是封装平常用的方法,不需要你重复造轮子,节省开发人员时间,提高工作效率。谷歌作为大公司,当然会从日常的工作中提取中很多高效率的方法出来。所以就诞生了guava。

guava的优点

  • 高效设计良好的API,被Google的开发者设计,实现和使用
  • 遵循高效的java语法实践
  • 使代码更刻度,简洁,简单
  • 节约时间,资源,提高生产力

guava的核心库

  • 集合 [collections]
  • 缓存 [caching]
  • 原生类型支持 [primitives support]
  • 并发库 [concurrency libraries]
  • 通用注解 [common annotations]
  • 字符串处理 [string processing]
  • I/O 等等。

    在这里插入图片描述

guava的使用

引入gradle依赖(引入Jar包)

compile 'com.google.guava:guava:26.0-jre'
  1. <dependency>
  2. <groupId>com.google.guava</groupId>
  3. <artifactId>guava</artifactId>
  4. <version>21.0</version>
  5. </dependency>
1.集合的创建
  1. // 普通Collection的创建
  2. List<String> list = Lists.newArrayList();
  3. Set<String> set = Sets.newHashSet();
  4. Map<String, String> map = Maps.newHashMap();
  5. // 不变Collection的创建
  6. ImmutableList<String> iList = ImmutableList.of("a", "b", "c");
  7. ImmutableSet<String> iSet = ImmutableSet.of("e1", "e2");
  8. ImmutableMap<String, String> iMap = ImmutableMap.of("k1", "v1", "k2", "v2");

创建不可变集合 先理解什么是immutable(不可变)对象

  • 在多线程操作下,是线程安全的
  • 所有不可变集合会比可变集合更有效的利用资源
  • 中途不可改变
ImmutableList<String> immutableList = ImmutableList.of("1","2","3","4");

这声明了一个不可变的List集合,List中有数据1,2,3,4。类中的 操作集合的方法(譬如add, set, sort, replace等)都被声明过期,并且抛出异常。 而没用guava之前是需要声明并且加各种包裹集合才能实现这个功能

  1. // add 方法
  2. @Deprecated @Override
  3. public final void add(int index, E element) {
  4. throw new UnsupportedOperationException();
  5. }

1.2 当我们需要一个map中包含key为String类型,value为List类型的时候,以前我们是这样写的

  1. Map<String,List<Integer>> map = new HashMap<String,List<Integer>>();
  2. List<Integer> list = new ArrayList<Integer>();
  3. list.add(1);
  4. list.add(2);
  5. map.put("aa", list);
  6. System.out.println(map.get("aa"));//[1, 2]

现在

  1. Multimap<String,Integer> map = ArrayListMultimap.create();
  2. map.put("aa", 1);
  3. map.put("aa", 2);
  4. System.out.println(map.get("aa")); //[1, 2]

1.3

MultiSet: 无序+可重复   count()方法获取单词的次数  增强了可读性+操作简单
创建方式:  Multiset<String> set = HashMultiset.create();

Multimap: key-value  key可以重复  
创建方式: Multimap<String, String> teachers = ArrayListMultimap.create();

BiMap: 双向Map(Bidirectional Map) 键与值都不能重复
创建方式:  BiMap<String, String> biMap = HashBiMap.create();

Table: 双键的Map Map--> Table-->rowKey+columnKey+value  //和sql中的联合主键有点像
创建方式: Table<String, String, Integer> tables = HashBasedTable.create();

...等等(guava中还有很多java里面没有给出的集合类型)

2.特色工具

字符串连接器Joiner 连接多个字符串并追加到StringBuilder

  1. StringBuilder stringBuilder = new StringBuilder("hello");
  2. // 字符串连接器,以|为分隔符,同时去掉null元素
  3. Joiner joiner1 = Joiner.on("|").skipNulls();
  4. // 构成一个字符串foo|bar|baz并添加到stringBuilder
  5. stringBuilder = joiner1.appendTo(stringBuilder, "foo", "bar", null, "baz");
  6. System.out.println(stringBuilder); // hellofoo|bar|baz

连接List元素并写到文件流

  1. FileWriter fileWriter = null;
  2. try{
  3. fileWriter = new FileWriter(new File("/home/gzx/Documents/tmp.txt"));
  4. }
  5. catch(Exception e){
  6. System.out.println(e.getMessage());
  7. }
  8. List<Date> dateList = new ArrayList<Date>();
  9. dateList.add(new Date());
  10. dateList.add(null);
  11. dateList.add(new Date());
  12. // 构造连接器:如果有null元素,替换为no string
  13. Joiner joiner2 = Joiner.on("#").useForNull("no string");
  14. try{
  15. // 将list的元素的tostring()写到fileWriter,是否覆盖取决于fileWriter的打开方式,默认是覆盖,若有true,则是追加
  16. joiner2.appendTo(fileWriter, dateList);
  17. // 必须添加close(),否则不会写文件
  18. fileWriter.close();
  19. }
  20. catch(IOException e){
  21. System.out.println(e.getMessage());
  22. }

字符串分割器Splitter

将字符串分割为Iterable

  1. // 分割符为|,并去掉得到元素的前后空白
  2. Splitter sp = Splitter.on("|").trimResults();
  3. String str = "hello | world | your | Name ";
  4. Iterable<String> ss = sp.split(str);
  5. for(String it : ss){
  6. System.out.println(it);
  7. }

结果为: hello world your Name

字符串工具类Strings

  1. System.out.println(Strings.isNullOrEmpty("")); // true
  2. System.out.println(Strings.isNullOrEmpty(null)); // true
  3. System.out.println(Strings.isNullOrEmpty("hello")); // false
  4. // 将null转化为""
  5. System.out.println(Strings.nullToEmpty(null)); // ""
  6. // 从尾部不断补充T只到总共8个字符,如果源字符串已经达到或操作,则原样返回。类似的有padStart
  7. System.out.println(Strings.padEnd("hello", 8, 'T')); // helloTTT

字符匹配器CharMatcher 空白一一替换

  1. // 空白回车换行对应换成一个#,一对一换
  2. String stringWithLinebreaks = "hello world ryou are here\n\ntake it\t\t\teasy";
  3. String s6 = CharMatcher.BREAKING_WHITESPACE.replaceFrom(stringWithLinebreaks,'#');
  4. System.out.println(s6); // hello#world###you#are#here##take#it###easy

连续空白缩成一个字符

  1. // 将所有连在一起的空白回车换行字符换成一个#,倒塌
  2. String tabString = " hello world you nare here ";
  3. String tabRet = CharMatcher.WHITESPACE.collapseFrom(tabString, '#');
  4. System.out.println(tabRet); // #hello#world#you#are#here#

去掉前后空白和缩成一个字符

  1. // 在前面的基础上去掉字符串的前后空白,并将空白换成一个#
  2. String trimRet = CharMatcher.WHITESPACE.trimAndCollapseFrom(tabString, '#');
  3. System.out.println(trimRet);// hello#world#you#are#here

保留数字

  1. String letterAndNumber = "1234abcdABCD56789";
  2. // 保留数字
  3. String number = CharMatcher.JAVA_DIGIT.retainFrom(letterAndNumber);
  4. System.out.println(number);// 123456789
3.将集合转换为特定规则的字符串

3.1以前我们将list转换为特定规则的字符串是这样写的:

  1. //use java
  2. List<String> list = new ArrayList<String>();
  3. list.add("aa");
  4. list.add("bb");
  5. list.add("cc");
  6. String str = "";
  7. for(int i=0; i<list.size(); i++){
  8. str = str + "-" +list.get(i);
  9. }
  10. //str 为-aa-bb-cc
  11. //use guava
  12. List<String> list = new ArrayList<String>();
  13. list.add("aa");
  14. list.add("bb");
  15. list.add("cc");
  16. String result = Joiner.on("-").join(list);
  17. //result为 aa-bb-cc

3.2把map集合转换为特定规则的字符串

  1. Map<String, Integer> map = Maps.newHashMap();
  2. map.put("xiaoming", 12);
  3. map.put("xiaohong",13);
  4. String result = Joiner.on(",").withKeyValueSeparator("=").join(map);
  5. // result为 xiaoming=12,xiaohong=13
4.将String转换为特定的集合
  1. //use java
  2. List<String> list = new ArrayList<String>();
  3. String a = "1-2-3-4-5-6";
  4. String[] strs = a.split("-");
  5. for(int i=0; i<strs.length; i++){
  6. list.add(strs[i]);
  7. }
  8. //use guava
  9. String str = "1-2-3-4-5-6";
  10. List<String> list = Splitter.on("-").splitToList(str);
  11. //list为 [1, 2, 3, 4, 5, 6]

guava还可以使用 omitEmptyStrings().trimResults() 去除空串与空格

  1. String str = "1-2-3-4- 5- 6 ";
  2. List<String> list = Splitter.on("-").omitEmptyStrings().trimResults().splitToList(str);
  3. System.out.println(list);

将String转换为map

  1. String str = "xiaoming=11,xiaohong=23";
  2. Map<String,String> map = Splitter.on(",").withKeyValueSeparator("=").split(str);
5.guava还支持多个字符切割,或者特定的正则分隔
  1. String input = "aa.dd,,ff,,.";
  2. List<String> result = Splitter.onPattern("[.|,]").omitEmptyStrings().splitToList(input);

关于字符串的操作 都是在Splitter这个类上进行的

  1. // 判断匹配结果
  2. boolean result = CharMatcher.inRange('a', 'z').or(CharMatcher.inRange('A', 'Z')).matches('K'); //true
  3. // 保留数字文本 CharMatcher.digit() 已过时 retain 保留
  4. //String s1 = CharMatcher.digit().retainFrom("abc 123 efg"); //123
  5. String s1 = CharMatcher.inRange('0', '9').retainFrom("abc 123 efg"); // 123
  6. // 删除数字文本 remove 删除
  7. // String s2 = CharMatcher.digit().removeFrom("abc 123 efg"); //abc efg
  8. String s2 = CharMatcher.inRange('0', '9').removeFrom("abc 123 efg"); // abc efg
6. 集合的过滤

我们对于集合的过滤,思路就是迭代,然后再具体对每一个数判断,这样的代码放在程序中,难免会显得很臃肿,虽然功能都有,但是很不好看。

guava写法

  1. import com.google.common.base.*;
  2. import com.google.common.collect.*;
  3. import com.google.common.collect.Maps;
  4. import org.junit.jupiter.api.Test;
  5. import java.util.*;
  6. /**
  7. * @author: xingkong
  8. * @date: 2020/11/18 10:26
  9. * @description:
  10. */
  11. public class Test8 {
  12. @Test
  13. public void Test1(){
  14. //按照条件过滤
  15. ImmutableList<String> names = ImmutableList.of("begin", "code", "Guava", "Java");
  16. Iterable<String> fitered = Iterables.filter(names, Predicates.or(Predicates.equalTo("Guava"), Predicates.equalTo("Java")));
  17. System.out.println(fitered);
  18. // [Guava, Java]
  19. //自定义过滤条件 使用自定义回调方法对Map的每个Value进行操作
  20. ImmutableMap<String, Integer> m = ImmutableMap.of("begin", 12, "code", 15);
  21. // Function<F, T> F表示apply()方法input的类型,T表示apply()方法返回类型
  22. Map<String, Integer> m2 = Maps.transformValues(m, input -> {
  23. if(input > 12){
  24. return input;
  25. }else{
  26. return input + 1;
  27. }
  28. });
  29. System.out.println(m2);
  30. //{begin=13, code=15}
  31. }
  32. }

set的交集, 并集, 差集

  1. HashSet setA = newHashSet(1, 2, 3, 4, 5);
  2. HashSet setB = newHashSet(4, 5, 6, 7, 8);
  3. SetView union = Sets.union(setA, setB);
  4. System.out.println("union:");
  5. for (Integer integer : union)
  6. System.out.println(integer); //union 并集:12345867
  7. SetView difference = Sets.difference(setA, setB);
  8. System.out.println("difference:");
  9. for (Integer integer : difference)
  10. System.out.println(integer); //difference 差集:123
  11. SetView intersection = Sets.intersection(setA, setB);
  12. System.out.println("intersection:");
  13. for (Integer integer : intersection)
  14. System.out.println(integer); //intersection 交集:45

map的交集,并集,差集

  1. HashMap<String, Integer> mapA = Maps.newHashMap();
  2. mapA.put("a", 1);mapA.put("b", 2);mapA.put("c", 3);
  3. HashMap<String, Integer> mapB = Maps.newHashMap();
  4. mapB.put("b", 20);mapB.put("c", 3);mapB.put("d", 4);
  5. MapDifference differenceMap = Maps.difference(mapA, mapB);
  6. differenceMap.areEqual();
  7. Map entriesDiffering = differenceMap.entriesDiffering();
  8. Map entriesOnlyLeft = differenceMap.entriesOnlyOnLeft();
  9. Map entriesOnlyRight = differenceMap.entriesOnlyOnRight();
  10. Map entriesInCommon = differenceMap.entriesInCommon();
  11. System.out.println(entriesDiffering); // {b=(2, 20)}
  12. System.out.println(entriesOnlyLeft); // {a=1}
  13. System.out.println(entriesOnlyRight); // {d=4}
  14. System.out.println(entriesInCommon); // {c=3}
7.检查参数
  1. //use java
  2. if(list!=null && list.size()>0)
  3. '''
  4. if(str!=null && str.length()>0)
  5. '''
  6. if(str !=null && !str.isEmpty())
  7. //use guava
  8. if(!Strings.isNullOrEmpty(str))
  9. //use java
  10. if (count <= 0) {
  11. throw new IllegalArgumentException("must be positive: " + count);
  12. }
  13. //use guava
  14. Preconditions.checkArgument(count > 0, "must be positive: %s", count);

免去了很多麻烦!并且会使你的代码看上去更好看。而不是代码里面充斥着 !=null, !=""

==检查是否为空,不仅仅是字符串类型,其他类型的判断,全部都封装在 Preconditions类里,里面的方法全为静态==

其中的一个方法的源码

  1. @CanIgnoreReturnValue
  2. public static <T> T checkNotNull(T reference) {
  3. if (reference == null) {
  4. throw new NullPointerException();
  5. }
  6. return reference;
  7. }

在这里插入图片描述

8. MoreObjects

这个方法是在Objects过期后官方推荐使用的替代品,该类最大的好处就是不用大量的重写 ==toString==,用一种很优雅的方式实现重写,或者在某个场景定制使用。

  1. Person person = new Person("aa",11);
  2. String str = MoreObjects.toStringHelper("Person").add("age", person.getAge()).toString();
  3. System.out.println(str);
  4. //输出Person{age=11}
9.强大的Ordering排序器

排序器[Ordering]是Guava流畅风格比较器[Comparator]的实现,它可以用来为构建复杂的比较器,以完成集合排序的功能。

  1. natural() 对可排序类型做自然排序,如数字按大小,日期按先后排序
  2. usingToString() 按对象的字符串形式做字典排序[lexicographical ordering]
  3. from(Comparator) 把给定的Comparator转化为排序器
  4. reverse() 获取语义相反的排序器
  5. nullsFirst() 使用当前排序器,但额外把null值排到最前面。
  6. nullsLast() 使用当前排序器,但额外把null值排到最后面。
  7. compound(Comparator) 合成另一个比较器,以处理当前排序器中的相等情况。
  8. lexicographical() 基于处理类型T的排序器,返回该类型的可迭代对象Iterable<T>的排序器。
  9. onResultOf(Function) 对集合中元素调用Function,再按返回值用当前排序器排序。

示例

  1. Person person = new Person("aa",14); //String name ,Integer age
  2. Person ps = new Person("bb",13);
  3. Ordering<Person> byOrdering = Ordering.natural().nullsFirst().onResultOf(new Function<Person,String>(){
  4. public String apply(Person person){
  5. return person.age.toString();
  6. }
  7. });
  8. byOrdering.compare(person, ps);
  9. System.out.println(byOrdering.compare(person, ps)); //1 person的年龄比ps大 所以输出1
10.计算中间代码的运行时间
  1. import com.google.common.base.Stopwatch;
  2. import java.util.concurrent.TimeUnit;
  3. /**
  4. * @author: xingkong
  5. * @date: 2020/11/18 20:16
  6. * @description:
  7. */
  8. public class Test9 {
  9. public static void main(String[] args) throws InterruptedException {
  10. // 创建stopwatch并开始计时
  11. Stopwatch stopwatch = Stopwatch.createStarted();
  12. Thread.sleep(1980);
  13. // 以秒打印从计时开始至现在的所用时间,向下取整
  14. System.out.println(stopwatch.elapsed(TimeUnit.SECONDS)); // 1
  15. // 停止计时
  16. stopwatch.stop();
  17. System.out.println(stopwatch.elapsed(TimeUnit.SECONDS)); // 1
  18. // 再次计时
  19. stopwatch.start();
  20. Thread.sleep(100);
  21. System.out.println(stopwatch.elapsed(TimeUnit.SECONDS)); // 2
  22. // 重置并开始
  23. stopwatch.reset().start();
  24. Thread.sleep(1030);
  25. // 检查是否运行
  26. System.out.println(stopwatch.isRunning()); // true
  27. long millis = stopwatch.elapsed(TimeUnit.MILLISECONDS); // 1034
  28. System.out.println(millis);
  29. // 打印
  30. System.out.println(stopwatch.toString()); // 1.034 s
  31. }
  32. }
11.文件操作

以前,我们写文件读取时,要定义缓冲区,各种条件判断,各种。。。。

而现在我们只需要用好guava的api就能使代码变的简介,并且不用单鞋因为漏写逻辑而背锅。

  1. File file = new File("test.txt");
  2. List<String> list = null;
  3. try {
  4. list = Files.readLines(file, Charsets.UTF_8);
  5. } catch (Exception e) {
  6. }
  7. Files.copy(from,to); //复制文件
  8. Files.deleteDirectoryContents(File directory); //删除文件夹下的内容(包括文件与子文件夹)
  9. Files.deleteRecursively(File file); //删除文件或者文件夹
  10. Files.move(File from, File to); //移动文件
  11. URL url = Resources.getResource("abc.xml"); //获取classpath根下的abc.xml文件url
12.guava缓存

==guava的缓存设计的比较巧妙,可以很精巧的使用。guava缓存创建分为两种,一种是CacheLoader,另一种则是callback方式==

CacheLoader:

  1. LoadingCache<String,String> cahceBuilder=CacheBuilder
  2. .newBuilder()
  3. .build(new CacheLoader<String, String>(){
  4. @Override
  5. public String load(String key) throws Exception {
  6. String strProValue="hello "+key+"!";
  7. return strProValue;
  8. }
  9. });
  10. System.out.println(cahceBuilder.apply("begincode")); //hello begincode!
  11. System.out.println(cahceBuilder.get("begincode")); //hello begincode!
  12. System.out.println(cahceBuilder.get("wen")); //hello wen!
  13. System.out.println(cahceBuilder.apply("wen")); //hello wen!
  14. System.out.println(cahceBuilder.apply("da"));//hello da!
  15. cahceBuilder.put("begin", "code");
  16. System.out.println(cahceBuilder.get("begin")); //code

api中已经把apply声明为过期,声明中推荐使用get方法获取值。

声明:本文内容由网友自发贡献,转载请注明出处:【wpsshop博客】
推荐阅读
相关标签
  

闽ICP备14008679号