google guava使用介绍

ゞ浴缸里的玫瑰 2022-09-23 10:54 209阅读 0赞

## guava简介 ##

Google Guava很优秀，大有取代Apache Commons之势。Guava是用来，用原汁原味的英文来说就是“Our goal is for you to write less code and for the code you do write to be simpler, cleaner, and more readable”，Guava中主要包括Basic Utilities，Collections，Caches，Functional Idioms，Concurrency，Strings，Primitives Support，Ranges，I/O等等。下面介绍一些它的简单使用例子：  
1、预先判断Preconditions  
　　可以用在方法的开始或者是构造函数的开始，对于不合法的校验可以快速报错。

import static com.google.common.base.Preconditions.checkArgument;
    import static com.google.common.base.Preconditions.checkNotNull;
    
    public class PreconditionsDemo {
        public static void main(String[] args) {
            new Car(null);//Exception in thread "main" java.lang.NullPointerException
            //Exception in thread "main" java.lang.IllegalArgumentException: speed (0.0) must be positive
            new Car("Audi").drive(0);
        }
    }
    
    class Car {
        private String name;
    
        public Car(String name) {
            this.name = checkNotNull(name);//NPE Null Pointer Exception
        }
    
        public void drive(double speed) {
            checkArgument(speed > 0.0, "speed (%s) must be positive", speed);
        }
    }

除了checkNotNull之外，Preconditions还提供了一些其他的方法，如chekArgument, checkState, checkElementIndex, checkPositionIndex等,更多可参考Preconditions API。

2、Object.toStringHelper()  
　　这个方法主要是用于更加简单的实现Object.toString()方法。

import com.google.common.base.MoreObjects;
    
    public class MoreObjectsDemo {
        private String name;
        private String userId;
        private String petName;
        private String sex;
    
        @Override
        public String toString() {
            //prints:MoreObjectsDemo{name=testName, userId=NO1, petName=PIG}
            return MoreObjects.toStringHelper(this).add("name", "testName").add("userId", "NO1").add("petName", "PIG").omitNullValues().toString();
            //prints:MoreObjectsDemo{name=testName, userId=NO1, petName=PIG}
            //return MoreObjects.toStringHelper(this).add("name", "testName").add("userId", "NO1").add("petName", "PIG").toString();
        }
        public static void main(String[] args) {
            System.out.println(new MoreObjectsDemo());
        }
    }

3、Stopwatch(计时器)  
　　我们经常需要判断某一段语句执行需要多少时间，过去常用的做法是记录运行前的时间，然后用运行完成的时间减去运行前的时间，并且转换成我们可读的秒或是毫秒时间（这个转换过程可并不简单），在guava中可以有一个更好的方法：

import com.google.common.base.Stopwatch;
    
    public class StopWatchDemo {
        public static void main(String[] args) {
    
            final Stopwatch stopwatch = Stopwatch.createUnstarted().start();
            //start
            stopwatch.start();
            try {
                System.out.println("You can do something!");
                Thread.sleep(1000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            stopwatch.stop();
            long nanos = stopwatch.elapsed(TimeUnit.NANOSECONDS);
            System.out.println(nanos);//1000076976
        }
    }

附：TimeUUnit可选值有：  
　　NANOSECONDS 毫微秒 十亿分之一秒（就是微秒/1000）  
　　MICROSECONDS 微秒 一百万分之一秒（就是毫秒/1000）  
　　MILLISECONDS 毫秒 千分之一秒  
　　SECONDS 秒  
　　MINUTES 分钟  
　　HOURS 小时  
　　DAYS 天

4、CharMatcher  
　　字符匹配的方法特别多，举一个例子过滤用户的输出。

import com.google.common.base.CharMatcher;
    
    public class CharMatcherDemo {
        private static final CharMatcher ID_MATCHER = CharMatcher.DIGIT.or(CharMatcher.is('-'));
    
        public static void main(String[] args) {
            String userID = "123454-333";
            String s = ID_MATCHER.retainFrom(userID);
            System.out.println(s);//123454-333
            s = ID_MATCHER.retainFrom("1 test 11-222");
            System.out.println(s);//可以把输入的的字符类型去掉，111-222
        }
    }

5、String Joining 字符串连接  
　　可以快速地把一组字符数组连接成为用特殊符合连接的一个字符串，如果这组字符中有null值的话，我们可以使用skipNulls或是useForNull来控制我们要输出的内容。

//Joiner JOINER= Joiner.on(",").skipNulls();
    
    Joiner JOINER= Joiner.on(",").useForNull("null");
    
    String str = JOINER.join("hello","world",null,"qiyadeng");
    
    //hello,world,null,qiyadeng

6、String Splitting字符串分割  
　　有这样一组字符串”hello, ,qiyadeng,com,”我们用split(“,”)分割字符串,得到的结果是\[“hello”,”“,”qiyaeng”,”com”\]，但是我们如果希望的是把空值去掉，还需要另外处理，使用guava的Splitter可以简单做到。使用指定的分隔符对字符串进行拆分，默认对空白符不做任何处理，并且不会静默的丢弃末尾分隔符，如果需要处理的话要显式调用trimResults()，omitEmptyStrings()。

public class SplitterDemo {
        public static void main(String[] args) {
            Iterable<String> split = Splitter.on(',').trimResults().omitEmptyStrings().split("foo, ,bar,quux,blue,");
            for (String s : split) {
                System.out.print(s + "---");//foo---bar---quux---blue---
            }
            System.out.println();
            String[] split1 = "foo, ,bar,quux,blue,".split(",");
            for (String s : split1) {
                System.out.print(s + "---");//foo--- ---bar---quux---blue---
            }
        }
    }

7、Guava的官方API参考文档：  
[http://google.github.io/guava/releases/snapshot/api/docs/][http_google.github.io_guava_releases_snapshot_api_docs]  
[https://github.com/google/guava][https_github.com_google_guava]

[http_google.github.io_guava_releases_snapshot_api_docs]: http://google.github.io/guava/releases/snapshot/api/docs/
[https_github.com_google_guava]: https://github.com/google/guava