spring.turbo.util.RegexUtils Maven / Gradle / Ivy
package spring.turbo.util;
import org.springframework.lang.Nullable;
import java.util.regex.Pattern;
import java.util.regex.PatternSyntaxException;
import static spring.turbo.util.StringPool.EMPTY;
/**
* 正则表达式相关工具
*
* @author 应卓
* @see java.util.regex.Pattern
* @since 1.0.6
*/
public final class RegexUtils {
/**
* 私有构造方法
*/
private RegexUtils() {
}
/**
*
* 移除所有的匹配的子字符串
*
*
*
* RegexUtils.removeAll("any", Pattern.compile("")) = "any"
* RegexUtils.removeAll("any", Pattern.compile(".*")) = ""
* RegexUtils.removeAll("any", Pattern.compile(".+")) = ""
* RegexUtils.removeAll("abc", Pattern.compile(".?")) = ""
* RegexUtils.removeAll("A<__>\n<__>B", Pattern.compile("<.*>")) = "A\nB"
* RegexUtils.removeAll("A<__>\n<__>B", Pattern.compile("(?s)<.*>")) = "AB"
* RegexUtils.removeAll("A<__>\n<__>B", Pattern.compile("<.*>", Pattern.DOTALL)) = "AB"
* RegexUtils.removeAll("ABCabc123abc", Pattern.compile("[a-z]")) = "ABC123"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @return 结果
* @see #replaceAll(String, Pattern, String)
* @see java.util.regex.Matcher#replaceAll(String)
* @see java.util.regex.Pattern
*/
public static String removeAll(final String text, final Pattern regex) {
return replaceAll(text, regex, EMPTY);
}
/**
*
* 移除所有的匹配的子字符串，这个方法默认不使用 {@link Pattern#DOTALL} 模式
*
*
*
* RegexUtils.removeAll("any", "") = "any"
* RegexUtils.removeAll("any", ".*") = ""
* RegexUtils.removeAll("any", ".+") = ""
* RegexUtils.removeAll("abc", ".?") = ""
* RegexUtils.removeAll("A<__>\n<__>B", "<.*>") = "A\nB"
* RegexUtils.removeAll("A<__>\n<__>B", "(?s)<.*>") = "AB"
* RegexUtils.removeAll("ABCabc123abc", "[a-z]") = "ABC123"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @return 结果
* @throws PatternSyntaxException 正则表达式非法
* @see #replaceAll(String, String, String)
* @see #removePattern(String, String)
* @see String#replaceAll(String, String)
* @see java.util.regex.Pattern
* @see java.util.regex.Pattern#DOTALL
*/
public static String removeAll(final String text, final String regex) {
return replaceAll(text, regex, EMPTY);
}
/**
*
* 移除第一个匹配的子字符串
*
*
*
* RegexUtils.removeFirst("any", Pattern.compile("")) = "any"
* RegexUtils.removeFirst("any", Pattern.compile(".*")) = ""
* RegexUtils.removeFirst("any", Pattern.compile(".+")) = ""
* RegexUtils.removeFirst("abc", Pattern.compile(".?")) = "bc"
* RegexUtils.removeFirst("A<__>\n<__>B", Pattern.compile("<.*>")) = "A\n<__>B"
* RegexUtils.removeFirst("A<__>\n<__>B", Pattern.compile("(?s)<.*>")) = "AB"
* RegexUtils.removeFirst("ABCabc123", Pattern.compile("[a-z]")) = "ABCbc123"
* RegexUtils.removeFirst("ABCabc123abc", Pattern.compile("[a-z]+")) = "ABC123abc"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @return 结果
* @see #replaceFirst(String, Pattern, String)
* @see java.util.regex.Matcher#replaceFirst(String)
* @see java.util.regex.Pattern
*/
public static String removeFirst(final String text, final Pattern regex) {
return replaceFirst(text, regex, EMPTY);
}
/**
*
* 移除第一个匹配的子字符串，这个方法默认不使用 {@link Pattern#DOTALL} 模式
*
*
*
* RegexUtils.removeFirst("any", "") = "any"
* RegexUtils.removeFirst("any", ".*") = ""
* RegexUtils.removeFirst("any", ".+") = ""
* RegexUtils.removeFirst("abc", ".?") = "bc"
* RegexUtils.removeFirst("A<__>\n<__>B", "<.*>") = "A\n<__>B"
* RegexUtils.removeFirst("A<__>\n<__>B", "(?s)<.*>") = "AB"
* RegexUtils.removeFirst("ABCabc123", "[a-z]") = "ABCbc123"
* RegexUtils.removeFirst("ABCabc123abc", "[a-z]+") = "ABC123abc"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @return 结果
* @throws PatternSyntaxException 正则表达式非法
* @see #replaceFirst(String, String, String)
* @see String#replaceFirst(String, String)
* @see java.util.regex.Pattern
* @see java.util.regex.Pattern#DOTALL
*/
public static String removeFirst(final String text, final String regex) {
return replaceFirst(text, regex, EMPTY);
}
/**
*
* 移除所有匹配的子字符串，这个方法默认使用 {@link Pattern#DOTALL} 模式
*
*
*
* RegexUtils.removePattern("A<__>\n<__>B", "<.*>") = "AB"
* RegexUtils.removePattern("ABCabc123", "[a-z]") = "ABC123"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @return 结果
* @throws PatternSyntaxException 正则表达式非法
* @see #replacePattern(String, String, String)
* @see String#replaceAll(String, String)
* @see Pattern#DOTALL
*/
public static String removePattern(final String text, final String regex) {
return replacePattern(text, regex, EMPTY);
}
/**
*
* 替换所有的匹配的子字符串
*
*
*
* RegexUtils.replaceAll("", Pattern.compile(""), "zzz") = "zzz"
* RegexUtils.replaceAll("", Pattern.compile(".*"), "zzz") = "zzz"
* RegexUtils.replaceAll("", Pattern.compile(".+"), "zzz") = ""
* RegexUtils.replaceAll("abc", Pattern.compile(""), "ZZ") = "ZZaZZbZZcZZ"
* RegexUtils.replaceAll("<__>\n<__>", Pattern.compile("<.*>"), "z") = "z\nz"
* RegexUtils.replaceAll("<__>\n<__>", Pattern.compile("<.*>", Pattern.DOTALL), "z") = "z"
* RegexUtils.replaceAll("<__>\n<__>", Pattern.compile("(?s)<.*>"), "z") = "z"
* RegexUtils.replaceAll("ABCabc123", Pattern.compile("[a-z]"), "_") = "ABC___123"
* RegexUtils.replaceAll("ABCabc123", Pattern.compile("[^A-Z0-9]+"), "_") = "ABC_123"
* RegexUtils.replaceAll("ABCabc123", Pattern.compile("[^A-Z0-9]+"), "") = "ABC123"
* RegexUtils.replaceAll("Lorem ipsum dolor sit", Pattern.compile("( +)([a-z]+)"), "_$2") = "Lorem_ipsum_dolor_sit"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @param replacement 替换字符串
* @return 结果
* @see java.util.regex.Matcher#replaceAll(String)
* @see java.util.regex.Pattern
*/
public static String replaceAll(final String text, final Pattern regex,
final String replacement) {
Asserts.notNull(text);
Asserts.notNull(regex);
Asserts.notNull(replacement);
return regex.matcher(text).replaceAll(replacement);
}
/**
*
* 替换所有的匹配的子字符串，这个方法默认不使用 {@link Pattern#DOTALL} 模式
*
*
*
* RegexUtils.replaceAll("", "", "zzz") = "zzz"
* RegexUtils.replaceAll("", ".*", "zzz") = "zzz"
* RegexUtils.replaceAll("", ".+", "zzz") = ""
* RegexUtils.replaceAll("abc", "", "ZZ") = "ZZaZZbZZcZZ"
* RegexUtils.replaceAll("<__>\n<__>", "<.*>", "z") = "z\nz"
* RegexUtils.replaceAll("<__>\n<__>", "(?s)<.*>", "z") = "z"
* RegexUtils.replaceAll("ABCabc123", "[a-z]", "_") = "ABC___123"
* RegexUtils.replaceAll("ABCabc123", "[^A-Z0-9]+", "_") = "ABC_123"
* RegexUtils.replaceAll("ABCabc123", "[^A-Z0-9]+", "") = "ABC123"
* RegexUtils.replaceAll("Lorem ipsum dolor sit", "( +)([a-z]+)", "_$2") = "Lorem_ipsum_dolor_sit"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @param replacement 替换字符串
* @return 结果
* @throws PatternSyntaxException 正则表达式非法
* @see #replacePattern(String, String, String)
* @see String#replaceAll(String, String)
* @see java.util.regex.Pattern
* @see java.util.regex.Pattern#DOTALL
*/
public static String replaceAll(final String text, final String regex,
final String replacement) {
Asserts.notNull(text);
Asserts.notNull(regex);
Asserts.notNull(replacement);
return text.replaceAll(regex, replacement);
}
/**
*
* 替换第一个匹配的子字符串
*
*
*
* RegexUtils.replaceFirst("", Pattern.compile(""), "zzz") = "zzz"
* RegexUtils.replaceFirst("", Pattern.compile(".*"), "zzz") = "zzz"
* RegexUtils.replaceFirst("", Pattern.compile(".+"), "zzz") = ""
* RegexUtils.replaceFirst("abc", Pattern.compile(""), "ZZ") = "ZZabc"
* RegexUtils.replaceFirst("<__>\n<__>", Pattern.compile("<.*>"), "z") = "z\n<__>"
* RegexUtils.replaceFirst("<__>\n<__>", Pattern.compile("(?s)<.*>"), "z") = "z"
* RegexUtils.replaceFirst("ABCabc123", Pattern.compile("[a-z]"), "_") = "ABC_bc123"
* RegexUtils.replaceFirst("ABCabc123abc", Pattern.compile("[^A-Z0-9]+"), "_") = "ABC_123abc"
* RegexUtils.replaceFirst("ABCabc123abc", Pattern.compile("[^A-Z0-9]+"), "") = "ABC123abc"
* RegexUtils.replaceFirst("Lorem ipsum dolor sit", Pattern.compile("( +)([a-z]+)"), "_$2") = "Lorem_ipsum dolor sit"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @param replacement 替换字符串
* @return 结果
* @see java.util.regex.Matcher#replaceFirst(String)
* @see java.util.regex.Pattern
*/
public static String replaceFirst(final String text, final Pattern regex,
final String replacement) {
Asserts.notNull(text);
Asserts.notNull(regex);
Asserts.notNull(replacement);
return regex.matcher(text).replaceFirst(replacement);
}
/**
*
* 替换第一个匹配的字串，这个方法不使用 {@link Pattern#DOTALL} 模式
*
*
*
* RegexUtils.replaceFirst("", "", "zzz") = "zzz"
* RegexUtils.replaceFirst("", ".*", "zzz") = "zzz"
* RegexUtils.replaceFirst("", ".+", "zzz") = ""
* RegexUtils.replaceFirst("abc", "", "ZZ") = "ZZabc"
* RegexUtils.replaceFirst("<__>\n<__>", "<.*>", "z") = "z\n<__>"
* RegexUtils.replaceFirst("<__>\n<__>", "(?s)<.*>", "z") = "z"
* RegexUtils.replaceFirst("ABCabc123", "[a-z]", "_") = "ABC_bc123"
* RegexUtils.replaceFirst("ABCabc123abc", "[^A-Z0-9]+", "_") = "ABC_123abc"
* RegexUtils.replaceFirst("ABCabc123abc", "[^A-Z0-9]+", "") = "ABC123abc"
* RegexUtils.replaceFirst("Lorem ipsum dolor sit", "( +)([a-z]+)", "_$2") = "Lorem_ipsum dolor sit"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @param replacement 替换字符串
* @return 结果
* @throws PatternSyntaxException 正则表达式非法
* @see String#replaceFirst(String, String)
* @see java.util.regex.Pattern
* @see java.util.regex.Pattern#DOTALL
*/
public static String replaceFirst(final String text, final String regex,
final String replacement) {
Asserts.notNull(text);
Asserts.notNull(regex);
Asserts.notNull(replacement);
return text.replaceFirst(regex, replacement);
}
/**
*
* 替换所有的匹配的字串，这个方法使用 {@link Pattern#DOTALL} 模式
*
*
*
* RegexUtils.replacePattern("", "", "zzz") = "zzz"
* RegexUtils.replacePattern("", ".*", "zzz") = "zzz"
* RegexUtils.replacePattern("", ".+", "zzz") = ""
* RegexUtils.replacePattern("<__>\n<__>", "<.*>", "z") = "z"
* RegexUtils.replacePattern("ABCabc123", "[a-z]", "_") = "ABC___123"
* RegexUtils.replacePattern("ABCabc123", "[^A-Z0-9]+", "_") = "ABC_123"
* RegexUtils.replacePattern("ABCabc123", "[^A-Z0-9]+", "") = "ABC123"
* RegexUtils.replacePattern("Lorem ipsum dolor sit", "( +)([a-z]+)", "_$2") = "Lorem_ipsum_dolor_sit"
*
*
* @param text 原始字符串
* @param regex 正则表达式
* @param replacement 替换的字符串
* @return 结果
* @throws PatternSyntaxException 正则表达式非法
* @see #replaceAll(String, String, String)
* @see String#replaceAll(String, String)
* @see Pattern#DOTALL
*/
public static String replacePattern(final String text, final String regex,
final String replacement) {
Asserts.notNull(text);
Asserts.notNull(regex);
Asserts.notNull(replacement);
return Pattern.compile(regex, Pattern.DOTALL).matcher(text).replaceAll(replacement);
}
/**
* 判断正则表达式是否合法
*
* @param regex 正则表达式
* @return 合法时返回 {@code true} 否则返回 {@code false}
*/
public static boolean isValidRegex(@Nullable String regex) {
if (regex == null) {
return false;
}
try {
Pattern.compile(regex);
return true;
} catch (PatternSyntaxException e) {
return false;
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy