DICOM医学图像处理：Orthanc Plugin SDK实现WADO服务

背景：

        Orthanc是博主发现的一个很完美的DICOM和HTTP服务端开源软件，前几篇分别介绍了Orthanc的基本使用。Orthanc从0.8.0版本之后给出了Plugin SDK，通过该SDK可以利用Orthanc内建的REST API实现WADO服务，下面就参照官网给出的说明介绍一下如何使用SDK实现WADO服务，并且对官网的实例进行更新，采用最新的方式直接实现WADO服务。

官方说明中文翻译：

1）简介

        DICOM标准定义了文件格式以及医学影像网络传输协议。WADO，即Web Access to DICOM Persistent Objects，是DICOM3.0标准中制定的一种基于网络web服务访问医学图像的协议（具体在DICOM3.0第18部分）。通过WADO协议，专业的医生可以使用常见的浏览器（目前Orthanc貌似不支持IE）预览和下载医学图像。

        本博文所附代码给出了一个实现简单WADO服务的示例。该示例可以返回原始的DICOM图像，或者JPEG格式图像；并可以作为Orthanc的插件来运行。借助于Orthanc的框架，可以通过简单的几行代码实现WADO服务。

2）背景：

        Orthanc是一款开源的、轻型的、独立的，并支持脚本化的DICOM服务端。Orthanc主要用来精简临床就医流程和简化医学图像的管理。另外通过兼容常见的JSON、PNG格式和RESTful API，使得DICOM标准在计算机图像领域得到更广泛的应用。Orthanc隐藏了DICOM文件格式和DICOM协议的复杂性，因此医院普通的网络管理人员以及专业的医学图像自动分析软件开发人员都可以使用。Orthanc可以作为一个健壮的医学影像处理中心，为各个医院提供服务。

        从0.8.0（2014 7月份发布）开始，Orthanc给外部开发人员 提供了插件开发SDK。利用SDK开发的动态库形式的插件可以被导入到Orthanc服务中，插件通过注册回调函数来响应浏览器的HTTP请求。回调函数反过来可以访问Orthanc数据库提取目标DICOM文件的信息。Orthanc Plugin SDK以C语言头文件形式给出，链接如下：https://code.google.com/p/orthanc/source/browse/Plugins/OrthancCPlugin/OrthancCPlugin.h?name=Orthanc-0.8.0，说明文档：http://www.codeproject.com/KB/webservices/797118/OrthancPluginDocumentation.zip

3）DICOM 和 WADO

        本小节只概括介绍WADO协议，详细介绍参见DICOM3.0标准的第18部分。

        DICOM协议里规定了如下标准：一个患者（Patient）可以做多次检查（Studies）。每一个检查（Study）包含一系列医学图像，即序列（Series)。举个例子：标准的PET-CT检查（Study）会包含两组序列，CT 序列和PET 序列。序列中通常对应人体的二维/三维/四维影像。每种影像会被分割成多个文件存储，即Instance（也就是我们看到的包含单幅图像的单个后缀为DCM的文件）。

        通常，一个DICOM实例（Instance）可以看做是二维图像与存储了患者元信息（人口统计学信息，如姓名、年龄、身高、体重等等）结构的组合。患者元信息通常是包含了DICOM标签对应值的数组。每个标签由两个十六进制数表示。非常重要的是，每一级的检查（Study）、序列（Series）和图像（Instance）要求全局唯一。

        例如(0x0020,0x000d)代表的是Study Instance UID，定义检查（Study）的唯一性；

…………

        一个WADO请求就是一个简单的HTTP GET请求，请求中包含了Study、Series和Instance标识符。例如：

http://localhost/wado?
    studyUID=1.2.840.113845.11.1000000001951524609.20121203131451.1457891&
    seriesUID=1.2.840.113619.2.278.3.262930758.589.1354512768.115&
    objectUID=1.2.840.113619.2.278.3.262930758.589.1354512768.116.1&
    requestType=WADO

        该WADO请求的响应会是与studyUID/seriesUID/objectUID对应的DICOM图像的JPEG格式。如果希望直接获取DICOM格式文件，应在WADO请求中添加contentType=application%2Fdicom，如下所示：

http://localhost/wado?
    studyUID=1.2.840.113845.11.1000000001951524609.20121203131451.1457891&
    serie