为什么即使添加 throws 包装异常仍会请求 try-catch？

Question

我正在我自己的个人图书馆中使用SikuliX's API。这个想法是在外部项目中单独引用我的库，其中包含我需要的 SikuliX 部分。

现在，SikuliX 抛出了 FindFailed 异常，这是我需要的。我试着做：

public class FindFailed extends org.sikuli.script.FindFailed {
    FindFailed(String msg) { super(msg); }
}

这似乎是有道理的。但是，当尝试在其中一种方法中使用 throws 语句时：

import org.mylibrary.exceptions.FindFailed;

public static boolean clickFinishButton() throws FindFailed {
    pattern = PatternManager.loadPattern("my-image.png");

    screen.wait(pattern, 10);
    region = screen.exists(pattern);
    region.click(pattern);

    return true;
}

我仍然收到Unhandled exception type FindFailed 警告。将其改回原来的org.sikuli.script.FindFailed 当然可以，但是在外部项目中使用try-catch 将需要我重新添加相关的SikuliX jar 文件。

我想做的，只是简单地包装 SikuliX 抛出的 FindFailed 异常，并在我的库内部和外部使用它。

所有这一切的主要目标是用我自己的附加方法等封装另一个 API，这样当我引用这个库时，以后的项目也不必引用 SikuliX 的 jar。

- - - - My Library - - - <—————— External Project
|                      |
|        SikuliX       |
- - - - - - - - - - - - 

就目前而言，我需要执行以下操作：

- - - - My Library - - - <—————— External Project
|                      |                |
|        SikuliX       |                |
- - - - - - - - - - - -                 v
                                  SikuliX (Again)

---

到目前为止，我已经进行了如下更改，似乎可行。

public class FindFailed extends Exception {
    public FindFailed(Throwable cause) { super(cause); }
}

我现在不扩展任何第三方例外。相反，我继续执行以下操作：

public static boolean clickNewScan() throws FindFailed {
    pattern = PatternManager.loadPattern("my-image.png");   
    region = screen.exists(pattern);
    try {
        screen.wait(pattern, 60);
        region.click(pattern);
    } catch (org.sikuli.script.FindFailed e) {
        throw new FindFailed(e);
    }
    return true;
}

Answer 1

您可以通过将 SikuliX 中的所有调用封装到它们自己的接口中来做到这一点。我不知道SikuliX，所以我做一个玩具例子。

package third.party.library;

public class Foo {
    public void doSomething() throws ThirdPartyException {
        // Their code
    }
}

好的，所以你想包装这个功能而不依赖于他们的库。

package juxhin;

public interface FooBehavior {
    public void doSomething() throws MyException;
}

然后，当你需要他们的行为时，你可以使用你自己的实现：

package juxhin; // YOU write this class

public class ThirdPartyFooBehavior implements FooBehavior {
    private final Foo foo;

    public FooThirdPartyFooBehavior(Foo theirObject) {
        this.foo = theirObject;
    }

    @Override
    public void doSomething() throws MyException {
        try {
            foo.doSomething();
        } catch (ThirdPartyException e) {
            throw new MyException(e);
        }
    }
}

一旦您将它们的库封装在您自己的所有接口后面，那么您的类将只依赖于您自己的接口，这意味着您不必担心它们的异常。只要您使用非依赖实现重新实现这些接口，它们的库将完全可移除。

注意MyException 不应该扩展third.party.library.ThirdPartyException，因为这对你的问题没有帮助；它应该使用Exception(Throwable cause) 构造函数并将其从org.sikuli.script 类层次结构中删除。

---

不过，底线是您仍然必须以某种方式包含 SikuliX 中包含的代码。这就是存在Maven 之类的工具的原因，因此添加对jar 的引用非常容易。例如，如果您的 jar 依赖于 SikuliX，那么当您告诉新项目使用您的 jar 时，它将自动包含 SikuliX 引用，而无需您执行任何操作。你最终会得到这样的依赖树，它会自动为你完成所有这些工作：

我个人使用 Maven，但还有其他选项，例如 Ivy 和 Gradle，它们可以做同样的事情 - 我不是在这里提倡使用任何特定工具，只是提倡使用 any 依赖工具。

Answer 2

从您不拥有的课程扩展绝不是一个好主意，应该避免。此外，它会使处理您的异常的人仍然拥有包含 org.sikuli.script.FindFailed 的 jar。

更好的方法是像这样包装异常：

public class MyFindFailedException extends Exception {
    MyFindFailedException(String message, Exception cause) {
        super(message, cause);
    }
}

然后像这样使用它：

public static boolean clickFinishButton() throws MyFindFailedException {
  try {
    pattern = PatternManager.loadPattern("my-image.png");

    screen.wait(pattern, 10);
    region = screen.exists(pattern);
    region.click(pattern);

    return true;
  } catch (FindFailed e) {
    throw new MyFindFailedException("something went wrong", e);
  }
}