欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

[Playframework文档中文翻译] Play 可以做的 5 件很酷的事

程序员文章站 2022-04-18 11:46:38
...

Play 可以做的 5 件很酷的事

 


(原文链接:http://play-framework.herokuapp.com/zh/5things 来自"Playframework中文小站 " )

通过 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) {
   ...
}



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

(原文链接:http://play-framework.herokuapp.com/zh/5things 来自"Playframework中文小站 " )