yabe.administration

第三篇：play手把手教你创建一个博客项目-09.创建定制编辑区域

09.创建定制编辑区域

在之前的教程中，我们已经创建一个管理区域（administration area），并准备好了‘My posts’部分。这个页面将为每位作者提供一个属于他自己博文的列表，并且可以对这些博文进行编辑或创建新的博文。

我们可以重用CRUD模块作为这个页面的基础，但在这里，我们将以此为基础（scratch，起跑线，基础）创建一些东西，我们需要在这些屏幕里提供许多个性化的东西。

从用户博文列表开始

在这里，我们只需得到并显示当前登录用户的博文。非常简单，让我们开始增强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

第一个屏幕就准备好了: 接着写‘写一篇新博文’页面

我们将创建一个窗体来实现创建一篇新博文。通常情况下，在窗体操作时你需要两个actions：一个用于显示窗体，另一个用于处理窗体提交的信息。让我们创建这个新的Admin.form和Admin.save actions，以用于显示和处理窗体提交信息：

在abe/conf/routes里添加如下路由：

GET /admin/new Admin.form POST /admin/new Admin.save 接着在Admin.java控制器里添加form()和save()actions： 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

...检测一下结果： 接下来，我们必须完成Admin.save action，以用于处理当前窗体提交的数据。action将创建一个新的Post对象，把tag（特征）列表转换到真实的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”)的快捷方式，它只告诉play去使用窗体action的默认模板。测试下看看！

为正在编辑的Posts重用这些填充数据

我们已经定义了HTML窗体并且让Java action能够创建一个新的博客Post，但是我们同时也需要允许编辑存在的博文，因此我们可以很容易地重用相同的代码，使我们在编辑现有博文时的工作量尽量减少： 首先我们需要让Admin.form找回存在的Post: public static void form(Long id){ if(id!= null){ Post post = Post.findById(id);render(post);} render();} 正如你所看到的一样，我们使之成为可选项（通过id!=null），因此当id参数已经填值后，同样的action将用于找回存在的博文。因此，我们现在可以把主屏幕的博文列表链接到编辑窗体了。编辑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

非常好，很容易就实现了，但这里还有一个小问题。如果你看一下通过Router为这些链接生成的真实的URL，你就会发现如下样式的URL： /admin/new?id=3 它们能正常工作，但是并不太漂亮。OK，让我们对其进行修改，如果id参数提交上来，我们将使用一个不同的URL范示，路由定义如下： GET /admin/myPosts/{id} Admin.form GET /admin/new Admin.form 正如你看到的一样，我们在旧的路由之前定义了这些路由，因此它们具有更好的优先级。这也就是说，如果一个id参数被提交，play将率先使用这个URL范示，如果没有提交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} 正如你看到的一样，我们已经更新窗体目的action，以方便添加博文ID作为第一个action参数。因此当博文拥有一个id字段集时（意思是博文在系统里已经存在），窗体将发送到Admin.save action进行处理。接下来我们可以修改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();} 使用和之前同样的技巧，让URL更加完美，如果id参数存在，我们就使用优先路由：

POST /admin/myPosts/{id} Admin.save POST /admin/new Admin.save 工作全部完成！现在我们使用同一样action就实现了创建新博文与编辑旧博文的功能，同时完成了管理区域administration area）的编程工作！

第四篇：play手把手教你创建一个博客项目-04.显示并发表评论

04.显示并发表评论

博客的主页已经搞定，接下来，我们将编写博文的详细内容页面。这个页面将显示当前博文的所有评论，页面还将包括一个用于发表新评论的窗体。

创建 ‘show’ action

为了显示博文的详细页面，我们需要在Application控制器里创建一个新的action方法，这个新的action叫做show()： public static void show(Long id){ Post post = Post.findById(id);render(post);} 你可以看到，这个action非常简单。我们在方法签名里声明了一个Long类型的id参数用于自动从http请求的id变量里得到id值。这个参数会从HTTP的请求字符串、URL路径或窗体里获得

如果我们试着从http请求里传递一个错误的id值时，id变量值将为null，这时play将自动添加一个验证错误秋errors容器（变量）里。

这个action将用/yabe/app/views/Application/show.html模板进行显示： #{extends 'main.html' /} #{set title:post.title /}

#{display post:post, as:'full' /} 由于我们在之前已经编写了display标签，因此在这个页面的编码就非常简单了。

为详细页面添加链接

在display标签里，我们让所有的链接为空(使用#)。是时候让这些链接指向Application.show action了。在play里，你可以很容易在一个模板里使用@{...}注释构建链接，这个语法使用了路由的“URL反向查找”功能，用于反向查找指定action的URL。

打开/yabe/app/views/tags/display.html标签并修改： „

${_post.title}

„

刷新主页，单击博文标题以显示博文内容。非常好，但是这个页面缺少一个返回主页的链接。OK，让我们打开/yabe/app/views/main.html模板，完成标题的链接：

„

About this blog

${blogTitle}

${blogBaseline}

第五篇：play手把手教你创建一个博客项目-02.迭代编写数据模型代码

02.迭代编写数据模型代码

下面，我们将开始为我们的博客引擎写一个数据模型。

JPA介绍

在play应用程序（事实上也包括所有设计良好的应用程序）里，模型层是最为核心的地方。play是一个域驱动类型的数据表现框架，既然我们想要创建一个博客引擎，那么模型层所需要的类（比如User/Post和Comment）就应当首先考虑。

因为大多数模型对象都需要在应用程序重新启动后能够继续保存数据，因此，我们就必须把它们保存在一个可持久化的存储器里。通常，我们会选择一个关系数据库来保存数据。但是，由于java是面向对象的语言，因此，我们将使用对象关系映射来减少匹配阻抗。

Java Persistence API(JPA)是一个Java规范，它定义了一个标准的对象关系映射API集。作为JPA规范的实现，play使用众所周知的Hibernate框架来实现JPA。使用基于Hibernate API的JPA的一个优势就是所有映射都是在java对象里进行声明的。

如果在此之前你曾经用过Hibernate或JPA，那么在play里使用JPA你会感到非常惊讶，因为在Play里使用Hibernate或JPA实在是太简单了，它不需要进行任何配置即可正常工作~！

如果你不知道什么是JPA，哈哈，请在继续下面的课程之前先补补课some of these simple presentations。

创建第一个模型类User 接下来我们将开始为博客引擎编写代码，首先是创建User类，接下来让我们创建/yabe/app/models/User.java类： package models;

import java.util.*;import javax.persistence.*;

import play.db.jpa.*;

@Entity public class User extends Model {

public String email;public String password;public String fullname;public boolean isAdmin;

public User(String email, String password, String fullname){ this.email = email;this.password = password;this.fullname = fullname;} } @Entity注释使User类成为一个可被管理的JPA实体，其继承的Model超类自动为其提供了一系列非常有用的JPA帮助方法（后面我们会作介绍）。所有User类的fields（以下均称为字段，不再提示）都会自动持久化到数据库里。默认情况下，数据库表的名称为 ‘User’。在某些情况下，默认的表名可能会与数据库的保留关键字冲突，这时就需要对数据库表名进行定制，比如针对User类，可以注释为@Table(name=“blog_user”)。

继承play.db.jpa.Model类并不是必须的，你可以继续使用原始的JPA。但继承Model类是一个好的选择，通过继承Model类，你可以通过它提供的帮助方法很方便的对实体类进行操作。

如果之前你用过JPA，那么你应该知道每个JPA实体都必须提供一个@Id属性。在这里，Model超类提供了一个自动生成数字型ID的功能，在很多情况下已经足够了。

注意，请不要把Model自动提供的ID当作功能性标识符使用，只能把它当成是技术性标识符使用。通常情况下，自动生成的数字ID作为一个技术标识符是个较好的主意。

如果你是一个经验丰富的java开发者，那么你就会知道在模型对象里的字段应该是private的，访问这些字段的方式是为这些字段创建getter/setter方法。但是，在play里，字段是用public修饰的，其目的是为了编写代码的量，请别担心，事实上play会小心照顾好这些字段，自动为其生成getter/setter。刷新一下应用程序主页，看看有些什么变化没。事实上，除非代码有错误，你应该看不到任何变化。play已经自动编译和加载了User类，但是这并没有为应用程序添加任何新的特征。

编写第一个测试程序 在play里，测试新创建的User类的好方法就是编写一个JUnit单元测试。这个测试将允许你对User进行测试。

要想进行测试，你得把play切换到test模式下。首先停止当前正在运行的应用程序，在命令行输入如下命令，以切换到测试模式： ~$ play test 除了加载了一个test runner模块，以允许你在浏览器直接运行测试组件外，play test命令和play run很相似。

当play运行与测试模式时，Play将自动切换到测试框架ID，并加载相应的application.conf配置文件，参考framework ID documentation了解更多信息。在浏览器打开http://localhost:9000/@tests URL地址，就可以看到test runner了。试着选择所有默认的测试并运行它们，所有的结果都应该是绿色的„其实这些测试并没有进行任何实质性的测试。为了测试User模型（适用于所有的模型类），我们打算使用JUnit测试。正如你所看到的一样，play已经提供了一个默认的BasicTests.java文件，让我们打开看看(/yabe/test/BasicTest.java)： import org.junit.*;import play.test.*;import models.*;

public class BasicTest extends UnitTest { @Test public void aVeryImportantThingToTest(){ assertEquals(2, 1 + 1);} } 删除默认的无用的测试(aVeryImportantThingToTest)，并创建一个新的测试，在其中将试着创建一个新的user，并得到它：

@Test public void createAndRetrieveUser(){ // Create a new user and save it new User(“bob@gmail.com”, “secret”, “Bob”).save();

// Retrieve the user with e-mail address bob@gmail.com User bob = User.find(“byEmail”, “bob@gmail.com”).first();

// Test assertNotNull(bob);assertEquals(“Bob”, bob.fullname);} 正如你所看到的一样Model超类提供了两个非常有用的方法save()and find()。在play管理手册的JPA support节，你可了解更多Model类的方法。在test runner里选择BasicTests.java，单击start进行测试，可以看到结果全是绿色。

接下来，我们需要在User里创建一个验证user的username和password是否正确的方法（通过username和password来找到user）。打开User.java源文件，添加connect()方法：

public static User connect(String email, String password){ return find(“byEmailAndPassword”, email, password).first();} 在BasicTests.java里添加测试代码：

@Test public void tryConnectAsUser(){ // Create a new user and save it new User(“bob@gmail.com”, “secret”, “Bob”).save();

// Test assertNotNull(User.connect(“bob@gmail.com”, “secret”));assertNull(User.connect(“bob@gmail.com”, “badpassword”));assertNull(User.connect(“tom@gmail.com”, “secret”));} 每次修改后，你都可以直接在test runner里运行所有的测试。

创建Post类

Post类用展现发表的博客：

package models;

import java.util.*;import javax.persistence.*;

import play.db.jpa.*;

@Entity public class Post extends Model {

public String title;public Date postedAt;

@Lob public String content;

@ManyToOne public User author;

public Post(User author, String title, String content){ this.author = author;this.title = title;this.content = content;this.postedAt = new Date();} } 在这里，我们使用@Lob注释来告诉JPA这个字段是一个超大文本数据库类型，用是存储发表的内容。我们同时用@ManyToOne来声明Post与User是多对一的关系。意思是每篇博客都是单个用户写的，每个用户可是发表多篇博客。现在的PostgreSQL版本还不能存储用@Lob注释的String类型字段，解决方法是使用@Type(type = “org.hibernate.type.TextType”)进行注释。接下来，我们将编写新的测试代码用于测试Post类。但是在写更多测试代码之前，我们需要在JUnit测试类里做一些工作，比如在当前的测试代码里，数据库内容并不会删除，因此，我们每运行一次，play就会增加一个新创建的对象，这些对象会越来越多，当进行更高级的测试时，这或许会成为问题。

因此，让我们在运行每个测试之前写一个JUnit setup()方法来删除数据库： public class BasicTest extends UnitTest {

@Before public void setup(){ Fixtures.deleteDatabase();}

„ } @Before是JUnit测试工具最核心的概念。

正如你所看到的，Fixtures类帮助我们在测试期间管理数据库。接下来，我们将编写下一个测试：

@Test public void createPost(){ //创建一个新的user，并保存

User bob = new User(“bob@gmail.com”, “secret”, “Bob”).save();

// 创建一个新post new Post(bob, “My first post”, “Hello world”).save();

// 测试上一步是否创建了新的post assertEquals(1, Post.count());

// 获取所有“Bob”发表的posts List

bobPosts = Post.find(“byAuthor”, bob).fetch();

// Tests assertEquals(1, bobPosts.size());Post firstPost = bobPosts.get(0);assertNotNull(firstPost);assertEquals(bob, firstPost.author);assertEquals(“My first post”, firstPost.title);assertEquals(“Hello world”, firstPost.content);assertNotNull(firstPost.postedAt);} 千万不要忘记了导入java.util.List，否则会出现编译错误。

编写Comment类

最后一件事就是创建Comment类，为发表的博客提供评论的能力。package models;

import java.util.*;import javax.persistence.*;

import play.db.jpa.*;

@Entity public class Comment extends Model {

public String author;public Date postedAt;@Lob public String content;

@ManyToOne public Post post;

public Comment(Post post, String author, String content){ this.post = post;this.author = author;this.content = content;this.postedAt = new Date();} } Comment的测试代码: @Test public void postComments(){ // Create a new user and save it User bob = new User(“bob@gmail.com”, “secret”, “Bob”).save();

// Create a new post Post bobPost = new Post(bob, “My first post”, “Hello world”).save();

// Post a first comment new Comment(bobPost, “Jeff”, “Nice post”).save();new Comment(bobPost, “Tom”, “I knew that!”).save();

// Retrieve all comments List bobPostComments = Comment.find(“byPost”, bobPost).fetch();

// Tests assertEquals(2, bobPostComments.size());

Comment firstComment = bobPostComments.get(0);assertNotNull(firstComment);assertEquals(“Jeff”, firstComment.author);assertEquals(“Nice post”, firstComment.content);assertNotNull(firstComment.postedAt);

Comment secondComment = bobPostComments.get(1);assertNotNull(secondComment);assertEquals(“Tom”, secondComment.author);assertEquals(“I knew that!”, secondComment.content);assertNotNull(secondComment.postedAt);} 这里，你可以看到在Post和Comment之间进行导航并不容易：我们需要使用查询来找到一个博文的所有评论。在这里我们还有更好的方法，方法就是在Post类里定义它与Comment之间的一多对关系。在Post类里添加一个comments域：

...@OneToMany(mappedBy=“post”, cascade=CascadeType.ALL)public List comments;

public Post(User author, String title, String content){ this.comments = new ArrayList();this.author = author;this.title = title;this.content = content;this.postedAt = new Date();}...请注意，在这里我们使用mappedBy属性来告诉JPA，Comment类的post字段是comment的拥有者，由post负责维护它们的关系。当你用JPA定义一个一个双向关系时，明确指定哪边负责维护关系非常重要。在这种情况下，既然Comment的多个实例隶属于一个Post，因此，我们就在Comment.post上定义反转关系。同时，我们设置cascade属性来告诉JPA，当我们删除一个Post实例里，要JPA自动同步删除其关联的comments。

定义好上述关系后，我们需要在Post类里添加一个帮助方法用于添加评论： public Post addComment(String author, String content){ Comment newComment = new Comment(this, author, content).save();this.comments.add(newComment);this.save();return this;} 其测试代码为：

@Test public void useTheCommentsRelation(){ // Create a new user and save it User bob = new User(“bob@gmail.com”, “secret”, “Bob”).save();

// Create a new post Post bobPost = new Post(bob, “My first post”, “Hello world”).save();

// Post a first comment bobPost.addComment(“Jeff”, “Nice post”);bobPost.addComment(“Tom”, “I knew that!”);

// Count things assertEquals(1, User.count());assertEquals(1, Post.count());assertEquals(2, Comment.count());

// Retrieve Bob's post bobPost = Post.find(“byAuthor”, bob).first();assertNotNull(bobPost);

// Navigate to comments assertEquals(2, bobPost.comments.size());assertEquals(“Jeff”, bobPost.comments.get(0).author);

// Delete the post bobPost.delete();

// Check that all comments have been deleted assertEquals(1, User.count());assertEquals(0, Post.count());assertEquals(0, Comment.count());} 测试下看看：

使用Fixtures来编写更复杂的测试 在开发编写更复杂的测试之前，我们通常需要提前准备一系列的测试数据，Fixtures类允许我们在一个YAML文件里描述需要准备数据的模型，它允许我们在进行任何测试之前加载这个yaml文件。

编辑/yabe/test/data.yml文件，对User模型的数据进行描述：

User(bob): email: bob@gmail.com password: secret fullname: Bob...OK，这个data.yml文件有点大，我们已经提前准备好了，还是下载吧download it here。

接下来，我们将在测试代码里加载这个文件里描述的数据，并对它进行测试： @Test public void fullTest(){ Fixtures.loadModels(“data.yml”);

// Count things assertEquals(2, User.count());assertEquals(3, Post.count());assertEquals(3, Comment.count());

// Try to connect as users assertNotNull(User.connect(“bob@gmail.com”, “secret”));assertNotNull(User.connect(“jeff@gmail.com”, “secret”));assertNull(User.connect(“jeff@gmail.com”, “badpassword”));assertNull(User.connect(“tom@gmail.com”, “secret”));

// Find all of Bob's posts List

bobPosts = Post.find(“author.email”, “bob@gmail.com”).fetch();assertEquals(2, bobPosts.size());

// Find all comments related to Bob's posts List bobComments = Comment.find(“post.author.email”, “bob@gmail.com”).fetch();assertEquals(3, bobComments.size());// Find the most recent post Post frontPost = Post.find(“order by postedAt desc”).first();assertNotNull(frontPost);assertEquals(“About the model layer”, frontPost.title);

// Check that this post has two comments assertEquals(2, frontPost.comments.size());

// Post a new comment frontPost.addComment(“Jim”, “Hello guys”);assertEquals(3, frontPost.comments.size());assertEquals(4, Comment.count());} 更多关于YAML的内容，请阅读YAML manual page。