PlayFramework 1 模板应用 -- Java 对象扩展

涉及到页面显示的问题,用自定义标签总能够能事不少,即使是最原始的自定义 JSP 标签也有人乐此不疲,进化到  Play 中的自定义标签数得上很轻量级的实现,简单的只需要一小页文档 The template engine 就足矣。

概括起来 Play1 支持三种方式自定义标签: HTML 文件方式, 自定义 FastTags, Java 对象扩展方法. 前二者为面向过程的方式,第三种方式为面向对象的方式,是在往某种数据类型追加一个方法。

确切的说针对 Java 对象的方法的扩展并不能称之为自定义标签。

一个这样的场景,股票价格变化值要显示在页面上,根据正,负,零,再加上不同的区域四种条件分别显示为不同的颜色,比如美国分别为绿色,红色和黑色(注: 美国股市显示的颜色正好与中国相反)。假设 priceChange 是 Integer 类型,我们就可以定义对 Integer 对象的扩展,所在类必须继承自 JavaExtensions 类:

Play1 中的模板是用的是 Groovy 模板,看到后面用 ${obj.abc()} 格式来调用就知道,FastTags 是用 #{abc} 这样的形式。

以上 showFor() 函数第一个参数的类型表示是对 Integer  类型进行扩展,相当于 Integer  类型拥有了 showFor(String region) 这么个方法,其余参数才是使用标签方法时的参数列表,这里除 region 外还可以有更多。方法返回的字符串就是要在页面上输出的内容。

注:这里不能声明为 showFor(int priceChange, String region),否则会提示

Exception raised was MissingMethodException : No signature of method: java.lang.Integer.showFor() is applicable for argument types: (java.lang.String) values: [US] Possible solutions: power(java.lang.Number), power(java.lang.Integer).

我们这是要为对象 Integer 扩展方法,原始类型不能扩展方法,也就是像往集合里放对象一样,调用时只会装箱,不会拆箱。

使用方法,创建了上面的类及方法,无需作任何的配置操作,Play 就知道找到来用。

假设在 Controller  中是这样渲染模板的

int priceChange = 10;  // Integer priceChange = 10; 在 viewTemplate 中会装箱为 Integer
String region = "US";
renderTemplate("abc.html", priceChange, region);

在  abc.html 页面中就可以这么使用自定义的标签了

${priceChange.showFor('US').raw()}

到浏览器中输出的源文件就会是

<span style='color:green'>10</span>

防止直接显示 HTML 源代码除了上面 .raw() 也可以用

#{verbatim}
    ${priceChange.showFor('US')
#{/verbatim}

Java 对象扩展方法中只要第一个参数匹配的类型就被扩展了该方法,各级属性也行,如

${stock.priceChangePercentage.showFor('CN').raw()}
${(-25).showFor("US").raw()}
${100.showFor("CN").raw()}

剩下就是自己发挥的问题了。

类别: PlayFramework. 标签: . 阅读(127). 订阅评论. TrackBack.

Leave a Reply

Be the First to Comment!

avatar