一、service的定义
1、概述
在hivemind中，一个service是一个简单的实现特定接口的对象，你可以提供此接口的核心实现，使用者可以通过实现此接口来覆盖你的实现。模块的定义可以包含元素来定义服务，一个模块可以包含任意多的服务。
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"/>
>
属性定义如下表所示
|
属性
|
类别
|
必需
|
描叙
|
|
id
|
字符串
|
是
|
服务扩展点的简单id，全写的id通过前边加上模块id来获得
|
|
interface
|
类名
|
否
|
此服务扩展点支持的接口的名字，如果没有定义，则默认为服务id，全协的名称通过前边加上模块的报名来获得
|
|
parameters-schema-id
|
字符串
|
否
|
用来参考模块中定义的schema，schema定义了此服务需要用到的参数，当服是通过ServiceImplementationFactory或者
ServiceInterceptorFactory.类定义时。
|
|
parameters-occurs
|
unbounded | 0..1 | 1
| 1..n | none
|
否
|
参数元素允许的数量：
- unbounded: 无穷
- 0..1: 可选
- 1 (default) :必须
- 1..n: 至少一个
- none:不允许
|
服务定义中可以包含、 、 、定义。
4、服务的创建
服务可以通过两种方式来构造实例创建和实现工厂，实例创建表现为元素，实现工厂表现为元素。
|
属性
|
类别
|
必需
|
描叙
|
|
class
|
类名
|
是
|
用来实例化的类名，此类中的属性不需要额外配置
|
|
model
|
primitive | singleton | threaded | pooled
|
否
|
指定构造模式，singleton是默认模式
|
- 通过另一个服务来实例化一个接口的实现类，它包含一个service-id属性，定义了一个实现ServiceImplementationFactory接口的服务。通过此方式创建的service将通过service的接口类型自动绑定各个服务。
|
属性
|
类别
|
必需
|
描叙
|
|
service-id
|
字符串
|
否
|
工厂服务的id，可以是统一模块中的简单id，也可以是全写的id。如果没有确定，默认为hivemind.BuilderFactory服务
|
|
model
|
primitive | singleton
| threaded | pooled
|
否
|
指定构造模式，singleton是默认模式
|
5、拦截器的定义
拦截器使用来表示，属性service-id标识一个服务拦截器工厂服务，工厂服务实现了ServiceInterceptorFactory接口。
|
属性
|
类别
|
必需
|
描叙
|
|
service-id
|
字符串
|
是
|
服务的id
|
|
before
|
字符串
|
否
|
一个服务id的列表，这些服务需要在此服务后执行
|
|
after
|
字符串
|
否
|
一个服务id的列表，这些服务需要在此服务前执行
|
|
name
|
字符串
|
否
|
用来排序，没有指定的话，默认为service-id
|
服务id的列表以逗号分隔每个服务。
6、工厂参数的定义
<invoke-factory>可能需要取得一些参数来配置需要的信息，所以定制工厂的参数是必要的。Schema用于统一定义数据的表现形式，针对参数的定义有个具体的parameters-schema来使用，parameters-schema不象shema那样可以单独定义，它只能出现在定义中，而且跟parameters-schema-id的定义互斥，两者只能出现一个。