CMISS接口应用开发说明.docx

CMISS接口应用开发说明  接口应用开发与实战 CIMISS接口应用概述 CIMISS接口开发流程 登录网站，申请API账户 登录MUSIC接口网站，申请web用户和API账户。参见“2.7 用户空间与接口测试”。 明确需求，选择资料 （1）想要获取哪类资料：地面资料、雷达资料、卫星资料、服务产品资料 （2）资料需要不需要质控：基数据、质控后 （3）所需资料的时间属性：分钟级、小时、日值、候值、旬值、年值 （4）所需资料的空间属性：站号级、区县级、市级、省级、流域级、国家级、世界级 （5）所需资料的要素属性： 根据不同的时间、空间属性，关注的要素级别也不相同。以气温为例：过去24小时变温、过去24小时最高气温（小时级）、平均气温、最高气温（日级）…… 参考网站，选择资料和接口 （1）选择检索一个时次的还是一个时间范围的：time（s）、timeRange （2）选择检索一个站的还是个区域的：staId、adminCode （3）选择检索资料要素、还是统计信息：StaElemSearch、StaElemStat （4）选择所要的返回方式：对象、html、json、jsonp、txt、xml 在线测试接口 在“用户空间”中，对选择的资料和接口进行调用测试。参见“2.7 用户空间与接口测试”。 资料、接口无误，进行开发 （1）仅仅是查看资料情况或查询资料量很小，无需编程使用REST即可； （2）仅仅是需要保存资料，无格式限制，脚本方式下载即可； （3）选择适合的接口调用方式：clib、webs； （4）选择自己擅长的编程语言进行开发。 MUSIC调用方式 客户端方式： 使用ICE中间件平台，将数据返回封装为ICE对象，再由ICE提供的API接口解析为调取的数据。开源中间件ICE提供多种语言支持C/C++、C#、Java、PHP、Python。 主要适用于后台加工处理系统，如数值预报资料同化系统等，能较快地提供大数据量的数据对象和文件检索。 REST方式： 主要适用于前台交互应用系统，如县级综合业务平台、气象业务内网等，检索数据量不宜过大，返回XML、json、html、text等多种格式，其中，文件类产品一般不返回数据，只返回其URL。 Web Service方式： 主要适用于前台交互应用系统，如县级综合业务平台、气象业务内网等，检索数据量不宜过大，除以数组形式返回要素数据外，也支持与REST服务相同的返回格式和功能。 脚本方式： 主要适用于个人用户，通过配置脚本，执行部署在客户端的脚本工具，即可定时或一次性地获取所需数据，存为本地文件。 接口使用-客户端方式（以Java为例） 从网站中下载客户端SDK包，即可使用。此外，还可以直接从网站上下载DEMO工程，里面包含了REST、WEB Service和客户端开发的所有示例代码，可在修改服务地址后，直接运行使用。 Java编程环境安装与配置 Java安装 双击jdk-7u80-windows-x64.exe，默认安装路径，并一路选择默认即可。 为系统添加环境变量：计算机右键-属性-高级系统设置-高级-环境变量，新建系统变量JAVA_HOME：C:\Program Files\Java\jdk1.7.0_80 新增系统变量CLASSPATH：（注：变量值在最开始的地方有一个点，即“.”）变量值为 .;C:\Program Files\Java\jdk1.7.0_80\lib\tools.jar;C:\Program Files\Java\jdk1.7.0_80\jre\lib\ 在系统变量PATH中添加：C:\Program Files\Java\jdk1.7.0_80\bin; 在CMD中输入：java –version， 如出现以下信息即表示安装成功。 Eclipse安装与配置 解压eclipse-jee-mars-R-win32-x86_64.zip，在Windows-Preference-Java-Installed JREs中设置JRE环境： Demo工程 工程导入 File-Import-Existing Projects into Workplaces: 工程结构 client.config:配置应用服务器地址 lib包：工程引用第三方的jar包 JRE System Library: 使用安装在系统中的Java的类库 Reference Libraries:第三方jar包编译引入工程 src：工程代码包 程序代码结构 接口调用方式：clib（客户端）、rest、webs 调用通用接口类型： FileInfoSearch:文件类资料检索 GribElemPointSearch:数值格点检索（一点或多点） GribElemRectSearch:数值格点类检索（检索一个场）