【導(dǎo)讀】第2頁(yè)共22頁(yè)。第3頁(yè)共22頁(yè)。Begin…

　　

【正文】 。= 。 try { do some code } finally 。 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 14 頁(yè) 共 22 頁(yè) 軟件部項(xiàng)目管理 項(xiàng)目開(kāi)發(fā)規(guī)范 :代碼編寫要求 。 end。 一個(gè)更安全更合適的分配過(guò)程應(yīng)是： SomeClass1 := 。 try SomeClass2 := 。 try { do some code } finally 。 end。 finally 。 end。 try… except的使用 只有當(dāng)在異常被觸發(fā)而你想執(zhí)行一些任務(wù)時(shí)才使用 try? except。通常，你沒(méi)有必要為了只是簡(jiǎn)單地在屏幕上顯示一個(gè)錯(cuò)誤信息而使用 try? except語(yǔ)句，因?yàn)檫@會(huì)被 Application 對(duì)象自動(dòng)執(zhí)行。如果你想在 except 子句中執(zhí)行完一些任務(wù)之后調(diào)用缺省的異常處理，使用 raise來(lái)重新觸發(fā)異常到下一個(gè)句柄。 try… except… else的使用 try? except中的 else子句不建議使用，因?yàn)樗鼤?huì)打斷所有的異常包括那些你沒(méi)有準(zhǔn)備的異常。 類類型 命名和格式 類類型的名稱應(yīng)符合使用它們的目的。類型名字應(yīng)加以前綴 T以表明這是一個(gè)類型的定義 － 例如： type Tcustomer = class(TObject) 類型的實(shí)例通常是沒(méi)有前綴 T的類型的名字 － 例如： var Customer :Tcustomer。 注意：查閱“構(gòu)件類型的命名標(biāo)準(zhǔn)”來(lái)獲得更多有關(guān)構(gòu)件命名的信息。 域 命名 /格式 類的域名遵循與變量標(biāo)識(shí)符同樣的約定除了它們應(yīng)以 F為前綴，來(lái)表明這是一個(gè)域的名稱。 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 15 頁(yè) 共 22 頁(yè) 軟件部項(xiàng)目管理 項(xiàng)目開(kāi)發(fā)規(guī)范 :代碼編寫要求 可視化 所有的域都必需是私有的。想在類的范圍之外存取域得通過(guò)屬性來(lái)使用。 方法 命名 /格式 方法的命名應(yīng)遵循本文檔中有關(guān)過(guò)程和函數(shù)的約定敘述。 使用靜態(tài)的方法 如果使用一個(gè)靜態(tài)的方法，那么該方法就不能被該類的后代類所繼承。 使用虛擬 /動(dòng)態(tài)的方法 如果你打算該類的方法能被后代的類所繼承就得使用虛擬的方法。只有在該方法有多 個(gè)繼承時(shí)（直接的或間接的）才使用動(dòng)態(tài)的方法。例如，一個(gè)類類型包含一個(gè)可繼承的方法，而 100個(gè)后代類要繼承這種方法，那么這個(gè)方法就會(huì)動(dòng)態(tài)地產(chǎn)生為 100個(gè)后代類使用的內(nèi)存。 使用抽象的方法 如果在一個(gè)類中使用抽象的方法，該類就不能被創(chuàng)建。只有在那些永遠(yuǎn)不會(huì)被創(chuàng)建的類中使用抽象的方法。 屬性存取方法 所有存取類的方法都只能出現(xiàn)在類的 private或 protected部分。屬性存取方法的命名應(yīng)遵循過(guò)程和函數(shù)的約定規(guī)則。讀取存取方法（方法讀取器）必需以單詞 Get為前綴。寫入存取方法（方法寫入器）必需以單詞 Set為前綴 。方法寫入器的參數(shù)的名字應(yīng)為 Value，并且它的類型應(yīng)是它所操作的屬性的類型。例如： TSomeClass = class(TObject) private FsomeField : Integer。 protected function GetSomeField : Integer。 procedure SetSomeField(Value : Integer)。 public property SomeField : Integer read GetSomeField write SetSomeField。 end。 屬性 命名 /格式 屬性如果是表示為一個(gè)私有域的存取器的話，那么它的名字應(yīng)是它們所操作的域的名字除去解釋符 F。 屬性的名字應(yīng)是名詞，不是動(dòng)詞。屬性表示的是數(shù)據(jù)，而方法表示的是行為。 數(shù)組類型的名稱應(yīng)為復(fù)數(shù)。一般情況下屬性的名稱應(yīng)為單數(shù)。 使用存取的方法 盡管沒(méi)有要求，但還是建議盡量少地為一個(gè)表示私有域的屬性而使用寫入存取方法。 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 16 頁(yè) 共 22 頁(yè) 軟件部項(xiàng)目管理 項(xiàng)目開(kāi)發(fā)規(guī)范 :代碼編寫要求 文件 工程文件 工程文件應(yīng)取個(gè)描述性的名字。例如， Delphi 4開(kāi)發(fā)者指南錯(cuò)誤管理器 的工程名字是：。一個(gè)有關(guān) 系統(tǒng)信息的程序的名字就應(yīng)象 。 窗體文件 一個(gè)窗體文件的取名應(yīng)可以描述使用該窗體的目的，并加以后綴 Frm。例如，一個(gè)“關(guān)于”的窗體的文件名應(yīng)是 。主窗體的文件名應(yīng)是 。 數(shù)據(jù)模板文件 數(shù)據(jù)模板的取名應(yīng)能表示使用該數(shù)據(jù)模板的目的，它的名稱應(yīng)加以兩個(gè)字符的后綴 DM。例如，自定義數(shù)據(jù)模板的文件名字應(yīng)為 。 遠(yuǎn)端數(shù)據(jù)模板文件 遠(yuǎn)端數(shù)據(jù)模板的取名應(yīng)能表示使用該遠(yuǎn)端數(shù)據(jù)模板的目的，它的名稱應(yīng)加以三個(gè)字符的后綴 RDM。例如，自定義 遠(yuǎn)端數(shù)據(jù)模板的文件名字應(yīng)為 。 Unit文件 通用 Unit結(jié)構(gòu) unit的名字 Unit 文件應(yīng)取一個(gè)可描述性的名字。例如，包含應(yīng)用程序主窗體的單元應(yīng)叫做。 uses子句 在 interface 部分的 uses 子句應(yīng)包含在 interface 部分中的代碼所需要的單元。去掉那些Delphi可以自動(dòng)加入到程序中的單元。 在 implementation 部分的 uses 子句應(yīng)只包含在 implementation 部分中的代碼所需要的單元的名字。去掉不必要的單元。 interface部分 interface部分應(yīng)包含只那些其它單元所需要存取類型的定義、變量、過(guò)程 /函數(shù)的預(yù)定義等等。否則，就應(yīng)放在 implementation部分定義。 implementation部分 implementation部分應(yīng)包含那些只在本單元中私用的類型定義、變量、過(guò)程 /函數(shù)定義等等。 initialization部分 不要在 initialization 部分放入耗時(shí)長(zhǎng)的代碼，這將使程序的第一個(gè)界面出現(xiàn)得比較緩慢。 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 17 頁(yè) 共 22 頁(yè) 軟件部項(xiàng)目管理 項(xiàng)目開(kāi)發(fā)規(guī)范 :代碼編寫要求 finalization部分 在這里要保證釋放你在 Initialization部分所分配 的任何資源。 窗體單元 一個(gè)窗體的單元文件應(yīng)擁有與它所對(duì)應(yīng)的窗體文件同樣的名稱。例如，“關(guān)于”窗體的單元名稱應(yīng)為 ，而主窗體的單元名稱應(yīng)為 。 數(shù)據(jù)模板單元 一個(gè)數(shù)據(jù)模板的單元文件應(yīng)擁有與它所對(duì)應(yīng)的數(shù)據(jù)模板文件同樣的名稱。例如，一個(gè)自定義數(shù)據(jù)模板單元的名稱應(yīng)為 。 一般目的單元 一般目的單元的取名應(yīng)符合使用該單元的目的。例如，一個(gè)實(shí)用程序單元取名為。一個(gè)包含全局變量的單元取名為 。 注意，該單元的名字不能與它的工程中所使用的所有包中的單元的名字相同。不贊成使用一般的或通用的單元名字。 構(gòu)件單元 構(gòu)件單元應(yīng)放在獨(dú)立的目錄，以將它們同定義構(gòu)件組或構(gòu)件集合的單元區(qū)分開(kāi)來(lái)。它們要永遠(yuǎn)同工程在不同的目錄。單元名字應(yīng)同它們的內(nèi)容相符。注意：查閱“用戶定義的構(gòu)件”部分來(lái)獲得更多有關(guān)構(gòu)件命名標(biāo)準(zhǔn)的信息。 窗體和數(shù)據(jù)模板 窗體 窗體類型命名標(biāo)準(zhǔn) 窗體類型的取名應(yīng)能表達(dá)使用該窗體的目的。類型定義應(yīng)加以前綴 T。前綴后面跟隨著描述性的名字。最后，應(yīng)加以 Form 后綴來(lái)描述名字。例如，一個(gè)“關(guān)于”的 窗體的類型的名字應(yīng)為： TAboutFrom = class(TForm)。 主窗體的定義為： TMainForm = class(TForm)。 一個(gè)用戶接入窗體的名字應(yīng)象： TCustomerEntryForm = class(TForm)。 窗體實(shí)例命名標(biāo)準(zhǔn) 窗體實(shí)例應(yīng)是沒(méi)有帶前綴 T的相應(yīng)類的名字。例如，對(duì)應(yīng)于前面窗體類型而言，其實(shí)例的名字應(yīng)為： 類型名稱 實(shí)例名稱 TAboutForm AboutForm 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 18 頁(yè) 共 22 頁(yè) 軟件部項(xiàng)目管理 項(xiàng)目開(kāi)發(fā)規(guī)范 :代碼編寫要求 TMainForm MainForm TCustomerEntryForm CustomerEntryForm 自動(dòng)創(chuàng)建窗體 只有主窗體可以是自動(dòng)創(chuàng)建的除非有其它更好的理由不這樣做。所有其它的窗體必需從工程選項(xiàng)對(duì)話框中的自動(dòng)創(chuàng)建列表中移走。查閱以下部分來(lái)獲得更多的信息。 模式窗體實(shí)例化函數(shù) 所有的窗體單元都應(yīng)包含一個(gè)窗體實(shí)例化函數(shù)，該函數(shù)用來(lái)創(chuàng)建、設(shè)置、模式地顯示窗體，并釋放窗體。該函數(shù)應(yīng)返回窗體的模式結(jié)果。該函數(shù)要傳遞的參數(shù)應(yīng)遵循本文檔指定的“參數(shù)傳遞”標(biāo)準(zhǔn)。通過(guò)這種方式封裝的函數(shù) 性有助于代碼的再利用和維護(hù)。 該窗體的變量要從單元中移走，并再窗體實(shí)例的函數(shù)中進(jìn)行本地式地定義。注意，這就意味著該窗體必需從工程 /選項(xiàng)對(duì)話框中的自動(dòng)創(chuàng)建列表中剔除。參考本文檔后面的“自動(dòng)創(chuàng)建窗體”。 例如，下面的單元展示了再 GetUserData窗體中的一個(gè)函數(shù)。 unit UserDataFrm。 interface uses windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs, StdCtrls。 type TUserDataForm = class(TForm) edtUserName : TEdit。 edtUserID : TEdit。 private { Private declarations } public { Public declarations } end。 function GetUserData(var aUserName ： String。 var aUserID : Integer) : Word。 implementation {$R *.DFM } function GetUserData(var aUserName : String。 var aUserID : Integer) : word。 var UserDataForm : TuserDataForm。 begin UserDataForm := (Application)。 try := ‘Getting User Data’。 Result := 。 if (Result = mrOK) then 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 19 頁(yè) 共 22 頁(yè) 軟件部項(xiàng)目管理 項(xiàng)目開(kāi)發(fā)規(guī)范 :代碼編寫要求 begin aUserName := 。 aUserID := StrToInt()。 end。 finally 。 end。 end。 end. 數(shù)據(jù)模板 數(shù)據(jù)模板命名標(biāo)準(zhǔn) 數(shù)據(jù)模板的取名要符合使用該數(shù)據(jù)模板的目的。類型的定義應(yīng)加以前綴 T，后面緊接著描述性的名字，最后要加以后綴單詞“ DataModule”。例如，一個(gè)自定義的數(shù)據(jù)模板有時(shí)候應(yīng)該象： TCustomerDataModule = class(TDataModule) 一個(gè)命令式的數(shù)據(jù)模板的名字應(yīng)象： TOrdersDataModule = class(TDataModule) 數(shù)據(jù)模板實(shí)例命名標(biāo)準(zhǔn) 數(shù)據(jù)模板實(shí)例的名稱應(yīng)是對(duì)應(yīng)不帶前綴 T的類型的 名稱。例如，對(duì)于前面的窗體類型而言，其實(shí)例的名稱應(yīng)為： 類型名稱 實(shí)例名稱 TCustomerDataModule CustomerDataModule TOrdersDataModule OrdersDataModule 包 使用運(yùn)行包和設(shè)計(jì)包的比較 運(yùn)行時(shí)刻的包應(yīng)只包含其它構(gòu)件包所要求的單元或構(gòu)件。另外，包含屬性 /構(gòu)件編輯器和其它只為設(shè)計(jì)的代碼應(yīng)放入到設(shè)計(jì)時(shí)刻包中。注冊(cè)單元應(yīng)放在設(shè)計(jì)包中。 文件命名標(biāo)準(zhǔn) 包的名稱應(yīng)依照下面的例子 ： “ ” － 設(shè)計(jì)時(shí)刻包 “ ” － 運(yùn)行時(shí)刻