愛華網(wǎng)
上一個項目遇到一些接口問題，現(xiàn)總結(jié)如下，以備將來改進(jìn)。轉(zhuǎn)載請標(biāo)明出處。
問題描述，在軟件開發(fā)活動中，當(dāng)系統(tǒng)分調(diào)結(jié)束而進(jìn)入聯(lián)調(diào)時，開發(fā)者們突然發(fā)現(xiàn)，系統(tǒng)各部分之間的接口約定出現(xiàn)了很多令人不愉快的形勢：
1.有人不遵守約定，也未通知有關(guān)方面；
2.有人臨時創(chuàng)造出一些強加于人的約定；
3.原始的約定本身不完備或不正確，但在開發(fā)過程中未予修正等等
導(dǎo)致的結(jié)果只有一個：系統(tǒng)根本無法聯(lián)調(diào)，而要局部或者全部進(jìn)【】行返工?？紤]到由此引發(fā)的開發(fā)人員、甚至單位之間的心理因素的變化，互相埋怨。推卸責(zé)任，就會耽誤大量工期。
本文旨在針對接口設(shè)計中的共性問題提出解決的方法或想法，供大家參考。
本文將圍繞子系統(tǒng)接口設(shè)計、模塊接口設(shè)計討論。
二、子系統(tǒng)間的接口設(shè)計
1、子系統(tǒng)之間的接口設(shè)計是一個全局性的問題，應(yīng)該受到管理者和全體開發(fā)者的重視。
在軟件開發(fā)過程中應(yīng)在系統(tǒng)分析和系統(tǒng)設(shè)計時就開始考慮接口設(shè)計問題，這個應(yīng)由負(fù)責(zé)系統(tǒng)總體的、經(jīng)驗豐富的系統(tǒng)開發(fā)者完成，主要包括子系統(tǒng)劃分和相應(yīng)的接口設(shè)計。
2.1.1由于現(xiàn)在的系統(tǒng)多為分布式的，不同的子系統(tǒng)分布在不同的物理機或虛擬機上，子系統(tǒng)交互如果采取文件的形式必須考慮接口文件的格式轉(zhuǎn)換問題（即子系統(tǒng)之間數(shù)據(jù)的一致性）。
2.1.2由于現(xiàn)在的系統(tǒng)常會引用其他的開源或付費的商業(yè)軟件，因此在子系統(tǒng)之間必須考慮是否需要增加必要的接口文件或相應(yīng)的軟件工具。
三、模塊間的接口設(shè)計
1、模塊間的接口分類：參數(shù)傳遞，全局變量，文件
2、設(shè)計原則：
3.2.1 低耦合，高內(nèi)聚
3.2.2 兩個耦合的模塊間以數(shù)據(jù)耦合為最佳，即除了調(diào)用時傳參數(shù)以外不存在其他關(guān)系。設(shè)計要點：
3.2.2.1模塊功能力求單一，即一個模塊只做一件事
3.2.2.2模塊的輸入輸出數(shù)據(jù)全部組織成為調(diào)用參數(shù)且當(dāng)被調(diào)用時實參和形參要保持一致
四、軟件接口設(shè)計流程
4.1 軟件接口需求分析
需求人員需對所開發(fā)的軟件系統(tǒng)中的接口給出定義并作需求分析、制定詳細(xì)的接口需求說明，當(dāng)接口關(guān)系非常復(fù)雜很難說明時，需要對接口做出完整的描述，并將軟件接口進(jìn)行分解并單獨做需求分析和說明，經(jīng)審定和批準(zhǔn)后、作為軟件接口開發(fā)工作的基礎(chǔ)，。
4.2 接口設(shè)計：
4.2.1分類明確說明該軟件產(chǎn)品所配置的各接口的功能、性能等技術(shù)要求。
4.2.2列出各接口的標(biāo)準(zhǔn)、約定等技術(shù)要求。
4.2.3．接口的數(shù)據(jù)需求（
a各個數(shù)據(jù)元素的單一標(biāo)識符和簡短說明
b各個數(shù)據(jù)元素的源和目標(biāo)
c各個數(shù)據(jù)元素的數(shù)值范圍或極限
d各個數(shù)據(jù)元素的計量單位
e各個數(shù)據(jù)元素的精度要求
f其他數(shù)據(jù)要求
g數(shù)據(jù)類型，如整型，實型、常量等
h數(shù)據(jù)元素的合法性檢查
i數(shù)據(jù)元素的計算或更新的頻率
j數(shù)據(jù)表達(dá)式或格式
k數(shù)據(jù)元素的優(yōu)先級
4.2.4接口的質(zhì)量保證要求（時間特性、空間特性）
4.2.5 接口關(guān)系
以框圖或結(jié)構(gòu)圖的方式、說明系統(tǒng)與各個接口之間的連接關(guān)系、包括主要控制信息和數(shù)據(jù)信息流向。
4.2.6接口一覽表
分類列出各接口的名稱、標(biāo)識、類別和基本功能。
4.2.7 硬件環(huán)境
說明需求的硬件環(huán)境和特征。
4.2.8其他約定
如工作方式、調(diào)用方式等。
4.3 接口測試
由開發(fā)及測試人員針對接口的設(shè)計完成覆蓋測試，并形成最終文檔。
