一:官方教程
网址:http://blog.csdn.net/axi295309066/article/details/53726023
API文档:http://tool.oschina.net/apidocs/apidoc?api=guava
博客:http://ju.outofmemory.cn/entry/67423
博客:http://outofmemory.cn/java/guava/base/Strings
Github地址:https://github.com/google/guava/wiki/CachesExplained
二:Optional优雅的使用null
Optional方法说明和使用实例:
1.常用静态方法:
Optional.of(T):获得一个Optional对象,其内部包含了一个非null的T数据类型实例,若T=null,则立刻报错。
Optional.absent():获得一个Optional对象,其内部包含了空值
Optional.fromNullable(T):将一个T的实例转换为Optional对象,T的实例可以不为空,也可以为空[Optional.fromNullable(null),和Optional.absent()等价。
2.实例方法:
1>. boolean isPresent():如果Optional包含的T实例不为null,则返回true;若T实例为null,返回false
2>. T get():返回Optional包含的T实例,该T实例必须不为空;否则,对包含null的Optional实例调用get()会抛出一个IllegalStateException异常
3>. T or(T):若Optional实例中包含了传入的T的相同实例,返回Optional包含的该T实例,否则返回输入的T实例作为默认值
4>. T orNull():返回Optional实例中包含的非空T实例,如果Optional中包含的是空值,返回null,逆操作是fromNullable()
5>. Set asSet():返回一个不可修改的Set,该Set中包含Optional实例中包含的所有非空存在的T实例,且在该Set中,每个T实例都是单态,如果Optional中没有非空存在的T实例,返回的将是一个空的不可修改的Set。
三:函数式编程
Guava提供两个基本的函数式接口:
Function,它声明了单个方法B apply(A input)。Function对象通常被预期为引用透明的——没有副作用——并且引用透明性中的”相等”语义与equals一致,如a.equals(b)意味着function.apply(a).equals(function.apply(b))。
Predicate,它声明了单个方法boolean apply(T input)。Predicate对象通常也被预期为无副作用函数,并且”相等”语义与equals一致。
注意:Range类实现了Predicate,用以判断值是否在区间内。
1:断言
注意:断言Predicate的最基本应用就是过滤集合。所有Guava过滤方法都返回”视图”。也就是说:并非用一个新的集合表示过滤,而只是基于原集合的视图。
集合类型过滤方法
IterableIterables.filter(Iterable, Predicate)
FluentIterable.filter(Predicate)
IteratorIterators.filter(Iterator, Predicate)
CollectionCollections2.filter(Collection, Predicate)
SetSets.filter(Set, Predicate)
SortedSetSets.filter(SortedSet, Predicate)
MapMaps.filterKeys(Map, Predicate)
Maps.filterValues(Map, Predicate)
Maps.filterEntries(Map, Predicate)
SortedMapMaps.filterKeys(SortedMap, Predicate)
Maps.filterValues(SortedMap,Predicate)
Maps.filterEntries(SortedMap, Predicate)
MultimapMultimaps.filterKeys(Multimap, Predicate)
Multimaps.filterValues(Multimap, Predicate)
Multimaps.filterEntries(Multimap, Predicate)
另外还有:Guava另外提供了若干用Predicate处理Iterable的工具——通常在Iterables工具类中。
Iterables方法签名说明另请参见
boolean all(Iterable, Predicate)是否所有元素满足断言?懒实现:如果发现有元素不满足,不会继续迭代Iterators.all(Iterator, Predicate)
FluentIterable.allMatch(Predicate)
boolean any(Iterable, Predicate)是否有任意元素满足元素满足断言?懒实现:只会迭代到发现满足的元素Iterators.any(Iterator, Predicate)
FluentIterable.anyMatch(Predicate)
T find(Iterable,Predicate)循环并返回一个满足元素满足断言的元素,如果没有则抛出NoSuchElementExceptionIterators.find(Iterator, Predicate)
Iterables.find(Iterable, Predicate, T default)
Iterators.find(Iterator, Predicate, T default)
Optional tryFind(Iterable, Predicate)返回一个满足元素满足断言的元素,若没有则返回Optional.absent()Iterators.find(Iterator, Predicate)
Iterables.find(Iterable, Predicate, T default)
Iterators.find(Iterator, Predicate, T default)
indexOf(Iterable, Predicate)返回第一个满足元素满足断言的元素索引值,若没有返回-1Iterators.indexOf(Iterator, Predicate)
removeIf(Iterable, Predicate)移除所有满足元素满足断言的元素,实际调用Iterator.remove()方法Iterators.removeIf(Iterator, Predicate)
2:函数
注意:到目前为止,函数最常见的用途为转换集合。同样,所有的Guava转换方法也返回原集合的视图。
集合类型转换方法
IterableIterables.transform(Iterable, Function)
FluentIterable.transform(Function)
IteratorIterators.transform(Iterator, Function)
CollectionCollections2.transform(Collection, Function)
ListLists.transform(List, Function)
Map*Maps.transformValues(Map, Function)
Maps.transformEntries(Map, EntryTransformer)
SortedMap*Maps.transformValues(SortedMap, Function)
Maps.transformEntries(SortedMap, EntryTransformer)
Multimap*Multimaps.transformValues(Multimap, Function)
Multimaps.transformEntries(Multimap, EntryTransformer)
ListMultimap*Multimaps.transformValues(ListMultimap, Function)
Multimaps.transformEntries(ListMultimap, EntryTransformer)
TableTables.transformValues(Table, Function)
*Map和Multimap有特殊的方法,其中有个EntryTransformer参数,它可以使用旧的键值来计算,并且用计算结果替换旧值。
可以组合Function使用的类包括:
OrderingOrdering.onResultOf(Function)
PredicatePredicates.compose(Predicate, Function)
EquivalenceEquivalence.onResultOf(Function)
SupplierSuppliers.compose(Function, Supplier)
FunctionFunctions.compose(Function, Function)
此外,ListenableFuture API支持转换ListenableFuture。Futures也提供了接受AsyncFunction参数的方法。AsyncFunction是Function的变种,它允许异步计算值。
Futures.transform(ListenableFuture, Function)
Futures.transform(ListenableFuture, Function, Executor)
Futures.transform(ListenableFuture, AsyncFunction)
Futures.transform(ListenableFuture, AsyncFunction, Executor)
二:字符串处理:分隔,连接,填充
连接器[Joiner]
用分隔符把字符串序列连接起来也可能会遇上不必要的麻烦。如果字符串序列中含有null,那连接操作会更难。Fluent风格的Joiner让连接字符串更简单。
Joiner joiner = Joiner.on("; ").skipNulls();return joiner.join("Harry", null, "Ron", "Hermione");
上述代码返回”Harry; Ron; Hermione”。另外,useForNull(String)方法可以给定某个字符串来替换null,而不像skipNulls()方法是直接忽略null。 Joiner也可以用来连接对象类型,在这种情况下,它会把对象的toString()值连接起来。
Joiner.on(",").join(Arrays.asList(1, 5, 7)); // returns "1,5,7"
警告:joiner实例总是不可变的。用来定义joiner目标语义的配置方法总会返回一个新的joiner实例。这使得joiner实例都是线程安全的,你可以将其定义为static final常量。
拆分器[Splitter]
JDK内建的字符串拆分工具有一些古怪的特性。比如,String.split悄悄丢弃了尾部的分隔符。
拆分器工厂
方法描述范例
Splitter.on(char)按单个字符拆分Splitter.on(‘;’)
Splitter.on(CharMatcher)按字符匹配器拆分Splitter.on(CharMatcher.BREAKING_WHITESPACE)
Splitter.on(String)按字符串拆分Splitter.on(“, “)
Splitter.on(Pattern)Splitter.onPattern(String)按正则表达式拆分Splitter.onPattern(“\r?\n”)
Splitter.fixedLength(int)按固定长度拆分;最后一段可能比给定长度短,但不会为空。Splitter.fixedLength(3)
拆分器修饰符
方法描述
omitEmptyStrings()从结果中自动忽略空字符串
trimResults()移除结果字符串的前导空白和尾部空白
trimResults(CharMatcher)给定匹配器,移除结果字符串的前导匹配字符和尾部匹配字符
limit(int)限制拆分出的字符串数量
字符集[Charsets]
bytes=string.getBytes(Charsets.UTF_8);