Java主要方法中args的Jdoc描述

Question

我正在主要方法上方创建一个Jdoc注释。

在这种情况下，对args的正确描述是什么？

/**
 * supplies command-line arguments as an array of String objects
 * @param args 
 */
public static void main (String args[]) {

    Apple apple = new Apple();
    String firstInput = JOptionPane.showInputDialog("Enter number of apples: ");
    apple.setNumber(Double.parseDouble(firstInput));

    String secondInput = JOptionPane.showInputDialog("Enter apple type: ");
    apple.setType(Double.parseDouble(secondInput));

    JOptionPane.showMessageDialog(null, apple.toString());

}

非常感谢您回答我的问题。

Answer 1

主应用程序入口点通常不需要文档，因为它是Java应用程序的一种常见且易于理解的方法。 Even Oracle's "Hello World" example doesn't bother to document it。

但是，如果您仍然倾向于记录主方法签名，则可能满足以下条件：

/**
 * The application's entry point
 *
 * @param args an array of command-line arguments for the application
 */
public static void main(String[] args) {
    ...
}

请记住，Javadocs的预期目标受众是developers，而不是您的应用程序用户。因此，在Javadocs中记录参数的确切细节几乎没有意义。相反，如果他们传递了不正确或丢失的参数，请考虑将消息打印给用户。对于更全面的解决方案，您还可以考虑使用Apache Commons CLI之类的库。

Answer 2

您对此评论有何看法：