码迷,mamicode.com
首页 > Web开发 > 详细

DICOM:剖析Orthanc中的Web Server, Mongoose

时间:2015-01-25 12:32:28      阅读:331      评论:0      收藏:0      [点我收藏+]

标签:orthanc   dicom   

背景:

        

        DICOM专栏文章中介绍过解构PACS(分布式PACS)Orthanc的安装和使用,以及相关插件、SQLite数据库等主要模块的分析,此次简单介绍Orthanc中嵌入的Web Server,Mongoose。依托于Mongoose这一轻量级Web Server,Orthanc很好的实现了RESTful API与传统DICOM服务的整合,这也是实现分布式PACS的关键。博文中先给出Mongoose的安装和简单的与C/C++的嵌入式编程,让大家对Mongoose有一个初步的认识,后续再深入分析。

Mongoose Web Server:

        

        Mongoose Web Server的官网地址是http://cesanta.com/mongoose.shtml,开源项目托管在GoogleCode上(http://code.google.com/p/mongoose/),目前国内只能使用VPN打开。Mongoose英文原意代表一种动物的名字,这里Mongoose指的是一个Web服务器,通过提供一个web接口给它,可以轻松嵌入到现有的应用程序中。Mongoose Web Server的执行是自满足的,不依赖于任何其他服务。可随意将其复制到任何目录,它将启动web服务并将当前目录作为主目录、端口号是8080。当然这些配置选项都可以通过配置文件mongoose.conf设置。

技术分享

下载与安装:

        想快速体验一下Mongoose,可到官网中直接下载免费版的安装包双击打开即可,官网中有与Windows、MacOS、Linux系统分别对应的安装包,如下图所示:

技术分享

        作为优秀的开源项目,我们自然希望是下载到源码,对于Mongoose来说源码很少,只有mongoose.h和mongoose.c两个文件。其源码在Github的托管地址是https://github.com/cesanta/mongoose,从代码仓库中可以看到官方源码包中除了包含mongoose.h和mongoose.c源码文件外,还给出了说明文档和测试用例,这里我们下载完整的mongoose源码包,便于后续的学习和使用。在Mongoose的代码仓库中README.md文件给出了一个下载链接DownLoads,该处的链接与官网中下载运行包的流程略有不同,选择好对应版本后需要我们输入联系人方式才可获得下载链接。比较奇葩的是邮箱地址中输入163、126和QQ邮箱都会提示格式错误,看来只能使用国外的邮箱,例如GMail、Hotmail了。鉴于GMail目前在国内的服务稳定性,我选择使用Hotmail。


技术分享

        输入正确的邮箱地址后,会收到一封官方发来的邮件,打开其中的链接即可下载Mongoose的源码包。实在不行也可以直接从Github上Clone也可以。

        按照以往对于开源项目的使用流程,接下来应该是本地编译。由于Mongoose源码只有mongoose.h和mongoose.c,且自包含,这里就不单独介绍如何编译这两个源码文件了,对于有编程经验的人来说so easy,当然如果你使用Linux系统也可以参考该博文Mongoose源码剖析:Introduction and Installation

编译尝试:

        在本地创建一个C++的控制台工程,开始直接将Mongoose嵌入其中。此处的参考资料就是源码包中的docs文件夹下的Embed.md。

技术分享

        本地建立MongooseEmbbed工程,为了结构清晰建立mongoose_source文件夹,将mongoose.h和mongoose.c文件拷贝到其中,打开MongooseEmbbed.sln工程,右键添加“现有项目”,分别将mongoose.h和mongoose.c文件添加到头文件和源文件中,如下图所示:

技术分享

        接下来按照Embed.md文件的说明,在工程文件MongooseEmbbed.cpp文件中输入示例代码,具体代码如下(直接从Embed.md中拷贝所得),

// MongooseEmbbed.cpp : 定义控制台应用程序的入口点。
//

#include "stdafx.h"
#include "mongoose.h"


int _tmain(int argc, _TCHAR* argv[])
{
	struct mg_server *server= mg_create_server(NULL,NULL);
	mg_set_option(server,"document_root",".");
	mg_set_option(server,"listening_port","8080");

	for(;;)
	{
		mg_poll_server(server,1000);
	}
	mg_destroy_server(&server);
	
	return 0;
}

        按下F6启动工程编译,竟然出现了错误,接下来让我们看一下如何解决错误。

编译错误与解决方案:


错误1:        

        首先遇到的错误如下图,

技术分享

        从错误提示中可以看出这应该是预编译头出现的错误,该问题最简单的解决方案就是在工程属性的“预编译头”中取消预编译,当然取消预编译后对于庞大的工程来说编译时间会增加很多,对于该问题的分析大家可参考预编译头文件来自编译器的早期版本,或者预编译头为 C++ 而在 C 中使用它(或相反)。在这里由于工程很小我就直接采用关闭预编译的方式来解决,如下图操作:

技术分享

        修改完成后,F6启动编译后,后出现了新的错误,具体错误如下。

错误2:

技术分享

        百度搜索一下,关于该问题的解决方案都是说添加_CRT_NONSTDC_NO_DEPRECATE预定义即可,因此起初尝试了在代码工程中直接添加#define _CRT_NONSTDC_NO_DEPRECATE或者#define _CRT_NONSTDC_NO_DEPRECATE 1,无论是放在#include "stdafx.h"代码之前还是之后,依然出现该错误。后来想想其实对于预处理器的定义在VS中应该是在工程属性的预处理器项目下添加,如下图尝试后,能够顺利完成MongooseEmbeed.sln工程的编译。

技术分享

运行测试:

        

        接下来让我们启动MongooseEmbbed.sln工程,实际测试一下。在浏览器中输入:http://localhost:8080,此处的8080是我们在工程主文件中设置的Mongoose Web Server的监听端口号,具体测试结果如下:

技术分享

        上图右侧显示的就是MongooseEmbbed工程所在目录下的文件列表,Mongoose Web Server会默认将工程所在目录作为Web Server的主目录。之前在介绍WEB PACS的系列博文中提到过Web Server有一个默认的索引文件,通常叫做index.html(当然在配置选项中也可以进行自由设置)。在Mongoose源码包的examples文件夹下给我们准备了多种index.html,让我们将mongoose-5.5\mongoose-5.5\examples\restful_api\index.html拷贝到工程主目录下,再一次启动本地工程,此次我们看到Mongoose Web Server自动加载了主目录下的index.html文档,具体运行结果如下图:

技术分享

        至此,对于Mongoose Web Server的安装和本地嵌入的简短介绍就完成了,与Apache等其他Web Server类同,我们也可以按照自己意愿来配置Mongoose Web Server,对于Mongoose的源码剖析和配置后再后续博文中进行介绍,敬请期待。




作者:zssure@163.com

时间:2015-01-25



DICOM:剖析Orthanc中的Web Server, Mongoose

标签:orthanc   dicom   

原文地址:http://blog.csdn.net/zssureqh/article/details/43113091

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!