javadoc中没有提到不推荐的方法
我有两门课。第一个包含一个不推荐使用的方法。第二个类实例化第一个类并使用其已弃用的方法 编译器确实显示警告,但: 问题:为什么在运行javadoc中没有提到不推荐的方法,java,javadoc,Java,Javadoc,我有两门课。第一个包含一个不推荐使用的方法。第二个类实例化第一个类并使用其已弃用的方法 编译器确实显示警告,但: 问题:为什么在运行javadoc Test.Java之后,不推荐的方法没有列在生成的Java文档中 代码如下: import java.lang.annotation.*; class Tester{ private int a = 1; /** * @deprecated * This is deprecated because I do not like
javadoc Test.Java
之后,不推荐的方法没有列在生成的Java文档中
代码如下:
import java.lang.annotation.*;
class Tester{
private int a = 1;
/**
* @deprecated
* This is deprecated because I do not like it
*/
@Deprecated
public void afficher(){
System.out.println("a is: " + a);
}
}
public class Test{
public static void main(String[] args){
Tester T = new Tester();
T.afficher();
}
}
以下是生成的Java文档文件的屏幕截图,其中未列出不推荐的方法:
Javadoc只记录公共类。您的类中存在不推荐使用的方法,该类不是公共类,因此不会被记录
javadoc Test.java
为类测试生成文档。您不推荐使用的方法是在class Tester中。正如注释中指出的那样:class
Tester
将不会被记录,因为它与javadoc
不相关。
默认情况下,仅收集public
或protected
作为文档()
更改其可见性(例如,使其受保护
或公共
),或生成带有标志-package
或-private
的javadoc。但是请注意,您可能会生成大量文档,而您可能根本不需要这些文档
javadoc -package Test.java
所以用javadoc-package-d*.java调用它。java您的类不是公共的-
Tester
目前根本不会被记录。这与弃用无关。@JonSkeet我使用我提到的命令生成了上面程序的文档,但我没有看到弃用的方法将moveTest
列到他自己的文件中,并将其设置为公共类。然后再做一次javadoc。谢谢你,但是之前我被要求不要在类本身中使用不推荐的元素:不,你被告知,你不会被警告。我再次仔细阅读了你的答案,并使用了上面@AxelH的注释,所以它现在可以工作了。非常感谢你
-public: Shows only public classes and members.
-protected: Shows only protected and public classes and members. This is the default.
-package: Shows only package, protected, and public classes and members.
-private: Shows all classes and members.