ServiceUi使用手册
1.概述
ServiceUi是一套用于增强Bosent服务调用功能的Bosent应用提供了三个主要功能:生成WebService种子对象、服务测试和输入参数校验。
1. ServiceUi的服务测试功能:serviceUi可以通过读取扩展的服务用户接口配置文件自动生成测试页面,能够提供更友好的界面,并且可以将Map或List类型的参数展开。
2. ServiceUi的输入参数校验功能:校验是输入参数格式进行校验,参数的格式可在扩展的服务用户接口配置文件中定义。
3. ServiceUi生成WebService种子对象的功能:可以通过ServiceUi将WebService种子对象(封装了对服务的调用)发布成WebService,部署到NetWeaver服务器上。调用webservice服务
2.ServiceUi的存放位置
serviceUi是bosent下的一个扩展应用,其配置文件出于在eclipse环境和NetWeaver IDE环境
的初始化自适应的目的,其放置位置需要放在各应用组应用目录下的config/serviceUi目录下,并且config目录需要加入到源路径中:每个应用对应一个或多个serviceUi_*.xml配置文件,例如:merchant应用的配置文件为l。
3. 扩展服务用户接口配置文件
3.1 <service-group>元素及其扩展
  serviceUi_*.xml配置文件的根元素是<service-group>,其作用是:
包含<service>元素,实现了按应用分组service配置,便于维护配置文件。
service-group对应一个WebService种子对象,其下包含的service对应一个WebService种子对象的方法。
service-group对应测试页面上的一个一级菜单,其下包含的service对应一个菜单项。
例子:
<service-group>有如下属性:
name : 服务组名,全局唯一。同时作为默认的WS种子对象的类名。
title : 标题。测试页面菜单标题。WS种子对象源码的类注释内容。
class-name : WS种子对象的类名。必填,此属性的值为WS种子对象的全类名。此属性将生成的种子对象存放的位置交由用户自己决定。
各元素详细扩展情况可参照2.3节:元素属性表中的说明。
3.2 <service>和<attribute>元素及其扩展
l扩展了<service>和<attribute>元素的属性,增加了显示和校验相关的配置,注意:<service>元素不是以Bosent服务为单位,而是以WebService为单位,其下所属的<attribute>元素的配置也是以WebService的接口定义为准。主要的扩展配置如下:
<service>和<attribute>元素title属性,用于配置在测试页面中服务与参数显示的标题。
<service>元素other-name属性,因为存在多个WebService调用同一个Bosent服务的情况,所以该属性用做生成的WebService种子对象服务方法名,同时也是<service>元素的唯一标示。原有的name属性仍然表示一个Bosent服务名。
<attribute>属性other-name属性,用于对外发布的WebService接口和内部使用的Bosent服务接口命名不一致的情况。
<attribute> class-name属性,用以避免类命名冲突。
<attribute>格式校验相关的属性,如值长度length。
类型为Map或List的参数如果包含预先定义的内部结构,可以在该参数的<attribute>元素下嵌套<attribute>子元素来配置参数的内部结构。嵌套层数没有限制。
类型为Map或List的参数如果不包含内部结构,即自由Map或自由List,则只需指定该参数的<attribute>元素type属性为Map或List,并不再嵌套<attribute>子元素即可。

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。