Turbine实战(下)

原创 2003年07月25日 10:32:00

3.3.2 Layout

Layout相当于ScreenNavigation的容器。负责页面的布局控制。

模板化Layout,实际上就是以.vm文件作为Layout模板,使用Velocity来进行页面布局控制。

我们已经在2.2节中见到过一个Layout的模板。可以看到,在这个模板文件中,没有包含任何可显示的数据,仅有的都是一些用来控制布局用的HTML元素。Okay,相信聪明的你都明白我将要说什么了:Layout模板相当于一个有着很多的格子的盒子。而我们唯一需要做的,就是把NavigationScreen等这些“插件”放到这些格子里去。此时,Layout就相当于表述层中的Controller。写到这里,我不禁为Turbine开发者如此的用心良苦表示钦佩与感谢。

在上一节中,我们已经用Velocity制作了一个简单的Screen。除了需要将基类换为VelocityOnlyLayout[i]以外,使用Velocity编写Layout的步骤跟Screen是完全一样的。Layout模板文件放置在“TEMPLATES-PATH/layouts/”目录下。

现在,让我们再来看一下2.2节中Layout模板里的几个主要变量:

l        $screen_placeholder 非常重要的一个变量。这个变量放置的地方就是Screen将要被输出的地方。这个变量里填充的就是保存在String对象里的Screen文本信息。

l        $navigation 这个变量是用来取得Navigation的。它的对象类型是:org.apache.turbine.util.template.TemplateNavigation

l        $data 不用多说,就是RunDataJ

3.3.3 Navigation

NavigationVelocity实现方式跟ScreenLayout完全一致。Navigation模板放置的地方为:“TEMPLATES-PATH/navigations/”目录。可以使用的基类为:VelocityNavigation

3.3.4 Action

当浏览器中输入的URI中包含Action参数,即类似这样时:

http://www.server.com/servlet/Turbine/template/HelloWorld.vm/action/UpdateWorld

Action将会被触发并执行。

此时,Turbine按照以下顺序执行:

首先,位于“WEB-INF/classes/com/yourcompany/app/modules/actions/”下的UpdateWorld class将会被执行;随后,执行HelloWorld class(如果存在的话);最后,执行HelloWorld.vm

Action是一个执行特定事务的模块。这些事务可能是发一封mail,也可能是操作数据库,或其他可能的事务。Action执行结束后不返回任何值,仅有可能通过RunData.setMessage()方法在RunData中放置一条Message。但是,在Action的事务处理过程中,有可能改变或中断即将被执行的TemplateScreen

Velocity同样提供了对Action的支持,但与上面提到的三个模块(ScreenLayoutNavigation)不同的是,Action不需要编写对应的模板文件。下表就是一个简单的Action

package com.yourcompany.app.modules.actions;

 

// Velocity Stuff

import org.apache.velocity.context.Context;

 

// Turbine Stuff

import org.apache.turbine.util.RunData;

import org.apache.turbine.modules.actions.VelocityAction;

 

public class AddUser extends VelocityAction

{

    public void doPerform( RunData data, Context context ) throws Exception

    {

        if ( data.getParameters().getString("username",null) == null)

        {

            data.setMessage("Username does not exist");

            setTemplate ( data, "AddUser.vm" );

            return;

        }

 

        // store user info into database

        data.setMessage("Information stored!");

        setTemplate( data, "MainMenu.vm");

 

        // stuff something into the Velocity Context

        context.put ("variable", "foo");

    }

}

它检查提交的数据中是否包含“username”变量。如果不包含的话,将切换到“AddUser.vm”模板,并显示了一个错误提示。否则,转换到“MainMenu.vm”,并显示相应的提示信息,除此之外,还在Velocity Context中放入了一些数据。

3.3.4.1 Velocity Action Event

上面只是Action的一个简单用法,Turbine还提供一种机制,就是Action Event。通过Action Event机制,Turbine提供了一种非常便利的处理form submission的方法,使得我们可以更快速的开发Turbine应用。

为了明白Action Event机制的原理,我们先复习一下Turbine的相关内容J

Turbine接受到一个包含Action请求的URI时,首先执行这个Action,然后……噢,对的,就是这样。然而,对于那些继承自ActionEvent的类来说,在这个Action被执行时,发生了一些奇妙的事……

给大家留个悬念先,让我们来看一下代码J

public class NewUserFoo extends VelocityAction

{

    public void doAdd (RunData data, Context context) throws Exception

    {

        // put code here to add the user to the system

        context.put ("username", username );

        data.setMessage("User Added!");

    }

 

    public void doPerform(RunData data, Context context) throws Exception

    {

        data.setMessage("Button not found!");

    }

}

然后,在我们的HTML tag中嵌入这样的代码:

<form method="post" action="$link.setAction("NewUserFoo ")">

<input type="submit" name="eventSubmit_doAdd" value="Add User">

这一次,请大家自己看一下执行结果吧!

原来,在我们的这个继承自VelocityAction Action开始执行的时候,有一个“event”也同时传递给了它[ii]Turbine会根据这个“event”自动去执行相应的方法[iii]。如果没有指定“event”或指定的“event”没有对应的处理方法的话,doPerform()方法将会被执行。

好了,看到这样的机制给我们带来了一个什么样的结果了吗?我们可以把原来需要用一个Action类来完成的事务写到ActionEvent类的一个方法里!这样,我们就不必为每一个“Action”都写一个对应的类,给我们日后的程序维护和文档维护带来了非常大的便利之处。尤其在一个页面中有很多Button的时候,我们就能更轻松的应付,并且阻止了我们陷入“if…else if…”的怪圈。

然而,为了获得这项神奇的能力,我们不得不以自由为代价……J

1、Action Event name必须以“eventSubmit_”作为前缀

2、完成Action Event的方法必须以“do”打头

3、do”之后的第一个字母必须大写,其余的字母必须小写

4 总结

本文整理了在Turbine下开发简单应用的方法步骤,主要起到一个引领入门的作用。通过本文,读者应能够快速上手,再通过一些自我实践,开发一个完整的Turbine应用不是难事。

备注

Velocity template文件的查找方式

Screen

假设在Turbine的控制流程中,data.getParameters().getString("template")返回的是“/about_us/directions/driving.vm”的话,Turbine将按照如下顺序查找相应的Screen class

4、about_us.directions.Driving

5、about_us.directions.Default

6、about_us.Default

7、Default

8、VelocityScreen(即services.VelocityService.default.screen

如果返回值为null,则VelocityScreen将会被执行,此时调用的模板文件为“templates/screens/index.vm”。

假设出现其他任何异常,比如“templates/screens/index.vm”不存在,或模板文件不合法,或发生了其他任何异常,“templates/screens/error.vm”都将被载入执行。

Layout & Navigation

此时,对于LayoutNavigation来说,将按照下面的顺序查找相应的模板文件:

1、/about_us/directions/driving.vm

2、/about_us/directions/default.vm

3、/about_us/default.vm

4、/default.vm

资源

1、  http://www.jieesoft.com/resource/jbvelocity/jbvelocity.htm, Jbuilder开发Turbine应用。

2、  http://jakarta.apache.org/builds/jakarta-turbine/tdk/release/, TDK的下载点。

3、  http://jakarta.apache.org/turbine/tdk/tdk-howto.html, TDK安装指南。

4、  http://jakarta.apache.org/turbine/turbine-2.2.1/howto/context-howto.html, Velocity Context how-to

5、  http://httpd.apache.org/docs/mod/mod_rewrite.html, 如何用更简短的形式书写URL



[i] Turbine2.2的示例程序中,使用VelocityECSLayout作为缺省的Layout类,但这个类不支持Frame。除此之外,还提供了VelocityDirectLayoutVelocityXslLayout两个类供开发者使用。

[ii] 在这里,这个“Event”就是“eventSubmit_doAdd”。

[iii] 此时,Turbine使用java.lang.reflect包完成了这件神奇的事。不过值得注意的是:java.lang.reflect包可是一个“大名”昭著的性能杀手。

Turbine实战(下)

  • zgqtxwd
  • zgqtxwd
  • 2008年04月25日 14:21
  • 101

Spring Cloud中Hystrix仪表盘与Turbine集群监控

Hystrix仪表盘,就像汽车的仪表盘实时显示汽车的各项数据一样,Hystrix仪表盘主要用来监控Hystrix的实时运行状态,通过它我们可以看到Hystrix的各项指标信息,从而快速发现系统中存在的...
  • u012702547
  • u012702547
  • 2017年10月13日 11:59
  • 4588

Turbine实战(下) menlion(原作)

3.3.2 LayoutLayout相当于Screen、Navigation的容器。负责页面的布局控制。模板化Layout,实际上就是以.vm文件作为Layout模板,使用Velocity来进行页面布...
  • mlovex
  • mlovex
  • 2006年09月23日 21:10
  • 747

十六、断路器-Turbine 的使用

断路器-Turbine 的使用
  • dengqiang123456
  • dengqiang123456
  • 2017年07月28日 07:39
  • 1084

Spring Cloud——断路器监控Hystrix Dashboard&Turbine

在前文谈论过,服务客户端的负载均衡中,为了保证高可用的特性,我们使用了断路器Hystrix。 回顾一下,Hystrix做了什么事情呢? 在标注了HystrixCommand注解的方法中,如果该方法执行...
  • a60782885
  • a60782885
  • 2017年04月15日 19:05
  • 2595

九、Spring Cloud系列:实战经验总结

GitHub项目cloud-phantom,里面包含全套的Spring Cloud生态体系的构建。从 eureka/config/zuul/hystrix/turbine/admin/zipkin等配...
  • KingBoyWorld
  • KingBoyWorld
  • 2017年11月27日 13:46
  • 138

史上最简单的SpringCloud教程 | 第十三篇: 断路器聚合监控(Hystrix Turbine)

上一篇文章讲述了如何利用Hystrix Dashboard去监控断路器的Hystrix command。当我们有很多个服务的时候,这就需要聚合所以服务的Hystrix Dashboard的数据了。这就...
  • forezp
  • forezp
  • 2017年04月18日 21:54
  • 36637

springcloud(第五篇)springcloud turbine

spring cloud turbine简介turbine是聚合服务器发送事件流数据的一个工具,hystrix的监控中,只能监控单个节点,实际生产中都为集群,因此可以通过 turbine来监控集群下...
  • liaokailin
  • liaokailin
  • 2016年05月08日 09:56
  • 20070

Turbine实战(上)

  • zgqtxwd
  • zgqtxwd
  • 2008年04月26日 01:31
  • 134

使用Maven构造Turbine项目

一 关于Maven    它是一个命令行构建工具.本身配置比较简单.主要是几个环境变量的设置.在${Maven.home}/bin/下有个批处理文件maven.bat,其中:@REM --------...
  • keepeye
  • keepeye
  • 2005年07月15日 16:15
  • 1217
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Turbine实战(下)
举报原因:
原因补充:

(最多只允许输入30个字)