java - 代码编译时遇到警告信息 "uses or overrides a deprecated API"

Question

我编译了我的程序，但出现了以下错误。我该如何解决？

Note: ClientThreadClients.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.

Answer 1

您应该做的是按照警告信息所说的去做。使用 -Xlint:deprecation 选项重新编译该类。然后，编译器会告诉您正在使用或覆盖哪些已弃用的 API。

怎么做？

• 如果您使用 javac 从命令 shell 进行编译，只需将 -Xlint:deprecation 选项添加到命令行即可。

• 对于 Maven 构建，按如下方式运行 maven:

  mvn clean install -Dmaven.compiler.showDeprecation=true
  

• 对于 Gradle 构建，将以下内容添加到根构建文件中:

  allprojects { 
      tasks.withType(JavaCompile) { 
          options.deprecation = true
      }
  }
  

  或设置特定编译任务的选项。

• 对于 Ant 构建，在 javac 任务中将 deprecation 属性设置为 true。

• 对于 IDE:

  • eclipse :参见 Eclipse not showing deprecated warning?
  • NetBeans:参见 Where can I find the Xlint option in Netbeans?
  • Intellij:参见 Intellij Idea find all deprecated usages in the project

---

确定导致问题的 API 后，可以通过三种方法“解决”错误。

1. 您可以阅读已弃用 API 的 javadoc 以找出它被弃用的原因。然后根据 javadoc 所说的内容和上下文，您需要想出一种方法来用更好的东西替换代码对已弃用元素的使用。

2. 您可以使用 @SuppressWarnings("deprecation") 注释告诉编译器对此“保持安静”。

   这通常是个坏主意:

   • 已弃用的 API 可能会在未来的版本中删除，这将阻止您的代码在升级时运行。 (建议您查看有关删除已弃用 API 的产品政策。)

   • 已弃用的 API 可能存在根本性缺陷，使您的应用程序在某些情况下不可靠。

   对这些警告的不明智的压制只会造成您或您的继任者将来必须解决的技术问题。

3. 如果弃用警告是由于 Java SE 本身或您正在使用的第 3 方 API 发生更改，您可以通过回滚到未显示警告。 这比前一个想法更糟糕。回滚，你只是让技术部门积累。

---

(对于这个特定示例，我的猜测是 OP 使用了 Thread 类中已弃用的方法之一:

• countStackFrames()
• 销毁()
• 暂停()
• resume()
• 停止()
• 停止(Throwable)
• 挂起()

这些方法要么不可靠，要么不安全，要么两者兼而有之，强烈建议您不要使用它们。阅读此说明:"Why are Thread.stop, Thread.suspend and Thread.resume Deprecated? ".)