第1章 入门指南

一、Google Guava简介

什么是Google Guava?最初开始于2007年的"Google Collections Library",它为使用Java集合类提供了实用程序,Google Guava项目已经发展成为Java开发者必备的工具集。

它有为了处理字符串(strings),集合(collections),并发(concurrency),I/O和反射(reflection)的类。

Function接口给了我们把函数式编程整合进Java的能力,且极大地简化我们的代码。

Supplier接口有助于创建型模式(creational patterns)。

但Guava不仅仅是带有一些Java之外的模版的抽象,或我们总觉得本应该放到Java中的便利方法。它有关编写良好的代码且让代码更富有弹性和简洁性。

所有我的建议是:不只是使用Guava,而且要看看源码和感受一下功能是如何实现的。然后尝试将你学到的原理应用于你的代码。

 

二、安装Guava
为了开始使用Guava,你只需要安装Java 1.6或更高的版本。Guava的最新版本是18.0,发布于2014年8月25日。
以下是你开始使用Guava,需要执行执行的步骤:
1.下载guava-18.0.jar,地址:http://mvnrepository.com/artifact/com.google.guava或者http://central.maven.org/maven2/com/google/guava/。
2.如果你正在使用GWT且想要在代码中利用Guava的优势,下载GWT兼容版guava-gwt-18.0.jar。
3.一旦JAR文件已下载,将其作为外部库添加到你的IDE中(IntelliJ, NetBeans, 或Eclipse)。如果你正在使用文本编辑器(Sublime Text 2或TextMate),添加JAR文件到你的classpath。
4.为了方便地使用Guava,可以下载Guava的源码包guava-18.0-sources.jar和Guava的API包guava-18.0-javadoc.jar。

 

三、和Maven或Gradle一起使用Guava

尽可能地和构建工具(如Maven或Gradle)一起使用Guava。

为了在你的Maven项目中使用Guava,添加如下内容到你的pom.xml文件的dependencies部分:
<dependency>
 <groupId>com.google.guava</groupId>
 <artifactId>guava</artifactId>
 <version>18.0</version>
</dependency>

如果你正在使用Gradle,首先要添加Maven中央资料库(如果你还没有),是通过添加如下内容到你的build.gradle文件中来实现的:
repositories {
    mavenCentral()
}

然后,添加如下添加如下内容(只需compile group部分)到你的build.gradle文件的dependencies部分:

dependencies {
    compile group: 'com.google.guava' name: 'guava' version: '18.0'
}

Maven的更多信息:http://maven.apache.org/
Gradle的更多信息:http://www.gradle.org/

 

提及Guava只有一个依赖即JSR-305,是非常重要的。

JSR-305是一个定义注释的规范,它被Java程序中检查缺陷的工具使用。详见:https://jcp.org/en/jsr/detail?id=305。

如果你不打算直接使用JSR-305 JAR包,你不需要将它包含在你的dependencies中。但是如果你想使用JSR-305,你需要显式定义这个依赖,因为它不会自动被引入。

另外,如果你打算在Sacla中使用Guava,你将必须引入JSR-305 JAR文件。尽管Java编译器编译时不需要包含注释(annotations)的包,但Scala编译器目前需要。

尽管未来可能会改变,但是现在,如果你想要在Scala中使用Guava,你将需要把JSR-305 JAR文件放在你的classpath下。

 

在Maven项目使用Guava:
打开Eclipse,File--New--Maven Project,
Next--选择"maven-archetype-quickstart", Next,
Group Id: com.xxx.guava
Artifact Id: guavademo
Version: 0.0.1-SNAPSHOT
Package: com.xxx.guava.guavademo

--Finally。


在pom.xml的<dependencies>标签部分添加:
<dependency>
  <groupId>com.google.guava</groupId>
  <artifactId>guava</artifactId>
  <version>18.0</version>
</dependency>


在Eclipse中配置Maven下载源码和javadoc:
Window--Preferences--Maven:
选择"Download Artifact Sources"和"Download Artifact JavaDoc"即可。
(还可以选择"Download repository index updates on startup")


接下来,就可以使用Guava了。

 

 

 

 

 

 

你可能感兴趣的:(第1章 入门指南)