1、數據模型的首次迭代接下來我們要開始完成我們的博客引擎的模型部分。JPA入門模型層是一個Play應用的核心（對于其他Web框架也同樣成立）。它是一個對應用操作的 資源的領域特定的表示。因為我們想要創建一個博客引擎，模型層就包括User，Post和Comme nt （用戶，博文和評論）。因為大多數模型對象需要在應用停止運行時保留下來，我們需要把它們存儲在持久性數據庫中。一個普遍的選擇是使用關系型數據庫。因為Java是一個面向對象的語言，我們將使用一個ORM來減少一些繁瑣的工作。JPA是一個給ORM定義一套標準 API的Java規范。作為一個 JPA的實現，Play使用猿 媛皆知的Hibernate

2、框架。之所以使用 JPA而不是原生的 Hibernate API ，是因為這樣所有 的映射都可以用 Java對象直接完成。如果之前用過 Hibernate或JPA，你將驚訝于 Play所添加的包裝。不再需要配置什么了； JPA與Play框架合一。如果你不知道JPA，你可以在繼續之前閱讀一些JPA實現的介紹User 類我們首先來完成 User類。創建新文件/yabe/app/models/User.java，并寫入下面的內容：package models;import java.util.*;import javax.persistenee.*;import play.db.jpa.*;En t

3、itypublic class User extendsModel public Stri ng email;public String password;public String full name;publicboolea n isAdmi n;public User (Stri ng email, String password, String full name) this .email = email;this.password=password;this.full name =full name;En tity 注解(anno tation )標記該類成為托管的 JPA實體(ma

4、n aged JPA En tity )，而 Model父類將自動提供一些接下來將會用到的有用的JPA輔助函數。這個類的所有成員變量都會被持久化到數據庫中。默認情況下，對應的表就是User。如果想要使用一個user是保留關鍵字的數據庫，你需要 給JPA映射指定一個不同的表名。要想這么做，使用Table(name=blog_user) 注解User類。你的模型對象不一定得繼承自 play.db.jpa.Model類。你也可以使用原生JPA。但繼承自該類往往是個更好的選擇，因為它使得運用JPA變得更為簡單。如果之前用過JPA，你知道每個JPA實體都需要提供一個 ld屬性。在這里，Model父類 已

5、經提供了一個自動生成的ID，在大多數情況下，這樣就行了。不要認為生成的id成員變量是函數變量 (functional identifier )，其實它是技術變量(technical identifier )。區分這兩概念通常是個好主意，記住自動生成的ID是一個技術變量(譯注：這里我弄不懂，以下附上原文)Don t think about this provided id field as a functional identifier but as a technical identifier.It is gen erally a good idea to keep both con cept

6、s separated and to keep an automatically gen erated nu meric ID as a tech ni cal ide ntifier.如果你寫過Java ,心中可能已經敲起了警鐘，因為我們居然大量使用公有成員！在Java （一如其他面向對象語言），最佳實踐通常是盡量保持各成員私有，并提供getter和setter。這就是封裝，面向對象設計的基本概念之一。事實上，Play已經考慮到這一點，在自動生成getter和setter的同時保持封裝；等下我們將看到它是怎么做到的。現在你可以刷新主頁面，看一下結果。當然，除非你犯錯，否則應該什么變化都看不到

7、:D。Play自動編譯并加載了 User類，不過這沒有給應用添加任何新特性。寫下第一個測試測試新增的User類的一個好方法是寫下JUnit測試用例。它會允許你增量開發的同時保證一切安好。要運行一個測試用例，你需要在test模式下運行應用。 停止當前正在運行的應用，打開命令行并輸入：yobe gumounet ploy test* Rtnoirifl in test He* CtrlC to stopT III I J C)Listening fcr traftsrrt m.socket at aMrest:錚鮒 17:14:1515I7lll5t72517：l+il5f6301?：1+：15,

8、3611 ：M 15,83617 d*：15,631n；i+；L5.97ZD$ play testapplicati on.conf已經存在一個默認的BasicTests.java ,）：importorg.j un it.*;importplay.test.*;importmodels.*;當你在test mode 中運行Play應用時，Play會自動切換到test框架ID并加載對應的 。閱讀框架ID文檔來了解更多。在瀏覽器打開http:/localhost:9000/tests頁面來看看測試運行器。嘗試選擇所有的默認測試并運行；應該全部都會是綠色但是默認的測試其實什么都沒測 :DTests

9、 runnertha tMU to mn then國tan andThere is 1 unit test.1 functional test.and 1 selenium test.我們將使用JUnit測試來測試模型部分。如你所見,所以讓我們打開它（/yabe/test/BasicTest.javaassertEquals(2, 1 + 1);publicclass BasicTest exte ndsUn itTestTest()public void aVeryImporta ntThi ngToTest刪除沒用的默認測試(aVerylmporta ntTh in gToTest)，創建

10、一個注冊新用戶并進行檢查的測試：Testpublic void createA ndRetrieveUser() / Create a new user and save itnew User( bob , secret , Bob ).save();/ Retrieve the user with e-mail address bobUser bob = User.fi nd(byEmail , bob ).first();/ TestassertNotNull(bob);assertEquals( Bob , bob.fullname);如你所見，Model父類給我們提供了兩個非常有用的方

11、法：save()和find()。你可以在Play文檔中的JPA支持閱讀到Model類的更多方法。在test runner中選擇BasicTests.java，點擊開始，看一下是不是全都變綠了。我們將需要在User類中添加一個方法，來檢查給用戶的用戶名和密碼是否存在了。讓我們 完成它，并且測試它。在 User.java 中，添加 connect() 方法：public static User connect (String email, String password) retur n find(byEmailA ndPassword, email, password).first();如今測試

12、用例成這樣:Testpublic void tryC onn ectAsUser() / Create a new user and save itnew User( bob gmail .com , secret , Bob ).save();/ TestassertNotNull(User.connect (bob gmail .com , secret );assertNull(User.connect (bob gmail .com , badpassword );assertNull(User.connect (tom gmail .com , secret );每次修改之后，你都可

13、以從Play測試運行器運行所有的測試，來確保沒有什么被破壞了。Post 類Post類表示博客文章。讓我們寫下代碼: package models;import java.util.*;import javax.persistenee.*;import play.db.jpa.*;En titypublic class Post extends Model public String title;public Date postedAt;Lobpublic String content;Ma nyTo Onepublic User author;public Post (User author,

14、 String title, String content) this .author = author;this .title = title;this .content = content;this .postedAt = new Date();這里我們使用Lob注解告訴JPA來使用字符大對象類型(clob )來存儲文章內容。我們也 聲明跟User類的關系是ManyToOne。這意味著每個 Post對應一個User，而每個User可 以有多個Post。PostgreSQL的最近版本不會將 Lob注解的String成員存儲成字符大對象類型，除非你額外用 Type(type = org.hib

15、ernate.type.TextType)注解該成員。我們將寫一個新的測試用例來檢查Post類能否正常工作。但在寫下更多測試之前，我們需要修改下JUnit測試類。在當前測試中，數據庫的內容永不刪除，所以每次運行測試都會創 建越來越多的對象。假如將來我們需要測試對象的數目是否正確，這將會是一個問題。所以先寫一個JUnit的setup()方法在每次測試之前清空數據庫:public class BasicTestexte ndsUni tTest Beforepublic void setup () Fixtures.deleteDatabase();Before是JUnit測試工具的一個核心概念如

16、你所見，Fixtures類是一個在測試時幫助處理數據庫的類。再次運行測試并檢查是否一切安好。之后接著下下一個測試：Testpublic void createPost () / Create a new user and save itUser bob = new User( bob , secret , Bob ).save();/ Create a new postnew Post(bob, My first post , Hello world ).save();/ Test that the post has bee n createdassertEquals( 1, Post.co

17、un t();/ Retrieve all posts created by Bob,bob).fetch();List bobPosts = Post.fi nd(byAuthor/ TestsassertEquals( 1, bobPosts.size();Post firstPost = bobPosts.get (0);assertNotNull(firstPost);assertEquals(bob, firstPost.author);assertEquals( My first post , firstPost.title);assertEquals( Hello world,

18、firstPost.c onten t);assertNotNull(firstPost.postedAt);不要忘記導入java.util.List，否則你會得到一個編譯錯誤。添加Comment 類最后，我們需要給博文添加評論功能。創建Comment類的方式十分簡單直白。package models;import java.util.*;import javax.persistenee.*;import play.db.jpa.*;En titypublic classComment extendsModel public String author;public Date postedAt

19、;Lobpublic String content;Ma nyTo Onepublic Post post;publicComme nt(Post post, String author, Str ing content) this .post = post;this .author = author;this .content = content;this .postedAt = new Date();讓我們寫下第一個測試用例：Testpublic void postComments () / Create a new user and save itUser bob = new User(

20、 bob , secret , Bob ).save();/ Create a new postPost bobPost = new Post(bob, My first post , Hello world ).save ();/ Post a first comme ntNice post ).save();new Comme nt(bobPost,Jeffnew Comme nt(bobPost,Tom , I knew that !).save();/ Retrieve all comme ntsListvComme nt bobPostComme nts = Comme nt.fi

21、nd( etch();byPost , bobPost).f/ TestsassertEquals(2, bobPostComme nts.size();Comment firstComment = bobPostComments.get ( 0);assertNotNull(firstComme nt);assertEquals( Jeff, firstComme nt.author);assertEquals( Nice post , firstComme nt.c onten t); assertNotNull(firstComme nt.postedAt);Comme nt sec o

22、n dComme nt = bobPostComme nts.get ( 1);assertNotNull(sec on dComme nt);assertEquals( Tom , sec on dComme nt.author);assertEquals( I knew that !, sec on dComme nt.c onten t);assertNotNull(seco ndComme nt.postedAt);你可以看到Post和Comments 之間的聯系并不緊密：我們不得不通過查詢來獲得所有跟 某一個Post關聯的評論。通過在 Post和Comment類之間建立新的關系，我們

23、可以改善這 一點。在Post類添加comments成員：On eToMa ny( mappedBy=post , cascade=CascadeType.ALL)public List comme nts;public Post (User author, String title, String content) this .comments =new ArrayListvComment();this .author = author;this .title = title;this .content = content;this .postedAt = new Date();注意現在我們用

24、 mappedBy屬性來告訴JPA Comment類的post成員是維持這個關系的一方。 當你用JPA定義一個雙向關系時，需要指定哪一方來維持這個關系。在這個例子中，因為 Comment示例依賴于 Post，我們按 Comment.post 的反向來定義關系。我們也設置了 cascade屬性來告訴JPA，我們希望Post的刪除將級聯影響到 comments。 也即是，如果你刪除一個博文時，所有相關的評論也將一并刪除。由于有了這個新關系，我們可以給Post類添加一個輔助方法來簡化評論的添加：public Post addComme nt(Stri ng author, Str ing conte

25、nt) Comment newComment =new Comment( this , author, content).save();this .comments.add(newComment);this .save();return this ;讓我們寫多一個測試檢查它能否工作：Testpublic void useTheComme ntsRelati on() / Create a new user and save itUser bob = new User( bob , secret , Bob ).save();/ Create a new post).savePost bobPo

26、st = new Post(bob, My first post , Hello world();/ Post a first comme ntbobPost.addComment(Jeff , Nice post );bobPost.addComment(Tom , I knew that !);/ Count thi ngsassertEquals(1, User.co un t();assertEquals(2, Comme nt.co un t();/ Retrieve Bobs postbobPost = Post.fi nd(byAuthor , bob).first();asse

27、rtNotNull(bobPost);/ Navigate to comme ntsassertEquals(2, bobPme nts.size();assertEquals(Jeff , bobPments.get (0).author);/ Delete the postbobPost.delete();/ Check that all comme nts have bee n deleted1, User.co un t();0, Post.cou nt();0, Comme nt.co un t();assertEquals(assertEquals(assertEquals(這次全

28、綠了么?Tests runnerSelKl tiw *m1s to run fwi dick 沁可 and 阿町ruThere is 1 unit test,使用Fixtures來寫更復雜的測試當你開始寫更加復雜的測試，你通常需要一些測試數據。Fixtures允許你在一個YAML文件 中描述你的模型，并在測試開始前加載。編輯 /yabe/test/data.yml并開始描述一個 User:User(bob):email : bobpassword : secretfull name : Bob呃，因為data.yml有點大，你可以在 這里下載它。現在我們可以創建一個加載數據并對它運行一些斷言的

29、測試用例:Testpublic void fullTest () Fixtures .lo adModels(data.yml);/ Count thi ngsassertEquals(assertEquals(assertEquals(2, User.co un t();3, Post.cou nt();3, Comme nt.co un t();/ Try to connect as users assertNotNull(User.c onn ect( assertNotNull(User.c onn ect( assertNull(User.c onn ect( assertNull(

30、User.c onn ect(bob , secret );jeff , secret );jeffbadpassword);tom , secret );/ Find all of Bobs postsList bobPosts = Post.find( fetch();assertEquals( 2, bobPosts.size();author.email , bob)./ Fi nd all comme nts related to Bobs postsList bobComme nts = Comme nt.fi nd( b ).fetch();assertEquals( 3, bobComme nts.size();post.author.emailbo/ Find the most rece nt postPost fron tPost = Post.fi nd(order by postedAt desc).first();assertNotNull(fro ntPost);assertEquals( About the model layer ,