WebService 服务返回类型设计

      一般来讲,WebService服务的返回值类型可能是一条查询的数据或者是一个列表,也可能是执行结果状态(比如int或则bool类型),而且如果执行失败还必须告诉客户端是什么原因导致失败,是参数不合法呢还是服务异常所致,当然这些都可以通过抛出异常来告知客户端。现在我要介绍的是我总结出来的一个比较通用的方法,很简单,包括三个核心类:

WebService 服务返回类型设计_第1张图片

1、StatusData类作为基类,主要用来返回一个执行的结果,调用端只关心是否执行成功或者执行失败的原因:

     Result属性是bool类型,告诉调用端是否执行成功了

     Message属性是string类型,如果Result为false,则Message必须说明失败的原因

2、SingleData继承于StatusData类,返回单条数据的服务调用,比如单条查询、登陆返回的信息等等

     Item是调用者真正需要的数据,只有在Result为true的情况下,才可访问,否则通过Message查看失败原因

3、PagedData同样继承StatusData类,返回分页查询的数据

     PageCount是查询的总页数,Total是总记录数,List是当前查询页索引返回的数据列表,同样只有Result为ture的情况下才可使用,否则通过    Message查看失败原因。返回此类型的调用至少需要接收包括页索引(PageIndex)和每页查询的记录数(PageSize)的参数,这样才能进行分页操作。

原文地址:http://www.cnblogs.com/txdlf/archive/2009/03/27/1422996.html

你可能感兴趣的:(Java,webservice)