字符串切割 - StrSplitter

由来

Java 提供了 String.split 方法来通过指定分隔符将字符串分割为数组，但在实际开发中，通常会有更多的需求，如：

• 限制分割后的字符串个数。
• 分割后是否去除每个字符串两端的空格。
• 是否忽略空白项。
• 根据固定长度进行分割。
• 通过正则表达式进行分割。

基于这些需求，Hutool 提供了功能更丰富且易于使用的 StrSplitter 工具类，它包含了一系列静态方法，能够灵活处理各种字符串分割操作。

1. 使用场景

• 复杂字符串分割：当需要进行自定义规则的字符串分割时，StrSplitter 提供了更多选项和灵活性。
• 路径处理：在处理文件路径或 URL 时，StrSplitter 的路径分割方法非常实用。
• 批量数据解析：对于需要将长字符串按特定规则解析成多个部分的场景，StrSplitter 提供了更简洁和高效的解决方案。

2. 主要方法

2.1 基础方法

StrSplitter 提供了多种基础方法来处理字符串的分割，包括按分隔符分割、按正则表达式分割、按固定长度分割等。

示例：使用分隔符进行字符串分割

import cn.hutool.core.text.StrSplitter;

import java.util.List;

public class StrSplitterExample {
    public static void main(String[] args) {
        // 要分割的字符串
        String str1 = "a, ,efedsfs,   ddf";

        // 使用 StrSplitter 进行字符串分割
        // 参数：被分割的字符串，分隔符（逗号），分割后的最大字符串数（0 表示无限制），是否去除每个部分的空格，是否忽略空白项
        List<String> splitList = StrSplitter.split(str1, ',', 0, true, true);

        // 输出结果
        System.out.println(splitList);
        // 输出结果: [a, efedsfs, ddf]
    }
}

• 方法签名：
  • List<String> split(String str, char separator, int limit, boolean trim, boolean ignoreEmpty)：按指定分隔符分割字符串。
• 参数说明：
  • str: 要分割的字符串。
  • separator: 分隔符，可以是字符（如 ,）。
  • limit: 分割后的最大字符串数，0 表示无限制。
  • trim: 是否去除每个部分的前后空格。
  • ignoreEmpty: 是否忽略空白项。
• 返回值：List<String>，分割后的字符串列表。
• 作用：在需要自定义分隔符、限制分割数以及控制空格和空白项处理时，StrSplitter 提供了更强的灵活性。
• 实际开发场景：在解析配置文件、处理批量数据或用户输入时，通常需要更复杂的分割逻辑，StrSplitter 是理想的选择。

示例：使用正则表达式进行分割

import cn.hutool.core.text.StrSplitter;

import java.util.List;

public class StrSplitterExample {
    public static void main(String[] args) {
        // 要分割的字符串
        String str2 = "abc123def456ghi";

        // 使用正则表达式进行分割
        List<String> splitList = StrSplitter.splitByRegex(str2, "\\d+");

        // 输出结果
        System.out.println(splitList);
        // 输出结果: [abc, def, ghi]
    }
}

• 方法签名：
  • List<String> splitByRegex(String str, String regex)：根据正则表达式分割字符串。
• 参数说明：
  • str: 要分割的字符串。
  • regex: 用于分割的正则表达式。
• 返回值：List<String>，分割后的字符串列表。
• 作用：使用正则表达式进行灵活分割，适用于复杂的模式匹配场景。

示例：按固定长度分割字符串

import cn.hutool.core.text.StrSplitter;

import java.util.List;

public class StrSplitterExample {
    public static void main(String[] args) {
        // 要分割的字符串
        String str3 = "abcdefghijk";

        // 按固定长度分割
        List<String> splitList = StrSplitter.splitByLength(str3, 3);

        // 输出结果
        System.out.println(splitList);
        // 输出结果: [abc, def, ghi, jk]
    }
}

• 方法签名：
  • List<String> splitByLength(String str, int length)：按固定长度分割字符串。
• 参数说明：
  • str: 要分割的字符串。
  • length: 每个部分的固定长度。
• 返回值：List<String>，分割后的字符串列表。
• 作用：适用于需要按固定长度提取字符串的场景，例如处理固定长度的编码或格式化数据。

2.2 特殊方法

除了常规的字符串分割，StrSplitter 还提供了一些针对路径的分割方法，例如按 / 分割路径。

示例：按路径分割字符串

import cn.hutool.core.text.StrSplitter;

import java.util.List;

public class StrSplitterExample {
    public static void main(String[] args) {
        // 要分割的路径字符串
        String path = "/user/home/docs/file.txt";

        // 按路径分割
        List<String> splitList = StrSplitter.splitPath(path);

        // 输出结果
        System.out.println(splitList);
        // 输出结果: [user, home, docs, file.txt]
    }
}

• 方法签名：
  • List<String> splitPath(String str)：按路径分割字符串，分隔符为 /。
• 参数说明：
  • str: 要分割的路径字符串。
• 返回值：List<String>，分割后的路径部分列表。
• 作用：在处理文件路径或 URL 时，该方法可以快速获取路径的各个部分。

3. 实际应用场景

• 配置文件解析：在读取配置文件时，通常需要对配置项进行灵活的分割和解析。
• 日志分析：在分析日志数据时，可能需要按不同的分隔符或正则进行切割，以提取有用的信息。
• 文本处理：在处理文本文件、用户输入或批量数据时，StrSplitter 提供了强大的工具支持，适用于复杂的分割需求。

4. 注意事项

• 使用正则表达式分割时，确保正则表达式的正确性，否则可能导致分割结果不符合预期。
• 在处理路径时，splitPath 方法默认以 / 为分隔符，适用于 Unix 风格路径，Windows 路径需注意反斜杠的处理。