怎么使用微软的 ‘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_MACHINESOFTWAREWow6432NodeMicrosoftCppRestSDKOpenSourceReleaseP�1.3SDK中.不幸的是,一些SDK版本不会检查属性值,如果你不用上述的120替换掉110这个值,就不能成功生成对应工程。因为,不替换对应值的话,在生成项目的过程中,找不到正确的注册表入口。C++ REST SDK中提供的样例,也存在这样的问题,因此你必须在属性文件中替换相应值,才能正确生成项目文件。

未修改属性文件:

$([MSBuild]::GetRegistryValue(`HKEY_LOCAL_MACHINESoftwareMicrosoftCppRestSDKOpenSourceReleaseH�$(CppRestSDKVersionString)SDK`, `InstallDir`))

$(CppRestBaseFileName)110$(DebugFileSuffix)_$(CppRestSDKVersionFileSuffix)

修改后的属性文件:

$([MSBuild]::GetRegistryValue(`HKEY_LOCAL_MACHINESoftwareMicrosoftCppRestSDKOpenSourceReleaseP�$(CppRestSDKVersionString)SDK`, `InstallDir`))

$(CppRestBaseFileName)120$(DebugFileSuffix)_$(CppRestSDKVersionFileSuffix)

现在,打开在你喜欢的文本编辑器中,打开你的C++项目对应Visual Studio 中的vcxproj文件,在Project中加入下面一行。这样,你的项目就可以包含CppRest.props中的定义。值得注意的是,CppRest.props中有一行是引入已经拷贝的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++编程的小伙伴可以查看小编主页加群哦~小编这里有免费资源可以送给你的!

你可能感兴趣的:(怎么使用微软的 ‘C++ REST SDK’?)