在我看来,模板是静态类型的事实实际上是一件好事:可以保证,如果模板编译成功,调用模板不会失败。
但是,它确实在调用站点上增加了一些样板。但是您可以减少它(而不会失去静态键入优势)。
在Scala中,我看到了两种实现方法:通过动作组合或使用隐式参数。在Java中,我建议使用Http.Context.args
映射存储有用的值并从模板中检索有用的值,而不必显式传递为模板参数。
使用隐式参数
将menus
参数放在main.scala.html
模板参数的末尾,并将其标记为“隐式”:
@(title: String)(content: Html)(implicit menus: Seq[Menu])
<html>
<head><title>@title</title></head>
<body>
<div>
@for(menu<-menus) {
<a href="#">@menu.name</a>
}
</div>
@content
</body>
</html>
现在,如果您有调用此主模板的模板,则在这些模板中也将它声明为隐式参数的情况下,可以让Scala编译器将menus
参数隐式传递给main
模板:
@()(implicit menus: Seq[Menu])
@main("SubPage") {
...
}
但是,如果要从控制器隐式传递它,则需要提供它作为隐式值,该值可在调用模板的作用域中使用。例如,您可以在控制器中声明以下方法:
implicit val menu: Seq[Menu] = Menu.findAll
然后,您可以在操作中编写以下内容:
def index = Action {
Ok(views.html.index())
}
def index2 = Action {
Ok(views.html.index2())
}
您可以在此博客文章和此代码示例中找到有关此方法的更多信息。
更新:一篇好的博客贴子展示这种模式也被写在这里。
使用动作合成
实际上,将RequestHeader
值传递给模板通常很有用(例如,参见本示例)。这不会为您的控制器代码添加太多样板,因为您可以轻松编写接收隐式请求值的操作:
def index = Action { implicit request =>
Ok(views.html.index()) // The `request` value is implicitly passed by the compiler
}
因此,由于模板通常至少会收到此隐式参数,因此您可以将其替换为包含菜单等更丰富的值。您可以通过使用Play 2 的动作组合机制来做到这一点。
为此,您必须定义您的Context
类,并包装基础请求:
case class Context(menus: Seq[Menu], request: Request[AnyContent])
extends WrappedRequest(request)
然后,您可以定义以下ActionWithMenu
方法:
def ActionWithMenu(f: Context => Result) = {
Action { request =>
f(Context(Menu.findAll, request))
}
}
可以这样使用:
def index = ActionWithMenu { implicit context =>
Ok(views.html.index())
}
您可以将上下文作为模板中的隐式参数。例如main.scala.html
:
@(title: String)(content: Html)(implicit context: Context)
<html><head><title>@title</title></head>
<body>
<div>
@for(menu <- context.menus) {
<a href="#">@menu.name</a>
}
</div>
@content
</body>
</html>
使用动作组合可以使您将模板所需的所有隐式值聚合为一个值,但是另一方面,您可能会失去灵活性。
使用Http.Context(Java)
由于Java没有Scala的隐式机制或类似机制,因此,如果要避免显式传递模板参数,一种可行的方法是将它们存储在Http.Context
仅在请求期间有效的对象中。该对象包含args
type 的值Map<String, Object>
。
因此,您可以按照文档中的说明编写拦截器开始:
public class Menus extends Action.Simple {
public Result call(Http.Context ctx) throws Throwable {
ctx.args.put("menus", Menu.find.all());
return delegate.call(ctx);
}
public static List<Menu> current() {
return (List<Menu>)Http.Context.current().args.get("menus");
}
}
静态方法只是从当前上下文中检索菜单的快捷方式。然后注释您的控制器以与Menus
动作拦截器混合:
@With(Menus.class)
public class Application extends Controller {
// …
}
最后,menus
从模板中检索值,如下所示:
@(title: String)(content: Html)
<html>
<head><title>@title</title></head>
<body>
<div>
@for(menu <- Menus.current()) {
<a href="#">@menu.name</a>
}
</div>
@content
</body>
</html>