Documentation

You are viewing the documentation for Play 1. The documentation for Play 2 is here.

Play でできる 5 つのすごいこと

5 つの例を通して Play framework の背後にある哲学を見てみましょう。

HTTP パラメータの Java メソッド引数への紐付け

Play では Java のコードから簡単に HTTP パラメータを探すことができます。HTTP パラメータと同じ名前でメソッド引数を宣言するだけです。

例えば、このようなリクエスト場合:

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

Java のメソッド引数として宣言することで data パラメータと page パラメータを検索することができます:

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

Play は HTTP パラメータの値を Java オブジェクトに変換するために、static メソッドの引数を使用します。

このスマートな紐付けは どのようなクラス についても動作します。

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

person を追加するシンプルなアクションコントローラはこんな感じかもしれません:

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

HTML フォームのフィールドには person を構成する名前を定義します:

<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) API です。もし JPA を知っているなら、Play で JPA がいとも簡単に利用できることに驚くでしょう。なんの設定も無しに Play は自動的に JPA のエンティティマネージャを起動し、コードがリロードされたときはまるで魔法のように同期を行います。

さらに、スーパークラス 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 action="@{Article.uploadPhoto()}" method="POST" enctype="multipart/form-data">
    <input type="text" name="title" />
    <input type="file" id="photo" name="photo" />
    <input type="submit" value="Send it..." />
</form>

Java コードはこんな感じです:

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

これ以上簡単になりますかね?