【正文】 變量、常量的注釋應(yīng)放在其上方相鄰位置或右方。 } 注視規(guī)范 Java 的注釋有三 種 // 注釋一行 /* ...... */ 注釋若干行 /** ...... */ 注釋若干行，并寫入 javadoc 文檔 ，也叫 java 文檔注釋 注釋要簡單明了。 package class 的命名 class 的名字必須由大寫字母開頭而其他字母都小寫的單詞組成 ,對于所有標(biāo)識符，其中包含的所有單詞都應(yīng)緊靠在一起，而且大寫中間單詞的首字母。 3． 2 對產(chǎn)品質(zhì)量的評價 說明在測試中檢查出來的程序編制中的錯誤發(fā)生率，即每干條指令（或語句）中的錯誤指令數(shù)（或語句數(shù)）。 2 實際開發(fā)結(jié)果 2． 1 產(chǎn)品 說明最終制成的產(chǎn)品，包括： a．程序系統(tǒng)中各個程序的名字，它們之間的層次關(guān)系，以千字節(jié)為單位的各個程序的程序量、存儲媒體的形式和數(shù)量； b．程序系統(tǒng)共有哪幾個版本，各自的版本號及它們之間的區(qū)別； c．每個文件的名稱； d．所建立的每個數(shù)據(jù)庫。 3． 3 預(yù)處理 對數(shù)據(jù)的采集和預(yù)處理過程提出專門的規(guī)定，包括適合應(yīng)用的數(shù)據(jù)格式、預(yù)定的數(shù)據(jù)通信媒體和對輸入的時間要求等。 3 數(shù)據(jù)的采集 3． 1 要求和范圍 按數(shù)據(jù)元的邏輯分組來說明數(shù)據(jù)采集的要求和范圍，指明數(shù)據(jù)的采集方法，說明數(shù)據(jù)采集工作的承擔(dān)者是用戶還是開發(fā)者。給出每一數(shù)據(jù)元的名稱（包括縮寫和代碼）、定 義（或物 理意義）度量單位、值域、格式和類型等有關(guān)信息。 1． 3 定義 列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 4． 3． 3 輸出舉例 為每種輸出類型提供例子。如果有的話，還應(yīng)說明安裝過程中所需用到的專用軟件。 2． 3 安 全保密 說明本軟件在安全、保密方面的設(shè)計考慮和實際達(dá)到的能力。 1． 2 背景 說明： a．這份用戶手冊所描述的軟件系統(tǒng)的名稱； b．該軟件項目的任務(wù)提出者、開發(fā)者、用戶（或首批用戶）及安裝此軟件的計算中心。 3． 8 接口 用圖的形式說明本程序所隸屬的上一層模塊及隸屬于本程序的下一層模塊、子程序，說明參數(shù)賦值和調(diào)用方式，說明與本程序相直接關(guān)聯(lián)的數(shù)據(jù)結(jié)構(gòu)（數(shù)據(jù)庫、數(shù)據(jù)文卷）。 3． 1 程序描述 給出對該程序的簡要描述，主要說明安排設(shè)計本程序的目的意義，并且，還要說明本程序的特點（如 是常駐內(nèi)存還是非常駐？是否子程序？是可重人的還是不可重人的？有無覆蓋要求？是順序處理還是并發(fā) 處理卜?．．等）。 1． 2 背景 說明： a．待開發(fā)軟件系統(tǒng)的名稱； b．本項目的任務(wù)提出者、開發(fā)者、用戶和運行該程序系統(tǒng)的計算中心。 3． 4 數(shù)據(jù)管理能力要求 說明需要管理的文卷和記錄的個數(shù)、表和文卷的大小規(guī)模，要按可預(yù)見的增長對數(shù)據(jù)及其分量的存儲要求作出估算。這些是軟件設(shè)計工作的重要約束 2． 3 假定和約束 列出進行本軟件開發(fā)工作的假定和約束，例如經(jīng)費限制、開發(fā)期限等。 1． 3 定義 列出本文件中 用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 4． 1 計算機系統(tǒng)支持 逐項列出開發(fā)中和運行時所需的計算機系統(tǒng)支持，包括計算機、外圍設(shè)備、通訊設(shè)備、模擬器、編譯 （或 匯編）程序、操作系統(tǒng)、數(shù)據(jù)管理程序包、數(shù) 據(jù)存儲能力和測試支持能力等，逐項給出有關(guān)到貨日期、 使用時間的要求。 2． 4 驗收標(biāo)準(zhǔn) 對于上述這些應(yīng)交出的產(chǎn)品和服務(wù)，逐項說明或引用資料說明驗收標(biāo)準(zhǔn)。 1． 4 參考資料 列出用得著的參考資料，如： a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同、上級機關(guān)的批文； b．屬于本項目的其他已發(fā)表的文件； C．本文件中各處引用的文件、資料，包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。 、 考核指標(biāo)模板 此模板在每一個項目啟動前，根據(jù)實際項目情況進行實例化，項目管理辦公室與項目經(jīng)理溝通并在雙方確認(rèn)后開始執(zhí)行，每個項目的考核指標(biāo)實例允許在項目執(zhí)行過程中進行變 更，前提是考核相關(guān)的全部干系人一致同意。 7 溝通精神 不懂問題是拖延時間還是主動尋求幫助，技術(shù)經(jīng)驗是否主動分享。 2 客戶關(guān)注點 客戶關(guān)注點也就是軟件的品質(zhì)，涉及的內(nèi)容很多，按國家標(biāo)準(zhǔn)分為六個層面，即：功能、可靠性、易用性、高效性、可維護性、可移植性。 3 要體現(xiàn)多勞多得、獎勤罰懶。棘手的原因是既不能進行計時處理、也不能進行計件處理。編制 眾多的文檔需要花費大量的 時間 ，并且要使這些文檔 和 代碼保持同 步 ：就要花費 更 多的時 間 。 、 代碼 標(biāo)準(zhǔn)化管理 小組內(nèi)成員 必須開展互測 ， 項目經(jīng)理要督促進行。 另外還要為團隊固定一些一些角色， builder / Server administrator（ dbaamp。 開發(fā)組的責(zé)任人 是 開發(fā)經(jīng)理， 系統(tǒng)體系結(jié)構(gòu)與框架由開發(fā)經(jīng)理與開發(fā)組主力程序員聯(lián)合統(tǒng)籌，并以開發(fā)經(jīng)理 意見 為主 ，具體功能實現(xiàn)一般以 主力程序員 （ 系統(tǒng)分析員、高級程序員 ） 意見為 主 。 3 領(lǐng)導(dǎo) ? 保證項目組目標(biāo)明確且理解一致； ? 創(chuàng)建項目組的開發(fā)環(huán)境及氛圍，在項目范圍內(nèi)保證項目組成員不受項目其它方面的影響； ? 提升項目組士氣，加強項目組凝聚力； ? 合理安排項目組各成員的工作，使各成員工作都能達(dá)到一定的飽滿度； ? 制定項目組需要的招聘或培訓(xùn)人員的計劃； ? 定期組織項目組成員 進行相關(guān)技術(shù)培訓(xùn)以及與項目相關(guān)的行業(yè)培訓(xùn)等； ? 及時發(fā)現(xiàn)項目組中出現(xiàn)的問題； ? 及時處理項目組中出現(xiàn)的問題。 2協(xié)助規(guī)劃、組織和推進公司內(nèi)部的過程持續(xù)改進工作。 3項目的過程和產(chǎn)品質(zhì)量保證，內(nèi)部審計、跟蹤過程缺陷直至解決、參與技術(shù)評審。 4 控制 ? 保證項目在預(yù)算成本范圍內(nèi)按規(guī)定的質(zhì)量和進度達(dá)到項目目標(biāo)； ? 在項目生命周期的各個階段，跟蹤、檢查項目組成員的工作質(zhì)量； ? 定期向領(lǐng)導(dǎo)匯報項目工作進度以及項目開發(fā)過程中的難題； ? 對項目進行配置管理與規(guī)劃； ? 控制項目組各成員的工作進度，及時了解項目組成員的工作情況，并快速解決難題； ? 不定期組織項目組成員進行項目以外的短期活動，以培養(yǎng)團隊精神。 “系統(tǒng)支持”屬于臨時調(diào)配，很可能是外部資源，但工作質(zhì)量由開發(fā)經(jīng) 理檢查。osa）。 如果一般性的缺陷被質(zhì)量組測試發(fā)現(xiàn)，項目經(jīng)理可以作出警告、取消休假、扣發(fā)獎金等處理措施。如果文檔和代 碼 之間失 去 同步， 那么文檔 就會變成 龐大的、復(fù)雜的謊言 ．會造成重大的 誤導(dǎo) ； 對 于團隊來說，編寫 并維護一份 系統(tǒng)原理和結(jié)構(gòu)方而的文擋將總是一個好主慝，但是那份文檔 應(yīng)該是短小、突出主題的。計時會造成出工不出力，計件（一般按代碼條數(shù)）會挫傷優(yōu)秀軟件人員的積極性（同樣實現(xiàn)一個功能，差的軟件人員成百上千行，而優(yōu)秀軟件人員只有幾十行，且好用）。 高效、高質(zhì)完成任務(wù)的人員必須得到區(qū)別對待（調(diào)資、休假、獎金）。這六個項目的次序也就是我們考察的順序，首先必須完成功能，然后再衡量功能是否可 靠，再然后才其他幾個方面 ，如果以 百分制來衡 量，這六個 指標(biāo)的比 例大致是50,25,15,10,5,5。 、考評矩陣軟件項目管理制度 作者 Page 13 8/10/2020 軟件項目管理制度 作者 Page 14 8/10/2020 開發(fā)人員當(dāng)期任務(wù)評測 表 任務(wù)書編號： 項目 指標(biāo) 時效率 按時 未按時 X%(X=100) 完成 未完成 X% Y% 客戶關(guān)注點 功能 可靠 易用 性能 維護 移植 功能 可靠 易用 性能 維護 移植 A≤ 50% B≤ 25% C≤ 15% D≤ 10% E≤ 5% F≤ 5% A≤ 50% B≤ 25% C≤ 15% D≤ 10% E≤ 5% F≤ 5% 規(guī)范與標(biāo)準(zhǔn) 好 中 差 G≥ 6 G≤ 4 G=0 復(fù)用與創(chuàng)新性 好 中 差 H≥ 3 H≤ 2 H=0 團隊精神 好 中 差 I≥ 5 I≤ 4 I∈ 0→ 2 奉獻(xiàn)精神 好 中 差 J∈ → J= J= 溝通精神 好 中 差 K≥ 3 K≤ 2 K= 記分 (30 + (A+B+C+D+E+F)*40+G+H+I+J+K)*X% 功能：實現(xiàn) 的結(jié)果是否體現(xiàn)的客戶的意圖，與客戶意圖之間的差距（ x%） , 功能測評比例 (1x%)*50% 可靠性：主要以 測試出的缺陷 多少來衡量 ，如果一個最低級功能被測出超過三個缺陷，可靠性為零 。 所有的差異比取值都是： 10% 30% 50% 80% 100%，共 5檔。 列出這些文件資料的標(biāo)題、文件編號、發(fā)表日期和出版單位，說明能夠得到這些文件資料的來源。 2． 5 完成項目的員遲用限 2． 6 本計劃的批準(zhǔn)者和批準(zhǔn)日期 軟件項目管理制度 作者 Page 19 8/10/2020 3 實施計劃 3． 1 工作任務(wù)的分門與人員分工 對于項目開發(fā)中需完成的各項工作，從需求分析、設(shè)計、實現(xiàn)、測試直到維護，包括文件的編制、審批、打印、分發(fā)工作，用戶培訓(xùn)工作，軟件安裝工作等，按層次進行分解，指明每項任 務(wù)的負(fù)責(zé)人和參加人員。 4． 2 需由用戶承擔(dān)的工作 逐項列出需要用戶承擔(dān)的工作和完成期限。 1． 4 參考資料 列出用得著的參考資料，如： a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同、上級機關(guān)的批文； b．屬于本項目的其他已發(fā)表的文件； c．本文件中各處引用的文件、資料、包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。 3 需求規(guī)定 3． 1 對功能的規(guī)定 用列表的方式（例如 IPO 表即輸入、處理、輸出表的形式），逐項定量和定性地敘述對軟件所提出的功能要求，說明輸入什么量、經(jīng)怎樣的處理、得到什么輸出，說明軟件應(yīng)支持的終端數(shù)和應(yīng)支持的并行操作的用戶數(shù)。 3． 5 故障處理要求 列出可能的軟件、硬件故障以及對各項性能而言所產(chǎn)生的后果和對故障處理的要求。 1． 3 定義 列出本文件中用到專門術(shù)語的定義和外文首字母組詞的原詞組。 3． 2 功能 說明該程序應(yīng)具有的功能，可采用 IPO 圖（即輸入一處理一輸出圖）的形式。 3． 9 存儲分配 根據(jù)需要，說明本程序的存儲分配。 1． 3 定義 列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 3 運行環(huán)境 3． 1 硬設(shè)備 列出為運行本軟件所要求的硬設(shè)備的最小配置，如： a．處理機的型號、內(nèi)存容量 。 4． 2 輸入 規(guī)定輸入數(shù)據(jù)和參量的準(zhǔn)備要求。對例子中的每一項，說明： a．定義 每項輸出信息的意義和用途； b．來源 是從特定的輸入中抽出、從數(shù)據(jù)庫文卷中取出、或從軟件的計算過程中得到 c．特性 輸出的值域、計量單位、在什么情況下可缺省等。 1． 4 參考資料 列出有關(guān)的參考資料，如： a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同，上級機關(guān)的批文； b．屬于本項目的其他已發(fā)表文件； c．本文件中各處引用的文件、資料，包括所要 用到的軟件開發(fā)標(biāo)準(zhǔn)。 2． 1 靜態(tài)數(shù)據(jù) 列出所有作為控制或參考用的靜態(tài)數(shù)據(jù)元素。具體的內(nèi)容包括： a．輸入數(shù)據(jù)的來源，例如是單個操作員、數(shù)據(jù)輸入站，專業(yè)的數(shù)據(jù)輸入公司或它們的軟件項目管理制度 作者 Page 28 8/10/2020 一個分組； b．?dāng)?shù)據(jù)輸入（指把數(shù)據(jù)輸入處理系統(tǒng)內(nèi)部）所用的媒體和硬設(shè)備。對于需經(jīng)模擬轉(zhuǎn)換或數(shù)字轉(zhuǎn)換處理的數(shù)據(jù)量，要給出轉(zhuǎn)換方法和轉(zhuǎn)換因子等有關(guān)信息，以便軟件系統(tǒng)使用這些數(shù)據(jù)。 如果開發(fā)中制訂過配置管理計劃，要同這個計 劃相比較。如果開發(fā)中制訂過 質(zhì)量保證計劃或配置管理計劃，要同這些計劃相比較。 public class ThisAClassName{} class 變量的命名 變量的名字必須用一個小寫字母開頭。 String userName = null。 全局變量要有較詳細(xì)的注釋，包括對其功能、取值范圍、哪些函數(shù)或過程存取它以及存取時注意事項等的說明。對數(shù)據(jù)結(jié)構(gòu)的注釋應(yīng)放在其上方相鄰位置，不可放在下面；對結(jié)構(gòu)中的每個域的注釋應(yīng)放在此域的右方； 同一結(jié)構(gòu)中不同域的注釋要對齊。 方法的參數(shù) 使用有意義的參數(shù)命名，如果可能的話，使用和要賦值的字 段一樣的名字： setCounter(int size){ = size。 package 的命名