注釋://表示注釋一行。

創新互聯建站是一家專注于網站設計、做網站與策劃設計,洮北網站建設哪家好?創新互聯建站做網站,專注于網站建設十年,網設計領域的專業建站公司;建站業務涵蓋:洮北等地區。洮北做網站價格咨詢:18980820575
/*表示注釋段內容(可以為很多行)*/
public static void main(String [] args){
System.out.println("Hello World1");
//System.out.println("Hello World2");
System.out.println("Hello World3");
/*System.out.println("Hello World4");
System.out.println("Hello World5");/*
}
這樣的話就只會輸出:
Hello World 1
Hello World 3
這樣很好理解吧?
做到這些規則的目的很簡單,就是寫出“優美”的Java代碼來。
1、Java注釋盡可能全面
對于方法的注釋應該包含詳細的入參和結果說明,有異常拋出的情況也要詳細敘述:類的注釋應該包含類的功能說明、作者和修改者。
2、多次使用的相同變量最好歸納成常量 多處使用的相同值的變量應該盡量歸納為一個常量,方便日后的維護。
3、盡量少的在循環中執行方法調用 盡量在循環中少做一些可避免的方法調用,這樣可以節省方法棧的創建。例如:
for(int i=0;ilist.size();i++){
System.out.println(i);}可以修改為:
for(int i=0,size=list.size();isize;i++){
System.out.println(i);}4、常量的定義可以放到接口中 在Java培訓中,接口里只允許存在常量,因此把常量放到接口中聲明就可以省去public static final這幾個關鍵詞。
5、ArrayList和LinkedList的選擇 這個問題比較常見。通常程序員最好能夠對list的使用場景做出評估,然后根據特性作出選擇。ArrayList底層是使用數組實現的,因此隨機讀取數據 會比LinkedList快很多,而LinkedList是使用鏈表實現的,新增和刪除數據的速度比ArrayList快不少。
6、String,StringBuffer和StringBuilder 這個問題也比較常見。在進行字符串拼接處理的時候,String通常會產生多個對象,而且將多個值緩存到常量池中。例如:
String a=“a”;
String b=“b”;a=a+b;這種情況下jvm會產生“a”,“b”,“ab”三個對象。而且字符串拼接的性能也很低。因此通常需要做字符串處理的時候盡量采用StringBuffer和StringBuilder來。
7、包裝類和基本類型的選擇 在代碼中,如果可以使用基本數據類型來做局部變量類型的話盡量使用基本數據類型,因為基本類型的變量是存放在棧中的,包裝類的變量是在堆中,棧的操作速度比堆快很多。
8、盡早的將不再使用的變量引用賦給null 這樣做可以幫助jvm更快的進行內存回收。當然很多人其實對這種做法并不感冒。
1、【文檔注釋】是寫在類或者方法的上面的。
文檔注釋可以用eclipse導出chm格式的幫助文檔,拿給其他人用時,方便他人理解。文檔注釋被調用的方法,當鼠標移到上面時提醒注釋內容。
使用文檔注釋時,需要在開始的?/**?之后,第一行或幾行是關于類、變量和方法的主要描述。
之后,可以包含一個或多個何種各樣的@?標簽。每一個@標簽必須在一個新行的開始或者在一行的開始緊跟星號(*)。多個相同類型的標簽應該放成一組。
2、【多行注釋】注釋的也是方法或類,言下之意就是一次性的將程序中的多行代碼注釋掉,但多行注釋的內容不能用于生成一個開發者文檔。
3、【多行注釋與文檔注釋的區別】多行注釋的內容不能用于生成一個開發者文檔,而文檔注釋的內容可以生產一個開發者文檔。
擴展資料
java常用的文檔注釋標簽
1、@author:標識一個類的作者
實例:?@authordescription
2、@deprecated:指名一個過期的類或成員
實例:?@deprecateddescription
3、@exception:標志一個類拋出的異常
實例:@exceptionexception-nameexplanation
4、{@inheritDoc}:從直接父類繼承的注釋
實例:Inheritsacommentfromtheimmediatesurperclass.
5、{@link}:插入一個到另一個主題的鏈接
實例:{@linknametext}
6、{@linkplain}:插入一個到另一個主題的鏈接,但是該鏈接顯示純文本字體
實例:Insertsanin-linelinktoanothertopic.
7、@param:說明一個方法的參數
實例:@paramparameter-nameexplanation
8、@return:說明返回值類型
實例:@returnexplanation
9、@see:指定一個到另一個主題的鏈接
實例:@seeanchor
10、@serial:說明一個序列化屬性
實例:@serialdescription
參考資料:百度百科-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?copy
span?style="font-size:18px;"*/
/**javadoc注釋的內容
*/
public?class?Hello{
/**屬性上的注釋*/
public?String?name;
/**這是main方法,是程序的入口
*@param?args?用戶輸入參數
*/
public?static?void?main(String[]?args){
System.out.println("Hello?World!");
f1();
}
/**?這是第1個方法,其作用是...*/
public?static?void?f1(){
System.out.println("f1()!");
}
}/span
[java]?view plain?copy
span?style="font-size:18px;"import?java.io.IOException;
/**javadoc注釋內容
*@since?1.0
*@version?1.1
*@author?Blue?Jey
*br鏈接到另一個文檔{@link?Hello},就這些
*see?Hello
*/
public?class?HelloWorld{
/**非public,protected?屬性上的注釋不生成*/
public?String?name;
/**這是main方法,是程序的入口
*@param?args?用戶輸入的參數,是數組
*@throws?IOException?main方法io異常
*/
public?static?void?main(String?args[])?throws?IOException{
System.out.println("hello?World!");
f1();
f2(1);
}
/**這是第一個方法,其作用是....
*@deprecated?從版本1.2開始,不再建議使用此方法
*/
public?static?void?f1(){
System.out.println("fl()!");
}
/**這是第二個方法,其作用是....
*@return?返回是否OK
*@param?i?輸入參數i
*@see?Hello
*@throws?IOException?io異常
*/
public?static?String?f2(int?i)throws?IOException{
System.out.println("f1()!");
return?"OK";
}
}?/span
注意:
如果源文件中有用到@version,@author標記,則在執行javadoc命令時,要加-version?-author
javadoc?-version?-author?-d?doc?*.java
(其中用-version用于提取源文件中的版本信息?-author用于提取源文件中的作者信息)
在Java里面主要有三種注釋:行注釋、段落注釋、文檔注釋
1)行注釋:行注釋也成為單行注釋,行注釋使用 “//注釋文字”的格式來對某一行的代碼進行注釋或者加以說明
2)段注釋:段注釋也成為多行注釋,通常是當說明文字比較長的時候的注釋方法
3)文檔注釋:文檔注釋是Java里面的一個比較厲害的功能,它可以用于注釋類、屬性、方法等說明,而且通過JDK工具javadoc直接生成相關文檔,文檔注釋的基本格式為“/**...*/”,不僅僅如此,文檔注釋本身還存在語法
試想一下,一個沒有一句注釋的程序源碼,怎么讀,一個程序要上萬條代碼不可能全部記得住哪一塊是什么用,而且一個項目也不會是一個人獨自完成,那樣效率太低,多人合作就要給別人說明,每一塊是什么用,方便他人使用,方便自己更正,而這些說明文字就是注釋,注釋不會被執行,不影響運行結果。
Java中代碼的注釋有三種:
// 注釋一行?
/* ...... */ 注釋若干行?
/** ...... */ 注釋若干行,并寫入 javadoc 文檔
前兩種比較容易理解,至于第三種,你學習Java看的api文檔就是javadoc程序根據第三種的注釋生成的。
擴展資料
注釋就是對代碼的解釋和說明,其目的是讓人們能夠更加輕松地了解代碼。注釋是編寫程序時,寫程序的人給一個語句、程序段、函數等的解釋或提示,能提高程序代碼的可讀性。
分享名稱:java代碼注釋一般格式 java中代碼注釋有哪些
URL標題:http://www.kartarina.com/article14/hjocde.html
成都網站建設公司_創新互聯,為您提供網頁設計公司、品牌網站制作、定制網站、搜索引擎優化、網站制作、軟件開發
聲明:本網站發布的內容(圖片、視頻和文字)以用戶投稿、用戶轉載內容為主,如果涉及侵權請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網站立場,如需處理請聯系客服。電話:028-86922220;郵箱:631063699@qq.com。內容未經允許不得轉載,或轉載時需注明來源: 創新互聯