guava 学习

1，本文翻译自 http://eclipsesource.com/blogs/2012/06/06/cleaner-code-with-guava-optionals-and-preconditions/，有说的不对的地方，欢迎斧正。

2，我开发软件的时候，朝着干净代码发展是我的特权，有一段时间，我曾在我几乎所有的项目中使用谷歌瓜娃（Google Guava）,理由很简单，guava为我编写漂亮代码提供了很大的便利，今天，我想向你展示下我是怎么使用预判断来避免不必要的if/throw 申明，使用选择来提升代码逻辑性。

　　预判断并不是新东西，Apache Commons项目有类似的功能，但是并没有瓜娃提供的解决方案简洁，预判断用来验证方法的参数，状态等等，当条件判断结果是false，预判断就会抛出预想的异常，预想的意味着以下情形，当检查状态的时候，你可以使用Preconditions.checkState( 条件 )，如果条件判断的结果是false,将会抛出非法状态异常，同样，另外一种预判断checkArgument会抛出非法参数异常，当然，使用预判断你唯一需要明确的时候就是使用静态导入，让我们来看一个例子。

　　给出的是一个方法，接受list作为参数，当这个方法被调用的时候，我们需要检查list是不是null和是不是空，一般的java解决方案如下所示：

public void doSomething( List<Object> list ) {
  if( list == null ) {
    throw new IllegalArgumentException( "List must not be null" );
  }
  if( list.isEmpty() ) {
    throw new IllegalArgumentException( "List must not be empty" );
  }
  doSomethingMore( list );
}

　　当使用guava的预判断，代码的数量明显减少，解决方案如下所示.

public void doSomething( List<Object> list ) {
  checkArgument( list != null, "List must not be null" );
  checkArgument( !list.isEmpty(), "List must not be empty" );
  doSomethingMore( list );
}

　　这肯定是一个提升，但是，当这个方法结合瓜娃的选择变得真正的性感，选择是一个概念，被设计来避免病态的null概念（阅读这里理解我为神马叫她“病态”），这里明显有一个对象容器来避免空引用，例如，null 大部分时间用来检查一个对象是不是存在，如果不存在，一个空指针异常发生了，结果如以下代码所示：

public void doSomething() {
  if( this.field == null ) {
    throw new IllegalStateException( "Field is not initialized" );
  }
  doSomethingMore();
}

　　与其保存这个对象直接放到field，我经常使用选择.这避免了我代码中的空指针异常并且显得更合语法，上面这个例子结合选择变成了如下所示：

public void doSomething() {
  checkState( field.isPresent(), "Argument is not initialied" );
  doSomethingMore();
}

1，大纲

让我们来熟悉瓜娃，并体验下它的一些API,分成如下几个部分：

• Introduction
• Guava Collection API
• Guava Basic Utilities
• IO API
• Cache API

2，为神马选择瓜娃？

• 瓜娃是java API蛋糕上的冰激凌（精华）
• 高效设计良好的API.
• 被google的开发者设计，实现和使用。
• 遵循高效的java这本书的好的语法实践。
• 使代码更刻度，简洁，简单。
• 使用java 1.5的特性，
• 流行的API，动态的开发
• 它提供了大量相关的应用类，集合，多线程，比较，字符串，输入输出，缓存，网络，原生类型，数学，反射等等
• 百分百的单元测试，被很多的项目使用，帮助开发者专注业务逻辑而不是写java应用类
• 节省时间，资源，提高生产力
• 我的目的是为基本的java特征提供开源代码的支持，而不是自己再写一个
• Apache Common库-Apache是一个很好的成熟的库，但是不支持泛型，Apache对早起的java版本很有用，（1.5之前的）
• java7，java8 最新的java支持一些guava的API

guava最新的正式版本是14.0-rc2，这个版本需要java1.6支持.

最新的maven坐标是：

<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>14.0-rc2</version>
</dependency>

3,集合API的使用

　　3.1简化工作

可以简化集合的创建和初始化；

3.2 不变性

很大一部分是google集合提供了不变性，不变对比可变：

• 数据不可改变
• 线程安全
• 不需要同步逻辑
• 可以被自由的共享
• 容易设计和实现
• 内存和时间高效

不变对比不可修改

google的不变被确保真正不可改变，而不可修改实际上还是可以修改数据；如下所示：

Set<Integer> data = new HashSet<Integer>();

data.addAll(Arrays.asList(10, 20, 30, 40, 50, 60, 70, 80));

Set<Integer> fixedData = Collections.unmodifiableSet(data); // fixedData - [50, 70, 80, 20, 40, 10, 60, 30]

data.add(90); // fixedData - [50, 70, 80, 20, 40, 10, 90, 60, 30]

如何创建不可变的集合：

ImmutableSet<Integer> numbers = ImmutableSet.of(10, 20, 30, 40, 50);

使用copyOf方法

ImmutableSet<Integer> another = mmutableSet.copyOf(numbers);

使用Builder方法

ImmutableSet<Integer> numbers2 = ImmutableSet.<Integer>builder().addAll(numbers) .add(60) .add(70).add(80).build();

//3,创建不可变的集合

ImmutableList<Person> personImmutableList=
ImmutableList.of(new Person(1, 1, "a", "46546", 1, 20), new Person(2, 1, "a", "46546", 1, 20));

ImmutableSet<Person> personImmutableSet=ImmutableSet.copyOf(personSet2);

ImmutableMap<String,Person> personImmutableMap=ImmutableMap.<String,Person>builder()
.put("hell",new Person(1,1,"a","46546",1,20)).putAll(personMap2) .build();

3.3 新的集合类型

The Guava API provides very useful new collection types that work very nicely with existing java collections.

guava API 提供了有用的新的集合类型，协同已经存在的java集合工作的很好。

分别是 MultiMap， MultiSet， Table， BiMap， ClassToInstanceMap

ClassToInstanceMap<Number> numberDefaults = MutableClassToInstanceMap.create();numberDefaults.putInstance(Integer.class, Integer.valueOf(0));

3.4 谓词和筛选

谓词（Predicate）是用来筛选集合的；

谓词是一个简单的接口，只有一个方法返回布尔值，但是他是一个很令人惊讶的集合方法，当你结合collections2.filter方法使用，这个筛选方法返回原来的集合中满足这个谓词接口的元素；

举个例子来说：筛选出集合中的女人

public static void main(String[] args)
{
Optional<ImmutableMultiset<Person>> optional=Optional.fromNullable(testPredict());

if(optional.isPresent())
{
for(Person p:optional.get())
{
System.out.println("女人："+p);
}
}

System.out.println(optional.isPresent());
}

public static ImmutableMultiset<Person> testPredict()
{
List<Person> personList=Lists.newArrayList(new Person(1, 1, "a", "46546", 1, 20),
new Person(2, 1, "ab", "46546", 0, 30),
new Person(3, 1, "abc", "46546", 0, 25),
new Person(4, 1, "aef", "46546", 1, 50),
new Person(5, 1, "ade", "46546",0, 27),
new Person(6, 1, "acc", "46546", 1, 29),
new Person(7, 1, "add", "46546",0, 33));

return ImmutableMultiset.copyOf(Collections2.filter(personList,new Predicate<Person>() {
@Override
public boolean apply( Person input) {
return input.getSex()==0;
}
}));
}

Predicates含有一些内置的筛选方法，比如说 in ,and ,not等，根据实际情况选择使用。

3.5 功能和转换

转换一个集合为另外一个集合；

实例如下：

public static void main(String[] args)
{
Optional<ImmutableMultiset<String>> optional=Optional.fromNullable(testTransform());

if(optional.isPresent())
{
for(String p:optional.get())
{
System.out.println("名字："+p);
}
}

System.out.println(optional.isPresent());
}

public static ImmutableMultiset<String> testTransform()
{
List<Person> personList=Lists.newArrayList(new Person(1, 1, "a", "46546", 1, 20),
new Person(2, 1, "ab", "46546", 0, 30),
new Person(3, 1, "abc", "46546", 0, 25),
new Person(4, 1, "aef", "46546", 1, 50),
new Person(5, 1, "ade", "46546",0, 27),
new Person(6, 1, "acc", "46546", 1, 29),
new Person(7, 1, "add", "46546",0, 33));

return ImmutableMultiset.copyOf(Lists.transform(personList,new Function<Person, String>() {
@Override
public String apply( Person input) {
return input.getName();
}
}));
}

3.6 排序

是guava一份非常灵活的比较类，可以被用来操作，扩展，当作比较器，排序提供了集合排序的很多控制；

实例如下：

Lists.newArrayList(30, 20, 60, 80, 10);

Ordering.natural().sortedCopy(numbers); //10,20,30,60,80

Ordering.natural().reverse().sortedCopy(numbers); //80,60,30,20,10

Ordering.natural().min(numbers); //10

Ordering.natural().max(numbers); //80

Lists.newArrayList(30, 20, 60, 80, null, 10);

Ordering.natural().nullsLast().sortedCopy(numbers); //10, 20,30,60,80,null

Ordering.natural().nullsFirst().sortedCopy(numbers); //null,10,20,30,60,80

public static void testOrdering()
{
List<Person> personList=Lists.newArrayList(
new Person(3, 1, "abc", "46546", 0, 25),
new Person(2, 1, "ab", "46546", 0, 30),
new Person(5, 1, "ade", "46546",0, 27),
new Person(1, 1, "a", "46546", 1, 20),
new Person(6, 1, "acc", "46546", 1, 29),
new Person(4, 1, "aef", "46546", 1, 50),
new Person(7, 1, "add", "46546",0, 33)
);

Ordering<Person> byAge=new Ordering<Person>() {
@Override
public int compare( Person left, Person right) {
return right.getAge()-left.getAge();
}
};

for(Person p: byAge.immutableSortedCopy(personList))
{
System.out.println(p);
}
}

引用 ： http://www.cnblogs.com/snidget/archive/2013/02/05/2893344.html