国产xxxx99真实实拍_久久不雅视频_高清韩国a级特黄毛片_嗯老师别我我受不了了小说

資訊專欄INFORMATION COLUMN

Java 文檔注釋

bladefury / 651人閱讀

摘要:概述只有種注釋方式。單行注釋塊注釋說明注釋,等說明注釋允許你在程序中嵌入關于程序的信息。每一個標簽必須在一個新行的開始。多個相同類型的標簽應該放成一組。類描述輸出工具將你程序的源代碼作為輸入,輸出一些包含你程序注釋的文件。參考資料文檔注釋

概述

Java只有3種注釋方式。

//,單行注釋

/* */,塊注釋

說明注釋,@author,@version

說明注釋允許你在程序中嵌入關于程序的信息。你可以使用javadoc工具軟件來生成信息,并輸出到HTML文件中。

Javadoc 標簽

javadoc工具軟件識別以下標簽

標簽 描述
@author 標示一個類的作者
@deprecated 標識一個過期的類或成員
{@docRoot} 指明當前文檔跟目錄的路徑
@exception 指明一個類拋出的異常
@throws @exception一樣
{@inheritDoc} 從直接父類繼承的注釋
{@link} 插入一個到另一個主題的鏈接
{@linkplain} 插入一個到另一個主題的鏈接,但該鏈接顯示純文本字體
@param 說明一個方法的參數
@return 說明返回值類型
@see 指定一個到另一個主題的鏈接
@serial 說明一個序列化屬性
@serialData 說明通過 writeObject() 和 writeExternal() 方法寫的數據
@serialField 說明一個ObjectStreamField組件
@since 標記當引入一個特定的變化時
{@value} 顯示常亮的值,必須是static屬性
@version 指定類的版本號
文檔注釋

在開始的/**之后,第一行或幾行是關于類、變量和方法的主要描述。

之后,你可以包一個或多個各種各樣的@標簽。每一個@標簽必須在一個新行的開始。

多個相同類型的標簽應該放成一組。例如,如果你有三個@see標簽,可以將它們一個接一個的放在一起。

/** 
* 類描述
* @author panda
* @version 1.2
*/
...
Javadoc 輸出

Javadoc 工具將你Java程序的源代碼作為輸入,輸出一些包含你程序注釋的HTML文件。

每一個類的信息將在獨自的HTML文件里。Javadoc也可以輸出繼承的樹形結構和索引。

由于Javadoc的實現不同,工作也可能不同,你需要檢查你的Java開發系統的版本等細節,選擇合適的Javadoc版本。

實例

package com.coder4j.jse.javadoc;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;

/**
 * 輸入一個數,輸出其平方數。
 * 
 * @author panda
 * @version 1.2
 */
public class SquareNum {
    
    /**
     * 輸出平方值。
     * 
     * @param num
     *            待求平方數
     * @return 平方值
     */
    public double square(double num) {
        return num * num;
    }

    /**
     * 用戶輸入一個數
     * 
     * @return 返回用戶輸入的數
     * @exception IOException
     *                可能拋出的異常
     * @see IOException
     */
    public double getNumber() throws IOException {
        InputStreamReader isr = new InputStreamReader(System.in);
        BufferedReader inData = new BufferedReader(isr);
        String str;
        str = inData.readLine();
        return (new Double(str)).doubleValue();
    }

    /**
     * 入口主函數
     * 
     * @param args
     *            Unused.
     * @return Nothing.
     * @exception IOException
     *                On input error.
     * @see IOException
     */
    public static void main(String args[]) throws IOException {
        SquareNum ob = new SquareNum();
        double val;
        System.out.println("請輸入一個數: ");
        val = ob.getNumber();
        val = ob.square(val);
        System.out.println("平方值是: " + val);
    }
}

我在eclipse里寫了這個類,右鍵export,選擇Java/javadoc 然后按提示確認,控制臺輸出:

正在加載程序包com.coder4j.jse.javadoc的源文件...
正在構造 Javadoc 信息...
標準 Doclet 版本 1.7.0_75
正在構建所有程序包和類的樹...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/com/coder4j/jse/javadoc/SquareNum.html...
/Users/panda/Documents/lunaspace/code4j/src/com/coder4j/jse/javadoc/SquareNum.java:52: 警告 - 不能在返回類型為空的方法中使用 @return 標記。
正在生成/Users/panda/Documents/lunaspace/code4j/doc/com/coder4j/jse/javadoc/package-frame.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/com/coder4j/jse/javadoc/package-summary.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/com/coder4j/jse/javadoc/package-tree.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/constant-values.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/com/coder4j/jse/javadoc/class-use/SquareNum.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/com/coder4j/jse/javadoc/package-use.html...
正在構建所有程序包和類的索引...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/overview-tree.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/index-files/index-1.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/index-files/index-2.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/index-files/index-3.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/index-files/index-4.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/deprecated-list.html...
正在構建所有類的索引...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/allclasses-frame.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/allclasses-noframe.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/index.html...
正在生成/Users/panda/Documents/lunaspace/code4j/doc/help-doc.html...
1 個警告

默認在當前項目下新增doc目錄

doc/
|--com
|--index-files
|--resources
|--allclasses-frame.html
|--allclasses-noframe.html
|--constant-values.html
|--deprecated-list.html
|--help-doc.html
|--index.html
|--overview-tree.html
|--package-list
|--stylesheet.css

可以直接訪問index.html,你會看到類似這樣的頁面。

不同的Javadoc版本可能稍有不同喲。

參考資料

Java 文檔注釋

文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。

轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/65426.html

相關文章

  • Java編程思想》筆記2.一切都是對象

    摘要:方法的基本組成包括名稱參數返回值方法體方法名和參數列表唯一的標識出某個方法。如果返回的類型是,則的作用僅是退出方法否則必須返回正確的返回值包名名字可見性約定以域名反轉作為包名,用來劃分子目錄,并且全部小寫。 點擊進入我的博客 2.1用引用操縱對象 盡管一切都看作對象,但操縱的標識符實際上是對象的一個引用。 String s; // s是一個String類型的引用, 并沒有任何對象與其...

    taohonghui 評論0 收藏0
  • java代碼注釋規范

    摘要:下面說一下我們在訴求網二期開發中使用的代碼注釋規范,供大家參考下。在代碼不明晰處必須有注釋。在代碼修改處加上修改標識的注釋。在循環和邏輯分支組成的代碼中加注釋。 代碼注釋是架起程序設計者與程序閱讀者之間的通信橋梁,最大限度的提高團隊開發合作效率。也是程序代碼可維護性的重要環節之一。所以我們不是為寫注釋而寫注釋。下面說一下我們在訴求網二期開發中使用的代碼注釋規范,供大家參考下。 原則: ...

    desdik 評論0 收藏0
  • Java核心技術筆記 對象與類

    摘要:核心技術卷第章對象與類面向對象程序設計創建標準類庫中的類對象如何編寫自己的類傳統的結構化程序設計首先確定如何操作數據,再決定如何組織數據。當使用構造器時,無法改變所構造的對象類型。 《Java核心技術 卷Ⅰ》 第4章 對象與類 面向對象程序設計 創建標準Java類庫中的類對象 如何編寫自己的類 OOP 傳統的結構化程序設計:首先確定如何操作數據,再決定如何組織數據。 面向對象程序設...

    imtianx 評論0 收藏0
  • JAVA學習之路 (二) 變量和常量

    摘要:變量和常量中的關鍵字關鍵字對的編譯器有著特殊的意義,我們在程序中應用時一定不要使用關鍵字來定義變量或者常量,一定要慎重哦關鍵字是區分大小寫的哦,所以和是不一樣的中的標識符標識符就是用于給程序中變量類方法等命名的符號。 變量和常量 java中的關鍵字 showImg(https://segmentfault.com/img/bVbaF3o?w=519&h=178); 關鍵字對 Java ...

    focusj 評論0 收藏0
  • Java? 教程(仔細看看“Hello World!”應用程序)

    仔細看看Hello World!應用程序 現在你已經看到了Hello World!應用程序(甚至可能編譯并運行它),你可能想知道它是如何工作的,這是它的代碼: class HelloWorldApp { public static void main(String[] args) { System.out.println(Hello World!); // Display ...

    zollero 評論0 收藏0

發表評論

0條評論

最新活動
閱讀需要支付1元查看
<