没有调用“匹配”方法时Matcher抛出IllegalStateException的基本原理

Question

TL; DR

MatcherAPI 的设计决策是什么？

背景

Matcher有我意想不到的行为，而我找不到很好的理由。API文档说：

创建后，可以使用匹配器执行三种不同类型的匹配操作：这些方法中的每一个都返回一个指示成功或失败的布尔值。通过查询匹配器的状态，可以获得有关成功匹配的更多信息。

API文档进一步说明了：

匹配器的显式状态最初是不确定的。在成功匹配之前尝试查询它的任何部分都将引发IllegalStateException。

例

String s = "foo=23,bar=42";
Pattern p = Pattern.compile("foo=(?<foo>[0-9]*),bar=(?<bar>[0-9]*)");
Matcher matcher = p.matcher(s);
System.out.println(matcher.group("foo")); // (1)
System.out.println(matcher.group("bar"));

此代码抛出一个

java.lang.IllegalStateException: No match found

在(1)。要解决此问题，有必要调用matches()或使其处于Matcher允许状态的其他方法group()。以下作品：

String s = "foo=23,bar=42";
Pattern p = Pattern.compile("foo=(?<foo>[0-9]*),bar=(?<bar>[0-9]*)");
Matcher matcher = p.matcher(s);
matcher.matches(); // (2)
System.out.println(matcher.group("foo"));
System.out.println(matcher.group("bar"));

将通话添加到matches()at (2)会将设置Matcher为适当的状态为call group()。

问题，可能不是建设性的

为什么要这样设计该API？为什么用构建时不自动匹配？MatcherPatter.matcher(String)

Answer 1

实际上，你误解了文档。再来看一下你引用的语句：

在成功匹配之前尝试查询它的任何部分都将引发IllegalStateException。

如果找不到匹配项，则匹配器可能会抛出IllegalStateException访问错误matcher.group()。

因此，你需要使用以下测试来实际启动匹配过程：-

 - matcher.matches() //Or
 - matcher.find()

下面的代码：

Matcher matcher = pattern.matcher();  

只需创建一个matcher实例。这实际上不会匹配字符串。即使比赛成功。因此，你需要检查以下情况，以检查是否成功匹配：

if (matcher.matches()) {
    // Then use `matcher.group()`
}

而如果在条件if回报false，这意味着什么也没有匹配。因此，如果你在matcher.group()不检查此条件的情况下使用，将获得IllegalStateException未找到匹配项的信息。

假设，如果Matcher按照你所说的方式设计，那么你将必须进行null检查以检查是否找到了匹配项，以致电matcher.group()，如下所示：

你认为应该完成的方式：

// Suppose this returned the matched string
Matcher matcher = pattern.matcher(s);  

// Need to check whether there was actually a match
if (matcher != null) {  // Prints only the first match

    System.out.println(matcher.group());
}

但是，如果要打印任何其他匹配项，该方法可以在字符串中多次匹配，那么该方法应该告诉匹配器找到下一个匹配项。但是null支票无法做到这一点。为此，你必须将匹配器向前移动以匹配下一个字符串。因此，在Matcher类中定义了多种方法来达到目的。该matcher.find()方法匹配字符串，直到找到所有匹配项。

还有其他方法，即match字符串以不同的方式取决于你的匹配方式。因此，它最终会在Matcher类上matching针对字符串进行处理。Pattern类只会创建一个pattern要匹配的对象。如果Pattern.matcher()要match使用模式，则必须有某种方法可以定义to的各种方法match，就像matching可以以不同的方式一样。因此，需要Matcher上课。

因此，实际上是这样的：

Matcher matcher = pattern.matcher(s);

   // Finds all the matches until found by moving the `matcher` forward
while(matcher.find()) {
    System.out.println(matcher.group());
}

因此，如果在字符串中找到4个匹配项，则第一种方式将仅打印第一个匹配项，而第二种方式将matcher向前移动以匹配下一个模式，从而打印所有匹配项。

我希望这很清楚。

·类的文档描述了它提供的三种方法的用法，它们表示：-

通过调用模式的matcher方法从模式创建匹配器。创建匹配器后，可以使用匹配器执行三种不同类型的匹配操作：

• matchs方法尝试将整个输入序列与模式进行匹配。

• lookingAt方法尝试将输入序列从开头开始与模式进行匹配。

• find方法扫描输入序列以查找与该模式匹配的下一个子序列。

不幸的是，我一直没能找到任何其他官方消息来源，说明确为什么和如何这个问题。