Question

是java的方法文档的正确文档吗？我的部分代码如下。没有参数但有回报。只有局部变量。

/**
 *This method prompts user to enter the how many numbers user is going to test.
 *
 *@return     The validated value based on parameter.
 */

public static int getNum()
{
    int t;
    Scanner input=new Scanner(System.in);

    System.out.print("How many numbers would you like to test? ");
    t=input.nextInt();

    while (validateNum(t))
    {
        System.out.print("How many numbers would you like to test? ");
        t=input.nextInt();
    }

    return t;
}

Answer 1

方法的Javadoc应该不以“This method”开头 - 在每个方法描述的开头都是暗示。

同样，在记录课程时，我们会假设在您的评论之前出现“This class”字样。

此外，您正在描述实现（询问用户），但实现应该可以随意获取它，例如从文件读取或返回常量。

这是更适合的事情：

/**
 * Return how many numbers user is going to test.
 *
 * @return The number of numbers to be tested
 */

它是java的方法文档的正确文档吗？

1 个答案: