[翻译]Play框架1.2.7版本教程(9) - 自定义编辑区域

摘要：自定义编辑区域在前一章，我们给创建了一个关于面板，并准备了我的文章的部分。从文章列表开始我们仅需要查询用户相关的文章并显示出来。如果发生错误，它会刷新表单，显示错误信息。它表示使用的默认模板。这意味着，如果提交了参数，将选择这条路由。

在前一章，我们给yabe创建了一个关于面板，并准备了“我的文章”的部分。每个作者可以在这个部分看到他们发布过的文章，以及进行编辑或者创建新的文章。

我们可以重用CRUD模块来实现这部分。但是这里我们打算从头开始，因为我们需要许多自定义的设置。

我们仅需要查询用户相关的文章并显示出来。这很简单。从改进Admin.index action开始吧：

public static void index() {
    String user = Security.connected();
    List posts = Post.find("author.email", user).fetch();
    render(posts);
}

并完成yabe/app/views/Admin/index.html:

#{extends "admin.html" /}

Welcome ${user}, you have written ${posts.size() ?: "no"} 
${posts.pluralize("post", "posts")} so far

#{list items:posts, as:"post"}
    

        ${post.title}
    
#{/list}


    + write a new post

看看第一步的成果：

我们将创建一个用于发布文章的界面。一般对于一个表单，你可以做两件事：显示它，处理它提交的结果。让我们创建Admin.form"和Admin.save`来帮助显示和处理提交结果。

添加新的路由到yabe/conf/routes:

GET     /admin/new                          Admin.form
POST    /admin/new                          Admin.save

接着给Admin.java控制器添加form()和save()：

public static void form() {
    render();
}

public static void save() {
    // Not implemented yet
}

然后是创建yabe/app/views/Admin/form.html模板：

#{extends "admin.html" /}

Write, a new post

#{form @save()}

    #{ifErrors}
        

            Please correct these errors.
        
    #{/ifErrors}

    

        #{field "title"}
        Post title:
        
        #{error "post.title" /}
        #{/field}
    

    

        #{field "content"}
        Write here:
        ${post?.content}
        #{error "post.content" /}
        #{/field}
    

    

        #{field "tags"}
        Enter some tags:
        
        #{/field}
    

    

        
    

#{/form}

最后修改yabe/app/views/Admin/index.html，给表单添加Write a new post的链接：

...

    + write a new post

...

检查成果：

现在我们来完成处理提交结果的。它将创建一个新的Post对象，转换标签列表成真正的Tag列表，并验证所有成员，进行保存。如果发生错误，它会刷新表单，显示错误信息。

public static void save(String title, String content, String tags) {
    // Create post
    User author = User.find("byEmail", Security.connected()).first();
    Post post = new Post(author, title, content);
    // Set tags list
    for(String tag : tags.split("s+")) {
        if(tag.trim().length() > 0) {
            post.tags.add(Tag.findOrCreateByName(tag));
        }
    }
    // Validate
    validation.valid(post);
    if(validation.hasErrors()) {
        render("@form", post);
    }
    // Save
    post.save();
    index();
}

  
这里我们使用render("@form")作为render("Admin/form.html")的缩写。它表示使用form action的默认模板。

测试一下！

在发布文章的地方，我们已经写了不少的HTML表单和Java action代码。但我们还需要实现编辑现有文章的修改功能。只需改动一下，我们可以重用原来的代码。

首先我们需要Admin.form可以查询到一个现有的Post：

public static void form(Long id) {
    if(id != null) {
        Post post = Post.findById(id);
        render(post);
    }
    render();
}

如你所见，我们把查询功能变成可选的，仅当id参数不为空，才会去查询一个现有文章。所以你可以链接主页面的文章列表到编辑表单。修改yabe/app/views/Admin/index.html：

#{extends "admin.html" /}

Welcome ${user}, you have written ${posts.size() ?: "no"} ${posts.pluralize("post", "posts")} so far

#{list items:posts, as:"post"}
    

        ${post.title}
    
#{/list}


    + write a new post

非常简单，但是有一个问题。如果你查看这些链接生成的URL，会看到：

/admin/new?id=3

它能用，但是不是很好。我们可以指定另一个路由。如果指定了id参数，就用新的路由。

GET     /admin/myPosts/{id}                 Admin.form
GET     /admin/new                          Admin.form

如你所见，我们在旧的路由之上定义新路由，所以它的优先级更高。这意味着，如果提交了id参数，Play将选择这条路由。如果不是，它就选择原来那条。

刷新My posts页面，你应该能看到URL的变化。

现在我们需要修改yabe/app/views/Admin/form.html：

#{extends "admin.html" /}

#{ifnot post?.id}
    
Write, a new post
#{/ifnot}
#{else}
    
Edit, this post
#{/else}

#{form @save(post?.id)}

    #{ifErrors}
        

            Please correct these errors.
        
    #{/ifErrors}

    

        #{field "title"}
        Post title:
        
        #{error "post.title" /}
        #{/field}
    

    

        #{field "content"}
        Write here:
                  ${post?.content}
        
        #{error "post.title" /}
        #{/field}
    

    

        #{field "tags"}
        Enter some tags:
        
        #{/field}
    

    

        
    

#{/form}

如你所见，如果id参数存在，我们将用它作为提交表单的第一个参数。所以假如这个文章具有id的值（意味着它已经存在在系统中），Admin.save就会被调用。

现在我们改变save()方法，让它同时能处理创建和修改文章的情况：

public static void save(Long id, String title, String content, String tags) {
    Post post;
    if(id == null) {
        // Create post
        User author = User.find("byEmail", Security.connected()).first();
        post = new Post(author, title, content);
    } else {
        // Retrieve post
        post = Post.findById(id);
        // Edit
        post.title = title;
        post.content = content;
        post.tags.clear();
    }
    // Set tags list
    for(String tag : tags.split("s+")) {
        if(tag.trim().length() > 0) {
            post.tags.add(Tag.findOrCreateByName(tag));
        }
    }
    // Validate
    validation.valid(post);
    if(validation.hasErrors()) {
        render("@form", post);
    }
    // Save
    post.save();
    index();
}

一如之前那样，我们需要定义多一个更合适的路由，还是用之前的方式：

POST    /admin/myPosts/{id}                 Admin.save
POST    /admin/new                          Admin.save

完成了！现在我们可以用同一个方法来创建新的文章，或者修改旧的文章，而且管理面板也完成了！