Guava的Collections2：过滤和转换Java集合

Groovy的便利之一是能够通过Groovy的闭包支持轻松地对集合执行过滤和转换操作。 Guava将对集合的过滤和转换引入标准Java，这是本文的主题。

Guava的Collections2类具有两个公共方法，这两个方法都是静态的。方法filter（Collection，Predicate）和transform（Collection，Function）的作用含义是：分别对给定的集合执行过滤和转换。要过滤或转换的集合是每个静态方法的第一个参数。过滤函数的第二个参数是Guava的Predicate类的实例。转换函数的第二个参数是Guava的Function类的实例。这篇文章的其余部分展示了如何将所有这些结合在一起以过滤和转换Java集合。

使用番石榴过滤收藏

使用番石榴过滤集合非常简单。下面的代码片段演示了一个简单的示例。提供了一个String Set （未在代码片段中显示，但在代码后的输出中显而易见），并且仅对以大写字母“ J”开头的条目过滤了所提供的Set 。这是通过使用Java正则表达式支持和Guava的Predicates.containsPattern（String）来完成的，但是还可以指定其他类型的Predicate 。

过滤以'J'开头的字符串

/*** Demonstrate Guava's Collections2.filter method. Filter String beginning * with letter 'J'.*/public static void demonstrateFilter(){printHeader('Collections2.filter(Collection,Predicate): 'J' Languages');final Set<String> strings = buildSetStrings();out.println('\nOriginal Strings (pre-filter):\n\t' + strings);final Collection<String> filteredStrings =Collections2.filter(strings, Predicates.containsPattern('^J'));out.println('\nFiltered Strings:\n\t' + filteredStrings);out.println('\nOriginal Strings (post-filter):\n\t' + strings);}

接下来显示运行上述方法的输出。此输出显示了构成buildSetStrings()返回的原始String Set的冗长的编程语言列表，并显示了仅包含以'J'开头的那些编程语言的过滤器调用的结果。

使用番石榴改变收藏

使用Guava转换集合类似于语法过滤，但使用Function来指定如何将源集合条目“转换”为输出集合，而不是使用Predicate来确定要保留哪些条目。以下代码段演示了如何将给定集合中的条目转换为自身的大写版本。

将条目转换为大写

/*** Demonstrate Guava's Collections2.transform method. Transform input* collection's entries to uppercase form.*/public static void demonstrateTransform(){printHeader('Collections2.transform(Collection,Function): Uppercase');final Set<String> strings = buildSetStrings();out.println('\nOriginal Strings (pre-transform):\n\t' + strings);final Collection<String> transformedStrings = Collections2.transform(strings, new UpperCaseFunction<String, String>());out.println('\nTransformed Strings:\n\t' + transformedStrings);out.println('\nOriginal Strings (post-transform):\n\t' + strings);}

上面的转换代码片段使用了一个名为UpperCaseFunction的类，但是在Guava API文档中找不到该类。这是一个自定义类，如下面的代码清单所示。

UpperCaseFunction.java

package dustin.examples;import com.google.common.base.Function;/*** Simple Guava Function that converts provided object's toString() representation* to upper case.* * @author Dustin*/
public class UpperCaseFunction<F, T> implements Function<F, T>
{@Overridepublic Object apply(Object f){return f.toString().toUpperCase();}
}

接下来显示运行使用UpperCaseFunction类的转换代码段的输出。

上面的代码段显示了专用于使用Guava过滤和转换集合条目的方法。接下来显示主要类的完整代码清单。

GuavaCollections2.java

package dustin.examples;import static java.lang.System.out;import com.google.common.base.Predicates;
import com.google.common.collect.Collections2;
import java.util.Collection;
import java.util.HashSet;
import java.util.Set;/*** Class whose sole reason for existence is to demonstrate Guava's Collections2* class.* * @author Dustin*/
public class GuavaCollections2
{/*** Provides a Set of Strings.* * @return Set of strings representing some programming languages.*/private static Set<String> buildSetStrings(){final Set<String> strings = new HashSet<String>();strings.add('Java');strings.add('Groovy');strings.add('Jython');strings.add('JRuby');strings.add('Python');strings.add('Ruby');strings.add('Perl');strings.add('C');strings.add('C++');strings.add('C#');strings.add('Pascal');strings.add('Fortran');strings.add('Cobol');strings.add('Scala');strings.add('Clojure');strings.add('Basic');strings.add('PHP');strings.add('Flex/ActionScript');strings.add('JOVIAL');return strings;}/*** Demonstrate Guava's Collections2.filter method. Filter String beginning * with letter 'J'.*/public static void demonstrateFilter(){printHeader('Collections2.filter(Collection,Predicate): 'J' Languages');final Set<String> strings = buildSetStrings();out.println('\nOriginal Strings (pre-filter):\n\t' + strings);final Collection<String> filteredStrings =Collections2.filter(strings, Predicates.containsPattern('^J'));out.println('\nFiltered Strings:\n\t' + filteredStrings);out.println('\nOriginal Strings (post-filter):\n\t' + strings);}/*** Demonstrate Guava's Collections2.transform method. Transform input* collection's entries to uppercase form.*/public static void demonstrateTransform(){printHeader('Collections2.transform(Collection,Function): Uppercase');final Set<String> strings = buildSetStrings();out.println('\nOriginal Strings (pre-transform):\n\t' + strings);final Collection<String> transformedStrings = Collections2.transform(strings, new UpperCaseFunction<String, String>());out.println('\nTransformed Strings:\n\t' + transformedStrings);out.println('\nOriginal Strings (post-transform):\n\t' + strings);}/*** Print a separation header including the provided text.* * @param headerText Text to be included in separation header.*/private static void printHeader(final String headerText){out.println('\n==========================================================');out.println('== ' + headerText);out.println('==========================================================');}/*** Main function for demonstrating Guava's Collections2 class.* * @param arguments */public static void main(final String[] arguments){demonstrateFilter();demonstrateTransform();}
}

在结束本文之前，这里需要注意一个重要的注意事项。在Collections2类上定义的这两种方法在其Javadoc文档中均包含有关其使用的警告。两种方法都提供了被视为原始集合“实时视图”的集合，因此“对一个集合的更改会影响另一个集合”。例如，从源集合中删除元素类似地将其从转换后的集合中删除。每个方法的文档还警告即使源集合是可序列化的和/或线程安全的，也不会返回可序列化或线程安全的集合。

结论

Guava使使用Java过滤集合和转换集合条目变得更加容易。尽管执行类似操作的代码可能不如Groovy简洁，但是它比不使用Guava的Collections2类编写直接Java代码要好。 Java集合可以使用Collections2.filter(Collection,Predicate)进行过滤，也可以使用Collections2.transform(Collection,Function) 。

参考：在Inspired by Actual Events博客上，我们的JCG合作伙伴 Dustin Marx 用Guava的Collections2过滤和转换Java集合。