google guava使用教程系列（3）- 前置条件检查

 guava, java, 工具  No Responses »
9月 262019
 

google guava使用教程系列（3）- 前置条件检查

原文地址:[https://github.com/google/guava/wiki/PreconditionsExplained])(https://github.com/google/guava/wiki/PreconditionsExplained)

简而言之，guava提供了一系列检查参数的方案，个人感觉一般，实际业务场景中对于参数判断自己写可能比这种封装更方便。

官方举的例子：

checkArgument(i >= 0, "Argument was %s but expected nonnegative", i);
checkArgument(i < j, "Expected i < j, but %s >= %s", i, j);

大致有如下几类：

  • checkArgument(boolean)
  • checkNotNull(T)
  • checkState(boolean)
  • checkElementIndex(int index, int size)
  • checkPositionIndex(int index, int size)
  • checkPositionIndexes(int start, int end, int size)

http://ifeve.com/google-guava-preconditions/有翻译，但翻译不全，建议github上的原版wiki。看名字基本能猜到方法用途，看个人喜好吧，我个人倒是更喜欢apache commons里的校验方法，比如StringUtils.isEmpty()

google guava使用教程系列（2）-使用与避免使用null

 guava, java, 工具  No Responses »
5月 192019
 

有关null的使用

不要在Set中使用null，或者把null作为map的键值。使用特殊值代表null会让查找操作的语义更清晰。

如果你想把null作为map中某条目的值，更好的办法是 不把这一条目放到map中，而是单独维护一个”值为null的键集合” (null keys)。Map 中对应某个键的值是null，和map中没有对应某个键的值，是非常容易混淆的两种情况。因此，最好把值为null的键分离开，并且仔细想想，null值的键在你的项目中到底表达了什么语义。

如果你需要在列表中使用null，并且这个列表的数据是稀疏的，使用Map<Integer, E>可能会更高效，并且更准确地符合你的潜在需求。

此外，考虑一下使用自然的null对象——特殊值。举例来说，为某个enum类型增加特殊的枚举值表示null，比如java.math.RoundingMode就定义了一个枚举值UNNECESSARY，它表示一种不做任何舍入操作的模式，用这种模式做舍入操作会直接抛出异常。

如果你真的需要使用null值，但是null值不能和Guava中的集合实现一起工作，你只能选择其他实现。比如，用JDK中的Collections.unmodifiableList替代Guava的ImmutableList

Optional的使用

大多数情况下，开发人员使用null表明的是某种缺失情形：可能是已经有一个默认值，或没有值，或找不到值。例如，Map.get返回null就表示找不到给定键对应的值。
Continue reading »

google guava使用教程系列（1）-String相关

 guava, java  No Responses »
4月 142019
 

注意：本文档基于google guava 28 wiki

Joiner

连接器

将字符串拼接

Joiner joiner = Joiner.on("; ").skipNulls();
return joiner.join("Harry", null, "Ron", "Hermione");

返回Harry; Ron; Hermione
skipNulls()方法是直接忽略null，使用useForNull(String)方法可以给定某个字符串来替换null，即

Joiner joiner = Joiner.on("; ").useForNull("替换字符串");

Continue reading »