CMHK-OA-SD-WEB服务.docVIP

h 招商局集团综合办公系统 WEB SERVICE设计说明书 文件状态： [√] 草稿 [ ] 正式发布 [ ] 正在修改 文件标识： CMHK-OA-SD-WS 当前版本： 0.2 作 者： 黄伟平 完成日期： 2005-03-24 必威体育官网网址级别： 公开  修改记录 日期 版本 作者/修改者 描述 审核人 2005-03-17 0.1 黄伟平 初稿生成 2005-03-18 0.1 黄伟平 修改补充 2005-03-24 0.2 黄伟平 检查定稿  目 录 1 引言 3 1.1 目的 3 1.2 范围 3 1.3 读者对象 3 1.4 参考资料 3 1.5 术语与缩略语 3 2 需求概述 3 3 需求分析 4 4 设计策略 4 4.1设计约束 4 4.2 SOAP消息 4 4.2.1不带附件 6 4.2.2带附件 7 4.3 JAXM消息发送模型 7 4.4 JAXM编码实现 9 4.4.1客户端 9 4.4.2服务器端 10 4.5附件处理 11 4.5.1增加附件 11 4.5.2处理附件 12 4.6中文问题 12 4.6.1消息内容 12 4.6.2中文名附件 12 5 系统总体结构 14 6 环境的配置 14 6.1 开发环境的配置 14 6.2 运行环境的配置 14 6.3 测试环境的配置 14 6.3.1客户端 14 6.3.2服务器端 15 7 网络资源 15  1 引言 1.1 目的 在各个应用系统之间互通消息，比如OA系统到OA系统，OA系统到档案系统等其他系统。 1.2 范围 适应所有支持Http协议的应用系统。 1.3 读者对象 开发人员，设计人员，测试人员，用户 1.4 参考资料 资料名称[标识符] 出 版 单 位 作 者 日 期 1.5 术语与缩略语 缩写 原文 中文释意 EZ-OSSP EZ-CMM/OSSP（Organization Standard Software Process） EZCROSS CMM机构标准软件过程 WS Web Service Web服务 JAXM Java API for XML Messaging 处理xml消息的java API JAX-RPC Java API for XML-based RPC 基于xml的远程过程调用的java API SAAJ SOAP with Attachments API for Java 处理soap附件的java API SOAP Simple Object Access Protocol 简单对象访问协议 2 需求概述 招商局集团OA系统要与其他许多系统进行对接，也就是互相通信。例如： 集团OA系统发一篇公文信息到招商国际OA系统 统一用户管理系统发消息到各个OA系统 OA系统到档案系统 。。。。。。 这些都要求不需要直接登录到目标系统，比如：集团OA系统发一篇公文信息到招商国际OA系统，集团OA系统的公文信息发送者并不需要登录到招商国际OA系统（目标系统）。 3 需求分析 一个应用系统A往另一个应用系统B发送消息，A是消息发送者，B是消息接收者，这个过程就是单向通信的过程，如果A要求B返回消息的话，那么这个过程就是双向通信的过程。这种通信过程符合客户端/服务器端通信模型。A是客户端，B是服务器端，同样A也可以作为服务器端，B作为客户端。 与招商局集团OA系统互相通信的各个应用系统都建立在Http协议上，在他们之间建立统一的通信模式适合采用WEB SERVICE技术。WEB SERVICE技术是通过Http协议，在客户端与服务器端之间互相传送xml数据，客户端并不需要登录到服务器端，只需要获得对服务器端提供的Web服务的访问权，通常服务器端提供的Web服务都是公开的。 详细说明请参考【Web Service解析.doc】 4 设计策略 客户端与服务器端通过WEB SERVICE技术进行通信，消息的格式是xml数据，使用的是soap协议进行封装xml数据，可以称之为soap消息。客户端发送的消息是soap消息，服务器端接收的消息也是soap消息，服务器端返回的消息也是soap消息。Soap是一个基于XML的用于应用程序之间通信数据编码的传输协议，是新一代跨平台、跨语言分布计算Web Services的重要部分。 详细说明请参考【SOAP解析.doc】 4.1设计约束 招商局集团OA系统是采用java技术开发的，在java平台下开发Web Service有以下三个方向： Apache Axis、JAX-RPC、JAXM。 Apache Axis 一种实