在 Java 中弃用包的最清晰方法是什么？

package java deprecated

2022-09-01 03:35:16

我正在开发一个新的代码库，并将系统迁移到一个新的框架。

我想弃用许多软件包，只是为了向其他开发人员非常清楚地表明，此软件包中的所有内容都不应再用于新开发。

指示整个包已被弃用的最佳方法是什么？

答案 1

我最近不得不这样做，并使用该文件弃用该软件包。package-info.java

将文件添加到仅包含包声明的包中：package-info.java

/**
 * @deprecated As of release 2.0, replaced by {@link com.acme.new.package}
 */
@Deprecated
package com.acme.old.package;

在 Eclipse 中，用户从此包中导入类的所有位置都将带有弃用警告的下划线。

答案 2

你自己说过：你想弃用包里的所有东西，而不是包本身。包只不过是一个命名空间，弃用命名空间将具有不同的含义 - 就像不再使用此命名空间一样。例如，不要向该命名空间添加任何新项。

在你的例子中，我建议你弃用每个类的每个公共方法（和字段），这些方法（和字段）不应该再使用。这在现代IDE中变得可见，并且当开发人员想要使用旧的类和方法时，他们会受到警告。您可以查看代码并逐步重构它，以消除这些类和方法的依赖关系。