回覆列表
-
1 # CK鄔
-
2 # 繁星落石
不太一樣。
文件是技術設計說明書,用於描述介面的用法、形式以及各個引數的作用;原始碼就是這些功能的實現了。當然看原始碼的話,文件裡面的功能肯定是可以理解的,但是原始碼裡面一般只會包含相對關鍵的註釋,而不會把所有文件內容包含在內,所以閱讀起來的效率不高,對於不同的引數需要在原始碼裡搜尋對應的位置來判斷其作用,就不如直接透過文件查詢說明來得快;另外原始碼中可能存在一些bug導致程式碼實現的介面與文件不符,此時應該以文件為準,並對介面維護方提交bug報告。
-
3 # 石墨烯大傅
首先文件要優先於資料庫設計和原始碼(非常重要)
第一步:根據業務需求文件,先定義好所有業務介面文件。
一個好的API文件,可以讓人的思路瞬間清晰,讓人看完文件就知道要實現什麼功能,使用那些介面,以及介面的所需要的引數。
第二步:根據介面文件和業務需求文件,設計資料庫文件。
資料庫文件包括1.概念結構設計
將表名規範化,讓人一眼就知道這個表的作用2.關係模型 2.1 系統資料 2.2 使用者資料 2.3 檢視3. 表結構設計
第三步:接下來就可以編寫原始碼,來實現介面文件中的所有功能了。
後面的就是進入到正常的開發流程了,我就不一一列舉了。
總之介面文件和資料庫文件,都非常重要。不要急於求成,為了趕專案。一開始就coding,往往會導致專案偏離實際需求很遠,並且會拉長專案的週期。希望可以給予你一些幫助。
兩者在性質上完全不一樣,不能拿在一直對比。
資料庫介面文件一般是用於第三方對接使用,使用介面的好處是不需要第三方認識內部程式碼實現及邏輯,也能對自身系統起到很好的保護和保密作用,提高穩定性與安全性。
原始碼是軟體系統的核心,提供原始碼可以讓第三方瞭解所有此程式的內部邏輯及實現方法,但對第三方調對接使用並不友好,一方面要求第三方對原始碼所用語言要非常熟悉,同時原始碼的註釋如不清楚極容易造成誤解讀,最終第三方實現呼叫時容易造成出錯,並且暴露原始碼對系統穩定性和安全性是一個極大威脅。
綜上所述,如需由第三方進行對接呼叫,建議提供介面及相關文件,這個方式是最適當的。