webservice开发技术说明书.docVIP

前言 在NC环境中发布WS服务以及创建SEI（service endpoint interface）最便捷的方式就是使用NC Eclipse插件的相关功能。使用前需要手动安装NC WebService Eclipse插件：nc.uap.mde.wstools_1.0.0.jar。以下描述的发布过程假设该插件已成功安装且java工程为NC Module Project工程。 发布服务 在NC中发布WS服务可简单描述如下： 由Java接口创建WSDL文件。 如果Java接口中引用了自定义的Java类，需要创建相应的XSD文件。 在模块下的UPM文件中配置WS服务。 如果需要WS安全方面的考虑还需要配置ws-security.xml文件，及相关的证书管理配置。 注意：使用NC的Eclipse插件配置UPM文件的过程中，可以自动创建WSDL文件和XSD文件。这样比单独创建WSDL/XSD文件便捷。 创建WSDL文件 在Eclipse IDE中选中要发布为WS服务的接口文件，点击右键弹出功能菜单。选择WS Tools下的Genarate WSDL菜单项，如图： 选择后弹出WSDL创建面板，设置WSDL文件的保存路径。 勾选Cascade复选框：表示如果该接口引用到了其它的自定义Java类，则一并生成相应的XSD文件。 勾选force复选框：表示如果该路径下已存在同名的WSDL文件，则覆盖。 如图： 点击“Finish”按钮完成WSDL文件的创建工作。 创建XSD文件 关联类的XSD文件即可以在1.1创建WSDL文件的过程中级联创建，也可以单独创建。过程如下： 在Eclipse IDE中选中准备创建XSD的Java类文件，点击右键弹出功能菜单。选择WS Tools下的Genarate XSD菜单项，如图： 选择后弹出XSD创建面板，设置XSD文件的保存路径。 勾选Cascade复选框：表示如果该类引用到了其它的自定义Java类，则一并生成相应的XSD文件。 勾选force复选框：表示如果该路径下已存在同名的XSD文件，则覆盖。如图： 点击“Finish”按钮完成XSD文件的创建工作。 配置UPM文件 配置UPM文件的工作量并不大，可手工也可使用NC 工具。下面对使用NC 工具配置的流程加以描述，其中涉及到NC WebService Security方面的规范知识可参考《WebService安全配置》文档。 在Eclipse IDE中选中要发布为WS服务的接口文件或实现类，点击右键弹出功能菜单。选择WS Tools下的Publish Web Service菜单项后弹出UPM文件选择窗口，如图： 点击“Next”后进入如下配置页，最下面的interface，impl是两个必填项。指明要发布为ws服务的接口和实现类。“设置属性”栏中的各项属性是NC组件正常发布所需要的配置项，这里不做介绍，可参考组件发布的相关文档。需要指出的是如果配置了组件名则这个组件名就是WS的服务名，否则系统会将下页配置的Address做为WS的服务名。 点击“Next”后进入如下配置页。 ExtensionClass：指定了Server启动时部署这个组件的处理类。 Web Service Style：暂时只能选NC specify。 如果勾选了“Create WSDL if not exist”项，则当未创建wsdl 、xsd文件时会自动创建。 Wsdl location：指出wsdl 文件的位置。 Address：是WS服务地址，结构为“/”+服务名。 Interceptor：拦截器。 点击“Next”进入WebService 安全配置项。 勾选web service 安全配置项。 选择KeyStore，从modules/uapws/config/ws-security.xml中选择。默认的是该文件中crypto id为default的KeyStore。 decKS：解密需要的KeyStore。 encKS：加密需要的KeyStore。 signKS：签名需要的KeyStore。 verifyKS：验证签名需要的KeyStore。 点击“Next”，进入WebService安全详细信息配置页。 配置Protect项。如果在上一页的安全配置项中勾选了“要求认证授权”，则在当前的详细信息配置页中需要配置Protect项。如图： 认证组件：如果没有配置，表示使用系统默认的认证器。他为对nc.uap.ws.security.IAuthenticator组件的引用。默认为名称为nc.uap.ws.security.IAuthenticator的组件。 授权组件：如果没有配置，表示使用系统默认的权限机制，他为对nc.uap.ws.security.IAccessControlle