Hivmind使用指南(一)
一、service的定义
1、概述
在hivemind中,一个service是一个简单的实现特定接口的对象,你可以提供此接口的核心实现,使用者可以通过实现此接口来覆盖你的实现。模块的定义可以包含<service-poit>元素来定义服务,一个模块可以包含任意多的服务。
2、创建模式
Service有四种创建模式:primitive(主要的)、singleton(单例的)、threaded(线程的)和pooled(池化的)。在primitive和singleton模式中,每一个服务最终只会生成一个实例。在threaded和pooled模式中,同时可能有多个实例,但是每个线程只会有一个实例。各个模式的定义如下:
Primitive:服务在第一次参考时被构造
Singleton:服务在第一此调用接口的方法时被构造
Threaded:第一次调用接口的方法时构造,并绑定到当前线程
Pooled:同Threaded,但服务的实现被储存在池中
Hivemind使用代理模式来创建实例,除了primitive创建模式。代理类实现了服务接口,按需要构造实际的实现类。
3、定义方法
一个服务包含一个实现类和任意多的拦截类,拦截类可以实现日志、安全、事务定义和性能观测等功能。一般一个服务代理将首先创建,当代理类的方法被调用时,实际的服务实现类被构造和配置,所有的拦截类被创建。
定义如下:
<service-point id="MyService" interface="com.myco.MyServiceInterface"> <create-instance class="com.myco.impl.MyServiceImpl"/> <interceptor service-id="hivemind.LoggingInterceptor"/> </service-point>
属性定义如下表所示
属性 |
类别 |
必需 |
描叙 |
id |
字符串 |
是 |
服务扩展点的简单id,全写的id通过前边加上模块id来获得 |
interface |
类名 |
否 |
此服务扩展点支持的接口的名字,如果没有定义,则默认为服务id,全协的名称通过前边加上模块的报名来获得 |
parameters-schema-id |
字符串 |
否 |
用来参考模块中定义的schema,schema定义了此服务需要用到的参数,当服是通过ServiceImplementationFactory或者 ServiceInterceptorFactory.类定义时。 |
parameters-occurs |
unbounded | 0..1 | 1 | 1..n | none |
否 |
参数元素允许的数量:
|
服务定义中可以包含 <create-instance>、 <interceptor>、<invoke-factory> 、<parameters-schema>定义。
4、服务的创建
服务可以通过两种方式来构造实例创建和实现工厂,实例创建表现为<create-instance>元素,实现工厂表现为<invoke-factory>元素。
- <create-instance> 直接实例化一个接口的实现类
属性 |
类别 |
必需 |
描叙 |
class |
类名 |
是 |
用来实例化的类名,此类中的属性不需要额外配置 |
model |
primitive | singleton | threaded | pooled |
否 |
指定构造模式,singleton是默认模式 |
- <invoke-factory> 通过另一个服务来实例化一个接口的实现类,它包含一个service-id属性,定义了一个实现ServiceImplementationFactory接口的服务。通过此方式创建的service将通过service的接口类型自动绑定各个服务。
属性 |
类别 |
必需 |
描叙 |
service-id |
字符串 |
否 |
工厂服务的id,可以是统一模块中的简单id,也可以是全写的id。如果没有确定,默认为hivemind.BuilderFactory服务 |
model |
primitive | singleton |
否 |
指定构造模式,singleton是默认模式 |
5、拦截器的定义
拦截器使用<interceptor>来表示,属性service-id标识一个服务拦截器工厂服务,工厂服务实现了ServiceInterceptorFactory接口。
属性 |
类别 |
必需 |
描叙 |
service-id |
字符串 |
是 |
服务的id |
before |
字符串 |
否 |
一个服务id的列表,这些服务需要在此服务后执行 |
after |
字符串 |
否 |
一个服务id的列表,这些服务需要在此服务前执行 |
name |
字符串 |
否 |
用来排序,没有指定的话,默认为service-id |
服务id的列表以逗号分隔每个服务。
6、工厂参数的定义
<invoke-factory>可能需要取得一些参数来配置需要的信息,所以定制工厂的参数是必要的。Schema用于统一定义数据的表现形式,针对参数的定义有个具体的parameters-schema来使用,parameters-schema不象shema那样可以单独定义,它只能出现在<service-point>定义中,而且跟parameters-schema-id的定义互斥,两者只能出现一个。
推荐阅读
-
Hivmind使用指南(一)
-
javascript pattern只允许数字,英文字母和一些特殊字符 博客分类: Java编程PHP编程Web前端开发 HTMLWebJavaScriptjQuery
-
Photoshop 一张时尚的卡通音乐壁纸
-
Hivmind使用指南(一)
-
javascript pattern只允许数字,英文字母和一些特殊字符 博客分类: Java编程PHP编程Web前端开发 HTMLWebJavaScriptjQuery
-
如何用120行Java代码写一个自己的区块链
-
记一次linux lvm的扩展 博客分类: 服务器
-
第一次使用netbeans及创建web应用程序 博客分类: java base NetbeansJavaEE
-
SQLServer中常用的一些操作表,字段和索引的SQL语句
-
Oracle 10g clusterware 安装中遇到的一个问题