java塊注釋

Ⅰ java 中的幾種注釋方式

我看動力節點的java基礎大全301集教中的三種注釋方法：

1、單行注釋 //注釋的內容

2、多行注釋/*......*/

3、/**......*/，這種方式和第二種方式相似。這種格式是為了便於javadoc程序自動生成文檔。

下面介紹一下Javadoc的標記：

特別聲明：

（1）javadoc針對public類生成注釋文檔

（2）javadoc只能在public、protected修飾的方法或者屬性之上

（3）javadoc注釋的格式化：前導*號和HTML標簽

（4）javadoc注釋要僅靠在類、屬性、方法之前

下面主要舉例說明第三種注釋的應用：

（1）首先編寫.java文件

（2）在命令行中執行以下dos命令：

javadoc *.java //根據相應的Java源代碼及其說明語句生成HTML文檔

//javadoc標記：是@開頭的，對javadoc而言，特殊的標記。

（3）在當前目錄下就會產生doc文件夾，裡面有一系列的.html文件

附上代碼：

[java]view plain

• <spanstyle="font-size:18px;">*/

• /**javadoc注釋的內容

• */

• publicclassHello{

• /**屬性上的注釋*/

• publicStringname;

• /**這是main方法,是程序的入口

• *@paramargs用戶輸入參數

• */

• publicstaticvoidmain(String[]args){

• System.out.println("HelloWorld!");

• f1();

• }

• /**這是第1個方法,其作用是...*/

• publicstaticvoidf1(){

• System.out.println("f1()！");

• }

• }</span>

[java]view plain

• <spanstyle="font-size:18px;">importjava.io.IOException;

• /**javadoc注釋內容

• *@since1.0

• *@version1.1

• *@authorBlueJey

• *<br>鏈接到另一個文檔{@linkHello},就這些

• *seeHello

• */

• publicclassHelloWorld{

• /**非public，protected屬性上的注釋不生成*/

• publicStringname;

• /**這是main方法，是程序的入口

• *@paramargs用戶輸入的參數，是數組

• *@throwsIOExceptionmain方法io異常

• */

• publicstaticvoidmain(Stringargs[])throwsIOException{

• System.out.println("helloWorld!");

• f1();

• f2(1);

• }

• /**這是第一個方法，其作用是....

• *@deprecated從版本1.2開始，不再建議使用此方法

• */

• publicstaticvoidf1(){

• System.out.println("fl()!");

• }

• /**這是第二個方法，其作用是....

• *@return返回是否OK

• *@parami輸入參數i

• *@seeHello

• *@throwsIOExceptionio異常

• */

• publicstaticStringf2(inti)throwsIOException{

• System.out.println("f1()!");

• return"OK";

• }

• }</span>

注意：

如果源文件中有用到@version,@author標記，則在執行javadoc命令時，要加-version-author

javadoc-version-author-ddoc*.java

（其中用-version用於提取源文件中的版本信息-author用於提取源文件中的作者信息）

Ⅱ Java注釋有幾種類型

三種類型：
1、單選注釋：符號是：//
2、塊注釋： 符號是： /* */ 可以跨多行
3、javadoc注釋： 符號是： /** */ 可以跨多行， 生成javadoc時，這樣的注釋會被生成標準的javaapi注釋。

Ⅲ java中的注釋可分為三種類型

Java中三種類型的注釋：

單行注釋：// 注釋內容

多行注釋：/*... 注釋內容....*/

文本注釋：/**.. 注釋內容....*/

代碼注釋是架起程序設計者與程序閱讀者之間的通信橋梁，最大限度的提高團隊開發合作效率。也是程序代碼可維護性的重要環節之一。所以不是為寫注釋而寫注釋。

備註：簡單的代碼做簡單注釋，注釋內容不大於10個字即可，另外，持久化對象或VO對象的getter、setter方法不需加註釋。

(3)java塊注釋擴展閱讀：

類（模塊）注釋採用 /** …… */，在每個類（模塊）的頭部要有必要的注釋信息，包括：工程名；類（模塊）編號；命名空間；類可以運行的JDK版本；版本號；作者；創建時間；類（模塊）功能描述（如功能、主要演算法、內部各部分之間的關系、該類與其類的關系等，必要時還要有一些如特別的軟硬體要求等說明）；主要函數或過程清單及本類（模塊）歷史修改記錄等。

Ⅳ 如何在java程序中添加註釋

1、單行(single-line)--短注釋：//…… 單獨行注釋：在代碼中單起一行注釋， 注釋前最好有一行空行，並與其後的代碼具有一樣的縮進層級。如果單行無法完成，則應採用塊注釋。 注釋格式：/* 注釋內容 */ 行頭注釋：在代碼行的開頭進行注釋。主要為了使該行代碼失去意義。 注釋格式：// 注釋內容 行章節附註釋：尾端(trailing)--極短的注釋，在代碼行的行尾進行注釋。一般與代碼行後空8（至少4）個格，所有注釋必須對齊。 注釋格式：代碼 + 8（至少4）個空格 + // 注釋內容
2、塊(block)--塊注釋：/*……*/ 注釋若干行，通常用於提供文件、方法、數據結構等的意義與用途的說明，或者演算法的描述。一般位於一個文件或者一個方法的前面，起到引導的作用，也可以根據需要放在合適的位置。這種域注釋不會出現在HTML報告中。注釋格式通常寫成： /* * 注釋內容 */
3、文檔注釋：/**……*/ 注釋若干行，並寫入javadoc文檔。每個文檔注釋都會被置於注釋定界符 /**......*/ ...

Ⅳ JAVA程序中注釋的作用及類型分別是什麼

對於Java注釋我們主要了解三種：

1,// 注釋一行

2,/* ...... */ 注釋若干行

3,/**……*/文檔注釋 /** ...... */ 注釋若干行，並寫入 javadoc文檔

java圖標通常這種注釋的多行寫法如下： /** * ......... * ......... */

Ⅵ java三種注釋形式是什麼

1. /** 寫注釋的內容 */ 這個叫分塊注釋
2. /* 寫注釋的內容 */ 這個多行注釋
3. // 寫注釋的內容 這個單行注釋
對三種注釋沒具體規定的使怎麼用
我的用法是如：
System.out.println("i:"+i); //單行注釋這行做了個什麼事情

/*
*注釋這個showInfo（）方法是干什麼的
*/
public void showInfo(){

}

/**
*類的說明，作者信息，創建時間等
*/
public class Test {

}

Ⅶ 什麼是注釋如何在Java程序中加入注釋

試想一下，一個沒有一句注釋的程序源碼，怎麼讀，一個程序要上萬條代碼不可能全部記得住哪一塊是什麼用，而且一個項目也不會是一個人獨自完成，那樣效率太低，多人合作就要給別人說明，每一塊是什麼用，方便他人使用，方便自己更正，而這些說明文字就是注釋，注釋不會被執行，不影響運行結果。

Java中代碼的注釋有三種：

// 注釋一行
/* ...... */ 注釋若干行
/** ...... */ 注釋若干行，並寫入 javadoc 文檔

前兩種比較容易理解，至於第三種，你學習Java看的api文檔就是javadoc程序根據第三種的注釋生成的。

(7)java塊注釋擴展閱讀

注釋就是對代碼的解釋和說明，其目的是讓人們能夠更加輕松地了解代碼。注釋是編寫程序時，寫程序的人給一個語句、程序段、函數等的解釋或提示，能提高程序代碼的可讀性。