使用谷歌guava（一）：guava基本工具

最新推荐文章于 2024-02-20 00:53:50 发布
最新推荐文章于 2024-02-20 00:53:50 发布
阅读量727 收藏 2
点赞数
文章标签： guava 工具类 字符串处理
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/xlspadan/article/details/80133525
版权

本文大部分内容翻译自英文书籍《Getting Started with Google Guava》，作者对内容进行了适当补充修改并作了排版优化。

内容概要

  • 使用Joiner类将多个字符串以指定分隔符进行连接，涵盖MapJoiner类的使用。
  • 使用Splitter类将字符串以指定分隔符进行分割，涵盖MapSplitter类的使用。
  • 字符串操作，如去除特定子串，字符串匹配等，主要涉及CharMatcher和Strings类
  • 使用Preconditions对变量、参数等进行校验
  • 其他基本工具，包括帮助生成对象的toString、hashcode等方法的工具类，以及实现Comparable接口的简易方法

使用Joiner类

1. 将多个字符串以特定分隔符相连
// 不使用guava
public String buildString(List<String> stringList, String delimiter){
    StringBuilder builder = new StringBuilder();
    for (String s : stringList) {
        if(s !=null){
            builder.append(s).append(delimiter);
        }
    }
    // 需要去掉字符串尾端的分隔符
    builder.setLength(builder.length() – delimiter.length());
    return builder.toString();
}
// 使用guava
String[] stringList=new String[]{"foo","bar",null}
// skipNulls 忽略字符串数组中的null元素,输出“foo|bar”
Joiner.on("|").skipNulls().join(stringList);
// useForNUll 使用指定值替换字符串数组中的null元素,输出"foo|bar|no value"
Joiner.on("|").useForNull("no value").join(stringList);
2. 配合Appendable使用

appendable是个接口，表示可追加的，其常用实现类有stringbuilder及一些IO类如BufferWriter、FileWriter等，使用Joiner可以很方便的向这些对象中追加内容。

例一：

```
StringBuilder sb = new StringBuilder();
Joiner joiner = Joiner.on("|").skipNulls();
//返回StringBuilder实例，打印sb.toString输出"foo|bar|baz"
joiner.appendTo(sb,"foo","bar","baz")
```

例二：

```
FileWriter fileWriter = new FileWriter(new File("path")):
List<Date> dateList = getDates();
Joiner joiner = Joiner.on("#").useForNulls(" ");
//返回FileWriter实例， dateList中的数据以“#”连接后追加至FileWriter实例中
joiner.appendTo(fileWriter,dateList);
```
3. MapJoiner连接Map元素

MapJoiner的功能是将Map中的所有元素以指定分隔符连接在一起形成一个特定格式的字符串，MapJoiner实例的创建方法如下：

/*
 * Joiner.on("#")创建了Joiner对象，元素之间以“#”分隔
 * 在Joiner对象上调用withKeyValueSeparator("=")创建MapJoiner对象，Map元素的key、value之间以“=”分隔
 */
mapJoiner = Joiner.on("#").withKeyValueSeparator("=");

一个实例：

@Test
public void testMapJoiner() {
    String expectedString = "Washington D.C=Redskins#New York City=Giants#Philadelphia=Eagles#Dallas=Cowboys";
    //使用LinkedHashMap保证元素连接的顺序，使用hashMap的话，连接顺序与元素的put顺序可能不一致，这跟hashMap的遍历是一样的
    Map<String,String> testMap = Maps.newLinkedHashMap();
    testMap.put("Washington D.C","Redskins");
    testMap.put("New York City","Giants");
    testMap.put("Philadelphia","Eagles");
    testMap.put("Dallas","Cowboys");
    String returnedString = Joiner.on("#").withKeyValueSeparator("=").join(testMap);
    assertThat(returnedString,is(expectedString));
}
3. 注意事项：

  1. Joiner类连接的对象不局限于字符串，任何对象的数组、集合、可变参数都可以，底层是调用入参各个元素的toString方法得到待连接的字符串。如果没有使用skipNulls或useForNull,遇到null元素将会抛出NPE。

  2. Joiner类是不可变的，因此也是线程安全的，可以声明为static final变量以重用。考虑下面的代码：

Joiner stringJoiner = Joiner.on("|").skipNulls();
//useForNull()返回了一个新的Joiner实例，stringJoiner仍引用的是原来的Joiner
stringJoiner.useForNull("missing");
// null元素将被忽略，而不会替换为“missing”，输出"foo|bar"
stringJoiner.join("foo","bar",null);

使用Splitter类

1. 分割字符串

使用String.split：

String testString = "Monday,Tuesday,,Thursday,Friday,,";
//parts的元素为： [Monday, Tuesday, , Thursday,Friday]，注意索引2处的空元素
String[] parts = testString.split(",");

使用guava

/*
 * on方法参数代表分隔符，可以是字符、字符串、正则表达式
 * split方法返回一个包含所有分割后生成的字符串的可迭代对象,打印输出["foo",,,"bar","baz"]
 */
Iterable<String> stringIterable1=Splitter.on('|').split("foo|||bar|baz");

// 以正则表达式作为分隔符，返回["foo","bar","baz"]
Iterable<String> stringIterable2=Splitter.on("\\d+").split("foo123bar45baz")

// 自动去除空元素，返回["foo","bar","baz"]
Splitter.on('|').omitEmptyStrings().split("foo|||bar|baz")

// 自动去除每个元素前后的空字符，返回["foo","bar","baz"]
Splitter.on('|').trimResults().split("  foo|bar  |  baz  ")

// 自动去除每个元素前后的数字，返回["foo","bar","baz"]，还可以修剪元素首尾的其他特定字符
Splitter.on('|').trimResults(CharMatcher.DIGIT).split("1foo|bar2|3baz4")
2. 借助MapSplitter

与MapJoiner类似，直接看例子。

String startString = "Washington D.C=Redskins#New York City=Giants#Philadelphia=Eagles#Dallas=Cowboys";
Splitter.MapSplitter mapSplitter = Splitter.on("#").withKeyValueSeparator("=");
// 返回的是一个不可变的LinkedHasMap，元素顺序与被分割的字符串中的一致
Map<String, String> splitMap = mapSplitter.split(startString);
3. 注意事项
  1. Splitter与Joiner一样也是不可变且线程安全的。
Splitter splitter = Splitter.on('|');
//下面的代码将返回一个新的实例，不会影响上面的splitter
splitter.trimResults();
//输出结果仍然包括空元素[1,2,3,,,]
Iterable<String> parts = splitter.split("1|2|3|||");

使用Charsets类

该类非常简单，只是简单封装了java支持的六种标准字符集。

不使用Charsets：

try{
    bytes = "foobarbaz".getBytes("UTF-8");
    }catch (UnsupportedEncodingException e){
    //程序不可能走到这，“UTF-8”必须支持
}

使用Charsets：

// 杜绝了拼写错误的可能，且不会抛出UnsupportedEncodingException
byte[] bytes2 = "foobarbaz".getBytes(Charsets.UTF_8);

使用Strings类

  1. 追加字符
// 在字符串后面追加字符，返回"fooxxx"；第二个参数6代表返回字符串的最小长度，而非追加的次数，如输入字符串长度已超出6，则不会进行追加操作,也不会裁剪，而是原样返回
Strings.padEnd("foo",6,'x');
// 已超过6位，原样返回“foo4567”
Strings.padEnd("foo4567",6,'x');
// 在字符串前面追加字符，返回"xxxfoo"，用法同padEnd
Strings.padStart("foo",6,'x');
// 重复给定字符串，返回"ZYLZYLZYL"
Strings.repeat("ZYL", 3);
  1. 空字符串处理

看方法名即可知方法功能。

// ""
Strings.nullToEmpty(null);  
// null
Strings.emptyToNull(""); 
// false
Strings.isNullOrEmpty(" "); 
// true
Strings.isNullOrEmpty(""); 
// ZYL
Strings.commonPrefix("ZYL123","ZYL456"); 
// ZZZ
Strings.commonSuffix("123ZZZ","456ZZZ");

使用CharMatcher类

字符匹配类，对字符串中的字符进行匹配操作。

CharMatcher对象
  1. 内置的匹配对象
// 匹配任何字符
 ANY 
// 匹配ASCII字符
 ASCII
// 匹配所有可换行的空白字符(不包括非换行空白字符,例如"\u00a0")
 BREAKING_WHITESPACE
 // 匹配ASCII数字 
 DIGIT
 // 匹配所有看不见的字符
 INVISIBLE
// 匹配UNICODE数字, 使用 Character.isDigit() 实现
 JAVA_DIGIT
 // 匹配ISO控制字符, 使用 Charater.isISOControl() 实现
 JAVA_ISO_CONTROL
// 匹配字母, 使用 Charater.isLetter() 实现
 JAVA_LETTER
// 匹配数字或字母
 JAVA_LETTER_OR_DIGET
 // 匹配小写
 JAVA_LOWER_CASE
// 匹配大写
 JAVA_UPPER_CASE
// 不匹配所有字符
 NONE
// 匹配单字宽字符, 如中文字就是双字宽
 SINGLE_WIDTH
// 匹配所有空白字符
 WHITESPACE
  1. 自定义匹配对象
// 返回匹配指定字符的Matcher
 CharMatcher is(char match)
// 返回不匹配指定字符的Matcher
 CharMatcher isNot(char match)
// 返回匹配sequence中任意字符的Matcher
 CharMatcher anyOf(CharSequence sequence)
// 返回不匹配sequence中任何一个字符的Matcher
 CharMatcher noneOf(CharSequence sequence)
// 返回匹配范围内任意字符的Matcher
 CharMatcher inRange(char startInclusive, char endIncludesive)
// 返回使用predicate的apply()判断匹配的Matcher
 CharMatcher forPredicate(Predicate<? super Charater> predicate)
// 返回以当前Matcher判断规则相反的Matcher
 CharMatcher negate()
// 返回与other匹配条件组合做与来判断的Matcher
 CharMatcher and(CharMatcher other)
// 返回与other匹配条件组合做或来判断的Matcher
 CharMatcher or(CharMatcher other)
CharMatcher执行匹配及匹配后的处理

  1. 执行匹配

    • boolean matchesAnyOf(CharSequence sequence) 只要sequence中有任意字符能匹配Matcher，返回true
// true
CharMatcher.JAVA_LETTER.matchesAnyOf("123a456")
// false
CharMatcher.JAVA_LETTER.matchesAnyOf("123456")
  • boolean matchesAllOf(CharSequence sequence) sequence中所有字符都能匹配Matcher才返回true
// false
CharMatcher.DIGIT.matchesAllOf("123a456")
// true
CharMatcher.DIGIT.matchesAllOf("123456")
  • boolean matchesNoneOf(CharSequence sequence) sequence中所有字符都不能匹配Matcher,返回true
// false
CharMatcher.JAVA_LOWER_CASE.matchesNoneOf("ABc")
// true
CharMatcher.JAVA_LOWER_CASE.matchesNoneOf("ABC")
  • int indexIn(CharSequence sequence) 返回sequence中匹配到的第一个字符的坐标
// 0
CharMatcher.JAVA_UPPER_CASE.indexIn("AbcDef")
  • int indexIn(CharSequence sequence, int start) 返回从start开始,在sequence中匹配到的第一个字符的坐标
// 3
CharMatcher.JAVA_UPPER_CASE.indexIn("AbcDef", 1)
  • int lastIndexIn(CharSequence sequence) 返回sequence中最后一次匹配到的字符的坐标
// 7
CharMatcher.anyOf("abc").lastIndexIn("123a456b")
  • int countIn(CharSequence sequence) 返回sequence中匹配到的字符计数
// 8
CharMatcher.JAVA_LETTER_OR_DIGIT.countIn("123a456b")

  1. 对匹配的字符进行操作

    • String removeFrom(CharSequence sequence) 删除sequence中匹配到到的字符并返回
// 123456
CharMatcher.inRange('a','z').removeFrom("abc123def456")
  • String retainFrom(CharSequence sequence) 保留sequence中匹配到的字符并返回
// abcdef
CharMatcher.inRange('a','z').retainFrom("abc123def456")
  • String replaceFrom(CharSequence sequence, char replacement) 替换sequence中匹配到的字符并返回
// ***123***456
CharMatcher.inRange('a','z').replaceFrom("abc123def456","*")
  • String trimFrom(CharSequence sequence) 删除首尾匹配到的字符并返回
// 123def456
CharMatcher.inRange('a','z').trimFrom("abc123def456ghi");
  • String trimLeadingFrom(CharSequence sequence) 删除首部匹配到的字符
// 123def456ghi
CharMatcher.inRange('a','z').trimLeadingFrom("abc123def456ghi");
  • String trimTrailingFrom(CharSequence sequence) 删除尾部匹配到的字符
// abc123def456
CharMatcher.inRange('a','z').trimTrailingFrom("abc123def456ghi");
  • String collapseFrom(CharSequence sequence, char replacement) 将连续匹配的字符替换成replacement
// *123*456*
CharMatcher.inRange('a','z').collapseFrom("abc123def456ghi",'*');
  • String trimAndCollapseFrom(CharSequence sequence, char replacement) 先trim再replace
// 123*456
CharMatcher.inRange('a','z').trimAndCollapseFrom("abc123def456",'*')

使用Precondition类

本类的主要功能是对参数进行校验。

// 检查参数是否为null,如不是null,原样返回，否则抛NPE，message为异常说明信息，下同
checkNotNull (T object,Object message)
// 检查索引是否越界，参数size为数组或集合的大小,如不越界原样返回，否则抛IndexOutOfBoundsException
checkElementIndex (int  index , int  size ,  Object message)
// 检查参数是否满足表达式，无返回值，表达式expression为false将抛IllegalArgumentException
checkArgument (Boolean expression,  Object message)
// 检查参数是否满足表达式，无返回值，表达式expression为false将抛IllegalStateException
checkState (Boolean expression,  Object message)

对象工具

  • 协助实现对象的toString方法
// 一个含title、author等字段的POJO的toString方法
public String toString() {
    return Objects.toStringHelper(this)
        // 忽略null值字段    
        .omitNullValues()
        // 设置需要输出的字段
        .add("title", title)
        .add("author", author)
        .add("publisher", publisher)
        .add("price",price)
        .add("isbn", isbn).toString();
}
  • 协助实现对象的hashcode方法
public int hashCode() {
// 参数均为对象的属性
    return Objects.hashCode(title, author, publisher, isbn);
}
  • 协助实现compareTo方法
public int compareTo(Book o) {
    return ComparisonChain.start()
    // 按优先级以指定属性进行比较排序，相同时以下一属性继续比较
        .compare(this.title, o.getTitle())
        .compare(this.author, o.getAuthor())
        .compare(this.publisher, o.getPublisher())
        .compare(this.isbn, o.getIsbn())
        .compare(this.price, o.getPrice())
        .result();
}
熊猿
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
guava-use:使用谷歌guava工具包
04-28
花式学习 番石榴使用 java8-lambda Java反射 Java注释
google Guava集合工具类（超实用）
11-30
Guava 是一个 Google 的基于java1.6的类库集合的扩展项目，包括 collections, caching, primitives support, concurrency libraries, common annotations, string processing, I/O, 等等. 这些高质量的 API 可以使你...
Guava：Java开发者的必备工具库
一名Java语言狂热分子。
07-03 3461
Guava是由Google开发的一个Java核心库，旨在为Java开发者提供高效、易用的工具集合。它包含了许多实用的功能和方法，能够简化开发过程，并增加代码的可读性和可维护性。本文将介绍Guava的一些重要特性和使用案例。Guava是一款功能强大的Java工具库，提供了丰富的功能和方法，能够简化开发过程，并提高代码的可读性和可维护性。无论是集合框架、函数式编程、字符串处理、缓存操作还是IO处理，Guava都提供了简洁而高效的解决方案。
Guava中的使用
hefrankeleyn的博客
08-14 941
Guava的使用：基础功能、集合、缓存、EventBus、反射、并发、字符串功能
深入解析Google Guava库与Spring Retry重试框架
最新发布
码到三十五
02-20 1167
Guava Retryer和Spring Retry都是优秀的重试框架，具有各自的特点和优势。在选择时，我们可以根据项目的具体需求和技术栈来决定使用哪个框架。对于基于Spring的应用，Spring Retry是一个自然而然的选择；对于非Spring应用或需要更高灵活性的场景，Guava Retryer可能是一个更好的选择。随着分布式系统和网络应用的不断发展，重试机制将变得越来越重要。未来，我们可以期待这两个框架在功能、性能和易用性方面继续优化和演进，为开发者提供更加强大和便捷的重试功能。
【Java技术专题】「Guava开发指南」手把手教你如何进行使用Guava工具箱进行开发系统实战指南（基础编程篇）
世界上并没有完美的程序，但是我们并不因此而沮丧，因为写程序就是一个不断追求完美的过程。
06-04 850
上面的例子中，排序器首先调用 apply 方法获取 sortedBy值，并把 sortedBy 为 null 的元素都放到最前面，然后把剩下的元素按 sortedBy 进行自然排序。Ordering 把很多基于 Comparator 的静态方法（如 Collections.max）包装为自己的实例方法（非静态方法），并且提供了链式调用方法，来定制和增强现有的比较器。综上所述，无论是否有额外参数，我们都应该为抛出的异常提供有意义的错误消息，以便调用方能够更好地理解和解决问题。
Guava常用工具类总结
恒二哥的博客
02-17 3059
如定义一系列状态比如吃饭，睡觉，过马路，需要根据这个状态判断是否可以玩手机，可以在类中定义集合包装这个三个状态，如果当前状态属于三个之一那么不可以玩手机，你可以使用基本的hashset，但是hashset的元素可以被更改，导致可能方法的判断和原本的语义出现出入。Throwables 可用简化异常和错误的传播与检查，什么叫错误的传播——不捕获异常向上抛出，什么是异常的检查——多个catch，catch不同类型的异常进行不同的处理。同样的， rowKeySet()返回”行”的集合Set。
整理一波Guava的使用技巧
BASK2312的博客
03-30 823
Guava是Google发布的一个开源库，主要提供了一些在Java开发中非常有用的工具类和API，比如字符串处理、集合操作、函数式编程、缓存等等。不管是工作还是学习都是非常值得我们去熟悉的，一起来看看吧。
guava-25.1-jre.jar
04-21
google的guava工具包很实用，包括之前的字符串处理工具类的，还有大量的collection相关的
Google的Guava工具包
04-17
Guava 是一个 Google 的基于java1.6的类库集合的扩展项目，包括 collections, caching, primitives support, concurrency libraries, common annotations, string processing, I/O, 等等. 这些高质量的 API 可以使你...
Guava官方文档中文版（一）-介绍基本工具
dzq584462393的专栏
01-09 4024
Guava文档中文版
Java系列6：Google工具包Guava的使用（看这一篇就够了）
热门推荐
RuiKe的博客
08-08 1万+
一、Guava工具包 （1）使用前引入maven依赖 <dependency> <groupId>com.google.guava</groupId> <artifactId>guava</artifactId> <version>19.0</version> </dependency> 二、集合 2.1、创建集合
【Java技术专题】「Guava开发指南」手把手教你如何进行使用Guava工具箱进行开发系统实战指南（不可变集合篇）
BASK2311的博客
06-24 401
不可变集合包括元组和冻结集合，其特点是不能被修改。元组有序、不可变、可包含不同类型元素，不能进行修改、删除操作，可通过索引访问元素。冻结集合是一种无序的集合类型，内部元素不能修改、添加或删除，因此常用于。
Java开源工具库Guava使用指南详解
专注java二开部署
12-06 1790
同时，关注Guava的版本控制和兼容性也非常重要。• Splitter：用于拆分字符串的工具类，例如Iterable<String> words = Splitter.on(',').trimResults().omitEmptyStrings().split(s);• ByteStreams：提供了一些字节流处理的工具类，例如read(InputStream input)方法可以从输入流中读取字节流，write(byte[] b, OutputStream out)方法可以将字节流写入到输出流中。
Guava使用
eck_燃的博客
03-11 1150
Guava使用 Guava Cache 是Google Fuava中的一个内存缓存模块，用于将数据缓存到JVM内存中。 提供了get、put封装操作，能够集成数据源 ； 线程安全的缓存，与ConcurrentMap相似，但前者增加了更多的元素失效策略，后者只能显示的移除元素，相当于对已有集合框架类的一个扩充； Guava Cache提供了多种基本的缓存回收方式 监控缓存加载/命中情况 通常，Guava缓存适用于以下情况： 愿意花费一些内存来提高速度。 使用场景有时会多次查询key。 缓存将不需要存储超出RA
【Java技术专题】「Guava开发指南」手把手教你如何进行使用Guava工具箱进行开发系统实战指南（Optional篇）
世界上并没有完美的程序，但是我们并不因此而沮丧，因为写程序就是一个不断追求完美的过程。
06-03 614
Guava工程包含了许多被Google的Java项目广泛依赖的核心库。我们希望通过本文档为Guava中最流行和最强大的功能提供更具可读性和解释性的说明。本教程是中级教程，适合 Guava 中级开发者的进阶学习。大多数情况下，开发人员使用 null 表明的是某种缺失情形：可能是已经有一个默认值，或没有值，或找不到值。例如，Map.get 返回 null 就表示找不到给定键对应的值。
java 第三方库Guava的基本使用
weixin_47424834的博客
12-19 6224
Guava工程包含了若干被Google的 Java项目广泛依赖 的核心库，例如：**集合 [collections] 、缓存 [caching] 、原 生类型支持 [primitives support] 、并发库 [concurrency libraries] 、通用注解 [common annotations] 、字符 串处理 [string processing] 、I/O 等等**。
Guava使用指南
Alaskan_Husky的博客
12-06 944
Guava（Google Guava）是Google开发的一个Java库，提供了许多实用的工具和基础库，用于简化Java编程的常见任务。
Guava 工具类之Cache的使用 本地缓存组件
weixin_56800842的博客
12-15 396
guava cache是Google guava中提供的一款轻量级的本地缓存组件，其特点是简单、轻便、完善、扩展性强，内存管理机制也相对完善。
com.google.guava:guava:pom:32.0.1-jre 下载jar包
06-13
你可以通过以下链接下载 `com.google.guava:guava:pom:32.0.1-jre` 的 jar 包： https://repo1.maven.org/maven2/com/google/guava/guava/32.0.1/guava-32.0.1-jre.jar 你也可以通过 Maven 或 Gradle 等构建工具来自动下载该依赖项及其传递依赖项。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值