使用默认方法的界面演变–第一部分：方法

几周前，我们详细研究了默认方法 -Java 8中引入的一项功能，该功能允许为接口方法提供实现，即方法主体，从而定义接口中的行为。引入此功能是为了实现接口演进。

在JDK的上下文中，这意味着在不破坏所有代码的情况下向接口添加新方法。但是，尽管Java本身非常致力于保持向后兼容性，但其他项目并不一定要做到这一点。如果他们愿意，他们可以以让客户更改代码为代价来开发接口。

在Java 8之前，这经常涉及客户端编译错误，因此可以避免更改，否则客户端必须一次性迁移。使用默认方法，接口演变可以成为一个无错误的过程，在此过程中，客户端可以在版本之间留出时间来逐步更新代码。这大大增加了开发接口的可行性，并使其成为常规的库开发工具。

让我们看一下如何添加，替换和删除接口方法。未来的文章将探讨替换整个接口的方法。

总览

该帖子首先定义了一些术语，然后介绍了添加，替换和删除接口方法的方法。它是从更改库中界面的开发人员的角度编写的。

我觉得该主题不需要示例，因此我没有编写任何示例。如果您不同意并希望看到一些内容，请发表评论，并且-在时间允许的情况下-我会写一些。

术语

接口具有实现和调用者 。两者都可以存在于库中，在这种情况下，它们都称为internal ，或者在客户端代码中称为external 。这总共增加了四种使用界面的类别。

根据界面的发展方式和存在的用途，必须采用不同的模式。当然，如果既不存在外部实现也不存在外部调用者，则这些都不是必需的，因此本文的其余部分假定这些情况中至少有一种确实存在。

接口演变–方法

因此，让我们看看如何在不破坏客户端代码的情况下添加，替换或删除接口方法。

通常可以通过执行以下过程来实现：

新版本

该库的新版本已发布，其中界面定义是过渡性的，并结合了旧的和新的所需轮廓。默认方法可确保所有外部实现和调用仍然有效，并且在更新时不会出现编译错误。

过渡

然后，客户就有时间从旧大纲过渡到新大纲。同样，默认方法可确保适应的外部实现和调用有效，并且可以进行更改而不会编译错误。

新版本

在新版本中，该库删除了旧轮廓的残差。鉴于客户端明智地利用了自己的时间并进行了必要的更改，因此发布新版本不会导致编译错误。

这个过程使客户能够按自己的时间表平稳地更新代码，这使得接口的发展比以前更加可行。

Johanna Pung在CC-BY-SA 3.0下为Wikimedia Deutschland 发布。

遵循以下详细步骤时，请确保检查何时更新了内部和外部实现以及何时允许内部和外部调用者使用所涉及的方法。确保在您自己的代码中遵循此过程，并为您的客户正确记录下来，以便他们知道何时执行操作。 Javadoc标签@Deprecated和@apiNote是实现此目的的好方法。

通常，不必按该顺序执行过渡内的步骤。如果是，则明确指出。

如果您向客户提供可以在其界面实现上运行的测试，则这些步骤中包含测试。

加

仅当存在外部接口实现时才需要此过程。由于该方法是新方法，因此当然尚未调用，因此可以忽略这种情况。区分是否可以提供合理的默认实现是有意义的。

存在合理的默认实现

新版本

为新方法定义测试
使用默认实现（通过测试）添加方法
内部呼叫者可以使用该方法
内部实现可以在必要时覆盖该方法

过渡

外部呼叫者可以使用该方法
外部实现可以在必要时覆盖该方法

无需执行任何操作，也不需要任何新版本。这就是Java 8中添加的许多新的默认方法所发生的事情。

不存在合理的默认实现

新版本

定义新方法的测试；这些必须接受UnupportedOperationExceptions
添加方法：
- 包括一个引发UnupportedOperationException的默认实现（通过测试）
- @apiNote注释文档，默认实现将最终被删除
在所有内部实现中覆盖该方法

过渡

必须按该顺序执行以下步骤：

外部实现必须重写该方法
外部呼叫者可以使用该方法

新版本

测试不再接受UnupportedOperationExceptions
使方法抽象：
- 删除默认实现
- 删除@apiNote注释
内部呼叫者可以使用该方法

勉强一致的默认实现允许外部实现逐渐更新。请注意，在实际在内部或外部调用新方法之前，将更新所有实现。因此，永远不会发生UnupportedOperationException。

更换

在这种情况下，一种方法将被另一种方法替代。这包括方法更改其签名（例如，其名称或参数数量）的情况，在这种情况下，新版本可以看作是替换旧版本。

当存在外部实现或外部调用者时，必须应用此模式。仅在两种方法在功能上等效时才起作用。否则，就是添加一个功能并删除另一个功能的情况。

新版本

为新方法定义测试
添加新方法：
- 包括调用旧方法的默认实现
- @apiNote注释文档，默认实现将最终被删除
弃用旧方法：
- 包括调用新方法的默认实现（旨在进行循环调用；如果存在默认实现，则可以保留）
- @apiNote注释文档，默认实现将最终被删除
- @Deprecation评论文档说明将使用新方法
内部实现会覆盖新方法，而不是旧方法
内部调用者使用新方法代替旧方法

过渡

外部实现会覆盖新方法，而不是旧方法
外部呼叫者使用新方法代替旧方法

新版本

使新方法抽象：
- 删除默认实现
- 删除@apiNote注释
删除旧方法

尽管循环调用看起来很有趣，但它们确保实现哪种方法都无关紧要。但是，由于这两种变体都有默认实现，因此，如果两种实现均未实现，则编译器不会产生错误。不幸的是，这会产生无限循环，因此请确保将其指出给客户。如果您为他们的实现提供测试，或者他们编写了自己的实现，则他们会立即意识到这一点。

去掉

删除方法时，根据是否存在外部实现，可以应用不同的模式。

存在外部实现

新版本

方法的测试必须接受UnupportedOperationExceptions
弃用该方法：
- 包括一个引发UnupportedOperationException的默认实现（通过更新的测试）
- @Deprecation注释文档表明该方法最终将被删除
- @apiNote注释文档说明默认实现仅存在于逐步淘汰方法中
内部呼叫者停止使用该方法

过渡

必须按该顺序执行以下步骤：