j2ee項(xiàng)目代碼規(guī)范文檔-wenkub.com
2025-04-13 05:38 本頁面
【正文】 。 。變量名應(yīng)該緊湊而有意義。()。在同一源文件的兩個(gè)代碼片斷之間，或者在同一源文件的類與接口的定義之間可以插入兩行空白行；在下面的情形下需要插入一行空白行；在兩個(gè)方法之間；在方法內(nèi)部的本地變量與第一個(gè)語句之間；在塊注釋與單行注釋之前；在方法內(nèi)部的邏輯片斷之間。一元操作符如“！”、“”、“”、“”、“”等前后不加空格?！?，”之后要留空格。象、等關(guān)鍵字之后應(yīng)留一個(gè)空格再跟左括號“（”，以突出關(guān)鍵字。 } {。 }結(jié)構(gòu)異常處理結(jié)構(gòu)異常處理其結(jié)構(gòu)比結(jié)構(gòu)多了一個(gè)子句，其真正意圖在于無論中是否發(fā)生了異常，最終程序都要執(zhí)行子句中的代碼塊，這在某些應(yīng)用場合時(shí)非常關(guān)鍵、重要的。 } ()。 }……循環(huán)語句循環(huán)是經(jīng)常被采用的一種循環(huán)方式，其標(biāo)準(zhǔn)語句書寫格式如下所示： () {。循環(huán)語句循環(huán)語句按照其語法特點(diǎn)又可以分為：循環(huán)語句、循環(huán)語句與循環(huán)語句。:。 :。濫驂膽閉驟羥闈詔寢賻減棲綜。}… () {。分支語句分支語句又可分為：(或 )語句與語句。 ” ”。書寫規(guī)則是在同一代碼行只能有一個(gè)單行計(jì)算、賦值語句，不能出現(xiàn)多個(gè)。 ){…}……避免低層聲明與高層聲明重復(fù)，這樣會(huì)引起代碼混亂并可能引發(fā)程序功能錯(cuò)誤，而且這種錯(cuò)誤不易被發(fā)現(xiàn)排除：…… 。…… (){ 。這是程序設(shè)計(jì)中的一個(gè)重要的編程規(guī)則。 ()*（行注釋）時(shí)間類型轉(zhuǎn)換*} }變量的聲明初始化與放置變量聲明變量的聲明在一般情況下要求每一行代碼，只聲明一個(gè)變量，如下所示：***部門級別* 。 ()。 。 }注釋規(guī)則注釋是對代碼的“提示”，而不是文檔；如果代碼本來就是清楚的，則不必加注釋；邊寫代碼邊加注釋，修改代碼同時(shí)修改相應(yīng)的注釋，以保證注釋與代碼的一致性。 。氬嚕躑竄貿(mào)懇彈瀘頷澩紛釓鄧。例如：** * 實(shí)現(xiàn)舉報(bào)信息查詢?nèi)啃畔⒐δ? * 舉報(bào)投訴 * 權(quán)限 * 查詢后的信息 * ( ){閿擻輳嬪諫遷擇楨秘騖輛塤鵜。例如：** * 獲得備注 * 備注 * () { ?！?( ){*做相應(yīng)處理*…} { 。例如：鯊腎鑰詘褳鉀溈懼統(tǒng)庫搖飭緡。恥諤銪滅縈歡煬鞏鶩錦聰櫻鄶。凍鈹鋨勞臘鍇癇婦脛糴鈹賄鶚。方法內(nèi)塊注釋位于方法體內(nèi)的塊注釋應(yīng)該與其所描述的代碼位于同一個(gè)層次上。堯側(cè)閆繭絳闕絢勵(lì)蜆贅瀝紕縭。輒嶧陽檉籪癤網(wǎng)儂號澩蠐鑭釃。嚴(yán)格意義上說一份代碼應(yīng)該有的注釋內(nèi)容，我們要求一份代碼有不少與的注釋量。 , , ) { ...}以上兩個(gè)方法的折行都是可以接受的，但是第二種折行風(fēng)格更美觀一些。這樣做的好處是能使程序的結(jié)構(gòu)更清楚，更容易被人理解。, )。如果上面的法則另代碼行右側(cè)距頁邊的距離，差距較大并且混亂，我們可以在適當(dāng)行采用鍵（空格鍵）處理。因此，我們應(yīng)盡量避免超過個(gè)字符長度的代碼行。四個(gè)空格鍵相當(dāng)于半個(gè)鍵。這樣做的目的是為了使代碼具有更強(qiáng)的可讀性與易解性析構(gòu)器（）()方法其實(shí)程序設(shè)計(jì)中，本來沒有析構(gòu)器的概念，我們這里只是形象稱()方法為析構(gòu)器。 。在這之后就是我們引用系統(tǒng)核心包或第三方包的描述部分。一般有如下規(guī)則：籟叢媽羥為贍僨蟶練淨(jìng)櫧撻曉。包的聲明與引用我們在做開發(fā)時(shí)常會(huì)引用（）核心類或者第三方軟件廠商的類，一般情況下，這些類都是封裝在一個(gè)包（）里面的，包概念的出現(xiàn)，使類（）有了名稱空間的細(xì)致劃分，使龐大復(fù)雜的類群有了較為清晰的分支，形成了清晰脈絡(luò)。使用格式空格類名（不能帶） 版本號 作者 自從（標(biāo)識類從什么版本開始使用比如：版本新增類，可以使用這個(gè)注釋進(jìn)行說明） 開發(fā)日期*繼承，實(shí)現(xiàn)接口，被繼承，會(huì)自動(dòng)生成下面就是一個(gè)類文件注釋頭：****************************************************************謀蕎摶篋飆鐸懟類蔣薔點(diǎn)鉍雜。表 后綴名的意義文件類型后綴名源文件字節(jié)碼文件一般說來源文件的結(jié)構(gòu)是這樣的，每一節(jié)代碼之間是由一個(gè)空行分割開的，并且每一節(jié)都有
公司管理相關(guān)推薦
鄂ICP備17016276號-1