?應用程序接口API是什么
接口是一個抽象概念,一般有好幾種層面的接口。Interface可翻譯為界面也可翻譯為接口,翻譯為接口的由來應該是從電器的插口而來(未做考證)。通俗說法:接口就是用來連接而開放的入口。大致有這些類型的接口:硬件接口、用戶界面(UI)、軟件接口、面向對象接口。
至于API一般僅僅限于應用程序的編程接口。通俗的解釋應該是:一個組件(或程序庫)提供給開發者進行編程使用的,通過代碼可以與之溝通的入口。比如說你下載了一個控件包,通過閱讀說明你知道應該如何創建上下文、初始化、設置屬性、調用、回調、事件處理,這些就是這個控件包的API。
API一般對應函數,在面向對象領域可能對應類提供的特性,而對于傳輸協議一般指協議的一種實現所提供的使用該協議的方式。
返回值? ?方法名(參數1, 參數2 。。。) 這就可以認為是接口。
應用程序接口為:“‘計算機操作系統(Operating system)’或‘程序庫’提供給應用程序調用使用的代碼”。其主要目的是讓應用程序開發人員得以調用一組例程功能,而無須考慮其底層的源代碼為何、或理解其內部工作機制的細節。API本身是抽象的,它僅定義了一個接口,而不涉入應用程序如何實現的細節。例如,圖形庫中的一組API定義了繪制指針的方式,可于圖形輸出設備上顯示指針。當應用程序需要指針功能時,可在引用、編譯時鏈接到這組API,而運行時就會調用此API的實現(庫)來顯示指針。
應用程序接口API,就是軟件系統不同組成部分銜接的約定。由于近年來軟件的規模日益龐大,常常需要把復雜的系統劃分成小的組成部分,編程接口的設計十分重要。程序設計的實踐中,編程接口的設計首先要使軟件系統的職責得到合理劃分。良好的接口設計可以降低系統各部分的相互依賴,提高組成單元的內聚性,降低組成單元間的耦合程度,從而提高系統的維護性和擴展性。應用程序接口是一組數量上千、極其復雜的函數和副程序,可讓程序員做很多任務作,譬如“讀取文件”、“顯示菜單”、“在視窗中顯示網頁”等等。操作系統的API可用來分配存儲器或讀取文件。許多系統應用程序借由API接口來實現,像是圖形系統、數據庫、網絡Web服務,甚至是在線游戲。應用程序接口有諸多不同設計。用于快速執行的接口通常包括函數、常量、變量與數據結構。也有其它方式,如通過解釋器,或是提供抽象層以屏蔽同API實現相關的信息,確保使用API的代碼無需更改而適應實現變化。
應用程序接口經常是軟件開發工具包(SDK)的一部分
API又分為(Windows、Linux、Unix等系統的)系統級API,及非操作系統級的自定義API。作為一種有效的代碼封裝模式,微軟Windows的API開發模式已經為許多商業應用開發的公司所借鑒,并開發出某些商業應用系統的API函數予以發布,方便第三方進行功能擴展。如Google、蘋果電腦公司,以及諾基亞等手機開發的API等等。
#e#
關于API使用
網上有很多API教程,但是都是針對單個API的使用來講解,但是如果遇到網上沒有教程的API呢?如下教程的目的就是這樣:當遇到一個不會的API的時候,懂得如何利用資料學會使用這個API。
本文讀者需具備的知識:
1、VB的基本語法
2、API、結構體、常數
3、VB的數據類型,C語言的簡單數據類型
4、API Viewer 2004(或其他同類軟件)的基本使用
5、一定的英文閱讀能力
那么要調用一個陌生的API,基本上遵循以下步驟
1、找到相關API、結構體、常數的聲明
2、到MSDN閱讀這個API的網頁指南
3、按照MSDN寫代碼
實戰演示:
這次實戰的目標是:GetOpenFileName
首先介紹一下這個API吧,這個API會顯示一個打開對話框,給用戶選擇一個文件打開
這個跟CommonDialog里面的打開對話框是一樣的(那干嘛不直接用那個控件?教程用來做演示嘛,而且用API也有他的好處)
第一步:找到聲明
找聲明主要有兩種方法
第一種是通過軟件找,例如API Viewer 2004,這類軟件內置有絕大部分常用的聲明,直接復制即可,方便快捷
第二種是去MSDN找到API的頁面,然后復制聲明。MSDN是微軟的網站,聲明肯定是準確的,但是對于VB開發者的劣勢是,絕大部分聲明都是按照C語言的格式的(至今沒見過一個API的頁面有VB聲明),所以如果不懂C語言的話要轉換成VB的聲明難度就大了
還有其他方法,例如dump dll文件之類的
本文主要討論第一種方法,使用的軟件是API Viewer 2004,其他同類軟件操作大同小異
打開API Viewer 2004,打開Win32api.apv文件,然后選擇Declarations一欄,然后選擇Subs and Functions,在文本框輸入GetOpenFileName,然后就找到這個API的聲明了,復制下來,扔進VB的代碼里面
好了,現在來仔細看一下這個聲明:
Private Declare Function GetOpenFileName Lib “comdlg32.dll” Alias “GetOpenFileNameA” (ByRef pOpenfilename As OPENFILENAME) As Long
可以看到這里有一個陌生的參數類型OPENFILENAME,這明顯不是VB的基本數據類型,所以我們需要這個OPENFILENAME的聲明
于是回到API Viewer 2004,選擇Types一欄,在文本框輸入OPENFILENAME,找到聲明了,復制下來,扔到VB代碼里面
Private Type OPENFILENAME
lStructSize As Long
hwndOwner As Long
hInstance As Long
lpstrCustomFilter As String
nMaxCustFilter As Long
nFilterIndex As Long
lpstrFile As String
nMaxFile As Long
lpstrFileTitle As String
nMaxFileTitle As Long
lpstrInitialDir As String
lpstrTitle As String
flags As Long
nFileOffset As Integer
nFileExtension As Integer
lpstrDefExt As String
lCustData As Long
lpfnHook As Long
lpTemplateName As String
End Type
繼續仔細看這個結構體的聲明,可以發現成員都是VB的基本數據類型,說明不需要在找其他聲明了
第二步:閱讀MSDN對于這個API的解釋 & 第三步:按照MSDN寫代碼
這里說的MSDN不是按F1出來那個MSDN,而是MSDN網站msdn.microsoft.com。這個是微軟的官方開發者網站,里面資料齊全絕對是開發者的天堂
網站有中文版本和英文版本,不過強烈建議大家看英文版本,中文版的翻譯質量不好(這就是為什么要求有一定的英文閱讀能力)
好吧進入了這個官網之后,在最上面的Bing搜索里面打GetOpenFileName,然后搜索
出來的結果,一般選擇xxxx function這種頁面,這里選的就是第一個結果GetOpenFileName function
http://msdn.microsoft.com/en-us/library/windows/desktop/ms646927(v=vs.85).aspx
頁面打開了,可以看到這個頁面分成幾大節:
開頭:對API的簡單介紹
Syntax:語法,也就是API的聲明
Return Value:返回值
Remarks:一些附加的說明
Examples:示例代碼,一般都是用C語言寫的
Requirements:API對系統的要求等等
See Also:與此相關的API等
Community Additions:其他人對此文章的評論
網頁左欄:是整個站點的分類目錄
好吧,英文不好的同學要加油了,混國外網站英文是必須要會的
不要覺得一個API能有這么多內容,很多信息都是很有用很關鍵的,耐心從上往下一節一節讀完
開頭:這個自己看就是了,對API的介紹和描述,不是很重要的部分(不過有時會有很重要的批注,例如此API不再被微軟支持建議用xxx代替之類的)
Syntax:這個就是API的語法,也就是聲明啦,C語言的,所以對我們沒什么用,可以跳掉不看
如果要根據這個C語言的聲明自己寫出VB的聲明,還是需要一定的C語言數據類型的知識
PS:這里為什么返回值是BOOL,但是我們的聲明是Long呢?是不是應該把我們的VB聲明改成Boolean?不需要的。BOOL在C里面的定義就是long型(unsigned long?具體忘了,差不多這類東西),占用4字節,所以應該對應VB的Long型。當然,你閑著蛋疼也可以把返回值聲明成Single型,同樣也是4字節,不過沒什么意義
Parameters:API的參數部分啦,整個網頁最重要的部分之一
按照這里的解釋,填寫參數就可以調用API了
好吧這里只有一個參數,網頁寫的是
lpofn [in, out]
Type: LPOPENFILENAME
這個[in, out]是什么意思呢?in表示這個是個輸入參數,這個參數的值會作為輸入對API的結果進行影響。out表示這個同時也是個輸出參數,API會把部分數據返回到這個參數里面。(除了in和out,有些還會出現optional,表示這是個可選參數)
LPOPENFILENAME說的就是參數的類型,等等,我們的聲明不是寫的類型是OPENFILENAME嗎,怎么這里多了個LP?這個是C語言里指針的意思(long pointer?),意思是當調用API的時候,不是把這個整個OPENFILENAME結構體的數據傳過去,而是只把這個結構體的指針傳過去。同樣的寫法還有xxx*,例如OPENFILENAME*
接下來看他對這個參數的描述,大致是這個參數裝載著啟動這個API的參數,當API返回的時候會把結果放到這個結構體里面
說的基本都是廢話,這個結構體有這么多成員,我們還是不知道怎么填,那么就點進去這個OPENFILENAME的鏈接
點進去之后,發現這個OPENFILENAME文章結構也差不多
Syntax可以跳過,我們已經從API Viewer 2004里面找到聲明了(PS:后面這個#if和#endif中間的是什么東西呢?這個是C的預編譯指令,具體可以自己去看,在這里沒什么用)
Members,終于在講解這些成員的意思了,好吧可以開始寫代碼了,首先在VB里面寫
Dim ofn As OPENFILENAME
With ofn
End With
那么接下來就一個一個看成員,看他的解釋,是什么意思,應該怎么填
需要注意的一些東西是,不像API的參數,并沒有告訴你每個成員是作為輸入還是輸出的作用,需要自己認真讀解釋
lStructSize,Type: DWORD
結構體的字節大小,用sizeof(OPENFILENAME)獲得
sizeof其實就是C語言里面獲得結構體大小的函數,那VB里面我們就用LenB吧(Len也行,不過按照MSDN的說法還是用LenB吧)
(PS:DWORD對應VB的Long)
代碼:.lStructSize = LenB(ofn)
hwndOwner,Type: HWND
這個對話框的父窗體的句柄,可以設置成NULL
那我們就做成父窗體是我們的Form1吧
(PS:HWND也是對于VB的Long,NULL則是0)
代碼:.hwndOwner = Me.hWnd
hInstance,Type: HINSTANCE
如果要指定對話框的模板,那么這個需要填上模板所在的程序句柄
我們沒興趣用什么模板,windows自帶的那個已經夠好看了,不理他填個NULL
代碼:.hInstance = 0
lpstrFilter,Type: LPCTSTR
文件類型過濾器,格式為 描述文字