资源描述：
《sword core—服务总线组件说明》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。
1、中国软件与技术服务股份有限公司文件编号：RD-SWORD-PUB-STA-V5.0服务总线组件说明当前版本号SWORDV5.0最初发布日期最新修订日期审核者日期批准者日期中国软件与技术服务股份有限公司服务总线组件说明修订记录日期版本修订内容说明作者SWORDV5.0中国软件与技术服务股份有限公司服务总线组件说明目录中国软件与技术服务股份有限公司服务总线组件说明1.概述1.1.功能概述服务总线组件是平台内(本地JVM)服务管理与调用的核心组件.是平台启动时内置的服务类扫描器,扫描服务容器内的服务,并执行注册与服务代理类代码的生成.服务的调用按服务位置可分为本地服务调用与远程服务调用.按调用方式
2、可分为同步调用和异步调用.本地服务调用指服务在本地JVM内的调用,不需要服务器间(或本地多JVM间)的交互.远程服务调用只服务器间(或本地多JVM间)的服务调用.同步调用指服务调用方需等服务提供方处理完成返回后,才能继续向下执行.系统内的服务调用大多数都是此种方式(如EJB调用).异步调用指服务调用方不需要等待服务提供方处理完成就可继续向下执行(如JMS调用).注此文档不描述有关服务路由与服务调用协议的说明,那部分的说明请查看相关服务路由组件的说明.1.2.服务代码编写示例要求服务类有明确的注解代码:@ServiceContainer,@Servicecom.css.sword.kernel
3、.base.annotation.@ServiceContainer服务容器类注解:标注此类内有@Servicecom.css.sword.kernel.base.annotation.@Servcie服务注解:标注此方法为服务方法注意事项:一个服务容器内最多只允许有256个服务服务类示例:@ServiceContainerpublicclassMyServiceContainer{@Service(name="service1")publicvoidmyService1(…){doSomethings….}@Service(name="service2")publicIntegerhasR
4、etValService(…){doSomethings….}中国软件与技术服务股份有限公司-1-服务总线组件说明@Service//以方法名作为服务名publicvoidservice3(…){doSomethings….}1.2.1.@ServiceContainer说明标注此类为服务容器类,只有此注解的类才能被服务管理器组件扫描注册服务.�属性:deprecated类型:String,默认""说明:描述此类是否已过期.启动时会有警告日志.不影响使用1.2.2.@Service说明标注此方法为服务,服务管理器将为此方法生成服务代理类并注册为服务.�属性:serviceName说明:服务名
5、称,默认为方法名称.如果扫描到多个同名服务,以高版本号的服务为准,若版本号相同,后扫描的服务将覆盖之前的服务.并在启动日志中有警告说明.�属性:unitTest类型:booleantrue/false默认false说明:只在单元测试框架组件使用�属性:memo类型:String说明:服务功能描述�属性:version类型:String说明:服务版本号.�属性:deprecated类型:String,默认""说明:标注服务是否已不再被支持.服务调用时会有日志警告.�属性:autoShare类型:booleantrue/false默认true说明:表示服务是否可以作为共享路由自动传到外部系统使用
6、.注:此属性如何使用,设置是否有效需要看服务路由组件的支持情况,请查看相关路由组件的说明,若未描述则忽略此属性.�属性:syncCall类型:booleantrue/false默认false说明:描述此服务是否只允许同步调用.中国软件与技术服务股份有限公司-2-服务总线组件说明1.3.服务调用服务的调用统一使用com.css.sword.kernel.utils.SwordServiceUtils工具类提供的接口调用.服务调用可分为本地服务调用与远程服务调用,调用方式可以有同步调用与异步调用.SwordServiceUtils工具类提供不同的接口以支持不同的调用方式.注:此处的同步/异步服务
7、调用实现机制是使用异步服务引擎使用异步线程的方式调用,对于远程服务即使是使用异步线程引擎但服务器间(多JVM间)的服务调用最终会交给服务中介路由组件,对于服务器间的调用协议(EJB,JMS,WebService.....)部分需要查看相关组件的说明.1.3.1.callLocalService明确的本地服务调用.此种调用方式不会进行交易路由，即只会查找本地的服务注册表，并调用服务.参数:Stringservi
