webservice开发技术说明书

1 前言

在NC环境中发布WS服务以及创建SEI（service endpoint interface）最便捷的方式就是使用NC Eclipse插件的相关功能。使用前需要手动安装NC WebService Eclipse插件：nc.uap.mde.wstools_1.0.0.jar。以下描述的发布过程假设该插件已成功安装且java工程为NC Module Project工程。

2 发布服务

在NC中发布WS服务可简单描述如下：

n 由Java接口创建WSDL文件。

n 如果Java接口中引用了自定义的Java类，需要创建相应的XSD文件。

n 在模块下的UPM文件中配置WS服务。

n 如果需要WS安全方面的考虑还需要配置ws-security.xml文件，及相关的证书管理配置。

注意：使用NC的Eclipse插件配置UPM文件的过程中，可以自动创建WSDL文件和XSD文件。这样比单独创建WSDL/XSD文件便捷。

2.1 创建WSDL文件

n 在Eclipse IDE中选中要发布为WS服务的接口文件，点击右键弹出功能菜单。选择WS Tools下的Genarate WSDL菜单项，如图：

n 选择后弹出WSDL创建面板，设置WSDL文件的保存路径。

Ø 勾选Cascade复选框：表示如果该接口引用到了其它的自定义Java类，则一并生成相应的XSD文件。

Ø 勾选force复选框：表示如果该路径下已存在同名的WSDL文件，则覆盖。

如图：

n 点击“Finish”按钮完成WSDL文件的创建工作。

2.2 创建XSD文件

关联类的XSD文件即可以在1.1创建WSDL文件的过程中级联创建，也可以单独创建。过程如下：

n 在Eclipse IDE中选中准备创建XSD的Java类文件，点击右键弹出功能菜单。选择WS Tools下的Genarate XSD菜单项，如图： 

n 选择后弹出XSD创建面板，设置XSD文件的保存路径。

Ø 勾选Cascade复选框：表示如果该类引用到了其它的自定义Java类，则一并生成相应的XSD文件。

Ø 勾选force复选框：表示如果该路径下已存在同名的XSD文件，则覆盖。如图：

 

n 点击“Finish”按钮完成XSD文件的创建工作。

2.3 配置UPM文件

配置UPM文件的工作量并不大，可手工也可使用NC 工具。下面对使用NC 工具配置的流程加以描述，其中涉及到NC WebService Security