JDK 9 @不建议使用的注释增强功能

在帖子中， @ Deprecated可能会是什么样子？，我当时使用JEP 277 （“增强的弃用”）的描述来指导创建增强的自定义@Deprecated注释。但是，自从发布该文章以来，JEP 277进行了重大更改。该文章总结了JDK 9的更改以及@Deprecated的当前计划的增强功能。

在2016-03-03 18:04对JDK-8065614 （“ JEP 277：增强的弃用”）所做的更改删除了JEP描述中描述拟议的@Deprecated枚举的部分。 JEP 277主页上的“ 替代方法 ”部分介绍了为何删除枚举的原因：

该提案的先前版本包含各种“原因”代码，包括未审查，危险，过时，已取代，未完成和实验。 这些尝试尝试编码不推荐使用API的原因，使用它的风险以及是否有可用的替代API。 实际上，所有这些信息都过于主观，无法在注释中编码为值。 而是应在Javadoc文档注释中描述此信息。

修改后的@Deprecated注释现在支持两种方法，如API文档中所示。该文档解释说， forRemoval（）方法 “指示可评估的元素是否在将来的版本中会被删除”，并且默认情况下返回false 。 since（）方法文档指出，第二个方法“返回已弃用带注释元素的版本”，并且默认情况下返回空字符串。

forRemoval()和since()的默认值false和""分别是有意义的，因为这些默认值对应于今天无法使用@Deprecated指定此信息。因为在代码库中已经有@Deprecated无数用法，所以使@Deprecated这些现有用法对应于没有计划的删除和没有指定的“自”是最有意义的。开发人员将能够根据需要将这些值添加到现有@Deprecated批注中。

这些是@Deprecated批注的次要添加，但是新的@Deprecated仍然比我们在Java早期版本中的今天要好得多，因为我们现在可以在批注本身中指定弃用的两个非常重要的特征。指定何时不建议使用构造以及何时计划完全删除它，可以提供与不赞成使用有关的具有潜在洞察力的历史和未来信息。

翻译自: https://www.javacodegeeks.com/2016/08/jdk-9-deprecated-annotation-enhancements.html

JDK 9 @不建议使用的注释增强功能相关推荐

jdk170不支持注释_JDK 9 @不建议使用的注释增强功能
jdk170不支持注释在帖子中, @ Deprecated可能会是什么样子? ,我当时使用JEP 277 ("增强的弃用")的描述来指导创建增强的自定义@Deprecated注释 ...
应用JDK 9 @不推荐使用的增强功能
我在博客文章JDK 9 @Deprecated Annotation Enhancements中讨论了针对@Deprecated注释的当前建议的JDK 9增强功能 . 在本文中,我将更详细地介绍这些 ...
.NET Core 3.0中的新功能和增强功能
目录介绍主要变化 Windows桌面支持本机可执行文件 JSON API 更好的垃圾收集器性能改进 Docker增强 ARM64支持物联网支持密码学与.NET Core 2.2的AP ...
Spring Framework 4.2 中的新功能和增强功能
至今为止,Spring Framework 的最新版本为 4.2.1.RELEASE. 那么 Spring Framework 4.2 中的又有哪些新功能和增强功能呢? 核心容器改进如 @bean ...
微软宣布Azure Migrate和Site Recovery服务增强功能
近日,微软宣布了Azure Migrate和Azure Site Recovery服务的几项增强功能,包括用于存储发现和评估元数据的额外地理区域,以及用于迁移的其他受支持选项. 结合使用Azure M ...
ML.NET生成器带来了许多错误修复和增强功能以及新功能
ML.NET是一个开源的跨平台机器学习框架,适合 .NET 开发人员.它允许将机器学习集成到 .NET 应用中,而无需离开 .NET 生态系统,甚至拥有 ML 或数据科学背景.ML.NET工具(Vis ...
Internet Explorer 6 中的 CSS 增强功能
简介 Microsoft® Internet Explorer 6 及更高版本支持一些更早版本 Internet Explorer 并不支持的 CSS 功能.支持的两个附加 CSS 属性为 min-h ...
Eclipse自动生成作者、日期注释等功能设置
Eclipse自动生成作者.日期注释等功能设置在使用Eclipse 编写Java代码时,自动生成的注释信息都是按照预先设置好的格式生成的. 修改作者.日期注释格式:打开Windows->Pre ...
戴尔服务器开启虚拟机,Windows 服务器2019中的受防护虚拟机增强功能
受防护的虚拟机是由 Windows 服务器2016中 Microsoft 引入的唯一安全功能,已在 Windows 服务器2019版本中经历了大量增强.该博客主要是为了了解本功能的改进. 有关该功能的 ...

JDK 9 @不建议使用的注释增强功能

JDK 9 @不建议使用的注释增强功能相关推荐

最新文章

热门文章