1. 程式人生 > >怎麼使用微軟的 ‘C++ REST SDK’?

怎麼使用微軟的 ‘C++ REST SDK’?

有想學習c/c++程式設計的小夥伴要加油哦~

微軟的SDK已經出來很久了,有些小夥伴都曾經使用過,但是呢,還是有更多小夥伴沒有能夠弄清楚,今天我麼就來看看在VS2013中怎麼使用微軟的SDK吧!

SDK讓你可以在C++中使用REST服務

Visual Studio 2013中包括了C++ REST SDK version 1.0(也稱為Casablanca)。這個微軟的開源專案包括在CodePlex中,這個專案同時也利用了c++11中的新特點,設計了現代、非同步、多平臺API,從而簡化了基於雲端的程式設計。這是兩篇關於C++ REST SDK系列文章的第一篇,我會介紹如何通過SDK來使用REST服務。在下一篇文章中,我將介紹怎樣利用SDK來檢索和傳送JSON檔案。

理解C++ REST SDK結構

當你需要最佳效能時,你往往會在本地進行評估,那麼C++就是最佳選擇之一。微軟認為C++在雲端也是很有價值的,微軟最新的C++ REST SDK使得開發者可以通過C++來呼叫REST服務,從而滿足高效能和可擴充套件的要求。它讓你在C++中就可以呼叫REST服務或者是編寫其他與雲端計算相關的程式碼。

如果你正在使用C++來呼叫雲端服務,但是你在回撥函式中使用基於C語言的同步API,那麼你沒用充分利用最新C++版本的高明之處。同時,你的程式碼可能會很難閱讀和除錯,同步的API使得你很難設計一個反應敏捷的使用者介面(UI)。大部分現代的WEB API都儘量減少不必要的樣板,並且提供非同步方法。這些方法避免了C風格的回撥函式的複雜性。

比如,你正在使用C++,但是你利用它,通過呼叫一個同步的基於C的API,來進行HTTP的GET呼叫,那麼這樣做的效率是不能和其他程式語言比如C#、Python相提並論的。微軟基於並行模式庫PPL研發了C++ REST SDK,並且利用了PPL的基於任務程式設計模型。無論何時,你利用C++ REST SDK執行非同步操作,你都建立了一個新的PPL任務。為了讓C++ REST SDK可以移植到Linux平臺上,微軟確保PPL的關鍵部分可以在Linux上執行(並且使用GCC編譯)。因此,C++ REST SDK為依賴C++ 11的C++提供了一個併發執行環境。不同於使用回撥函式,你可以優雅地編寫C++11標準的程式碼來建立任務並且在其他任務執行完畢後,排程任務。如果你之前有過PPL的程式設計經驗,你會發現使用C++ REST SDK非常簡單。

C++ REST SDK基於如下的四個底層棧或是API,這些棧或是API是基於不同作業系統提供的服務。(見Figure1)

WinHTTP:也稱為Microsoft Windows HTTP Services. 這是一個基於C語言的HTTP客戶端API。

PPL( Parallel Patterns Library的簡稱): 構成非同步操作的程式設計模型。C++ REST SDK 在不同的Windows版本中使用WinHTTP 。

Boost.Asio: 跨平臺的C++庫,可以用於網路程式設計或是底層的I/O程式設計。它提供了一致的非同步模型。該庫採用現代C++方法。 C++ REST SDK 使用Boost.Asio 在Linux平臺上管理通訊。

HTTP.sys: Windows 伺服器端的HTTP。C++ REST SDK 在不同的Windows版本中使用 HTTP.sys。

目前(寫成本文時),C++ REST SDK支援以下作業系統。特別注意,對Windows XP 系統和Windows Phone 8.x系統的支援,還在試驗階段。

Windows XP

Windows Vista

Windows 7

Windows 8.x

Windows Phone 8.x

Linux

C++ REST SDK還包括如下部分,這些功能使用了不同的底層棧(見Figure 2):

Asynchronous streams and stream buffers(非同步流和流緩衝區):這部分提供了一種基本的非同步流,一種基本的非同步流緩衝區,以及許多實現,比如非同步檔案流。有一些特定的互操作流,可以支援STL iostreams和C++ REST SDK非同步流之間的互相操作。

HTTP client and listener(HTTP客戶端與監聽):HTTP客戶端允許你獲得與HTTP服務的連線,並且向伺服器傳送請求。 HTTP監聽讓你可以從指定的URI接收資訊。

JSON parser and writer(JSON解析和寫入): JSON對於像C++之類的靜態語言是一個挑戰。 C++ REST SDK 中使用一個單獨的類(web::json::value)來表示JSON值,並且提供了必要的操作來幫助資料序列化 。你可以在程式碼執行階段,宣告與JSON數值相關的型別。 C++ REST SDK 允許你通過JSON解析從流中讀取JSON資料,以及向流中寫入JSON資料。

TCP client and listener(TCP客戶端與監聽):TCP客戶端為TCP網路服務提供了客戶端連線。TCP監聽會持續監聽TCP客戶端的網路連線。TCP客戶端與監聽的最大優勢在於,可以完成非阻塞非同步操作。但是,這些元件仍然在實驗階段。如果你要使用System.Net.Sockets::TcpListener或者System.Net.Sockets::TcpClient類,你要適應使用實驗版的TCP客戶端和監聽,以及它們提供的簡單的非阻塞非同步操作。

微軟的C++ REST SDK團隊計劃在不久的將來,在系統中增加如下部分:

Web Sockets client and listener. WEB Socket客戶端與箭筒

UDP client and listener. UDP 客戶端與監聽

Additional product-specific APIs built on top of the C++ REST SDK, such as Azure Storage, Mobile Services, and Bing Maps. 基於C++ REST SDK的其他產品專用API,比如Azure儲存,移動服務和Bing地圖。

在Visual Studio 工程中使用C++ REST SDK

在Visual Studio中建立使用SDK的專案並且成功生成該專案,你需要從CodePlex(http://casablanca.codeplex.com/)下載並安裝最新的SDK。在本文中,使用的是1.3版本。如果你下載的不是這一版本,你要在相應的配置值上做出調整。

版本1.3中預設的安裝資料夾是C:Program Files (x86)Microsoft Cpp REST SDK for VS 2013 v1.3SDK.VSProject子資料夾下有兩個屬性檔案與你的Visual Studio工程相對應:CppRest.propsandversion.props.

當你在Visual Studio中建立了你準備使用C++ REST SDK的工程之後,你必須按照下列步驟操作:

將C++ REST SDK安裝資料夾下的兩個屬性檔案,即VSProject子資料夾中的CppRest.props以及version.propswe檔案,複製到你建立Visual Studio專案的主資料夾中。

開啟cpprest.props屬性檔案,其中的兩個屬性問價可能有錯誤值:CppRestSDKPathandCppRestRuntimeBaseFileName.如下圖所示,如果你找到了下面的兩行,你要將其中110替換為120。在64-bit的Windows版本中,規定了C++ REST SDK基本安裝資料夾的屬性值是InstallDir,這個屬性值在HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftCppRestSDKOpenSourceReleaseP1.3SDK中.不幸的是,一些SDK版本不會檢查屬性值,如果你不用上述的120替換掉110這個值,就不能成功生成對應工程。因為,不替換對應值的話,在生成專案的過程中,找不到正確的登錄檔入口。C++ REST SDK中提供的樣例,也存在這樣的問題,因此你必須在屬性檔案中替換相應值,才能正確生成專案檔案。

未修改屬性檔案:

<CppRestSDKPath>$([MSBuild]::GetRegistryValue(`HKEY_LOCAL_MACHINESoftwareMicrosoftCppRestSDKOpenSourceReleaseH$(CppRestSDKVersionString)SDK`, `InstallDir`))</CppRestSDKPath>

<CppRestRuntimeBaseFileName>$(CppRestBaseFileName)110$(DebugFileSuffix)_$(CppRestSDKVersionFileSuffix)</CppRestRuntimeBaseFileName>

修改後的屬性檔案:

<CppRestSDKPath>$([MSBuild]::GetRegistryValue(`HKEY_LOCAL_MACHINESoftwareMicrosoftCppRestSDKOpenSourceReleaseP$(CppRestSDKVersionString)SDK`, `InstallDir`))</CppRestSDKPath>

<CppRestRuntimeBaseFileName>$(CppRestBaseFileName)120$(DebugFileSuffix)_$(CppRestSDKVersionFileSuffix)</CppRestRuntimeBaseFileName>

現在,開啟在你喜歡的文字編輯器中,開啟你的C++專案對應Visual Studio 中的vcxproj檔案,在Project中加入下面一行。這樣,你的專案就可以包含CppRest.props中的定義。值得注意的是,CppRest.props中有一行是引入已經拷貝的CppRest.props配置檔案:<Import Project=”CppRest.props” />

在Visual Studio中開啟對應專案,開啟專案屬性。在Configuration Properties | VC++ Directories中的include Directories屬性中加入C++ REST SDK安裝路徑下include子資料夾的完整路徑。如果你使用的是預設安裝資料夾,你需要新增的屬性值為C:Program Files (x86)Microsoft Cpp REST SDK for VS 2013 v1.3SDKinclude。

在Configuration Properties | VC++ Directories中Library Directories屬性中加入C++ REST SDK安裝路徑下lib子資料夾的完整路徑.如果你使用的是預設安裝資料夾,那麼你需要新增的屬性值為C:Program Files (x86)Microsoft Cpp REST SDK for VS 2013 v1.3SDKlib.

新增C++ REST SDK庫。具體來說,在Configuration Properties | Linker | Input中的Additional Dependencies加入cpprest120d_1_3.lib檔案。

現在,你的C++專案就可以開始和C++ REST SDK一起工作了。(你也可以在 Package Manager Console控制檯,通過執行命令Install-Package cpprestsdk來安裝最新版本的C++ REST SDK,同時,使用相應包來向已經建立的專案新增C++ REST SDK並完成相應設定。但是,在新專案中使用最新版本SDK的最佳方法,是按照上文所述的步驟進行配置和新增。)

最後,小編在說一句,有需要VS2013或者VS2017學習c/c++程式設計的小夥伴可以加群:941636044哦~小編這裡有免費資源可以送給你的!