簡介

此教學將學習到如何從開始到結束來運用Play 框架呈現出最真實的Web應用程式。此應用程式當中，我們將嘗試使用任何你所需要的在此實際專案中，同時引進更好的Play應用開發上。

我們分解出幾種部分教學。每個部分都具有更複雜的功能，並提供一切應用程式的需求，包括：驗證(validation)、錯誤處理(error handling)、具完整性的安全框架(security framework)、自動化測試套件(automated test suite)、管理者權限(administration area)等等…

此專案範例是一個BLOG搜尋引擎，為了讓過程更好玩些，我們將管理多個用戶不同的角色，其權限包括：編輯、管理…。

此BLOG搜尋引擎專案稱為yabe。

---

建立專案

建立一個Play Application及IDE支援非常容易，輸入以下命令即可：

~$ play new yabe ~$ play eclipsify yabe

此命令是新建一個新的專案目錄yabe以及一系列的檔案及目錄等，其最重要的是：

• app/包含應用程式的核心部分，區分了模組(Models)、控制器(Controllers)以及視圖(Views)三個區塊的目錄。它可以包含其它Java packages。

• conf/包含所有應用程式的設定組態檔案，最主要的檔案是application.conf，而routes及messages檔案來定義使用國際化。
• lib/包含所有可選定的Java libraries等jar檔案。
• public/包括所有公開可用的資料，其中包括JavaScript files、stylesheets、images目錄。
• test/包括所有應用程式測試。可任一撰寫於JUnit及Selenium兩種。
  

---

執行專案

執行一個Play Application，並啟動一個Web服務器在9000 port，接下來打開瀏覽器輸入以下網址http://localhost:9000。則有一個標準的歡迎頁面，它只是告訴你已成功建立並執行專案。請輸入以下命令即可執行：

~$ play run yabe

＊檔案/目錄結構解說可參考HelloWorld教學



現在來試著編輯yabe/app/views/Application/index.html模組來取代歡迎信息：

#{extends 'main.html' /} #{set title:'Home' /}   <h1>A blog will be there</h1>

---

設定資料庫

Play具有一個獨立的SQL DBMS，稱之為HSQLDB。若要配置資料庫，可打開yabe/conf/application.conf檔案並取消註解這行：

db=mem

在Play中可以輕鬆配置任何JDBC兼容的資料庫，甚至配至連接池(connection pool)。現在重新刷新瀏覽器，則Play將自動啟用資料庫，而此訊息會在終端機上看見：

INFO  ~ Connected to jdbc:hsqldb:mem:playembed

---

---