Apache-CXF-使用指南.doc

UltraPASM 项目项目 CXF 使用说明书使用说明书 北京神州泰岳软件股份有限公司 Ultrapower Software Co Ltd 版 本V1 0 制定部门EPG 制定日期 2009 7 6 密 级公司级 文档状态发布 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 文档说明文档说明 本文档所涉及到的文字 图表等 仅限于北京神州泰岳软件有限公司和 用户 项 目内部使用 未经双方书面许可 请勿扩散到第三方 文档变更 版本描述修订人修订日期审核人审核日期 V0 1 初稿 张振新 2009 7 6 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 I 页 目目 录录 1引言 1 1 1编写目的 1 1 2背景 1 1 3术语 2 1 4参考资料 3 2系统描述 3 3类设计 4 3 1类图 4 3 2类描述 4 3 2 1类名称 5 3 2 1 1属性 5 3 2 1 2方法 5 3 2 1 2 1方法 1 5 4时序图 6 5界面设计 6 5 1界面功能点组织图 6 5 2界面流程 6 5 3界面布局图 6 6数据库设计 7 6 1E R 图 7 6 2数据字典 7 7配置文件说明 7 8日志 自管理和安全设计 8 8 1日志设计 8 8 2自管理设计 8 8 3安全设计 8 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 II 页 附图目录附图目录 错误 未找到图形项目表 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 1 页 共 13 页 1 引引言言 1 1 编编写写目目的的 UltraPASM 模块采用 WebService 提供对外的接口 经项目组决定采用 Apache cxf 做 为 WebService 的开发框架 本文档旨在对于 Apache cxf 不了解的人 通过阅读此文档 能够实现 UltraPASM 的 Webservice 接口开发 1 2 背背景景 经过 UltraPASM 项目组觉得 UltraPASM 模块提供对外 Webservice 接口 供其他应 用或者模块来调用 WebService 的数据 同时 满足亿阳的用户数据接口 1 3 术术语语 序号术语术语全称全称中文描述中文描述 1 CXFApache 基金会的 WebService 框架 2 3 4 5 1 4 参参考考资资料料 序号序号文档名称文档名称文档编号文档编号作者作者发布日期发布日期出版单位出版单位 1 2 3 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 2 页 共 13 页 2 系系统统描描述述及及约约束束 2 1 系系统统描描述述 2 2 设设计计约约束束 3 WebService 发发布布 3 1 Spring 集集成成 3 1 1 Spring 配配置置 在 resource 包下 ws applicationContext cxf xml 配置文件中引入以下 cxf 配置 其中 applicationContext cxf xml 需要在 spring 的上下文中加载 3 1 2 Web xml 配配置置 在 web xml 中添加过滤器 CXFServlet org apache cxf transport servlet CXFServlet 1 CXFServlet services 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 3 页 共 13 页 3 2 服服务务接接口口 3 2 1 服服务务类类接接口口 接口类 BocoUser SOAPBinding style SOAPBinding Style DOCUMENT use SOAPBinding Use LI TERAL WebService targetNamespace public interface BocoUser public List getAccount String flag public void Modifypwd String uid String pwd 接口实现类 WebService endpointInterface com ultrapower accredit api BocoUser targetNamespace serviceName BocoUserService portName BocoUserPort public class BocoUserImpl implements BocoUser 具体实现 3 2 2 Spring 配配置置 修改具体的发布服务端的配置文件 resource ws applicationContext cxf xml 文件 具体如下 3 2 3 生生成成 wsdl 文文件件 由于 eclipse 现在还不支持 cxf 如果想支持 需要下载 stp 插件 地址 http download eclipse org stp downloads 所以 采用 ant 来生成对应的 wsdl 文件 ant 脚 本如下 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 5 页 共 13 页 运行bocoWSDLToJava这个 target 会生成对应的 wsdl 文件 文件内容如下 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 6 页 共 13 页 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 7 页 共 13 页 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 8 页 共 13 页 项目 详细设计说明书 本文档仅北京神州泰岳软件有限公司和被呈送方内部使用 未经双方许可 请勿扩散到第三方 第 9 页 共 13 页 3 3 WebService 客客户户端端 3 3 1 Spring 客客户户端端 在 Java 内部调用可以直接使用 Spring 的配置