01 Starting up the project


簡介


此教學將學習到如何從開始到結束來運用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,而routesmessages檔案來定義使用國際化。
  • 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






























Comments