1. 程式人生 > >深入C++中API的問題詳解_C 語言

深入C++中API的問題詳解_C 語言

前言:本文書寫的格式與其它不相同。本文題目說是關於C++ API的思考,其實也不僅僅是C++,對於其它語言同樣適用。

API實際是指Application Programming Interface,應用程式程式設計介面。對API是一套用來控制Windows的各個部件的外觀和行為的一套預先定義的Windows函式。在C++中我認為:一個API就是一堆類以及類中方法和欄位的集合。
並不是所有的簽名都是API的一部分,未公開的部分(private)內容不是API,它不對外承諾相容性。API廣泛定義:凡是有利於在“無緒”的狀態下把一個大的系統以元件整合的方法拼裝出來的東西都屬於API。

為什麼要開發API?
我們希望將大塊的構建模組“無緒”地集合成應用程式,一些構建模組包含共享庫、框架、預先定義好的程式架構,以及這些內容的組合。

如何檢查API的質量?
1、可理解性
2、一致性
3、可見性
4、簡單的任務應該有簡單的方案
5、保護投資

API設計技巧一:
不要把類中的欄位直接對外公佈,而應該放置在內部。最好讓外部使用者只能通過set、Get方法來訪問欄位,千萬不要將欄位直接公佈出來。

使用方法訪問欄位要好於直接訪問欄位。如果你在編寫API的時候遵守這一建議,那麼可以在這個API的下一個版本中對方法的具體實現進行很多改動,如新增資料的驗證和校驗、覆蓋一個方法等,還可以做一些大的變化。如果直接使用指端就不能做上述改動。

API設計技巧二:
使用工廠方法而不是直接使用建構函式來建立一個物件。

使用工廠方法建立物件的好處:
1、工廠方法的返回值並不一定是宣告型別的例項,它可以是它子類的例項。使用工廠方法可以更好的體現面嚮物件語言中多型的優勢,程式碼也會顯得更加簡潔。
2、每次返回的物件並不一定都是新建立的物件,完全可以將其快取。相比之下,每次呼叫建構函式都會建立一個例項,而一個工廠方法可以快取以前建立的物件,並重用他們,從而節省了記憶體。
3、對同步控制,在工廠方法中可以將建立物件前後的相應程式碼進行統一處理。建構函式對這一種情況就無能為力。

API設計技巧三:
讓所有的內容不可改,如果不考慮讓其擁有子類,就應該讓這個類不能被繼承。
強烈推薦:不公開建構函式,轉而提供工廠方法

API設計技巧四:
避免濫用set方法,在不部分情況下set方法是多餘的。
建議:小心API中的每一個不必要的set方法

API設計技巧五:
儘可能通過友元的方式來公開功能。為了讓使用者更加簡單明瞭地使用好你的API,就不要再你的API中公開太多的方法,不要給使用者犯錯的機會。

API設計技巧六:
避免暴露深層次繼承。一旦發現繼承體系超過兩層時,一定要打住,並多多思考一下,要弄清楚:“我到底設計API還是在複用程式碼?”如果答案是後者,那麼重新審視,並嚴格設計這個API,或者做好子類化的準備。
以上是雲棲社群小編為您精心準備的的內容,在雲棲社群的部落格、問答、公眾號、人物、課程等欄目也有的相關內容,歡迎繼續使用右上角搜尋按鈕進行搜尋c語言 api 約瑟夫問題c語言詳解、vc 深入詳解 孫鑫 pdf、servlet jsp深入詳解、vc 深入詳解、深入理解java泛型詳解,以便於您獲取更多的相關知識。