GPRS開發(fā)系列文章之進階篇
一、前言
在前篇《GPRS開發(fā)系列文章之入門篇》里,我主要對GPRS開發(fā)中遇到的一些常用概念和一些業(yè)務(wù)邏輯做了簡單的介紹,沒想到得到了很多網(wǎng)友的支持和關(guān)注,因昨天有事因此延遲到今天才奉上這篇進階系列文章,還請各位見諒。希望大家支持同時歡迎拍磚,共同提高。
在最后一篇《GPRS開發(fā)系列文章之實戰(zhàn)篇》我將詳細敘述如何利用類庫開發(fā)Client和Server端通信程序,因此本文的多數(shù)講解將是為下文服務(wù)的。本文將向您介紹基于PPC2003的Windows mobile 系列的客戶端和基于.Net 2005的服務(wù)器端進行開發(fā)所需掌握和了解的開發(fā)庫,并著重圍繞客戶端進行GPRS連接所用到的一些API函數(shù)進行講解。本文的最后是一些用于引用和學(xué)習(xí)用的鏈接和利用API建立GPRS連接的demo,感興趣的同志可以去點擊或下載后進行深入研究。
關(guān)于客戶端API的敘述我基本上都是翻譯過來的,如欠妥還請各位多多斧正!同時demo程序我也是只做了部分加工,主要都是參照了謝紅偉的發(fā)表的文章(后面有引用鏈接)
二、進階系列篇詳解
1. 客戶端建立GPRS連接 API
客戶端開發(fā)采用 EVC4.0進行開發(fā),主要講解的類庫為Connection Manager 系列API,客戶端在進行GPRS撥號連接時將使用下文所介紹的API。
Connection Manager(本人譯為 連接管理器,此對象為一系列API的集合) 系列API的主要目的是為了集中管理基于Windows Mobile系列的設(shè)備網(wǎng)絡(luò)連接的建立與維護。移動應(yīng)用程序使用 連接管理器API去建立或規(guī)劃一個網(wǎng)絡(luò)連接,而連接管理器則掌控連接過程中的所有狀態(tài)信息.應(yīng)用程序在要發(fā)起一個連接(比如Internet),只要簡單的告知連接管理器就OK了。
當(dāng)一個應(yīng)用程序發(fā)起一個網(wǎng)絡(luò)連接的請求時,連接管理器首先從連接服務(wù)提供商(CSPS)處獲取所有可能的連接信息,然后連接管理器會從這一系列連接信息中根據(jù)開銷,延遲、帶寬等因素來選擇一個最佳的連接,最后連接管理器將被請求的連接排入隊列,然后在一個適合的時間使用CSPS來建立連接。
【API函數(shù)】:
a) ConnMgrApiReadyEvent()函數(shù)
函數(shù)原型:HANDLE WINAPI ConnMgrApiReadyEvent();
利用此函數(shù)來我們可以返回一個連接事件的句柄 ,注意在的得到句柄后要記得及時釋放
b) ConnMgrConnectionStatus()函數(shù)
函數(shù)原型:
HRESULT WINAPI ConnMgrConnectionStatus(HANDLE hConnection,DWORD * pdwStatus );利用此函數(shù)的返回值pdwStatus,我們可以得到很多的關(guān)于連接的信息,例如如果我們連接成功將返回CONNMGR_STATUS_CONNECTED,斷開連接將返回CONNMGR_STATUS_DISCONNECTED,他的返回狀態(tài)信息非常豐富,有14中之多,完全可以滿足我們的應(yīng)用需要;
c) ConnMgrEnumDestinations()函數(shù)
函數(shù)原型:
HRESULT WINAPI ConnMgrEnumDestinations(int nIndex,CONNMGR_DESTINATION_INFO * pDestInfo );
一般我們的PDA在連接GPRS時都有好幾個連接,利用此函數(shù)我們可以枚舉出所有可用的連接,然后再對挑選的連接進行篩選得到一個最佳連接
接下來講兩個很重要的函數(shù),我們將利用兩個函數(shù)中的一個來發(fā)起連接,他們是:
d) ConnMgrEstablishConnection()和ConnMgrEstablishConnectionSync()函數(shù),這兩個函數(shù)一個用于發(fā)起一個異步連接請求,一個用于同步請求,使用異步連接請求我們可以在發(fā)起連接后立即返回,而使用同步請求客戶端將一直被阻塞知道函數(shù)返回確認連接,關(guān)于異步和同步我就不再敘述;
它們的原型依次為:
HRESULT WINAPI ConnMgrEstablishConnection( CONNMGR_CONNECTIONINFO * pConnInfo, HANDLE * phConnection );
HRESULT WINAPI ConnMgrEstablishConnectionSync( CONNMGR_CONNECTIONINFO * pConnInfo, HANDLE * phConnection, DWORD dwTimeout, DWORD * pdwStatus );
可以看到兩個函數(shù)的第一個參數(shù)都為一個CONNMGR_CONNECTIONINFO對象,此對象為一個結(jié)構(gòu)體,它保存了客戶端發(fā)起連接請求的一系列信息,因此,在我們調(diào)用此函數(shù)時必須構(gòu)造一個該對象,然后將其作為參數(shù)傳入連接函數(shù)中。這里很有必要講一下該結(jié)構(gòu)體,該結(jié)構(gòu)體的原型如下:
typedef struct _CONNMGR_CONNECTIONINFO
{
DWORD cbSize; DWORD dwParams;DWORD dwFlags;
DWORD dwPriority;BOOL bExclusive;BOOL bDisabled;GUID guidDestNet;
HWND hWnd; UINT uMsg; LPARAM lParam;ULONG ulMaxCost; ULONG ulMinRcvBw;
ULONG ulMaxConnLatency;
} CONNMGR_CONNECTIONINFO;
其中參數(shù)dwFlags用于指定我們的接入點,比如我們常說的CMNER和CMWAP,而參數(shù)GUID則標志了我們對應(yīng)于每個接入點的全球唯一標志符,關(guān)于如何得到或者查看GUID,我們可以在“Program FilesWindows CE Toolswce420POCKET PC 2003IncludeArmv4”目錄下查看connmgr.h文件,里面包含了各個接入點的GUID,例如:
CMNET 為:(0x436ef144, 0xb4fb, 0x4863, 0xa0, 0x41, 0x8f, 0x90, 0x5a, 0x62, 0xc5, 0x72)
CMWAP為:0x7022e968, 0x5a97, 0x4051, 0xbc, 0x1c, 0xc5, 0x78, 0xe2, 0xfb, 0xa5, 0xd9
如果想更進一步了解,我們還可以通過查看注冊表方式來查看PDA上連接管理器的相關(guān)連接信息,在PPC 2003中注冊表路徑為:
[HKEY_LOCAL_MACHINECommConnMgr],如下圖所示:
在Destinations一項中就對應(yīng)我們所有可用的網(wǎng)絡(luò)連接,這個跟用ConnMgrEnumDestinations()方法得到的是一樣的效果,在默認Internet設(shè)置中我們將看到CMNET的GUID,如下所示:
在這里里面有DestId一項,就對應(yīng)著我們久違的GUID
e) ConnMgrReleaseConnection函數(shù)
我們在上一步中建立連接后我們將得到一個連接句柄,在重新開始一個新的連接或者斷開連接都要調(diào)用此函數(shù)來釋放掉之前創(chuàng)建的連接,它的原型為:[!--empirenews.page--]
HRESULT WINAPI ConnMgrReleaseConnection( HANDLE hConnection,BOOL bCache );
【連接管理API大致使用步驟】:
首先我們利用ConnMgrApiReadyEvent()函數(shù)來確認是否有可用連接,如果有可用連接我們則利用ConnMgrEnumDestinations()函數(shù)枚舉所有可用連接,然后遍歷所有連接調(diào)用我們的同步或異步連接方法ConnMgrEstablishConnectionSync()與ConnMgrEstablishConnection()來發(fā)起連接,一旦連接成功后我們就可以進行我們偉大的下一步了,就是和我們的服務(wù)器進行通信。
【GPRS demo效果圖】
【GPRSDemo介紹】
GPRSDemo主要利用了上述的幾個重要的API函數(shù)來獲取當(dāng)前可用連接,并自動選擇一個最佳的連接途徑,然后啟用這個連接,在連接啟動成功以后再用socket 進行網(wǎng)絡(luò)連接,與公網(wǎng)服務(wù)器進行通信。
首先檢查是否有可用連接
BOOL CConnectManager::GetConnMgrAvailable()
{
HANDLE hConnMgr = ConnMgrApiReadyEvent ();
BOOL bAvailbale = FALSE;
DWORD dwResult = ::WaitForSingleObject ( hConnMgr, 2000 );
if ( dwResult == WAIT_OBJECT_0 )
{
bAvailbale = TRUE;
}
// 關(guān)閉
if ( hConnMgr ) CloseHandle ( hConnMgr );
return bAvailbale;
}
然后枚舉所有可用連接:
void CConnectManager::EnumNetIdentifier ( OUT CStringArray &StrAry )
{
CONNMGR_DESTINATION_INFO networkDestInfo = {0};
// 得到網(wǎng)絡(luò)列表
for ( DWORD dwEnumIndex=0; ; dwEnumIndex++ )
{
memset ( &networkDestInfo, 0, sizeof(CONNMGR_DESTINATION_INFO) );
if ( ConnMgrEnumDestinations ( dwEnumIndex, &networkDestInfo ) == E_FAIL )
{
break;
}
StrAry.Add ( networkDestInfo.szDescription );
}
}
接下來找到“Internet”這個連接,可用遠程URL映射的方式來完成,這樣可以讓系統(tǒng)自動選取一個最好的連接。
int CConnectManager::MapURLAndGUID ( LPCTSTR lpszURL, OUT GUID &guidNetworkObject, OUT CString *pcsDesc/*=NULL*/ )
{
if ( !lpszURL || lstrlen(lpszURL) < 1 )
return FALSE;
memset ( &guidNetworkObject, 0, sizeof(GUID) );
int nIndex = 0;
HRESULT hResult = ConnMgrMapURL ( lpszURL, &guidNetworkObject, (DWORD*)&nIndex );
if ( FAILED(hResult) )
{
nIndex = -1;
DWORD dwLastError = GetLastError ();
AfxMessageBox ( _T("Could not map a request to a network identifier") );
}
else
{
if ( pcsDesc )
{
CONNMGR_DESTINATION_INFO DestInfo = {0};
if ( SUCCEEDED(ConnMgrEnumDestinations(nIndex, &DestInfo)) )
{
*pcsDesc = DestInfo.szDescription;
}
}
}
return nIndex;
}
最后啟用指定編號的連接并檢查連接狀態(tài)
BOOL CConnectManager::EstablishConnection ( DWORD dwIndex )
{
// 釋放之前的連接
ReleaseConnection ();
// 得到正確的連接信息
CONNMGR_DESTINATION_INFO DestInfo = {0};
HRESULT hResult = ConnMgrEnumDestinations(dwIndex, &DestInfo);
BOOL bRet = FALSE;
if(SUCCEEDED(hResult))
{
// 初始化連接結(jié)構(gòu)
CONNMGR_CONNECTIONINFO ConnInfo;
ZeroMemory(&ConnInfo, sizeof(ConnInfo));
ConnInfo.cbSize = sizeof(ConnInfo);
ConnInfo.dwParams = CONNMGR_PARAM_GUIDDESTNET;
ConnInfo.dwFlags = CONNMGR_FLAG_PROXY_HTTP | CONNMGR_FLAG_PROXY_WAP | CONNMGR_FLAG_PROXY_SOCKS4 | CONNMGR_FLAG_PROXY_SOCKS5;
ConnInfo.dwPriority = CONNMGR_PRIORITY_USERINTERACTIVE;
ConnInfo.guidDestNet = DestInfo.guid;
ConnInfo.bExclusive = FALSE;
ConnInfo.bDisabled = FALSE;
DWORD dwStatus = 0;
hResult = ConnMgrEstablishConnectionSync(&ConnInfo, &m_hConnection, 10*1000, &dwStatus );
if(FAILED(hResult))
{
m_hConnection = NULL;
}
else bRet = TRUE;
}
return bRet;
}
檢測連接狀態(tài)
BOOL CConnectManager::WaitForConnected ( int nTimeoutSec, DWORD *pdwStatus/*=NULL*/ )
{
DWORD dwStartTime = GetTickCount ();
BOOL bRet = FALSE;
while ( GetTickCount ()-dwStartTime < (DWORD)nTimeoutSec * 1000 )
{
if ( m_hConnection )
{
DWORD dwStatus = 0;
HRESULT hr = ConnMgrConnectionStatus ( m_hConnection, &dwStatus );
if ( pdwStatus ) *pdwStatus = dwStatus;
if ( SUCCEEDED(hr) )
{
if ( dwStatus == CONNMGR_STATUS_CONNECTED )
{
bRet = TRUE;
break;
}
}
}
Sleep ( 100 );
}
return bRet;
}
最后要記得釋放連接
void CConnectManager::ReleaseConnection ()
{
if ( m_hConnection )
{
ConnMgrReleaseConnection(m_hConnection, FALSE);
m_hConnection = NULL;
}
}
2. 客戶端與服務(wù)器端進行socket通信APIsocket通信相關(guān)開發(fā)API在Winsock2.h.文件中定義,因為SOCKET通信不是本文的重點但是又是必須要涉及的[!--empirenews.page--]
a) WSAStartup函數(shù)。在應(yīng)用程序進行Windows Sockets通信時,必須首先調(diào)用此函數(shù)來指定應(yīng)用程序要加載的Windows Scoket版本等信息,應(yīng)用程序結(jié)束前我們應(yīng)該調(diào)用WSACleanup去釋放掉所用的系統(tǒng)資源
b) Connect 函數(shù)。此函數(shù)用來建立連接
c) Select 函數(shù)。建立連接后,用來偵聽是否有數(shù)據(jù)傳輸
d) Send函數(shù)。用于給服務(wù)器發(fā)送消息
3. 服務(wù)器端與客戶端進行socket通信
服務(wù)器端主要涉及到的庫為:
System.Net,System.Net.Sockets,System.IO;
System.Net 命名空間為當(dāng)前網(wǎng)絡(luò)上使用的多種協(xié)議提供了簡單的編程接口,System.Net.Sockets 命名空間為需要嚴密控制網(wǎng)絡(luò)訪問的開發(fā)人員提供了Windows Sockets (Winsock) 接口的托管實現(xiàn)。
System.IO 命名空間包含允許讀寫文件和數(shù)據(jù)流的類型以及提供基本文件和目錄支持的類型。
需要了解的技術(shù)有:多線程,事件與委托,SOCKET通信等