Java語言編碼規(guī)范_第1頁
Java語言編碼規(guī)范_第2頁
Java語言編碼規(guī)范_第3頁
Java語言編碼規(guī)范_第4頁
Java語言編碼規(guī)范_第5頁
已閱讀5頁,還剩25頁未讀 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進(jìn)行舉報或認(rèn)領(lǐng)

文檔簡介

1、Superspirit Software StudioJAVA語言編碼規(guī)范作 成 日:2003/04/25目 錄1.前言11.1規(guī)范編寫的目的和意義11.2本規(guī)范的適用范圍12.JAVA源文件的組織結(jié)構(gòu)22.1 PACKAGE的組織22.2 JAVA源文件的內(nèi)部結(jié)構(gòu)23.命名規(guī)則63.1 JAVA源文件的命名63.2 Package的命名63.3 Class/Interface的命名63.4常量的命名63.5變量的命名73.5.1普通變量73.5.2約定變量73.6方法的命名73.7方法參數(shù)的命名74.樣式結(jié)構(gòu)84.1整體樣式84.1.1縮進(jìn)單位84.1.2縮進(jìn)和對齊84.1.3行寬94.1.

2、4斷行規(guī)則94.1.5空白的使用104.2注釋樣式124.2.1實(shí)現(xiàn)注釋124.2.2文檔注釋144.3聲明144.3.1變量的聲明144.3.2類和接口的聲明164.4語句174.4.1簡單語句174.4.2復(fù)合語句175.典型示例206.附錄21附1完整示例21附2關(guān)于JavaDoc23常用的JavaDoc標(biāo)記23JavaDoc命令的使用25附3參考資料28JAVA程序編碼規(guī)范 V1.01.前言1.1規(guī)范編寫的目的和意義 在軟件的生命周期中,維護(hù)的花費(fèi)通常占很大的比例,且?guī)缀跛械能浖谄湔麄€生命周期中,開發(fā)人員和維護(hù)人員都不盡相同。編碼規(guī)范可以改善軟件的可讀性,使程序員盡快而徹底地理解

3、代碼;同時,編碼規(guī)范還可以提高程序代碼的安全性和可維護(hù)性,提高軟件開發(fā)的生產(chǎn)效率,所以,編碼規(guī)范對于程序員而言至關(guān)重要。 為使開發(fā)項(xiàng)目中所有的JAVA程序代碼的風(fēng)格保持一致,增加代碼的可讀性,便于維護(hù)及內(nèi)部交流,使JAVA程序開發(fā)人員養(yǎng)成良好的編碼習(xí)慣,有必要對JAVA程序的代碼編碼風(fēng)格做統(tǒng)一的規(guī)范約束。1.2本規(guī)范的適用范圍除發(fā)注方另有特別要求外,本規(guī)范適用于公司關(guān)于Pure JAVA、JSP、Applet、Servlet、EJB等項(xiàng)目的開發(fā)。2.JAVA源文件的組織結(jié)構(gòu)2.1 PACKAGE的組織 Package是組織相關(guān)類的一種比較方便的方法。Package使我們能夠更容易查找和使用類文

4、件,并可以幫助我們在運(yùn)行程序時更好的訪問和控制類數(shù)據(jù)。 類文件可以很容易的組織到Package中,只要把相關(guān)的類文件存放到同一個目錄下,給該目錄取一個與這些類文件的作用相關(guān)的名稱。如果需要聲明程序包,那么每個JAVA文件(*.java)都需要在頂部進(jìn)行Package的聲明,以反映出包的名稱。 例:package com.fujitsu.fnst;2.2 JAVA源文件的內(nèi)部結(jié)構(gòu)所有的 JAVA(*.java) 文件都應(yīng)遵守如下的樣式規(guī)則,如果JAVA源文件中出現(xiàn)以下相應(yīng)的部分,應(yīng)遵循如下的先后順序。編碼時,即使某個類不是public類型的,也要在一個獨(dú)立的JAVA文件(*.java)中聲明,避

5、免一個JAVA文件包含多個類聲明。l 版權(quán)信息 版權(quán)信息應(yīng)在JAVA文件的開頭,其他不需要出現(xiàn)在 JavaDoc中的信息也可以包含在這里。 例: /* * Copyright (C) Fujitsu Co., Ltd. * */l Package/Import Package 行要在 import 行之前,import 中標(biāo)準(zhǔn)的包名要在本地的包名之前,而且按照字母順序排列。如果 import 行中包含了同一個包中的不同子目錄,應(yīng)import到某一個指定的類,避免*類型的import。 例: package com.fujitsu.fnst; import java.io.InputStream

6、;import java.io.OutputStream;l Class 類的注釋一般是用來解釋類的,建議使用文檔注釋。 例: /* * Class description goes here. * */ 接下來是類的定義,有可能包含了extends 和 implements。 例: public class CounterSet extends Observable implements Cloneable l Class Fields public的成員變量應(yīng)使用JavaDoc注釋,protected、private和 package 定義的成員變量如果名字含義明確的話,可以沒有注釋。注釋

7、成員變量時,建議使用文檔注釋。 例: /* classVar1 documentation comment */ public static int classVar1 = 0; /* * classVar2 documentation comment that happens to be * more than one line long */private static int classVar2 = 0;l 存取方法 如果存取方法只進(jìn)行簡單的賦值或取值操作,可以寫在一行上,否則不要寫在一行上。 例: /* * Get the counters */ public int getPacke

8、ts() packets+; return packets; /* * Set the counters * */ public void setPackets(int packets) this.packets = packets; l 構(gòu)造函數(shù) 構(gòu)造函數(shù)應(yīng)該按照參數(shù)數(shù)目的遞增順序進(jìn)行書寫。每個類都應(yīng)具有至少一個構(gòu)造函數(shù)。 例: /* * constructor Blah documentation comment * */ public Blah() /* * constructor Blah documentation comment * */ public Blah(int size)

9、 l 克隆方法 如果這個類是可以被克隆的,那么下一步就是 clone 方法: 例: /* * clone method for this class */ public Object clone() l 類方法 對于類的具體方法,應(yīng)將功能相似的方法放置在一起。 例: /* * Method doSomething documentation comment */ public void doSomething() l toString方法 每一個類都應(yīng)該定義toString方法。 例: /* * toString method for this class */ public String t

10、oString() l main方法 每個文件的主類中應(yīng)有一個main方法。main方法應(yīng)該提供簡單的測試和demo功能,它應(yīng)該寫在類的底部。 例: /* * The main method for simple test or demo use */ public static void main(String agrs) 3.命名規(guī)則3.1 JAVA源文件的命名JAVA源文件名必須和源文件中所定義的類的類名相同。3.2 Package的命名Package名的第一部分應(yīng)是小寫ASCII字符,并且是頂級域名之一,通常是com、edu、gov、mil、net、org或由ISO標(biāo)準(zhǔn)3166、198

11、1定義的國家唯一標(biāo)志碼。Package名的后續(xù)部分由各組織內(nèi)部命名規(guī)則決定,內(nèi)部命名規(guī)則指定了各組件的目錄名,所屬部門名、項(xiàng)目名等。 例: package erstage.j2ee.deploytool.deployment; package com.apple.quicktime.v2;3.3 Class/Interface的命名Class名應(yīng)是首字母大寫的名詞。命名時應(yīng)該使其簡潔而又具有描述性。異常類的命名,應(yīng)以Exception結(jié)尾。Interface的命名規(guī)則與Class相同。 例: public interface Set ; public class

12、CounterSet implement Set ; public class InvalidException extends Exception ;3.4常量的命名常量名的字母應(yīng)全部大寫,不同的單詞之間通過下劃線進(jìn)行連接,并且名字組合應(yīng)該賦予含義。 例: static final int MIN_WIDTH = 4; static final int MAX_WIDTH = 999;3.5變量的命名3.5.1普通變量普通變量名的首字母小寫,其它每個單詞的首字母大寫。命名時應(yīng)該使其簡短而又有特定含義,簡潔明了的向使用者展示其使用意圖。 例: float floatWidth = 0.0; d

13、ouble doubleWidth = 0.0;3.5.2約定變量 所謂約定變量,是指那些使用后即可拋棄(throwaway)的臨時變量。通常i、j、k、m和n代表整型變量;c、d和e代表字符型變量。 例: int i = 0; char c = a;3.6方法的命名方法名的第一個單詞應(yīng)是動詞,并且首字母小寫,其它每個單詞首字母大寫。 例: void findPersonID(int nID); void isStringEmpty(String str);3.7方法參數(shù)的命名應(yīng)該選擇有意義的名稱作為方法的參數(shù)名。如果可能的話,選擇和需要賦值的字段一樣的名字。 例: void setCount

14、er(int size) this.size = size;4.樣式結(jié)構(gòu)4.1整體樣式4.1.1縮進(jìn)單位 一個縮進(jìn)單位為四個空格,縮進(jìn)排版時以縮進(jìn)一個單位為最小縮進(jìn)量。不要使用制表符(Tab鍵),因?yàn)椴煌南到y(tǒng)對它的解釋不盡相同。4.1.2縮進(jìn)和對齊l 縮進(jìn)當(dāng)某行語句在邏輯上比下面的語句高一個層次時,該行下面的語句都要在該行的基礎(chǔ)上縮進(jìn)一個單位。 例: public void someMethod(parameterA,parameterB) int variantA=0; Sentence1; if (Conditions) Sentence2; l 對齊若干語句在邏輯上屬于同一層次時,這些

15、語句應(yīng)對齊。 例: public void someMethod(parameterA) int variantA=0; Sentence1 if (Conditions) Sentence2; Sentence3; 4.1.3行寬 為了和linux,unix等字符界面的操作系統(tǒng)兼容,JAVA代碼行應(yīng)限制在80個字符之內(nèi),多余部分應(yīng)換行。 例: variantA = someMethod(longExpression1, longExpression2, longExpression3); 應(yīng)改為: variantA = someMethod(longExpression1, longExpr

16、ession2, longExpression3);4.1.4斷行規(guī)則 當(dāng)一句完整的語句大于80個字符時需要斷行,斷行時,應(yīng)遵循下面規(guī)則。l 在逗號后換行 例: variantA = someMethod(longExpression1, longExpression2, longExpression3, longExpression4);l 在操作符前換行 例: longName1 = longName2 * (longName3 + longName4 - longName5) + 4 * longName6;l 換行后,應(yīng)和斷行處的前一層次對齊 例: longName1 = longNa

17、me2 * (longName3 + longName4 - longName5) + 4 * longName6; 應(yīng)改為: longName1 = longName2 * (longName3 + longName4 - longName5) + 4 * longName6;l 換行時盡量選擇高層次的地方進(jìn)行換行 例: longName1 = longName2 * (longName3 + longName4 - longName5) + 4 * longName6; 應(yīng)改為: longName1 = longName2 * (longName3 + longName4 - longNa

18、me5) + 4 * longName6;l 在使用上述的規(guī)則換行后對齊時,如果次行的長度大于80個字符,應(yīng)改用兩個單位的縮進(jìn)來代替層次對齊 例: private static synchronized horkingLongMethodName(int anArg, Object anotherArg, String yetAnotherArg, Object andStillAnother) 4.1.5空白的使用l 空格字符的使用1) 關(guān)鍵字和括號()之間要用空格隔開 例: while (condition) Sentence1; if (condition) Sentence2; 2)

19、參數(shù)列表中逗號的后面應(yīng)該使用空格 例: public void methodA(parameterA, parameterB, parameterC) Sentence1; 3) 所有的二元運(yùn)算符,除了".",應(yīng)該使用空格將之與操作數(shù)分開 例: longName1 = longName2 * (longName3 + longName4) + 4 * longName5;4) 強(qiáng)制類型轉(zhuǎn)換后應(yīng)該跟一個空格 例: methodA(byte) parameterA, (Object) parameterB);5) 左括號右邊和右括號左邊不能有空格 例: longName1 =

20、longName2 * ( longName3 + longName4 ); 應(yīng)改為: longName1 = longName2 * (longName3 + longName4);6) 方法名與其參數(shù)列表的左括號之間不能有空格 例: methodA (parameter1, parameter2); 應(yīng)改為: methodA(parameter1, parameter2);7) 一元操作符和操作數(shù)之間不應(yīng)該加空格,比如:負(fù)號("-")、自增("+")和自減("-") 例: variantA += variantB -; 應(yīng)改為:

21、variantA += variantB-;l 空白行的使用 空白行將邏輯相關(guān)的代碼段分隔開,以提高可讀性,有如下幾種情形:1) 一個源文件的兩個片段(section)之間用兩個空白行 例: 用兩個空白行將JAVA文件頂端的版權(quán)說明和下面的內(nèi)容隔開 /* * Copyright (c) 1999-2003 Fujitsu, Co., LTD. * */ package com.fujitsu.fnst;2) 兩個類聲明或接口聲明之間使用兩個空白行 例: public class A private class B 3) 兩個方法的聲明之間使用一個空白行 例: public class A pr

22、ivate void methodA() priavte void methodB() 4) 方法內(nèi)的局部變量和方法的第一條語句之間使用一個空白行 例: private void methodA() int variantA = 0; int variantB = 0; variantA = variantB + 10; 5) 塊注釋或單行注釋之前使用一個空白行 例: private void methodA() if (condition) /*This sentence can run on all occasions, */variantA = variantB + 10; 6) 一個方

23、法內(nèi)的兩個邏輯段之間應(yīng)該用一個空白行 例: private int methodA() variantA = methodGet(); variantB = methodGet(); return variantA + variantB; 4.2注釋樣式 JAVA程序有兩類注釋,實(shí)現(xiàn)注釋(implementation comments)和文檔注釋(document comments)。實(shí)現(xiàn)注釋,就是使用 /*.*/ 或 / 界定的注釋。文檔注釋,又被稱為"doc comments"或" JavaDoc注釋",是JAVA獨(dú)有的,由 /*.*/ 界定,并且文

24、檔注釋可以通過JavaDoc工具轉(zhuǎn)換成HTML文檔。在注釋里,應(yīng)該對設(shè)計決策中重要的或者不是顯而易見的地方進(jìn)行說明,但應(yīng)避免對意思表達(dá)已經(jīng)清晰的語句進(jìn)行注釋。特別注意,頻繁的注釋有時反映出代碼的低質(zhì)量。當(dāng)你覺得被迫要加注釋的時候,考慮一下是否可以重寫代碼,并使其更清晰。4.2.1實(shí)現(xiàn)注釋l 塊注釋 塊注釋通常用于提供對文件,方法,數(shù)據(jù)結(jié)構(gòu)和算法的描述。塊注釋被置于每個文件的開始處以及每個方法之前。它們也可以被用于其他地方,比如方法內(nèi)部。在功能和方法內(nèi)部的塊注釋應(yīng)該和它們所描述的代碼具有一樣的縮進(jìn)格式,并且,塊注釋之首應(yīng)該有一個空白行,用于把塊注釋和代碼分割開來。例:previousSenten

25、ces; /* * Here is a block comment. */ Sentences;l 單行注釋 單行注釋顯示在一行內(nèi),并與其后的代碼具有一樣的縮進(jìn)層次。如果一個注釋不能在一行內(nèi)寫完,應(yīng)采用塊注釋,且單行注釋之前應(yīng)該有一個空白行。 例: if (condition) /* Handle the condition. */ . l 尾端注釋 尾端注釋與它們所要描述的代碼位于同一行,但是應(yīng)該有足夠的空白來分開代碼和注釋。若有多個尾端注釋出現(xiàn)于大段代碼中,它們應(yīng)該具有相同的縮進(jìn)。 例: if (condition) return TRUE; /* special case */ else

26、 return isPrime(a); /* works only for odd a */ l 行末注釋 行末注釋的界定符是"/",它可以注釋掉整行或者一行中的一部分,一般不用于連續(xù)多行的注釋文本。但是,它可以用來注釋掉連續(xù)多行的代碼段。 例: if (condition) / Do a double-flip. Sentence;. else return false; / Explain why here. /if (condition) / /Do a triple-flip. / Sentence; / /else / return false; /4.2.2文檔

27、注釋 置于/*.*/之中的注釋稱之為文檔注釋。 文檔注釋用來描述Java的類、接口、構(gòu)造器、方法以及字段(field),一個注釋對應(yīng)一個類、接口或成員,該注釋應(yīng)位于聲明之前,與被聲明的對象有著相同的縮進(jìn)層次。 在類的聲明中,各種類、接口、變量、常量、方法之前都應(yīng)該有相應(yīng)注釋。關(guān)于文檔注釋中的各種target的使用,請參考附錄2關(guān)于JavaDoc。 例: /* * The Example class provides. */ public class Example /* * this is variant A */ int virantA = 0; /* * This is method A

28、*param parameterA The parameter A *return return an Integer */ public int methodA(parameterA) . ; 4.3聲明4.3.1變量的聲明l 一行只聲明一個變量 例: int variantA = 0, variantB = 0; 應(yīng)改為: int variantA = 0; int variantB = 0;l 聲明變量時要對其進(jìn)行初始化,如果是類中的變量,聲明時不初始化,在構(gòu)造函數(shù)中一定要初始化 例: int variantA; 應(yīng)改為: int variantA = 0;l 臨時變量放在其作用域內(nèi)聲明

29、 例: int tempA = 0; if (condition) tempA = methodA(); methodB(tempA); 應(yīng)改為: if (condition) int tempA = 0; tempA = methodA(); methodB(tempA); l 聲明應(yīng)集中放在作用域的頂端 例: if (condition) int tempA = 0; tempA = methodA(); int tempB = 0; tempB = methodB(); 應(yīng)改為: if (condition) int tempA = 0; int tempB = 0; tempA = m

30、ethodA(); tempB = methodB(); l 避免聲明的局部變量覆蓋上一級聲明的變量 例: int counter = 0; if (condition) int counter = 0; counter = methodA(); 應(yīng)改為: int counter = 0; if (condition) int counterTemp = 0; counterTemp = methodA(); 4.3.2類和接口的聲明當(dāng)編寫類和接口時,應(yīng)該遵守以下規(guī)則:l 在方法名與其參數(shù)列表之前的左括號"("間不要有空格l 左大括號""位于聲明語句同行

31、的末尾,并與末尾之間留有一個空格l 右大括號""另起一行,與相應(yīng)的聲明語句對齊。如果是一個空語句,""應(yīng)緊跟在""之后l 方法與方法之間以空白行分隔 例: public class Sample extends Object private int ivar1; private int ivar2; public Sample(int i, int j) ivar1 = i; ivar2 = j; public int emptyMethod() 4.4語句4.4.1簡單語句l 每行至多包含一條完整語句 例: variantA+; v

32、ariantB+; 應(yīng)改為: variantA+; variantB+;l 在沒有必要的情況下,不要在return語句中使用括號 例: return (0); 應(yīng)改成: return 0;4.4.2復(fù)合語句 復(fù)合語句是包含在大括號中的語句序列,形如" 語句 ",其編碼應(yīng)有如下基本規(guī)則:l 被括其中的語句應(yīng)該比復(fù)合語句縮進(jìn)一個層次l 左大括號""應(yīng)位于復(fù)合語句起始行的行尾,并且空一個空格,右大括號""應(yīng)另起一行并與復(fù)合語句首行對齊l 復(fù)合語句即使只有一個語句,也要有大括號作為界定l 每行至多包含一條完整語句1. 判斷語句 例: if-e

33、lse語句應(yīng)該具有如下格式: if (condition) Sentences; if (condition) Sentences; else if (condition) Sentences; else Sentences; 2. 選擇語句 在選擇語句中應(yīng)添加 default情況,防止不可預(yù)知的情況發(fā)生。 當(dāng)一個case在沒有break語句的情況下,它將順著往下執(zhí)行。應(yīng)在break語句的位置添加注釋。下面就含注釋/* falls through */ 例: switch (condition) case ABC: Sentences; /* falls through */ case DEF

34、: Sentences; break; case XYZ: Sentences; break; default: Sentences; break; 3. 循環(huán)語句l 在for語句的初始化或更新子句中,如果存在多項(xiàng),各項(xiàng)間應(yīng)用逗號隔開。同時,應(yīng)避免使用三個以上子句,從而導(dǎo)致復(fù)雜度提高;若確實(shí)需要,可以在for循環(huán)之前放置初始化子句或在for循環(huán)末尾放置更新子句。 例: for (int i = 0, j = 10, k = 10, m = 50; i < j + k + m; i+, j-, k-, m-) Sentences; 應(yīng)改為: int i = 0; int j = 100;

35、int k = 1000; int m = 500; for (; i < j + k + m ;) Sentences; i+; j-; k-; m-; l 一個空的for語句和while語句只用一行 例: for (initialization; condition; update) Sentences; for (initialization; condition; update); while (condition) Sentences; while (condition); do Sentences; while (condition);do ; while (conditio

36、n);4. Try-Catch結(jié)構(gòu)語句 例: try Sentences; catch (ExceptionClass e) Sentences; try Sentences; catch (ExceptionClass e) Sentences; finally Sentences;5.典型示例1) 方法的返回值表達(dá)應(yīng)盡量簡單。在return語句后一般不使用括號,但是如果返回中包含復(fù)雜表達(dá)式,則要使用括號。 例: return (x >= 0) ? x : y);2) 比較對象用equals() 方法代替操作符“=”。特別是不能用“=”去比較字符串類型的變量。 例: String st

37、rA = ”abc”; String strB = ”bcd”; if (strA = strB) 應(yīng)改為: String strA = ”abc”; String strB = ”bcd”; if (strA.equals(strB) 3) if、while等語句中的條件判斷部分,應(yīng)將常量(如果有)寫在“=”運(yùn)算符的左邊,而把變量寫在右邊。 例: if (3 = var) while (3 = var ) 4) 在每一個package中包含一個package.html文件用于對包的簡要說明。該文件結(jié)構(gòu)請參考鏈接:6.附錄附1完整示例/* * (#)Sample.java 1.00 2003/

38、04/15 * * Copyright (c) Fujitsu co, Ltd. */package com.fujitsu.fnst;import java.io.File;import java.util.Date;/* * Sample class description goes here * version1.00 15 April 2003 * authorYour name */public class Sample /* * classVar1 documentation comment */public static int classVar1 = 0; /* * class

39、Var2 documentation comment that happens to be * more than one line long */ private static final String ERROR_INFO = “This is an error message.” /* * GET method for classVar1 */ public int getClassVar1() return classVar1; /* * SET method for classVar1 */ public void setClassVar1(int var) classVar1 =

40、var; /* * Constructor Sample documentation comment */ public Sample() try doSomething(); catch (Exception e) /* * clone method for this class */ public Object clone() /* * Method doSomething documentation comment */ public void doSomething() for (int i = 0; i < 10; i+) classVar1 += i; /* * toStri

41、ng method for this class */ public String toString() /* * The main method for simple test or demo use */ public static void main(String args) 附2關(guān)于JavaDoc常用的JavaDoc標(biāo)記 JavaDoc標(biāo)記是插入文檔注釋中的特殊標(biāo)記。JavaDoc 標(biāo)記由“”、標(biāo)記、專用注釋引用組成。 JavaDoc主要有以下標(biāo)記: * author (用于類和接口,標(biāo)明開發(fā)該類模塊或接口的作者) * version (用于類和接口,標(biāo)明該模塊的版本) * param

42、 (用于方法和構(gòu)造函數(shù),說明方法中的某個參數(shù)) * return (用于方法,說明方法的返回值) * exception (用于方法,說明方法可能拋出的異常,同throws) * see (對類、屬性、方法的說明,參考轉(zhuǎn)向,也就是相關(guān)主題) * since (說明引進(jìn)該類、方法或?qū)傩缘钠鹗及姹荆?* deprecated (說明某類或方法不被推薦使用,以及相應(yīng)的替代類或替代方法) 關(guān)于JavaDoc標(biāo)記使用的更詳細(xì)信息請參考下面鏈接: author和version author標(biāo)記用于指明類或接口的作者。在缺省情況下JavaDoc工具將其忽略,但命令行開關(guān)-author可以修改這項(xiàng)功能,使其包

43、含的信息被輸出。句法:author作者名。 author可以多次使用,以指明多個作者,生成的文檔中每個作者之間使用逗號“,”分隔。 version標(biāo)記用于指明類或接口的版本。句法:version 版本號。 例: /* * author fancy * author bird * version Version 1.00 */param、return和exception 這三個標(biāo)記都是用于方法說明。 param標(biāo)記用于描述方法的參數(shù)。 句法:param參數(shù)名 參數(shù)的描述。每一個param只能描述方法的一個參數(shù),所以,如果方法需要多個參數(shù),就需要多次使用param來描述。 return標(biāo)記用于描述

44、方法的返回值。 句法:return返回值描述。一個方法中只能用一個return。 exception標(biāo)記用于說明方法可能拋出的異常,同throws。 句法:exception 異常類 拋出異常的原因。一個方法可以有多個exception標(biāo)記。 例: /* * param param1 description of param1 * param param2 description of param2 * return true or false * exception java.lang.Exception throw when switch is 1 * exception NullPointerException throw when parameter is null */see 該標(biāo)記用于參考轉(zhuǎn)向。句法: see 類名 see #方法名或?qū)傩悦?see 類名#方法名或?qū)傩悦?see <a href=”HTML鏈接”>HTML鏈接字</a> 關(guān)于類名,如果JAVA源文件

溫馨提示

  • 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

最新文檔

評論

0/150

提交評論