§Play 應用程式概觀

本教學實作為一個簡單的 Play 應用程式，我們可以檢查它以開始學習 Play。讓我們先看看執行時期會發生什麼事。當您在瀏覽器中輸入 https://127.0.0.1:9000/ 時

瀏覽器使用 GET 方法向 HTTP 伺服器要求根目錄 / URI。
Play 內部 HTTP 伺服器接收要求。
Play 使用 routes 檔案解析要求，該檔案將 URI 對應到控制器動作方法。
動作方法使用 Twirl 範本呈現 index 頁面。
HTTP 伺服器將回應作為 HTML 頁面傳回。

在高層面上，流程看起來像這樣

§探索專案

接下來，讓我們看看教學專案以找出實作

將要求對應到控制器方法的 routes 檔案。
定義如何處理根 URI 要求的控制器動作方法。
動作方法呼叫的 Twirl 範本，用於呈現 HTML 標記。

請依照下列步驟深入探討原始檔

注意：在下列程序中，對於 Windows 外殼程式，請在路徑名稱中使用 \ 取代 /（但不需要變更 URL 路徑名稱）。

使用命令視窗或 GUI，查看頂層專案目錄的內容。下列目錄包含應用程式元件

app 子目錄包含 controllers 和 views 的目錄，對於熟悉 Model View Controller (MVC) 架構的人來說，這些目錄會很熟悉。由於這個簡單專案不需要外部資料儲存庫，因此它不包含 models 目錄，但您可以在這裡新增它。
public 子目錄包含 images、javascripts 和 stylesheets 的目錄。
conf 目錄包含應用程式組態。有關專案其他結構的詳細資訊，請參閱 Play 應用程式的解剖。

若要找出控制器動作方法，請使用您最愛的文字編輯器開啟 app/controllers/HomeController.java（或 .scala）檔案。Homecontroller 類別包含 index 動作方法，如下所示。這是一個非常簡單的動作方法，它會從 index.scala.html Twirl 範本檔案產生一個 HTML 頁面。

Java

public Result index() {
return ok(views.html.index.render("Your app is ready."));
}

Scala

def index = Action {
  Ok(views.html.index("Your new application is ready."))
}

若要檢視將瀏覽器要求對應到控制器方法的路由，請開啟 conf/routes 檔案。路由包含 HTTP 方法、路徑和動作。這種對 URL 架構的控制，讓設計乾淨、人類可讀且可加入書籤的 URL 變得容易。下列程式行將根 URL / 的 GET 要求對應到 HomeController 中的 index 動作

GET     /           controllers.HomeController.index

使用文字編輯器開啟 app/views/index.scala.html。此檔案中的主要指令呼叫主範本 main.scala.html，並使用字串「歡迎使用 Play」來產生頁面。你可以開啟 app/views/main.scala.html 來查看 String 參數如何設定頁面標題。

有了此教學應用程式的概觀，你就可以準備新增「Hello World」問候語。

下一步：實作 Hello World

在此文件發現錯誤？此頁面的原始程式碼可以在這裡找到。在閱讀文件指引後，請隨時提交拉取請求。有問題或建議要分享？前往我們的社群論壇與社群展開對話。