Java .jd文件的具体用途是什么?

Java .jd文件的具体用途是什么?,java,html,javadoc,Java,Html,Javadoc,我一直在工作中使用.jd文件,在本地计算机中构建它以将其转换为html… 然而,我仍然对.jd文件的用途感到困惑?我做了一些研究,定义是:“Javadoc是一个从代码中的Javadoc注释生成html文档的工具(类似于java.sun.com上的参考页面)。 当我查看.jd文件代码时,它们看起来非常像html。它们有标签和标签。程序员编写javadoc代码吗?或者Javadoc是一个从Java代码中提取注释的工具(对我来说非常模糊,一个名为Javadoc的生成.jd文件的软件工具? 有人能帮我理

我一直在工作中使用.jd文件,在本地计算机中构建它以将其转换为html…

然而,我仍然对.jd文件的用途感到困惑?我做了一些研究,定义是:“Javadoc是一个从代码中的Javadoc注释生成html文档的工具(类似于java.sun.com上的参考页面)。

当我查看.jd文件代码时,它们看起来非常像html。它们有
标签和
  • 标签。程序员编写javadoc代码吗?或者Javadoc是一个从Java代码中提取注释的工具(对我来说非常模糊,一个名为Javadoc的生成.jd文件的软件工具?

    有人能帮我理解吗?由于我没有直接生成.jd文件,因此很难理解它的用途以及它到底是什么…


    多谢各位

    Javadoc是一种将Java代码中的类、方法和其他文档注释转换为可读的HTML API文档格式的方法,供人们查看

    几乎所有关于Java中特定类和方法的文档都是由Javadoc文件形成的


    TL;DR:他们将注释转换为文档页面。

    JavaDoc是由开发人员编写的,注释嵌入到他们的源代码中

    例如:

    /**
     * Returns an Image object that can then be painted on the screen. 
     * The url argument must specify an absolute {@link URL}. The name
     * argument is a specifier that is relative to the url argument. 
     * <p>
     * This method always returns immediately, whether or not the 
     * image exists. When this applet attempts to draw the image on
     * the screen, the data will be loaded. The graphics primitives 
     * that draw the image will incrementally paint on the screen. 
     *
     * @param  url  an absolute URL giving the base location of the image
     * @param  name the location of the image, relative to the url argument
     * @return      the image at the specified URL
     * @see         Image
     */
     public Image getImage(URL url, String name) {
            try {
                return getImage(new URL(url, name));
            } catch (MalformedURLException e) {
                return null;
            }
     }
    
    /**
    *返回可以在屏幕上绘制的图像对象。
    *url参数必须指定绝对值{@link url}。名字
    *参数是相对于url参数的说明符。
    *
    *此方法总是立即返回,无论
    *图像存在。当此小程序尝试在其上绘制图像时
    *在屏幕上,将加载数据。图形原语
    *绘制图像的步骤将在屏幕上递增绘制。
    *
    *@param url给出图像基本位置的绝对url
    *@param name图像相对于url参数的位置
    *@返回指定URL处的图像
    *@见图片
    */
    公共图像getImage(URL、字符串名称){
    试一试{
    返回getImage(新的URL(URL,name));
    }捕获(格式错误){
    返回null;
    }
    }
    
    本例记录了一个名为getImage的方法

    JavaDoc非常棒,因为它是开发人员可以在编写代码时编写的文档,与代码一起编写,并且在运行生成器之后,他们有很好的技术文档,其他人可以轻松阅读


    在.jd文件中看到html的原因是,出于格式化的原因,一些html可以嵌入到JavaDoc中(参见示例)

    实际看到
    .jd
    文件是非常罕见的。Javadoc通常包含在代码中,然后被处理成普通的
    .html
    。这就是我对Javadoc感到困惑的地方…你说Javadoc包含在代码中。假设代码是Java代码,那么你的意思是Javadoc只是Java代码中的注释?如果是这样的话,那么应该有一个工具来提取所有的注释(正如你所说的,javadoc)来提取它们并将它们变成一个.jd文件,对吗?不,它将它们变成一个HTML文件。你真的在任何地方看到
    .jd
    文件了吗?是的。我们收到了.jd文件,但里面没有评论…只有html标记和@jd.body后面的内容。所以我很困惑..如果.jd文件没有注释,它仍然是一个javadoc文件?我从来没有听说过
    .jd
    文件。这听起来像是某种中间格式。现代Javadoc直接读取Java文件并输出HTML。谢谢!但是我看到的.jd文件没有任何注释,只有第一行的
    page.title=blahblahblah
    ,第二行的
    @jd:body
    ,接下来的几乎都是html代码,其中有一些标记实例,比如
    {@docRoot}
    。为什么呢?另外,根据您的解释,我猜您在上面提供的javaDoc示例中的注释在从jd文件转换的html中是未注释的(或者不注释,因为这取决于html文件是为谁使用的)?@Penny我所描述的是典型的javaDoc用法。可能.jd文件是贵公司使用的一种内部格式?我在这里看不到对.jd文件的引用: