欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

Hivmind使用指南(一)  

程序员文章站 2024-02-20 18:13:04
...

一、service的定义

1、概述

hivemind中,一个service是一个简单的实现特定接口的对象,你可以提供此接口的核心实现,使用者可以通过实现此接口来覆盖你的实现。模块的定义可以包含<service-poit>元素来定义服务,一个模块可以包含任意多的服务。

2、创建模式

Service有四种创建模式:primitive(主要的)、singleton(单例的)、threaded(线程的)和pooled(池化的)。在primitivesingleton模式中,每一个服务最终只会生成一个实例。在threadedpooled模式中,同时可能有多个实例,但是每个线程只会有一个实例。各个模式的定义如下:

Primitive服务在第一次参考时被构造

Singleton服务在第一此调用接口的方法时被构造

Threaded:第一次调用接口的方法时构造,并绑定到当前线程

PooledThreaded,但服务的实现被储存在池中

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

字符串

用来参考模块中定义的schemaschema定义了此服务需要用到的参数,当服是通过ServiceImplementationFactory或者 ServiceInterceptorFactory.类定义时。

parameters-occurs

unbounded | 0..1 | 1 | 1..n | none

参数元素允许的数量:

  • unbounded: 无穷
  • 0..1: 可选
  • 1 (default) :必须
  • 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
| threaded | pooled

指定构造模式,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使用指南(一)
            
    
    
         Hivmind使用指南(一)