完成显示并发表评论功能
编写博客详细内容的页面,该页显示博客的所有评论,并可以添加新的评论!
创建显示评论的action
为了显示博文的详细页面,需要在Application.java中增加新的action的方法,这个action叫做show()
/**
* 显示详细的博文评论
*/
public static void show(Long id) {
Post post = Post.findById(id);
render(post);
}
这个action将使用模板进行显示。
添加show()对应的模板
增加yabe\app\views\Application\show.html
#{extends 'main.html' /}
#{set title:'Home' /}
<!-- 调用前面已经编写好的display模板进行显示 -->
#{display post:post, as:'full' /}
为详细页面添加链接
修改yabe\app\views\tags\display.html
设置具体的链接路径,通过@{...}进行路径的设置
<h2 class="post-title">
<!-- 设置标题的超链接,将跳转到博文的详细页面 -->
<a href="@{Application.show(_post.id}}">${_post.title}</a>
</h2>
刷新页面,标题已经可以链接到某个URL了!
http://localhost:9000/application/show?id=1
点击About the model layer,显示详细评论
添加返回主页面的链接
修改yabe\app\views\main.html,加入返回主页的链接
<div id="title">
<span class="about">About this blog</span>
<!-- 设置返回主页的链接 -->
<h1><a href="@{Application.index()}">${blogTitle}</a></h1>
<h2>${blogBaseLine}</h2>
</div>
点击Yet another blog即可返回主页
现在,就可以实现主页和详细页面的导航了!
指定更好的(RESTful风格)的URL
把http://localhost:9000/application/show?id=1这种格式的URL替换为:
http://localhost:9000/post?id=1这样风格的URL!
前面所看到的URL如/application/show?id=1 ,play使用默认的路由对其进行解析
在yabe\conf\routes中,有这样一句
# Catch all
* /{controller}/{action} {controller}.{action}
作为默认的路由解析配置,所以/application/show?id=1 将执行Application控制器的show()方法,并传入参数id=1,进行方法的调用!
可以配置route文件,指定更友好的路由方式
在第一个路由之后添加下面这条路由
# restful style route
GET /post/{id} Application.show
/post/{id}表示:id参数将从路径中获取
如/application/show?id=1 将显示为/post/1
添加分页功能
为了实现用户在博文之间导航(上一篇、下一篇)的功能,需要扩展Post类
修改yabe\app\models\Post.java
/**
* 前一篇博文
*/
public Post previous() {
return Post.find("postedAt < ? order by postedAt desc", postedAt).first();
}
/**
* 后一篇博文
*/
public Post next() {
return Post.find("postedAt > ? order by postedAt asc", postedAt).first();
}
接下来,在show.html中添加链接(在#{display /} 之前)
#{extends 'main.html' /}
#{set title:'Home' /}
<!-- 导航:上一篇,下一篇 -->
<ul id="pagination">
<!-- 前一篇 -->
#{if post.previous()}
<li id="previous">
<a href="@{Application.show(post.previous().id)}"> ${post.previous().title} </a>
</li>
#{/if}
<!-- 下一篇 -->
#{if post.next()}
<li id="next">
<a href="@{Application.show(post.next().id)}"> ${post.next().title} </a>
</li>
#{/if}
</ul>
<!-- 调用display模板显示 -->
#{display post:post, as:'full' /}
添加评论的Form
首先,在Application.java中增加添加评论的action
/**
* 添加评论
*/
public static void postComment(Long postId, String author, String content) {
Post post = Post.findById(postId);
//保存评论信息
post.addComment(author, content);
//重新显示该篇博文即其评论
show(postId);
}
接着,在show.html模板中编写"窗体代码",即打开一个Form表单,用户可以添加评论
在之#{display /}后,加入如下内容
<!-- 显示一个表单,用户可以添加评论 -->
<h3>Post a comment</h3>
#{form @Application.postComment(post.id)}
<p>
<label for="author">Your name:</label>
<input type="text" name="author" id="author"/>
</p>
<p>
<label for="content">Your comment:</label>
<textarea name="content" id="content"></textarea>
</p>
<p>
<input type="submit" value="submit your comment"/>
</p>
#{/form}
刷新页面
加入表单验证功能
为窗体提供验证功能,这里对表单的所有字段进行非空验证
Play提供的验证机制让我们很容易对HTTP参数里填充的值进行验证
修改Application.java控制器中的postComment action
为其添加@Required注解,并编写错误检测代码
/**
* 添加评论
* 使用@Required注解,检测author和content参数不能为空
*/
public static void postComment(Long postId, @Required String author, @Required String content) {
Post post = Post.findById(postId);
//错误检测
if(validation.hasErrors()) {
//将post对象重新传入模板中,否则新打开的show.html中的post为null!!!
render("Application/show.html",post);
}
//保存评论信息
post.addComment(author, content);
//重新显示该篇博文即其评论
show(postId);
}
当出现错误时,将跳转到show.html模板中显示错误信息
编辑show.html,以便发生错误时能够显示错误信息
在form表单代码中,添加显示错误的代码
<!-- 显示一个表单,用户可以添加评论 -->
<h3>Post a comment</h3>
#{form @Application.postComment(post.id)}
<!-- 在这里显示提交评论时出现的错误 -->
#{ifErrors}
<p class="error">All fields are required!</p>
#{/ifErrors}
<p>
<label for="author">Your name:</label>
<input type="text" name="author" id="author"/>
</p>
<p>
<label for="content">Your comment:</label>
<textarea name="content" id="content"></textarea>
</p>
<p>
<input type="submit" value="submit your comment"/>
</p>
#{/form}
提交一个空的评论,页面提示错误信息
注意:该页面中需要使用了post对象填充input组件。
所以在出现错误时,必须将post对象一起传入到模板中!
添加更炫的UI交互
使用jQuery的相关js支持
jquery-1.6.4.min.js
jquery.tools-1.2.5.toolbox.expose.min.js
在yabe\app\views\main.html中引入以上两个js文件
<script src="@{'/public/javascripts/jquery-1.6.4.min.js'}" type="text/javascript"></script>
<script src="@{'/public/javascripts/jquery.tools-1.2.5.toolbox.expose.min.js'}" type="text/javascript"></script>
实现效果:用户点击表单输入时,突出显示form表单,淡化背景
<script type="text/javascript" charset="utf-8"> //点击form之后,将淡化form之外的背景,突出显示表单 $(function() { $("form").click(function() { $("form").expose({api: true}).load(); }); }) //如果提交表单验证失败,让form获取焦点,以便突出显示form表单 //注意: $("form .error") 中 from 后面有一个空格,然后才是 .error! if($("form .error").size()) { $("form").expose({api: true, loadSpeed: 0}).load(); $("form input[type=text]").get(0).focus(); } </script>
现在这个窗体看起来非常酷了!
增加评论成功的提示信息
成功提交一条评论后提示一条提交成功信息
使用flash作用域实现不同action之前数据的传递
在Application.java控制器的postComment action中添加成功信息
/**
* 添加评论
* 使用@Required注解,检测author和content参数不能为空
*/
public static void postComment(Long postId, @Required String author, @Required String content) {
Post post = Post.findById(postId);
//错误检测
if(validation.hasErrors()) {
//将post对象重新传入模板中,否则新打开的show.html中的post为null!!!
render("Application/show.html",post);
}
//保存评论信息
post.addComment(author, content);
//设置提交成功后的提示信息到flash作用域
flash.success("Thanks for posting %s", author);
//重新显示该篇博文即其评论
show(postId);
}
在show.html模板中添加显示这条成功信息的脚本(在页面顶部加入)
...
<!-- 评论提交成功后,显示提示信息 -->
#{if flash.success}
<p class="success">${flash.success}</p>
#{/if}
<!-- 调用display模板显示 -->
#{display post:post, as:'full' /}
...
重新提交一条评论
页面显示评论成功的提示信息
定制REST风格的URL
跳转窗体postComment action的URL。
在没有具体指定路由的情况下,play使用默认的路由来定位到某个action
打开yabe\conf\routes,增加一条路由
POST /post/{postId}/comments Application.postComment
重新评论,即可看到form表单的action路径发生了变化
http://localhost:9000/application/postcomment?postId=1
变为了
http://localhost:9000/post/1/comments (REST :推崇以资源为导向的操作)