Question

这是我为我的项目编写的一个类的示例，它以意大利语记录：

/**
 * Eccezione da lanciare nel caso si verifichi un guasto al motore.
 * Eredita da <a  href="http://docs.oracle.com/javase/1.4.2/docs/api/java/lang/Exception.html">
 * java.lang.Exception </a>.
 * 
 * @author Ramy Al Zuhouri
 * @version 1.0
 */
package truckingCompany.utilities;

public class EngineFailureException extends Exception
{
    /**
     * Viene chiamato il costruttore della superclasse Exception, con un 
     * messaggio che descrive l' accaduto.
     */
    public EngineFailureException()
    {
        super("Guasto al motore durante il rientro alla base");
    }
}

但是生成javadoc时出现问题：在生成的html页面中看不到注释的上半部分。
所有这一切都是：

/*
 * Eccezione da lanciare nel caso si verifichi un guasto al motore.
 * Eredita da <a  href="http://docs.oracle.com/javase/1.4.2/docs/api/java/lang/Exception.html">
 * java.lang.Exception </a>.
 * 
 * @author Ramy Al Zuhouri
 * @version 1.0
 */

页面中没有显示。如何强制netbeans也包括这些评论？

Answer 1

这是因为那不是javadoc评论。 Javadoc评论看起来像：

/**
*
*
*/

你的是：

/*
*
*
*/

注意第一行的差异？如果您在第一行添加另一个*以使其/**，它应该可以正常工作。

有关Java read here.

中注释类型的更多信息

Answer 2

您是否尝试将其放在课程上方而非课程上方？

Netbeans没有正确生成javadoc

2 个答案: