青青草原综合久久大伊人导航_色综合久久天天综合_日日噜噜夜夜狠狠久久丁香五月_热久久这里只有精品

woaidongmao

文章均收錄自他人博客,但不喜標(biāo)題前加-[轉(zhuǎn)貼],因其丑陋,見諒!~
隨筆 - 1469, 文章 - 0, 評論 - 661, 引用 - 0
數(shù)據(jù)加載中……

JavaDoc注釋使用

    JavadocSun公司提供的一個技術(shù),它從程序源代碼中抽取類、方法、成員等注釋形成一個和源代碼配套的API幫助文檔。也就是說,只要在編寫程序時以一套特定的標(biāo)簽作注釋,在程序編寫完成后,通過Javadoc就可以同時形式程序的開發(fā)文檔了。
Javadoc
輸出的是一些HTML文件,我們可以通過WEB瀏覽器來查看它。
Javadoc
的語法:
所有Javadoc都只能源于/**開始和*/結(jié)束。使用javadoc有二種方式:一種是嵌入HTML;另一種是使用文檔標(biāo)簽。所謂文檔標(biāo)簽就是一些以 “@”開頭的命令,且“@”要置于注釋行的最前面。而行內(nèi)文檔標(biāo)簽則可以出現(xiàn)在Javadoc注釋中的任何地方,它們也是以“@”字符開頭,但要括在共括號內(nèi)。
Javadoc
只能為public或者protected成員進(jìn)行文檔注釋。private和包內(nèi)訪問的成員的注釋會被忽略掉。這樣做是有道理的,因為只有publicprotected成員才能在文件之外被使用,這也體現(xiàn)了封裝性的優(yōu)點(diǎn)。
嵌入HTML:
Javadoc
HTML代碼嵌入到所生成的HTML文件中。這樣能充分利用HTML的功能。比如:
/**
*<b>
*this is my test program;
*</b>
*/
但一般我們不要在HTML里使用標(biāo)題,如<h1><hr>,因為Javadoc會插入自己的標(biāo)題,我們的標(biāo)題可能會干擾它。
常用的標(biāo)簽:
1) @see:
引用其它類的文檔,相當(dāng)于超鏈接,Javadoc會在其生成的HTML文件中,將@see標(biāo)簽鏈到其他的文檔
@see classname
這樣在生成的文檔中會出現(xiàn)"See Also"的超鏈蛸。但是Javadoc不去檢查你的超鏈接是否有效。
2) {@link package.class#member label}
@See的功能一樣,只是用label作主超鏈接,而不是用"see also"
3) {@docRoot}
:標(biāo)簽產(chǎn)生 到文檔根目錄的相對路徑,用于文檔樹頁面的顯式超鏈接
4) {@inheritDoc}:
標(biāo)簽從當(dāng)前這個類的最直接的基類中繼承相關(guān)文檔到當(dāng)前的文檔注釋中。
5) @version
:使用方法為@version 2.2.1.2...
      2.2.1.2...
是我們作的版本說明信息
6) @author:
使用方法為 @author PowerFedora powpro@hotmail.com
     
也就是說我們可以在@author后加上作者名字,email等聯(lián)系方式
7) @since
:這個標(biāo)簽允許你指定程序最早使用的版本。
     
比如我們看JDK Document里的每個類最后都會說明從JDK哪個版本開始啟用。
8) @param
@param name 用于輸入客戶的姓名
      @param
后面是方法的參數(shù),以及相應(yīng)的說明
     
我們可以使用任意數(shù)量的此標(biāo)簽,每個參數(shù)都可以有這樣一個標(biāo)簽
9) @return this is description
      @return
后面是描述返回值的含義,可以延續(xù)幾行。
10) @throws fully-qualified-class-name description
      fully-qualified-class-name
為異常類的完整名字,
     
description告訴你為什么此異常會在方法中調(diào)用出現(xiàn)。
11) @deprecated:
用于指出一些舊特性已由改進(jìn)的新特性所取代,建議用戶不要再使用舊特性。

Sample


import java.util.*;
/**
這是一個為了測試Javadoc而專門寫的類
*
功能是打印字符串 HelloWorld
* @author AuthorName
* @version 1.0
*/
public class JavaDocTest {

/**
這里的main函數(shù),作為java程序的入口
  * @param
參數(shù)為一個String對象數(shù)組
  * @return
沒有返回值的內(nèi)容
  * @exception exceptions
沒有異常被拋出
  */
public static void main(String[] args){
     System.out.print("HelloWorld!");    
}
}
如果使用eclipse的話,完全不需要背這些標(biāo)簽。在需要注釋的地方打上/**之后,再打@符號eclipse會自動顯示所支持的標(biāo)簽供選擇。
同樣在生成HTML文檔時也可以利用eclipseexport功能直接導(dǎo)出,否則用javadoc手工來生成的話是件相當(dāng)痛苦的事情。

========================================================================

========================================================================

1.編寫一小段程序,體會文檔注釋的用法,并通過文檔生成工具提取文檔注釋,形成程序文檔。

代碼如下:

//: Property.java

import java.util.*;

 

/** The first example program in "Thinking in Java."

 * Lists system information on current machine.

 * @author Bruce Eckel

 * @author http://www.EckelObjects.com/Eckel

 * @version 1.0

 */

public class Property {

    /** Sole entry point to class & application

     * @param args Array of string arguments

     * @exception No exceptions are thrown

     */

    public static void main(String args[]) {

       System.out.println(new Date());

       System.getProperties().list(System.out);

       System.out.println("--- Memory Usage:");

       Runtime rt = Runtime.getRuntime();

       System.out.println("Total Memory = "

                         + rt.totalMemory()

                         + " Free Memory = "

                         + rt.freeMemory());

    }

} ///:~

利用Myeclipse生產(chǎn)javadoc文檔的步驟如下:

1.選擇File->Export->javadoc,下一步。

2.Javadoc comand選擇JDKbin目錄下的javadoc.exe。選擇要生成的源代碼和javadoc保存的目的路徑,下一步。

3.Document title輸入標(biāo)題,下一步。

4.overview輸入啟動指定的overview文件路徑,Extra Javadoc options輸入

-windowtitle 'Type B Monitor'[瀏覽器顯示標(biāo)題]

-bottom <center>Travelsky</center>[底部顯示文本]

下一步。

posted on 2009-06-15 11:13 肥仔 閱讀(2289) 評論(0)  編輯 收藏 引用 所屬分類: Web-后臺

青青草原综合久久大伊人导航_色综合久久天天综合_日日噜噜夜夜狠狠久久丁香五月_热久久这里只有精品
  • <ins id="pjuwb"></ins>
    <blockquote id="pjuwb"><pre id="pjuwb"></pre></blockquote>
    <noscript id="pjuwb"></noscript>
          <sup id="pjuwb"><pre id="pjuwb"></pre></sup>
            <dd id="pjuwb"></dd>
            <abbr id="pjuwb"></abbr>
            精品动漫一区| 国模 一区 二区 三区| 久久不射中文字幕| 亚洲人体大胆视频| 久久深夜福利| 午夜精品国产更新| 夜夜嗨av一区二区三区网页 | 欧美成在线观看| 香蕉亚洲视频| avtt综合网| 狠狠色狠狠色综合系列| 国产精品久久久亚洲一区| 欧美黄色片免费观看| 欧美在线观看一区二区| 亚洲精品女av网站| 久久综合色综合88| 亚洲专区免费| 一区二区三区免费网站| 亚洲破处大片| 亚洲国产一区二区三区高清 | 欧美华人在线视频| 久久免费视频这里只有精品| 亚洲一区二区三区免费视频| 亚洲美女av黄| 亚洲精品久久久久久下一站| 亚洲国产精品悠悠久久琪琪| 在线观看成人小视频| 韩国一区电影| 狠狠干综合网| 精品88久久久久88久久久| 国产又爽又黄的激情精品视频| 国产精品日韩在线观看| 国产精品r级在线| 欧美日韩在线一二三| 欧美日韩福利在线观看| 欧美欧美天天天天操| 欧美精品1区2区| 欧美日本韩国一区| 欧美日韩亚洲综合在线| 欧美日韩视频在线一区二区| 欧美日韩免费高清| 欧美日韩四区| 国产精品久久久久一区二区| 国产精品视频你懂的| 国产欧美日韩综合精品二区| 国产性色一区二区| 国产自产精品| 亚洲激情视频| 一本久久a久久精品亚洲| 亚洲神马久久| 欧美一区二区女人| 久久久久久久综合| 欧美成人精品在线观看| 亚洲日本aⅴ片在线观看香蕉| 亚洲精品久久久蜜桃| 亚洲天堂成人| 久久精品国产一区二区电影 | 亚洲国产精品t66y| 99国产精品久久久久老师 | 在线日韩电影| 99精品免费视频| 亚洲欧美中文日韩v在线观看| 欧美专区第一页| 欧美韩日一区二区| 99精品国产在热久久婷婷| 亚洲自拍都市欧美小说| 久久精品一区二区三区不卡牛牛| 猫咪成人在线观看| 欧美日韩高清在线播放| 国产日韩一区二区三区在线播放 | 欧美激情在线播放| 一区二区电影免费在线观看| 羞羞色国产精品| 久久综合色88| 国产精品v欧美精品v日本精品动漫| 国产欧美综合一区二区三区| 在线观看久久av| 亚洲性视频h| 久热精品视频在线观看| 日韩一二三区视频| 久久精品99国产精品日本| 欧美理论大片| 狠狠88综合久久久久综合网| 亚洲免费电影在线观看| 久久久久.com| 亚洲激情一区| 欧美在线日韩在线| 欧美日韩日韩| 亚洲国产精品999| 午夜精品视频一区| 欧美激情欧美狂野欧美精品 | 欧美专区福利在线| 亚洲国产精品久久久| 午夜在线成人av| 欧美激情亚洲自拍| 国内揄拍国内精品少妇国语| 亚洲美女免费视频| 久久国产精品高清| 亚洲精品资源| 免费观看在线综合| 韩日视频一区| 午夜欧美大片免费观看| 亚洲国产电影| 久久婷婷国产综合国色天香| 国产精品久久久久久久免费软件| 亚洲精品久久久久久久久久久 | 欧美国产另类| 精品电影在线观看| 欧美在线观看一区二区| 亚洲精品一区在线| 免费成人黄色片| 国产一区二区| 欧美一区二区三区免费在线看| 91久久夜色精品国产九色| 久久综合影音| 激情综合久久| 久久天天躁狠狠躁夜夜av| 亚洲欧美在线另类| 国产精品伊人日日| 亚洲一区二区三区高清| 日韩一级成人av| 欧美日韩日日骚| 日韩亚洲精品视频| 亚洲国产欧美精品| 欧美成人伊人久久综合网| 亚洲大片免费看| 免费美女久久99| 久久久欧美一区二区| 影音先锋成人资源站| 久久性色av| 久热精品在线| 最新国产精品拍自在线播放| 亚洲高清视频在线观看| 欧美国产另类| 亚洲视频免费| 亚洲一区视频| 国产日韩在线不卡| 久久久久久久一区| 久久午夜精品一区二区| 亚洲国产精品成人综合| 亚洲高清视频一区| 欧美日本亚洲| 亚洲女性裸体视频| 亚洲欧美日韩国产一区二区三区| 国产精品网站视频| 欧美一区二区视频在线| 久久不射中文字幕| 亚洲国内精品在线| 亚洲欧洲午夜| 国产精品二区三区四区| 欧美一区免费视频| 欧美在线视频观看| 亚洲国产精品第一区二区| 亚洲福利视频三区| 欧美日韩午夜在线| 久久精品av麻豆的观看方式| 欧美一区二区三区电影在线观看| 伊大人香蕉综合8在线视| 亚洲国产老妈| 国产精品国产a| 久久国产精品一区二区三区四区| 久久成人精品视频| 亚洲美女少妇无套啪啪呻吟| 在线亚洲国产精品网站| 国产在线国偷精品产拍免费yy| 欧美电影免费| 欧美日韩一区在线视频| 久久国产精品久久国产精品| 美国十次成人| 性色av一区二区怡红| 久久免费视频在线| 亚洲婷婷综合色高清在线| 性欧美超级视频| 亚洲日本一区二区| 亚洲永久免费av| 在线观看亚洲精品视频| 一区二区三区国产盗摄| 狠狠综合久久av一区二区小说| 亚洲欧洲在线一区| 国产亚洲精品成人av久久ww| 亚洲国产精品黑人久久久| 国产精品夜夜嗨| 亚洲电影观看| 国产午夜亚洲精品羞羞网站| 亚洲精品美女在线| 红桃视频成人| 国产精品99久久久久久有的能看| 伊人久久男人天堂| 亚洲香蕉网站| 99热在这里有精品免费| 久久成人精品| 欧美亚洲色图校园春色| 欧美久久久久| 美女网站久久| 国产伦精品一区二区三区四区免费| 亚洲人成人99网站| 在线视频国产日韩| 午夜精品久久久| 亚洲综合色视频| 欧美破处大片在线视频|