指南, 教程 & 参考手册

Browse

Contents

好书推荐

国内书籍(将于2012年出版)

国外书籍(电子图书)

Play 可以做的 5 件很酷的事

本章译者:@Playframwork

通过 5 个实例,透视 Play 框架背后的哲学。

绑定 HTTP 参数到 JAVA 方法参数

用 Play 框架,在 Java 代码中获取 HTTP 请求参数是非常简单的,只需要声明方法的参数名和 HTTP 请求的参数名一样就可以了。

例如,这个请求:

/articles/archive?date=08/01/08&page=2

datepage 声明为 Java 方法的传入参数,就可以获取 HTTP 请求中 date 和 page 参数的值了:

public static void archive(Date date, Integer page) {
    List<Article> articles = Articles.fromArchive(date, page);
    render(articles);
}

Play 框架会根据声明的 Java 参数类型,自动把 HTTP 请求参数转换成对应的 Java 对象。

这种自动绑定也适用于 任何的 Java 对象

public class Person {
    public String name;
    public Integer age;
}

一个简单的用于添加用户的控制器的 action 方法可以像这样:

public static void add(Person p) {
    p.save();
}

对应的 HTML 表单域使用复合的参数名:

<form action="/Directory/add" method="POST">
    Name: <input type="text" name="p.name" />
    Age: <input type="text" name="p.age" />
</form>

通过调用对应的 Java 方法进行重定向

Play 没有等价于 Java Servlet forward 命令的方法,但是实现重定向确实非常简单。只需调用相应的 Java 方法,Play 就会自动生成正确的重定向( HTTP Redirect )响应给客户端。

public static void show(Long id) {
    Article article = Article.findById(id);
    render(article);
}
 
public static void edit(Long id, String title) {
    Article article = Article.findById(id);
    article.title = title;
    article.save();
    show(id);
}

注意在 edit 方法的最后,是如何使我们重定向到 show 方法对应的页面的。

在任何模板文件中,你可以利用同样的语法生成链接:

<a href="@{Article.show(article.id)}">${article.title}</a>

将会生成以下 HTML 内容:

<a href="/articles/15">My new article</a>

不要重复地将 Java 对象传递到模板文件

在大多数的 Java 框架中,为了把 Java 对象传递到模板文件,通常你需要类似这样写:

Article article = Article.findById(id);
User user = User.getConnected();
Map<String, Object> model = new HashMap<String,Object>();
model.put("article", article);
model.put("user", user);
render(model);

使用 Play,你只须这样写:

Article article = Article.findById(id);
User user = User.getConnected();
render(article, user);

然后你就可以从模板中获取相应的 Java 变量。这样剩下了不少重复无用的代码…

JPA 持久化

JPA 无疑是目前 Java 领域最佳的对象关系映射框架( ORM )。如果你熟悉 JPA,你会惊讶于它在 Play 框架中变得如此简单。不需要任何配置,Play 会自动启动 JPA 实体管理器,并在代码发生修改时自动地同步。

而且如果你使用 Play 提供的 play.db.jpa.Model 作为超类时,它会帮助你把代码写得更漂亮。来看一下:

public void messages(int page) {
    User connectedUser = User.find("byEmail", connected()).first();
    List<Message> messages = Message.find(
        "user = ? and read = false order by date desc",
        connectedUser
    ).from(page * 10).fetch(10);
    render(connectedUser, messages);
}

简单易用的文件上传管理

在 Play 框架里文件上传管理非常简单。

以下 HTML 表单:

#{form @uploadPhoto(), enctype:'multipart/form-data'}
    <input type="text" name="title" />
    <input type="file" id="photo" name="photo" />
    <input type="submit" value="Send it..." />
#{/}

和这段 Java 代码:

public static void uploadPhoto(String title, File photo) {
   ...
}

就完成了! 再简单不过了吧?