在Turbine中实现自己的服务是非常轻易的一件事.你的类只需要继续org.apache.turbine.services.TurbineBaseService(这是必须的,只有这样,Turbine的ServiceBroker才能启动你的服务).
要告诉Turbine你的这个服务,你必需在TrubineResources.properties里这样配置:
services.MyServiceName.classname = full.class.name.of.your.service
配置好以后,当有程序请求这个服务的时候,Turbine会初始化这个服务.必须说明的是,你的服务并不是在Turbine启动的时候初始化的.这叫"lazy init",假如你需要你的服务在Turbine启动是就初始化,你必须在TurbineResources.properties里添加另一条配置:
services.MyServiceName.earlyInit = true
假如你查看一下db/TurbinePoolBrokerService或者servlet/TurbineServletService这两个简单的示例的话,你上手会更快一点.
In a Nutshell
* 你不能试着提供带参数的构造函数,最好是不提供构造函数,因为在类构造时不需要做任何事情(我们只需要默认的构造函数就好了).
* 你的服务只能初始化一次.因此,你的类必须是线程安全的(threadsafe),不能使用类级的变量来处理Session级的请求.
* 你需要提供一个"init()"方法,Turbine会在第一次请求的时候调用他(假如earlyInit=true,则是在Turbine启动时)并且初始化你的服务相关的内容.令人迷惑的是"init()"方法到底应该是什么样的?因为Turbine使用不同的方法来进行服务的初始化.不过,从 Turbine2.2开始,你只需要提供一个不带参数的方法就可以了:
public void init() throws InitializationException
{
}
* 假如正常初始化结束来,你必须调用"setInit(true)",否则你的服务仍然不能响应任何的用户请求.当你这么设置以后,你的服务服务就有可能被调用,所以你就不能再次调用"setInit()"了.
* 你可以提供一个"shutdown()"方法,Turbine会在自己关闭之前调用他.你可以在这里清理你服务的一些内部数据,在执行完"shutdown()"之前,你应该调用"setInit(false)".
一般的模式
假如你要实现一个FooService,声明一个继续org.apache.turbine.services.Service的接口 (your.package.FooService)是一个好习惯.这个接口应该提供一个叫SERVICE_NAME的常量,这是你的服务的名字,比如:
[code]
package your.package;
import org.apache.turbine.services.Service;
public interface FooService extends Service
{
/**
* 服务的标记,应该是唯一的,以区分开别的服务
*/
public String SERVICE_NAME = "FooService";
[...]
}
[/code]
your.package.TurbineFooService.Java 继续了org.apache.turbine.services.TurbineBaseService类并且实现your.package.FooService并提供来具体的实现 ,如:
[code]
package your.package;
import org.apache.turbine.services.TurbineBaseService;
public class TurbineFooService
extends TurbineBaseService
implements FooService
{
/**
* 在这里提供具体的实现
*/
[...]
}
[/code]
your.package.TurbineFoo.java 提供一些静态的facade方法来调用你的服务,如:
[code]
import org.apache.turbine.services.TurbineServices;
public class TurbineFoo
{
protected static FooService getService()
{
return (FooService) TurbineServices
.getInstance().getService(FooService.SERVICE_NAME);
}
[...]
public static void fooMethod1()
{
getService().fooMethod1();
}
public static int fooMethod2(int bar)
{
return getService().fooMethod2(bar);
}
[...]
}
[/code]
用户调用你的服务只需要简单的"TurbineFoo.fooMethod1();",在调用的代码里就不需要知道具体实现的类是哪一个.
注重:在Turbine2.1和2.2中治理服务的生命周期(lifecycle)的init()和shutdown()方法可能在以后的版本中有所改变的.
