1:guava源码笔记

一:官方教程

网址: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);

你可能感兴趣的:(1:guava源码笔记)