webservice开发技术说明书

《webservice开发技术说明书》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、1前言在NC环境中发布WS服务以及创建SEI（serviceendpointinterface）最便捷的方式就是使用NCEclipse插件的相关功能。使用前需要手动安装NCWebServiceEclipse插件：nc.uap.mde.wstools_1.0.0.jar。以下描述的发布过程假设该插件已成功安装且java工程为NCModuleProject工程。2发布服务在NC中发布WS服务可简单描述如下：n由Java接口创建WSDL文件。n如果Java接口中引用了自定义的Java类，需要创建相应的XSD文件。n在模块下的UPM文件中配置WS服务。n如果需要WS安全方面的考虑还需要配置ws-s

2、ecurity.xml文件，及相关的证书管理配置。注意：使用NC的Eclipse插件配置UPM文件的过程中，可以自动创建WSDL文件和XSD文件。这样比单独创建WSDL/XSD文件便捷。2.1创建WSDL文件n在EclipseIDE中选中要发布为WS服务的接口文件，点击右键弹出功能菜单。选择WSTools下的GenarateWSDL菜单项，如图：n选择后弹出WSDL创建面板，设置WSDL文件的保存路径。Ø勾选Cascade复选框：表示如果该接口引用到了其它的自定义Java类，则一并生成相应的XSD文件。Ø勾选force复选框：表示如果该路径下已存在同名的WSDL文件，则覆盖。如图：n点击“

3、Finish”按钮完成WSDL文件的创建工作。1.1创建XSD文件关联类的XSD文件即可以在1.1创建WSDL文件的过程中级联创建，也可以单独创建。过程如下：n在EclipseIDE中选中准备创建XSD的Java类文件，点击右键弹出功能菜单。选择WSTools下的GenarateXSD菜单项，如图：n选择后弹出XSD创建面板，设置XSD文件的保存路径。Ø勾选Cascade复选框：表示如果该类引用到了其它的自定义Java类，则一并生成相应的XSD文件。Ø勾选force复选框：表示如果该路径下已存在同名的XSD文件，则覆盖。如图：n点击“Finish”按钮完成XSD文件的创建工作。1.1配置U

4、PM文件配置UPM文件的工作量并不大，可手工也可使用NC工具。下面对使用NC工具配置的流程加以描述，其中涉及到NCWebServiceSecurity方面的规范知识可参考《WebService安全配置》文档。n在EclipseIDE中选中要发布为WS服务的接口文件或实现类，点击右键弹出功能菜单。选择WSTools下的PublishWebService菜单项后弹出UPM文件选择窗口，如图：n点击“Next”后进入如下配置页，最下面的interface，impl是两个必填项。指明要发布为ws服务的接口和实现类。“设置属性”栏中的各项属性是NC组件正常发布所需要的配置项，这里不做介绍，可参考组件

5、发布的相关文档。需要指出的是如果配置了组件名则这个组件名就是WS的服务名，否则系统会将下页配置的Address做为WS的服务名。n点击“Next”后进入如下配置页。ExtensionClass：指定了Server启动时部署这个组件的处理类。WebServiceStyle：暂时只能选NCspecify。如果勾选了“CreateWSDLifnotexist”项，则当未创建wsdl、xsd文件时会自动创建。Wsdllocation：指出wsdl文件的位置。Address：是WS服务地址，结构为“/”+服务名。Interceptor：拦截器。n点击“Next”进入WebService安全配置项。勾

6、选webservice安全配置项。选择KeyStore，从modules/uapws/config/ws-security.xml中选择。默认的是该文件中cryptoid为default的KeyStore。decKS：解密需要的KeyStore。encKS：加密需要的KeyStore。signKS：签名需要的KeyStore。verifyKS：验证签名需要的KeyStore。n点击“Next”，进入WebService安全详细信息配置页。Ø配置Protect项。如果在上一页的安全配置项中勾选了“要求认证授权”，则在当前的详细信息配置页中需要配置Protect项。如图：认证组件：如果没有配置

7、，表示使用系统默认的认证器。他为对nc.uap.ws.security.IAuthenticator组件的引用。默认为名称为nc.uap.ws.security.IAuthenticator的组件。授权组件：如果没有配置，表示使用系统默认的权限机制，他为对nc.uap.ws.security.IAccessController的组件的引用，默认为名称nc.uap.ws.security.IAccessController