ENVI Services Engine5.1 应用开发入门教程

这里可以选择安装的产品，如果选择ENVI Services Engine，只会安装ENVI Services Engine产品；如果选择ENVI for ArcGIS Services Edition，除了安装ENVI Services Engine之外，还会安装ENVI for ArcGIS Services Edition产品（专为ArcGIS Server定制的，详细可查看安装后的ENVI Services Engine帮助）。这里我们只选择ENVI Services Engine，点击Next。

图4 选择安装产品类型

选择ENVI Services Engine是否以服务方式安装，这里有三个选项：以自动启动的服务安装、以手动启动的服务安装、不以服务方式安装。这里我们选择以自动启动的服务方式安装，点击Next。

图5 选择服务启动方式

以自动启动的服务安装方式会要求输入启动该服务的用户账户，这里我们选择管理员Administrator，点击Next。

图6 设置用户名

选择ENVI Services Engine的安装路径，默认是:C:\Exelis,这里我们选择默认安装，点击Next。

图7 ENVI Services Engine安装路径

正在安装ENVI Services Engine5.1。

图8 正在安装

1.3.2 安装许可

图9 许可安装选择

选择“是”，直接导入许可，若选择“否”，可以通过“开始→IDL8.3→Tools→License Wizard”配置许可。

这里我们选择“是”，进入许可加载界面，在弹出程序界面中选择第三项，Install a license you have received，导入从Esri中国信息技术有限公司收到的许可文件。

图10 导入许可文件

图11 许可导入界面

导入许可后点击Finish完成安装。

图12 许可导入完成

图13 安装完成后重启电脑

1.3.3 验证

ENVI Services Engine安装完成后，可以通过开始->所有程序->ENVI 5.1->Tools->Services Engine Admin Console启动ENVI Services Engine管理员控制台（http://hostname:8181/admin），管理员控制台如果可以启动（注意浏览器版本）说明ENVI Services Engine安装成功！

图14 ENVI Services Engine管理员控制台

二、服务器端开发

ENVI Services Engine自5.1版本开始，可以直接在IDL8.3下完成以下内容：

l 任务创建

l ENVI/IDL程序开发

l JSON配置文件编辑

l 任务发布及管理

l ENVI Services Engine服务测试

2.1任务创建

创建任务：启动IDL8.3，点击菜单文件->New Task…后启动新建任务对话框，这里可以填入：任务名称、文件夹名称、IDL程序名称（三者最好保持一致）以及该任务保存的路径。

图15 新建任务

2.2ENVI/IDL程序开发

ENVI Services Engine任务包含两个文件：IDL源程序（.pro）文件和JSON配置文件（.json）。

双击ESE_Canny.pro即可编写ENVI/IDL功能，通过新建任务生成的pro文件，程序框架已经完成，只需要添加ENVI/IDL功能即可。计算Canny边缘算子的IDL程序如图16。

图16 Canny边缘算子计算IDL程序

这里有两点需要注意：

l IDL程序启动ENVI，必须是e=envi(/headless)而不能是ENVI，这里没有调用ENVI函数，因此不需要启动ENVI。

l 在IDL中调试时需要加上verifyServer，否则！SERVER环境变量无法初始化，verifyserver程序存放在C:\Exelis\se51\lib路径下，因此需要在IDL路径中加入了C:\Exelis\se51\lib路径IDL才可以找到该程序，否则无法直接调用。添加路径可以启动菜单窗口->首选项。

图17 插入IDL路径

2.3JSON配置文件编辑

ENVI/IDL程序开发完成后，需要编写JSON配置文件，双击config.json，打开json配置文件，ESE_Canny的配置文件编写如图18。关于JSON文件参数格式如图19，各参数说明详见ENVI Services Engine帮助。

图18 Canny边缘算子计算JSON文件

图19 JSON文件格式

2.4任务发布及管理

IDL文件和JSON配置文件编辑完成之后，即可在IDL下直接发布ENVI Services Engine服务。打开JSON文件，点击下方的发布后，即可进入发布界面，在该界面下，可以点击添加ENVI Services Engine服务器，这里使用的是本地机器，因此服务器地址为：http://localhost:8181/ESE。

图20 添加ENVI Services Engine服务器

添加ENVI Services Engine服务器后，即可选择服务端点（SyncServices（同步服务）和AsyncServices（异步服务））后右击发布该任务。也可以通过右侧工具栏进行任务发布、编辑、删除等操作。

图21 发布任务

2.5ENVI Services Engine服务验证

在IDL中直接发布任务后，可以登陆ENVI Services Engine管理员控制台查看服务的URL即HTTP REST服务地址。

图22 发布后的Canny服务

可以看到，该服务已经发布成功，接下来我们验证服务能否正常运行，点击右侧的Task Request Builder…，打开Task Request Builder面板后，点击Submit即可运行服务。

图23 Canny服务测试

服务运行成功后可以得到json返回结果，在json返回结果中可以查看服务是否运行成功及返回的结果。

图24 Canny计算结果

点击Task Request Builder面板上的Show Request，可以得到该服务的HTTP REST地址，有了该地址之后，就可以进行客户端开发，在客户端调用该服务。

图25 Canny服务地址（HTTP REST）

三、客户端开发

这里的客户端可以是基于HTML和Javascript、Flex、Silverlight等开发的web客户端，也可以是移动客户端（IOS、Android），在客户端中可以调用通过ENVI Services Engine平台发布的标准的HTTP REST服务。

这里的演示客户端比较简单，利用的是HTML与JavaScript来调用HTTP REST服务，只是一个HTML文件，里面嵌入了JavaScript来调用ENVI Services Engine的HTTP REST服务，JavaScript调用HTTP REST服务方法如图26所示。注意，这里是调用的同步服务，异步服务的调用与之类似。

图26 JavaScript调用Canny服务

运行HTML文件后，在线计算出边缘算子，如图27所示。

图27 在线计算Canny