PlayFramework 一步一步来 之 页面模板引擎

Play的魔板引擎本人认为可以说是为full stack Developers量身打造的功能。在原有的html页面基础上,只需要在html文件名后缀名前面加上”.scala“,就可以在页面上写Scala代码,而且页面之间可以像函数一样被”调用“。例如:index.html本身这个文件中不能够写scala代码,但是如果index.html后缀名前加上”.scala“变为”index.scala.html“,就可以在其中写scala代码了,”index.html“变为”index.scala.html“后,就会被看成一个scala文件,编译的时候会当做一个object来编译;是不是有点JSP的感觉?但是比JSP更爽,JSP必须是一个完整的html文件,而play 的魔板引擎可以”拼凑“,就是可以一个功能模块写一个文件,或者共同的模块儿抽象出来,写成一个公共的模块文件,然后被其他文件调用。有了play魔板引擎,写页面变的如此简单!PlayFramework 一步一步来 之 页面模板引擎

下面我们对play的页面魔板引擎做一个简单的介绍:

其实play的页面魔板引擎并不是为play而生的,它本身就是一个简单框架,有自己的名字,叫:”Twirl“,Twirl并不是依赖着play而存在的,它是一个单独的项目,具体请关注https://github.com/playframework/twirl/blob/master/README.md。

一个play 的页面魔板 是一个包含少量scala代码块的简单的text文件。页面魔板可以在任何文本格式的文件中触发,例如:HTML、XML或者CSV等。

页面魔板将会被编译成标准的Scala函数,假如你创建了一个views/Application/index.html页面魔板文件,它会生成一个包含applay()方法的views.html.Application.index类。

好了,正式开始:

play的页面模板是从神奇”@“字符开始的。在页面模板中,加入”@“后,就可以写Scala代码了,可以是变量、函数、对象、代码块…任何Scala相关的东西。

例如:

1、 Hello  @customer.name     !   在这里,”customer“代表的就是一个对象,name是customer的属性

2、Hello @{customer.firstName +customer.lastName}!看见了没有加了”@“后可以直接写Scala的代码,这样为动态的赋值增加了便利

3、Hello @{val name=customer.firstName +customer.lastName;name}  注意:这样输出的是”name“的值,很像Scala函数返回值的写法有木有?

加一个”@“有神奇的效果,但是两个”@“:”@@“就是脱离这种效果了PlayFramework 一步一步来 之 页面模板引擎,大家要注意。

页面模板就像一个函数,函数当然可以有参数,如果你想加参数,就得在文件的上面 定义:@(customer:Customer,order:List[Order]),完全是Scala函数的定义方法 有木有?也可以这样:@(title:String=”Home“) 还可以柯里化的形式,像这样:@(title:String)(body:Html),总之就是Scala函数的定义方法基本都可以。

循环:play 页面模板推荐使用增强for循环

例: <ul>

@for(p <-products){

<li>@p.name ($@p.price)</li>

}

</ul>

这里有个需要注意的地方:”{“必须和”for“字段在同一行

if语句:

例:@if(items.isEmpty){

<h1>Nothing to display</h1>

}else{

<h1>@items.size.items!</h1>

}

声明可以再度使用的代码块:(函数)

例1:     @display(product:Product)={

@product.name($@product.price)

}

<ul>

@for(product <- products){

@display(product)

}

例2:

@title(text:String)=@{

text.split(' ').map(_.capitalize).mkString(" ")

}

<h1>@title("hello world")</h1>

这个·用法非常的常用,可以在这个语法块中处理相关的逻辑,然后得出一个返回值,然后再别处调用。

顺便说一下:如果你想定义一个隐士的变量,必须在@之后以”implicit“开头命名就可以,例如:

@implicitFieldConstructor=@{MyFieldConstructor()}

注意:implicit和名字必须是连起来的,@implicit FiledConstructor这样写是不行的。

声明可以使用的值

@defining(user.firstName+" "+user.lastName){ fullName =>

<div>Hello @fullName </div>

}

注意:fullName的作用范围仅仅是”{}“之内,出了”{}“就不好用了

引入声明:

你可以引入任何你先引入的东西,类、包等等

例子:

@(customer:Customer,orders:List[Order])

@import utils._

注释:

play 页面模板的注释:@* *@

例子:

@*********************
* This is a comment *
*********************@

你可以放一条注释在模板的首页,作为Scala API的文档:

@*************************************
* Home page. *
* *
* @param msg The message to display *
*************************************@
@(msg: String) <h1>@msg</h1>

输出真实的HTML:

<p>
@Html(article.content)
</p>
上一篇:SUSE12Sp3-kafka安装


下一篇:POJ 1286 Necklace of Beads(Polya原理)