1、目 錄 項(xiàng)目案例1應(yīng)用場(chǎng)景1項(xiàng)目基本需求描述2系統(tǒng)核心業(yè)務(wù)流程2原始資料3項(xiàng)目運(yùn)行環(huán)境4文檔范例5開(kāi)發(fā)文檔6項(xiàng)目任務(wù)書(shū)6項(xiàng)目進(jìn)展報(bào)告（每個(gè)階段提交一份報(bào)告）6個(gè)人變更記錄7用戶界面檢查表7軟件總體設(shè)計(jì)文檔9測(cè)試計(jì)劃14測(cè)試報(bào)告15Java編碼規(guī)范161 介紹(Introduction)162 文件名()163 文件組織()174 縮進(jìn)排版(Indentation)185 注釋(Comments)206 聲明(Declarations)237 語(yǔ)句(Statements)258 空白(White Space)289 命名規(guī)范(Naming Conventions)2910 編程慣例(Progra

2、mming Practices)3111 代碼范例(Code Examples)33項(xiàng)目案例 應(yīng)用場(chǎng)景 Sunny Sport運(yùn)動(dòng)時(shí)尚成立于1990年，是NIKE品牌在中南地區(qū)最早的經(jīng)銷商，此外，公司還經(jīng)營(yíng)世界品牌“Adidas”等。Sunny Sport運(yùn)動(dòng)時(shí)尚在中南各大型商場(chǎng)都設(shè)有專柜，主要經(jīng)營(yíng)NIKE、Adidas、Reebok、Puma、李寧、安踏等二十幾個(gè)體育品牌，是體育愛(ài)好者購(gòu)物的天堂。隨著北京2008年奧運(yùn)會(huì)的成功舉辦以及人均收入的不斷提高，中國(guó)體育產(chǎn)業(yè)面臨巨大的商機(jī)和挑戰(zhàn)。公司目前共有資產(chǎn)8000萬(wàn)。店鋪50余家，年銷售值達(dá)數(shù)億元。“提供優(yōu)質(zhì)服務(wù)，共享健康人生”的企業(yè)理念是Su

3、nny Sport對(duì)體育事業(yè)不懈追求的體現(xiàn)，Sunny Sport所有同仁將全心投入，和所有國(guó)人一起推動(dòng)全民健身運(yùn)動(dòng)。Sunny Sport運(yùn)動(dòng)時(shí)尚在未來(lái)的幾年時(shí)間內(nèi)發(fā)展目標(biāo)是在國(guó)內(nèi)建立10個(gè)以上的省級(jí)分公司，中南地區(qū)的分店數(shù)量目標(biāo)在百家左右，成為全國(guó)范圍內(nèi)的較大的運(yùn)動(dòng)品牌連鎖企業(yè)。面對(duì)這樣的發(fā)展計(jì)劃，首先是日常運(yùn)營(yíng)業(yè)務(wù)流程上必須大幅度調(diào)整，核算體系和物流體系要有本質(zhì)的變化，而且公司的管理模式和組織結(jié)構(gòu)也需要優(yōu)化重組。為此，公司高層決定開(kāi)發(fā)一套進(jìn)銷存管理系統(tǒng)，提高工作效率，更好地實(shí)行科學(xué)化的管理。該系統(tǒng)開(kāi)發(fā)過(guò)程分為幾個(gè)階段，其中第一階段的主要任務(wù)是完成商品管理、客戶管理、供應(yīng)商管理、庫(kù)存管理和

4、系統(tǒng)管理和報(bào)表生成；第二階段的主要任務(wù)是完成采購(gòu)管理、銷售管理、配送管理、賬務(wù)管理等；第三階段增加經(jīng)營(yíng)狀況分析與決策等功能，讓該系統(tǒng)具備決策支持系統(tǒng)(DSS)的功能。由于第一階段是整個(gè)系統(tǒng)的核心，作為該進(jìn)銷存系統(tǒng)的重點(diǎn)模塊，本需求主要針對(duì)第一階段開(kāi)發(fā)任務(wù)而制定。現(xiàn)計(jì)劃采用的是二層客戶端/服務(wù)器(C/S)結(jié)構(gòu)來(lái)進(jìn)行本系統(tǒng)的第一階段開(kāi)發(fā)。 二層的C/S結(jié)構(gòu)是指以單一的服務(wù)器和局域網(wǎng)為核心，能通過(guò)客戶端與用戶進(jìn)行直接交互，用于檢查用戶從鍵盤(pán)等輸入的數(shù)據(jù)，顯示應(yīng)用輸出的數(shù)據(jù)，客戶端負(fù)責(zé)用戶界面的顯示和業(yè)務(wù)的處理；服務(wù)器端主要用于數(shù)據(jù)管理，充當(dāng)數(shù)據(jù)庫(kù)服務(wù)器的角色。為使用戶能直觀地進(jìn)行操作，一般要使用圖形

5、用戶接口(GUI)，操作簡(jiǎn)單、易學(xué)易用。典型的二層C/S結(jié)構(gòu)有以下特點(diǎn)：1、服務(wù)器負(fù)責(zé)數(shù)據(jù)管理及數(shù)據(jù)存儲(chǔ)；2、客戶機(jī)負(fù)責(zé)界面描述和界面顯示；3、客戶機(jī)向服務(wù)器提出數(shù)據(jù)處理要求；4、服務(wù)器響應(yīng)將數(shù)據(jù)處理結(jié)果返回客戶機(jī)；5、使網(wǎng)絡(luò)數(shù)據(jù)流量最少。項(xiàng)目基本需求描述 n 商品類別管理：查看、增加、刪除、修改商品類別，類別分為兩級(jí)，包括主類別和次類別，參考分類：服裝à運(yùn)動(dòng)服、休閑服、籃球服、健身服、登山服、運(yùn)動(dòng)裙；鞋子à足球鞋、籃球鞋、跑步鞋、休閑鞋、登山鞋、溜冰鞋、全能鞋；。n 商品管理：根據(jù)類別查看商品資料、根據(jù)商品名稱或編號(hào)查詢商品詳細(xì)信息、根據(jù)商品品牌查看商品資料；增加、刪除、

6、修改商品資料。各商品庫(kù)存需設(shè)置上限和下限，在入庫(kù)與出庫(kù)時(shí)提供庫(kù)存警報(bào)機(jī)制，提醒操作人員該商品庫(kù)存已經(jīng)處于臨界狀態(tài)。n 供應(yīng)商管理：查看、增加、刪除、修改供應(yīng)商資料。n 入庫(kù)管理：增加、刪除、修改入庫(kù)單，生成詳細(xì)的入庫(kù)單明細(xì)；入庫(kù)單信息包括入庫(kù)單編號(hào)、入庫(kù)日期和時(shí)間、入庫(kù)人編號(hào)、供應(yīng)商編號(hào)等；同時(shí)提供入庫(kù)單明細(xì)管理，入庫(kù)單明細(xì)包括入庫(kù)單編號(hào)、商品編號(hào)、數(shù)量、折扣等信息。n 客戶管理：查看、增加、刪除、修改客戶資料。n 出庫(kù)管理：增加、刪除、修改出庫(kù)單，生成詳細(xì)的出庫(kù)單明細(xì)；出庫(kù)單信息包括出庫(kù)單編號(hào)、出庫(kù)日期和時(shí)間、出庫(kù)人編號(hào)、客戶編號(hào)等；同時(shí)提供出庫(kù)單明細(xì)管理，出庫(kù)單明細(xì)包括出庫(kù)單編號(hào)、商品編號(hào)

7、、數(shù)量、折扣等信息。n 系統(tǒng)管理：查看、增加、刪除、修改系統(tǒng)管理員。（本系統(tǒng)簡(jiǎn)化權(quán)限管理功能，系統(tǒng)管理員既可以作為入庫(kù)人，也可以作為出庫(kù)人；可增加權(quán)限管理，系統(tǒng)管理員可增加操作人員，并可授權(quán)入庫(kù)、出庫(kù)和系統(tǒng)管理等功能；如果實(shí)現(xiàn)可以作為擴(kuò)展功能。）n 報(bào)表功能：能夠生成每日庫(kù)存報(bào)表和每日財(cái)務(wù)報(bào)表。系統(tǒng)核心業(yè)務(wù)流程 n 入庫(kù)：管理員登錄后可進(jìn)行入庫(kù)操作，每次處理一個(gè)入庫(kù)單，系統(tǒng)自動(dòng)記錄入庫(kù)日期和時(shí)間、入庫(kù)人（即管理員）、系統(tǒng)自動(dòng)生成入庫(kù)單編號(hào)，入庫(kù)單記錄供應(yīng)商基本信息（供應(yīng)商編號(hào)、名稱、聯(lián)系人、聯(lián)系電話、聯(lián)系地址等），可以通過(guò)選取供應(yīng)商編號(hào)或名稱自動(dòng)從數(shù)據(jù)庫(kù)獲取這些信息，如果供應(yīng)商不存在，必須先添

8、加該供應(yīng)商信息。一個(gè)入庫(kù)單對(duì)應(yīng)多個(gè)入庫(kù)明細(xì)，每一種商品的明細(xì)包括該商品的編號(hào)、名稱、類別、單價(jià)、數(shù)量、碼洋（原始價(jià)格）、折扣和實(shí)洋（折后價(jià)格）。入庫(kù)單顯示總碼洋和實(shí)收金額。在入庫(kù)時(shí)如果商品數(shù)量超過(guò)該商品庫(kù)存上限，提供庫(kù)存報(bào)警提示，該商品入庫(kù)操作不成功。n 出庫(kù)：管理員登錄后可進(jìn)行出庫(kù)操作，每次處理一個(gè)出庫(kù)單，系統(tǒng)自動(dòng)記錄出庫(kù)日期和時(shí)間、出庫(kù)人（即管理員）、系統(tǒng)自動(dòng)生成出庫(kù)單編號(hào)，出庫(kù)單記錄客戶基本信息（客戶編號(hào)、名稱、聯(lián)系人、聯(lián)系電話、聯(lián)系地址等），可以通過(guò)選取客戶編號(hào)或名稱自動(dòng)從數(shù)據(jù)庫(kù)獲取這些信息，如果客戶不存在，必須先添加該客戶信息。一個(gè)出庫(kù)單對(duì)應(yīng)多個(gè)出庫(kù)明細(xì)，每一種商品的明細(xì)包括該商品的

9、編號(hào)、名稱、類別、單價(jià)、數(shù)量、碼洋（原始價(jià)格）、折扣和實(shí)洋（折后價(jià)格）。出庫(kù)單顯示總碼洋和實(shí)收金額。在出庫(kù)時(shí)如果商品數(shù)量低于該商品庫(kù)存下限，提供庫(kù)存報(bào)警提示，該商品出庫(kù)操作不成功。原始資料 n 入庫(kù)單：Sunny Sport運(yùn)動(dòng)時(shí)尚入庫(kù)清單入庫(kù)單編號(hào)：SSI0001日期：2008-10-11時(shí)間：14:30入庫(kù)人：張三供應(yīng)商編號(hào)：P001名稱：安踏長(zhǎng)沙公司聯(lián)系人：李四電話：手機(jī)：傳真：地址：長(zhǎng)沙雨花區(qū)郵編：410001總數(shù)量（件）：45件總碼洋：7500.00元實(shí)付金額： 4500.00元折扣額：3000元編號(hào)商品名稱類別單價(jià)數(shù)量碼洋折扣實(shí)洋SF001安踏足球鞋S001鞋子(足球鞋)200.0

10、051000.0060%600.00FC002安踏休閑褲FC002褲子(休閑褲)100.00101000.0060%600.00BB013安踏籃球服BB013服裝(籃球服)250.00102500.0060%1500.00FB089安踏足球服FB089服裝(足球服)150.00203000.0060%1800.00n 出庫(kù)單：Sunny Sport運(yùn)動(dòng)時(shí)尚出庫(kù)清單出庫(kù)單編號(hào)：SSO0001日期：2008-10-12時(shí)間：9:30出庫(kù)人：張三客戶編號(hào)：C001名稱：長(zhǎng)沙一中聯(lián)系人：王五電話：手機(jī)：傳真：地址：長(zhǎng)沙開(kāi)福區(qū)郵編：410002總數(shù)量（件）：20件總碼洋：4000.00元實(shí)收金額： 32

11、00.00元折扣額：800元編號(hào)商品名稱類別單價(jià)數(shù)量碼洋折扣實(shí)洋BB013安踏籃球服BB013服裝(籃球服)250.00102500.0080%2000.00FB089安踏足球服FB089服裝(足球服)150.00101500.0080%1200.00n 每日庫(kù)存報(bào)表：Sunny Sport運(yùn)動(dòng)時(shí)尚每日庫(kù)存報(bào)表日期：2008-10-20類別編號(hào)商品名稱原庫(kù)存日入庫(kù)日出庫(kù)現(xiàn)庫(kù)存上限下限鞋子(足球鞋)SF001安踏足球鞋S00110201020505褲子(休閑褲)FC002安踏休閑褲FC002150510505服裝(籃球服)BB013安踏籃球服BB0131010020505服裝(足球服)FB089

12、安踏足球服FB08920101020505n 每日財(cái)務(wù)報(bào)表：Sunny Sport運(yùn)動(dòng)時(shí)尚每日財(cái)務(wù)報(bào)表日期：2008-10-20總實(shí)付金額：12000.00元總實(shí)收金額：22400.00元清單編號(hào)類別總碼洋實(shí)付金額實(shí)收金額折扣額SSI0001入庫(kù)4000.002400.000.001600.00SSI0002入庫(kù)6000.003600.000.002400.00SSO0001出庫(kù)8000.000.006400.001600.00SSI0003入庫(kù)10000.006000.000.004000.00SSO0002出庫(kù)20000.000.0016000.004000.00項(xiàng)目運(yùn)行環(huán)境 服務(wù)器軟硬件

13、要求（最低配置）軟件：n Windows 2000及以上n TCP/IP協(xié)議硬件：n CPU: PIII及以上n 內(nèi)存：512M以上n 硬盤(pán)：10G以上客戶機(jī)軟硬件要求軟件：n Windows 98/ME/2000及以上n TCP/IP協(xié)議硬件：n CPU: PIII及以上n 內(nèi)存：最少128Mn 硬盤(pán)：4G以上文檔范例 n 文檔文檔是計(jì)算機(jī)編程最重要的方面之一。大多數(shù)已經(jīng)完成了程序編寫(xiě)、測(cè)試和實(shí)現(xiàn)的程序員獲得解脫般太過(guò)著急地進(jìn)入下一個(gè)項(xiàng)目。另一方面，程序用戶抱怨文檔老是不完整、不精確或者不正確。僅由程序作者調(diào)試程序的情況很少。如果程序沒(méi)有輸入/輸出要求、如何執(zhí)行程序、特定部分的代碼做什么之類

14、的詳細(xì)信息，那么其他用戶就很難進(jìn)行程序調(diào)試。因此文檔的目的就是要指導(dǎo)用戶全面了解程序以及如何正確使用它。文檔應(yīng)在哪個(gè)階段書(shū)寫(xiě)呢？大多數(shù)情況是在項(xiàng)目結(jié)束時(shí)才補(bǔ)上的。結(jié)果，文檔就是些倉(cāng)促的注解列表，再加上很少的程序運(yùn)行指導(dǎo)。這個(gè)層次所提供的信息不充分，因此項(xiàng)目間的單元測(cè)試和檢查的想法將有助于制定一份有效和有用的文檔。n 程序文檔維護(hù)計(jì)算機(jī)程序的主要原因有兩個(gè)。第一個(gè)是由于我們沒(méi)有能力寫(xiě)出完全沒(méi)有錯(cuò)誤的大型程序所產(chǎn)生的后果；也就是程序bug的定位和改正。錯(cuò)誤檢測(cè)在許多情況下是一個(gè)貫徹程序整個(gè)生命周期的過(guò)程。大多數(shù)錯(cuò)誤在正式的調(diào)試和測(cè)試過(guò)程中被發(fā)現(xiàn)和改正，然后才認(rèn)為程序完成了。第二個(gè)原因是修改現(xiàn)有程序

15、以適應(yīng)規(guī)范的改變。必須修改程序才能滿足不斷變化的用戶需求，才能對(duì)程序進(jìn)行完善。要滿足程序文檔標(biāo)準(zhǔn)，保留用指定詳細(xì)信息更新過(guò)的每個(gè)單元的注釋頁(yè)對(duì)程序員而言非常有用，這使得項(xiàng)目文檔任務(wù)變得非常容易。n 項(xiàng)目文檔文檔是團(tuán)隊(duì)工作的一個(gè)重要方面。對(duì)于將可重用性作為首要益處的面向?qū)ο蠓椒ǘ愿侨绱恕?chuàng)建者對(duì)一個(gè)通用類所作的任何修改應(yīng)該立即寫(xiě)入文檔，這樣該類的用戶就能注意到。應(yīng)對(duì)文檔進(jìn)行更好的文字處理和適當(dāng)歸檔。文檔結(jié)構(gòu)應(yīng)該包括：n 封面頁(yè)，應(yīng)具有項(xiàng)目名稱、項(xiàng)目小組成員名字及他們的批號(hào)和注冊(cè)號(hào)、提交日期、總頁(yè)數(shù)（每頁(yè)文檔都要有頁(yè)碼）。n 問(wèn)題陳述的簡(jiǎn)要描述。n 分析和設(shè)計(jì)，這需要E/R圖、類定義和具有意義

16、字段名的表結(jié)構(gòu)。n 用于測(cè)試的樣本數(shù)據(jù)和程序清單。所有這些信息以及新的程序描述和任何有益于程序理解的其它注釋都應(yīng)整理并添加到文檔文件中，這樣就能對(duì)接管該程序或項(xiàng)目且必須重新理解其工作機(jī)制的其他人提供幫助。n 參見(jiàn)文檔范例開(kāi)發(fā)文檔 項(xiàng)目任務(wù)書(shū) Sunny Sport庫(kù)存管理系統(tǒng)項(xiàng)目的任務(wù)進(jìn)度計(jì)劃任務(wù)名稱工作人員工作時(shí)間任務(wù)描述需求分析開(kāi)發(fā)組2009年2月10日-2009年2月16日根據(jù)用戶提出的需求，制訂比較詳細(xì)的需求分析報(bào)告文檔系統(tǒng)設(shè)計(jì)開(kāi)發(fā)組2009年2月17日-2009年3月15日項(xiàng)目進(jìn)展報(bào)告（每個(gè)階段提交一份報(bào)告） 項(xiàng)目進(jìn)展報(bào)告項(xiàng)目名稱Sunny Sport庫(kù)存管理系統(tǒng)項(xiàng)目組長(zhǎng)報(bào)告名稱需求

17、分析報(bào)告項(xiàng)目所處階段需求分析階段時(shí)間段2009年2月10日-2009年2月16日工作總結(jié)經(jīng)過(guò)項(xiàng)目組的詳細(xì)分析和討論，確定主要功能需求如下：管理員登錄商品類別管理商品管理入庫(kù)管理出庫(kù)管理供應(yīng)商管理客戶管理系統(tǒng)管理報(bào)表功能問(wèn)題與對(duì)策1. 問(wèn)題： 庫(kù)存報(bào)警提示 對(duì)策：在系統(tǒng)中增加庫(kù)存檢查程序。 原因：個(gè)人變更記錄 個(gè)人變更記錄所屬項(xiàng)目Sunny Sport庫(kù)存管理系統(tǒng)變更標(biāo)題變更內(nèi)容說(shuō)明變更內(nèi)容以及相關(guān)技術(shù)。執(zhí)行人日期用戶界面檢查表 用戶界面檢查表設(shè)計(jì)要素重要性檢查項(xiàng)適合于檢查結(jié)果合適性非常重要用戶界面是否與軟件的功能相融洽？用戶界面是否適合于用戶的應(yīng)用環(huán)境？解釋：如果否定的話，意味著用戶不能有效地

18、使用這個(gè)軟件，是不可原諒的缺陷。這個(gè)缺陷是需求分析錯(cuò)誤造成的。評(píng)審測(cè)試容易理解非常重要（1）界面元素有錯(cuò)別字，或者措詞含糊、邏輯混亂。（2）消息框的提示文字和按鈕在語(yǔ)義上不連貫。（3）確認(rèn)消息框、告警消息框、通知消息框、過(guò)程消息框的風(fēng)格混淆在一起。解釋：如果出現(xiàn)如此低級(jí)的缺陷，說(shuō)明開(kāi)發(fā)人員根本沒(méi)有把用戶界面放在心上，用戶很反感這種不敬業(yè)的態(tài)度。是不可原諒的缺陷。評(píng)審測(cè)試重要（1） 對(duì)于常用的功能，用戶能否不必閱讀手冊(cè)就能使用嗎？（2） 是否所有界面元素提供了充分而必要的提示？（3） 界面結(jié)構(gòu)和工作流程匹配嗎？（4） 提供聯(lián)機(jī)幫助嗎？解釋：如果實(shí)現(xiàn)上述要求，說(shuō)明界面的細(xì)節(jié)做得很好。評(píng)審測(cè)試及時(shí)反

19、饋信息重要（1） 是否提供進(jìn)度條、動(dòng)畫(huà)等反映正在進(jìn)行的比較耗時(shí)間的過(guò)程？（2） 是否為重要的操作返回必要的結(jié)果信息？解釋：如果否定的話，說(shuō)明用戶界面不夠?qū)I(yè)。測(cè)試防錯(cuò)處理非常重要（1） 執(zhí)行破壞性的操作之前，是否獲得用戶的確認(rèn)？（2） 輸入數(shù)據(jù)或者遞交數(shù)據(jù)時(shí)，是否進(jìn)行相應(yīng)的數(shù)據(jù)校驗(yàn)（檢查數(shù)據(jù)是否合法）（3） 是否根據(jù)用戶的權(quán)限自動(dòng)隱藏或者禁用某些功能？解釋：如果否定的話，說(shuō)明開(kāi)發(fā)人員沒(méi)有防錯(cuò)處理的常識(shí)，是不可原諒的缺陷。測(cè)試可選是否提供Undo功能用以撤銷不期望的操作？解釋：如果實(shí)現(xiàn)該要求，說(shuō)明界面的細(xì)節(jié)做得很好。測(cè)試一致性重要（1） 同類的界面元素是否有相同的視感和相同的操作方式？（2） 是

20、否符合廣大用戶使用同類軟件的習(xí)慣？解釋：如果否定的話，說(shuō)明用戶界面不夠?qū)I(yè)。評(píng)審測(cè)試個(gè)性化可選是否在具備必要的“一致性”的前提下，設(shè)計(jì)了與眾不同的、讓用戶記憶深刻的界面？解釋：如果實(shí)現(xiàn)該要求，說(shuō)明界面很有創(chuàng)意。評(píng)審測(cè)試合理布局可選（1） 界面的布局符合軟件的功能邏輯嗎？（2） 界面元素是否在水平或者垂直方向?qū)R？（3） 界面元素的尺寸是否合理？行、列的間距是否保持一致？（4） 是否恰當(dāng)?shù)乩么绑w和控件的空白，以及分割線條？（5） 窗口切換、移動(dòng)、改變大小時(shí)，界面正常嗎？解釋：如果否定的話，說(shuō)明用戶界面不夠?qū)I(yè)。評(píng)審測(cè)試合理色彩重要（1） 界面的色調(diào)是否讓人感到和諧、滿意？（2） 重要的對(duì)象是否

21、用醒目的色彩表示？（3） 色彩使用是否符合行業(yè)的習(xí)慣？（4） 是否可以讓色盲、色弱人員使用？解釋：如果實(shí)現(xiàn)該要求，說(shuō)明界面細(xì)節(jié)很好。評(píng)審測(cè)試適應(yīng)用戶群體可選（1） 初學(xué)者和專家都有合適的方式操作這個(gè)界面嗎？（2） 色盲或者色弱的用戶能正常使用該界面嗎？解釋：如果實(shí)現(xiàn)該要求，說(shuō)明界面細(xì)節(jié)很好。測(cè)試國(guó)際化重要（1） 度量單位、日期格式、人的名字等是否讓用戶誤解？（2） 翻譯文字是否地道，是否符合讀者習(xí)慣？評(píng)審測(cè)試最少步驟最高效率重要是否用合理的最少步驟實(shí)現(xiàn)常用的操作，獲得高效率？解釋：如果實(shí)現(xiàn)該要求，說(shuō)明界面細(xì)節(jié)很好。測(cè)試可復(fù)用重要用戶界面的原型、代碼、文檔是否可以被復(fù)用？解釋：如果實(shí)現(xiàn)該要求，說(shuō)

22、明軟件的需求分析、設(shè)計(jì)、實(shí)現(xiàn)做得很好。開(kāi)發(fā)團(tuán)隊(duì)內(nèi)部評(píng)估軟件總體設(shè)計(jì)文檔 0. 文檔介紹0.1 文檔目的與范圍編寫(xiě)該文檔的目的在于明確Sunny Sport庫(kù)存管理系統(tǒng)的用戶需求，使得軟件開(kāi)發(fā)人員與用戶對(duì)待開(kāi)發(fā)軟件的需求有統(tǒng)一的、無(wú)二義性的認(rèn)識(shí)。該文檔所描述的內(nèi)容，可作為軟件確認(rèn)測(cè)試的依據(jù)。該文檔的讀者為用戶代表、軟件分析人員、開(kāi)發(fā)管理人員和測(cè)試人員。0.2 讀者對(duì)象閱讀對(duì)象：一般大眾0.3 參考文獻(xiàn)提示：列出本文檔的所有參考文獻(xiàn)（可以是非正式出版物），格式如下：標(biāo)識(shí)符 作者，文獻(xiàn)名稱，出版單位（或歸屬單位），日期0.4 術(shù)語(yǔ)與縮寫(xiě)解釋縮寫(xiě)、術(shù)語(yǔ)解 釋1. 系統(tǒng)概述提示：（1）說(shuō)明本系統(tǒng)“是什么

23、”，（2）描述本系統(tǒng)的主要功能。 Sunny Sport庫(kù)存管理系統(tǒng)是一個(gè)基于客戶機(jī)/服務(wù)器結(jié)構(gòu)的兩層系統(tǒng)，系統(tǒng)主要功能包括入庫(kù)操作、出庫(kù)操作和系統(tǒng)管理等。采用JAVA編寫(xiě)代碼，并使用JDBC訪問(wèn)Oracle數(shù)據(jù)庫(kù)。2. 設(shè)計(jì)約束提示：（1）需求約束。體系結(jié)構(gòu)設(shè)計(jì)人員從需求文檔（如用戶需求說(shuō)明書(shū)和軟件需求規(guī)格說(shuō)明書(shū)）中提取需求約束，例如：² 本系統(tǒng)應(yīng)當(dāng)遵循的標(biāo)準(zhǔn)或規(guī)范² 軟件、硬件環(huán)境（包括運(yùn)行環(huán)境和開(kāi)發(fā)環(huán)境）的約束² 接口/協(xié)議的約束² 用戶界面的約束² 軟件質(zhì)量的約束，如正確性、健壯性、可靠性、效率（性能）、易用性、清晰性、安全性、可擴(kuò)展性

24、、兼容性、可移植性等等。（2）隱含約束。有一些假設(shè)或依賴并沒(méi)有在需求文檔中明確指出，但可能會(huì)對(duì)系統(tǒng)設(shè)計(jì)產(chǎn)生影響，設(shè)計(jì)人員應(yīng)當(dāng)盡可能地在此處說(shuō)明。例如對(duì)用戶教育程度、計(jì)算機(jī)技能的一些假設(shè)或依賴，對(duì)支撐本系統(tǒng)的軟件硬件的假設(shè)或依賴等。3. 開(kāi)發(fā)與運(yùn)行環(huán)境提示：說(shuō)明本系統(tǒng)應(yīng)當(dāng)在什么樣的環(huán)境下開(kāi)發(fā)和運(yùn)行，有什么強(qiáng)制要求和建議？類別標(biāo)準(zhǔn)配置最低配置開(kāi)發(fā)環(huán)境測(cè)試環(huán)境運(yùn)行環(huán)境4. 軟件的總體設(shè)計(jì)提示： （1）將系統(tǒng)分解為若干子系統(tǒng)，繪制各種結(jié)構(gòu)圖（例如層次結(jié)構(gòu)圖、數(shù)據(jù)流圖），說(shuō)明各子系統(tǒng)的主要功能。（盡可能簡(jiǎn)單明了，但是能夠闡述清楚系統(tǒng)的結(jié)構(gòu)）。（2）說(shuō)明“如何”以及“為什么”（how and why）如此

25、分解系統(tǒng)。（3）說(shuō)明各子系統(tǒng)如何協(xié)調(diào)工作，從而實(shí)現(xiàn)原系統(tǒng)的功能。4.1 結(jié)構(gòu)圖A在確定本系統(tǒng)的基本結(jié)構(gòu)后，本系統(tǒng)可劃分為以下幾個(gè)子模塊，其功能如下：Ø 登錄模塊 提交用戶登錄信息給服務(wù)器；根據(jù)服務(wù)器返回的結(jié)果決定用戶是否可以登錄。Ø 入庫(kù)模塊 增加、刪除、修改入庫(kù)單，生成詳細(xì)的入庫(kù)單明細(xì)。Ø 出庫(kù)模塊增加、刪除、修改出庫(kù)單，生成詳細(xì)的出庫(kù)單明細(xì)。5. 軟件體系的面向?qū)ο笤O(shè)計(jì)5.1用例圖5.2 類圖登錄模塊類圖6. 數(shù)據(jù)庫(kù)設(shè)計(jì)概述6.1 數(shù)據(jù)庫(kù)環(huán)境說(shuō)明提示： 說(shuō)明所采用的數(shù)據(jù)庫(kù)系統(tǒng)，設(shè)計(jì)工具，編程工具，有關(guān)配置等6.2 數(shù)據(jù)庫(kù)命名規(guī)則提示：說(shuō)明表、字段等命名規(guī)則6.

26、3 安全性設(shè)計(jì)說(shuō)明提示：考慮用戶密碼、訪問(wèn)權(quán)限等等6.4 E/R圖mnordDateordTimeordAdminProductOrdercontainsordIDordTypeordTradeIDodDiscountodAmountodPricepNamepUlimitpAmountpLlimitpSubTypeIDpMainTypeIDpIDpPrice6.5 表匯總n 管理員信息表(Admin)字段字段名數(shù)據(jù)類型長(zhǎng)度能否為空備注aAccount管理員賬號(hào)varchar220NOT NULLPKaPassword管理員密碼varchar220NOT NULLaName管理員姓名pvarch

27、ar28NOT NULLaTel管理員聯(lián)系電話varchar220n 商品信息表(Product)字段字段名數(shù)據(jù)類型長(zhǎng)度能否為空備注pID商品編號(hào)varchar220NOT NULLPKpName商品名稱varchar220NOT NULLpMainTypeID商品主類別編號(hào)varchar210NOT NULLFKpSubTypeID商品次類別編號(hào)varchar210NOT NULLFKpPrice商品原始單價(jià)number10NOT NULLpAmount商品數(shù)量number5NOT NULLpUlimit商品庫(kù)存上限number5NOT NULLpLlimit商品庫(kù)存下限number5NOT

28、 NULLn 訂單表(Order)字段字段名數(shù)據(jù)類型長(zhǎng)度能否為空備注ordID訂單編號(hào)varchar220NOT NULLPKordDate日期DateNOT NULLordTime時(shí)間DateNOT NULLordAdmin出/入庫(kù)人varchar220NOT NULLFKordType訂單類型varchar24NOT NULL出庫(kù)單或者入庫(kù)單ordTradeID供/訂貨者編號(hào)number20NOT NULLFKn 訂單明細(xì)表(OrderDetail)字段字段名數(shù)據(jù)類型長(zhǎng)度能否為空備注ordID訂單編號(hào)varchar220NOT NULLPK、FKpID商品編號(hào)varchar220NOT N

29、ULLPK、FKodAmount商品數(shù)量number6NOT NULLodDiscount商品折扣number6NOT NULLodPrice商品價(jià)格number10NOT NULL訂單中的商品價(jià)格7. 用戶界面設(shè)計(jì)概述提示：說(shuō)明界面設(shè)計(jì)要素，注意事項(xiàng)，界面原型等。1、登錄界面控制條件值預(yù)期結(jié)果實(shí)際結(jié)果結(jié)論整理按鈕“登錄”表中存在該用戶并且密碼正確被點(diǎn)擊進(jìn)入主界面，并且名字顯示在主界面上YESOKOK按鈕“重置”None被點(diǎn)擊清除已經(jīng)輸入的賬號(hào)和密碼YESOKOK8. 綜合考慮8.1 穩(wěn)定性和可擴(kuò)展性提示：在“軟件”生命周期內(nèi)，判斷哪些需求是不變的，預(yù)測(cè)哪些需求可能發(fā)生的變化。在總體設(shè)計(jì)的時(shí)候

30、，既要使總體結(jié)構(gòu)穩(wěn)定，又要適應(yīng)需求變化。8.2 性能分析提示：（1）本系統(tǒng)應(yīng)當(dāng)具備哪些性能指標(biāo)才能滿足用戶的需求？（2）如何實(shí)現(xiàn)性能指標(biāo)？8.3 復(fù)用和移植提示：（1）本系統(tǒng)復(fù)用了什么東西（說(shuō)明出處）？如何解決被復(fù)用成果的質(zhì)量問(wèn)題？（2）本系統(tǒng)中哪些東西是可以被將來(lái)的系統(tǒng)復(fù)用的？有什么構(gòu)思？（3）如何使本系統(tǒng)的功能代碼和用戶界面代碼區(qū)分開(kāi)來(lái)8.4 防錯(cuò)與出錯(cuò)處理提示：（1）如何預(yù)防系統(tǒng)出錯(cuò)？（2）如果系統(tǒng)出錯(cuò)了，如何處理以減少危害？8.5 其它測(cè)試計(jì)劃 1. 測(cè)試范圍提示：系統(tǒng)測(cè)試小組應(yīng)當(dāng)根據(jù)項(xiàng)目的特征確定測(cè)試類型和主要內(nèi)容。一般地，系統(tǒng)測(cè)試的主要類型包括功能測(cè)試、健壯性測(cè)試、性能測(cè)試、用戶界

31、面測(cè)試、安全性（security）測(cè)試、安裝與反安裝測(cè)試等。測(cè)試類型測(cè)試內(nèi)容、描述2. 測(cè)試方法提示：例如黑盒測(cè)試和白盒測(cè)試，解說(shuō)方法。3. 測(cè)試環(huán)境與測(cè)試輔助工具測(cè)試環(huán)境測(cè)試輔助工具4. 測(cè)試完成準(zhǔn)則提示：對(duì)于非嚴(yán)格系統(tǒng)可以采用“基于測(cè)試用例”的準(zhǔn)則： （1）功能性測(cè)試用例通過(guò)率達(dá)到100；（2）非功能性測(cè)試用例通過(guò)率達(dá)到95時(shí)。對(duì)于嚴(yán)格系統(tǒng)，應(yīng)當(dāng)補(bǔ)充“基于缺陷密度”的規(guī)則：（3）相鄰n個(gè)CPU小時(shí)內(nèi)“測(cè)試期缺陷密度”全部低于某個(gè)值m。例如n大于10，m小于等于1。5. 人員與任務(wù)表任務(wù)描述時(shí)間人員6. 問(wèn)題與對(duì)策7. 本計(jì)劃審批意見(jiàn)提示：如果公司有測(cè)試經(jīng)理的話，本計(jì)劃需要測(cè)試經(jīng)理的審批。項(xiàng)

32、目經(jīng)理審批意見(jiàn)：測(cè)試經(jīng)理審批意見(jiàn)：測(cè)試報(bào)告 測(cè)試報(bào)告項(xiàng)目名稱Sunny Sport庫(kù)存管理系統(tǒng)測(cè)試任務(wù)描述管理員登錄功能測(cè)試人員張三測(cè)試時(shí)間2009-3-28測(cè)試環(huán)境和工具Windows XP測(cè)試用例或測(cè)試內(nèi)容結(jié)果說(shuō)明用戶名為空（1）無(wú)bug（2）發(fā)現(xiàn)bug ü（3）已消除bug沒(méi)有任何錯(cuò)誤提示。測(cè)試總結(jié)Java編碼規(guī)范 1 介紹(Introduction) n 為什么要有編碼規(guī)范(Why Have Code Conventions)編碼規(guī)范對(duì)于程序員而言尤為重要，有以下幾個(gè)原因：- 一個(gè)軟件的生命周期中，80%的花費(fèi)在于維護(hù)。- 幾乎沒(méi)有任何一個(gè)軟件，在其整個(gè)生命周期中，均由最初的

33、開(kāi)發(fā)人員來(lái)維護(hù)。- 編碼規(guī)范可以改善軟件的可讀性，可以讓程序員盡快而徹底地理解新的代碼。- 如果你將源碼作為產(chǎn)品發(fā)布，就需要確任它是否被很好的打包并且清晰無(wú)誤，一如你已構(gòu)建的其它任何產(chǎn)品。為了執(zhí)行規(guī)范，每個(gè)軟件開(kāi)發(fā)人員必須一致遵守編碼規(guī)范。n 1.2 版權(quán)聲明(Acknowledgments)本文檔反映的是Sun MicroSystems公司Java語(yǔ)言規(guī)范中的編碼標(biāo)準(zhǔn)部分。主要貢獻(xiàn)者包括：Peter King，Patrick Naughton，Mike DeMoney，Jonni Kanerva，Kathy Walrath以及Scott Hommel。本文檔現(xiàn)由Scott Hommel維護(hù)，

34、。2 文件名() 這部分列出了常用的文件名及其后綴。n 2.1 文件后綴()Java程序使用下列文件后綴：文件類別文件后綴Java源文件.javaJava字節(jié)碼文件.classn 2.2 常用文件名(Common )常用的文件名包括：文件名用途GNUmakefilemakefiles的首選文件名。我們采用gnumake來(lái)創(chuàng)建（build）軟件。README概述特定目錄下所含內(nèi)容的文件的首選文件名3 文件組織() 一個(gè)文件由被空行分割而成的段落以及標(biāo)識(shí)每個(gè)段落的可選注釋共同組成。超過(guò)2000行的程序難以閱讀，應(yīng)該盡量避免。“Java源文件范例”提供了一個(gè)布局合理的Java程序范例。n 3.1 J

35、ava源文件(Java Source Files)每個(gè)Java源文件都包含一個(gè)單一的公共類或接口。若私有類和接口與一個(gè)公共類相關(guān)聯(lián)，可以將它們和公共類放入同一個(gè)源文件。公共類必須是這個(gè)文件中的第一個(gè)類或接口。Java源文件還遵循以下規(guī)則：- 開(kāi)頭注釋（參見(jiàn)“開(kāi)頭注釋”）- 包和引入語(yǔ)句（參見(jiàn)“包和引入語(yǔ)句”）- 類和接口聲明（參見(jiàn)“類和接口聲明”） 3.1.1 開(kāi)頭注釋(Beginning Comments)所有的源文件都應(yīng)該在開(kāi)頭有一個(gè)C語(yǔ)言風(fēng)格的注釋，其中列出類名、版本信息、日期和版權(quán)聲明： /* * Classname * * Version information * * Date *

36、 * Copyright notice */ 3.1.2 包和引入語(yǔ)句(Package and Import Statements)在多數(shù)Java源文件中，第一個(gè)非注釋行是包語(yǔ)句。在它之后可以跟引入語(yǔ)句。例如： package java.awt; import java.awt.peer.CanvasPeer; 3.1.3 類和接口聲明(Class and Interface Declarations)下表描述了類和接口聲明的各個(gè)部分以及它們出現(xiàn)的先后次序。參見(jiàn)“Java源文件范例”中一個(gè)包含注釋的例子。 類/接口聲明的各部分注解1類/接口文檔注釋(/*/)該注釋中所需包含的信息，參

37、見(jiàn)“文檔注釋”2類或接口的聲明 3類/接口實(shí)現(xiàn)的注釋(/*/)如果有必要的話該注釋?xiě)?yīng)包含任何有關(guān)整個(gè)類或接口的信息，而這些信息又不適合作為類/接口文檔注釋。4類的(靜態(tài))變量首先是類的公共變量，隨后是保護(hù)變量，再后是包一級(jí)別的變量(沒(méi)有訪問(wèn)修飾符，access modifier)，最后是私有變量。5實(shí)例變量首先是公共級(jí)別的，隨后是保護(hù)級(jí)別的，再后是包一級(jí)別的(沒(méi)有訪問(wèn)修飾符)，最后是私有級(jí)別的。6構(gòu)造器 7方法這些方法應(yīng)該按功能，而非作用域或訪問(wèn)權(quán)限，分組。例如，一個(gè)私有的類方法可以置于兩個(gè)公有的實(shí)例方法之間。其目的是為了更便于閱讀和理解代碼。4 縮進(jìn)排版(Indentat

38、ion) 4個(gè)空格常被作為縮進(jìn)排版的一個(gè)單位。縮進(jìn)的確切解釋并未詳細(xì)指定(空格 vs. 制表符)。一個(gè)制表符等于8個(gè)空格(而非4個(gè))。n 4.1 行長(zhǎng)度(Line Length)盡量避免一行的長(zhǎng)度超過(guò)80個(gè)字符，因?yàn)楹芏嘟K端和工具不能很好處理之。注意：用于文檔中的例子應(yīng)該使用更短的行長(zhǎng)，長(zhǎng)度一般不超過(guò)70個(gè)字符。n 4.2 換行(Wrapping Lines)當(dāng)一個(gè)表達(dá)式無(wú)法容納在一行內(nèi)時(shí)，可以依據(jù)如下一般規(guī)則斷開(kāi)之：- 在一個(gè)逗號(hào)后面斷開(kāi)- 在一個(gè)操作符前面斷開(kāi)- 寧可選擇較高級(jí)別(higher-level)的斷開(kāi)，而非較低級(jí)別(lower-level)的斷開(kāi)- 新的一行應(yīng)該與上一行同一級(jí)別

39、表達(dá)式的開(kāi)頭處對(duì)齊- 如果以上規(guī)則導(dǎo)致你的代碼混亂或者使你的代碼都堆擠在右邊，那就代之以縮進(jìn)8個(gè)空格。 以下是斷開(kāi)方法調(diào)用的一些例子： someMethod(longExpression1, longExpression2, longExpression3, longExpression4, longExpression5); var = someMethod1(longExpression1, someMethod2(longExpression2, longExpression3);以下是兩個(gè)斷開(kāi)算術(shù)表達(dá)式的例子。前者更好，因?yàn)閿嚅_(kāi)處位于括號(hào)表達(dá)式的外邊，這是個(gè)較高級(jí)別的斷開(kāi)。 longN

40、ame1 = longName2 * (longName3 + longName4 - longName5) + 4 * longname6; /PREFFER longName1 = longName2 * (longName3 + longName4 - longName5) + 4 * longname6; /AVOID以下是兩個(gè)縮進(jìn)方法聲明的例子。前者是常規(guī)情形。后者若使用常規(guī)的縮進(jìn)方式將會(huì)使第二行和第三行移得很靠右，所以代之以縮進(jìn)8個(gè)空格。 /CONVENTIONAL INDENTATION someMethod(int anArg, Object anotherArg, Strin

41、g yetAnotherArg, Object andStillAnother) . /INDENT 8 SPACES TO AVOID VERY DEEP INDENTS private static synchronized horkingLongMethodName(int anArg, Object anotherArg, String yetAnotherArg, Object andStillAnother) . if語(yǔ)句的換行通常使用8個(gè)空格的規(guī)則，因?yàn)槌Ｒ?guī)縮進(jìn)(4個(gè)空格)會(huì)使語(yǔ)句體看起來(lái)比較費(fèi)勁。比如：/DONT USE THIS INDENTATION if (conditi

42、on1 && condition2) | (condition3 && condition4) |!(condition5 && condition6) /BAD WRAPS doSomethingAboutIt(); /MAKE THIS LINE EASY TO MISS /USE THIS INDENTATION INSTEAD if (condition1 && condition2) | (condition3 && condition4) |!(condition5 && conditi

43、on6) doSomethingAboutIt(); /OR USE THIS if (condition1 && condition2) | (condition3 && condition4) |!(condition5 && condition6) doSomethingAboutIt(); 這里有三種可行的方法用于處理三元運(yùn)算表達(dá)式： alpha = (aLongBooleanExpression) ? beta : gamma; alpha = (aLongBooleanExpression) ? beta : gamma; alpha

44、 = (aLongBooleanExpression) ? beta : gamma;5 注釋(Comments) Java程序有兩類注釋：Ø 實(shí)現(xiàn)注釋(implementation comments)Ø 文檔注釋(document comments)實(shí)現(xiàn)注釋使用/*.*/和/界定的注釋。文檔注釋(被稱為“doc comments”)是Java獨(dú)有的，并由/*.*/界定。文檔注釋可以通過(guò)javadoc工具轉(zhuǎn)換成HTML文件。實(shí)現(xiàn)注釋用以注釋代碼或者實(shí)現(xiàn)細(xì)節(jié)。文檔注釋從實(shí)現(xiàn)自由(implementation-free)的角度描述代碼的規(guī)范。它可以被那些手頭沒(méi)有源碼的開(kāi)發(fā)人員讀

45、懂。注釋?xiě)?yīng)被用來(lái)給出代碼的總括，并提供代碼自身沒(méi)有提供的附加信息。注釋?xiě)?yīng)該僅包含與閱讀和理解程序有關(guān)的信息。例如，相應(yīng)的包如何被建立或位于哪個(gè)目錄下之類的信息不應(yīng)包括在注釋中。在注釋里，對(duì)設(shè)計(jì)決策中重要的或者不是顯而易見(jiàn)的地方進(jìn)行說(shuō)明是可以的，但應(yīng)避免提供代碼中己清晰表達(dá)出來(lái)的重復(fù)信息。多余的注釋很容易過(guò)時(shí)。通常應(yīng)避免那些代碼更新就可能過(guò)時(shí)的注釋。注意：頻繁的注釋有時(shí)反映出代碼的低質(zhì)量。當(dāng)你覺(jué)得被迫要加注釋的時(shí)候，考慮一下重寫(xiě)代碼使其更清晰。注釋不應(yīng)寫(xiě)在用星號(hào)或其它字符畫(huà)出來(lái)的大框里。注釋不應(yīng)包括諸如制表符和回退符之類的特殊字符。n 5.1 實(shí)現(xiàn)注釋的格式(Implementation Com

46、ment Formats)程序可以有4種實(shí)現(xiàn)注釋的風(fēng)格：塊(block)、單行(single-line)、尾端(trailing)和行末(end-of-line)。5.1.1 塊注釋(Block Comments)塊注釋通常用于提供對(duì)文件，方法，數(shù)據(jù)結(jié)構(gòu)和算法的描述。塊注釋被置于每個(gè)文件的開(kāi)始處以及每個(gè)方法之前。它們也可以被用于其他地方，比如方法內(nèi)部。在功能和方法內(nèi)部的塊注釋?xiě)?yīng)該和它們所描述的代碼具有一樣的縮進(jìn)格式。塊注釋之首應(yīng)該有一個(gè)空行，用于把塊注釋和代碼分割開(kāi)來(lái)，比如： /* * Here is a block comment. */塊注釋可以以/*-開(kāi)頭，這樣indent(1)就可以將

47、之識(shí)別為一個(gè)代碼塊的開(kāi)始，而不會(huì)重排它。 /*- * Here is a block comment with some very special * formatting that I want indent(1) to ignore. * * one * two * three */注意：如果你不使用indent(1)，就不必在代碼中使用/*-，或?yàn)樗丝赡軐?duì)你的代碼運(yùn)行indent(1)作讓步。5.1.2 單行注釋(Single-Line Comments)短注釋可以顯示在一行內(nèi)，并與其后的代碼具有一樣的縮進(jìn)層級(jí)。如果一個(gè)注釋不能在一行內(nèi)寫(xiě)完，就該采用塊注釋(參見(jiàn)“塊注釋”)。單行注釋之前應(yīng)該有一個(gè)空行。以下是一個(gè)Java代碼中單行注釋的例子： if (condition) /* Handle the condition. */ . 5.1.3 尾端注釋(Trailing Comments)極短的注釋可以與它們所要描述的代碼位于同一行，但是應(yīng)該有足夠的空白來(lái)分開(kāi)代碼和注釋。若有多個(gè)短注釋出現(xiàn)于大段代碼中，它們應(yīng)該具有相同的縮進(jìn)。以下是一