§Play 教學
Play 的文件說明了可用的功能以及如何使用它們，但文件不會說明如何從頭到尾建立應用程式。這就是教學和範例的用武之地。
教學和範例對於展示單一應用程式的運作很有用，特別是在與其他系統（例如資料庫或 Javascript 框架）整合時。
play-samples GitHub 儲存庫 提供涵蓋大量案例的 Play 範例。您可以在其中找到 Java、Scala 和多個 Play 版本的專案。您可以選擇一個展示您有興趣的功能。請務必驗證執行 Play 的需求。您可以複製 play-samples GitHub 儲存庫 或下載其內容 為 zip 檔案。範例涵蓋以下主題
§Java
| 範例 | |
|---|---|
| 執行 Java Hello World 範例 | 連結 |
| 執行 Java Starter 範例 | 連結 |
| 執行 Java gRPC 範例 | 連結 |
| REST API 範例 | 連結 |
| 檔案上傳範例 | 連結 |
| 表單範例 | 連結 |
| JPA 範例 | 連結 |
| Ebean 範例 | 連結 |
| Websocket 範例 | 連結 |
| 使用 Websockets 的聊天室範例 | 連結 |
| 串流範例 | 連結 |
| 編譯時間依賴性注入範例 | 連結 |
| 使用 Dagger 2 進行編譯時間 DI | 連結 |
§Scala
| 範例 | |
|---|---|
| 執行 Scala Hello World 範例 | 連結 |
| 執行 Scala Starter 範例 | 連結 |
| 執行 Scala gRPC 範例 | 連結 |
| REST API 範例 | 連結 |
| 檔案上傳範例 | 連結 |
| 表單範例 | 連結 |
| Anorm 範例 | 連結 |
| 整合 Slick 範例 | 連結 |
| 獨立 Slick 範例 | 連結 |
| Websocket 範例 | 連結 |
| 使用 Websockets 的聊天室範例 | 連結 |
| 串流範例 | 連結 |
| 編譯時間依賴性注入範例 | 連結 |
| 使用 Macwire 的依賴性注入範例 | 連結 |
| 安全工作階段範例 | 連結 |
| TLS 範例 | 連結 |
§第三方教學課程和範本
Play 社群也提供許多教學課程和範本，它們涵蓋 Play 的各個面向，比文件更詳細，或從不同的角度切入。此處列出的範本並非由 Play 團隊維護，因此可能已過時。
以下是幾個有用的部落格文章，由於有些部落格文章撰寫於一段時間以前，因此此部分依 Play 版本分類。
§2.8.x
§Play Framework 教學課程和其他內容
- Play Framework 的表單教學課程：本教學課程將教您如何處理 Play Framework 的表單，包含錯誤處理和使用 Twirl 範本引擎顯示。
- 在 Play Framework 中建置 REST API：本文說明如何使用 Play Framework 和 Java 建立應用程式，並使用
GET、POST、PUT和DELETEAPI 進行 CRUD 作業。 - 處理 Play Framework 中的例外和錯誤：本教學課程說明如何在 Play Framework 中處理例外，以便將正確的回傳碼傳送回客戶端，並在回應主體中提供必要的錯誤資訊。
§2.6.x
§Play Framework 教學和其他內容
- 在 GraalVM 上執行 Play：Play 的核心貢獻者 Christian Schmitt 解釋如何使用 GraalVM 執行 Play 應用程式，以及將 GraalVM 與 Play 搭配使用的挑戰和好處。
- Play Framework 入門：此 DZone 參考卡以簡潔但極具資訊性的方式，展示 Play 的最基本概念。
- Play：遺失的教學：在此教學系列中，Shekhar Gulati
展示如何建立一個名為 blogy 的部落格平台，您可以使用它來撰寫和發布部落格。 - 使用 Kotlin 的 Play Framework 冒險：這篇文章由 Antonio López Marín 為 Karumi 所撰寫，詳細說明使用 Kotlin 語言撰寫 Play 應用程式的必要步驟。
- 使用 OIDC 和 Okta 將驗證新增至 Play Framework：Matt Raible 展示使用 play-pac4j 將 Play 與 OpenID Connect 等現代驗證機制整合有多麼容易。
- 使用 Java 和 Play Framework 的 REST API：本文展示如何使用 Play Framework 和 Java 建立一個應用程式，其中包含用於 CRUD 操作的
GET、POST、PUT和DELETEAPI。 - 使用 Play Framework 的 RESTful API - 第 1 部分 和 使用 Play Framework 的 RESTful API - 第 2 部分：在此兩部分教學中，Mercedes Wyss 說明如何使用 Play framework 設定您的開發環境，以及如何在您的機器上執行 Play，並在稍後探索如何在程式碼中處理 JSON，來建立 RESTful API。
- 在 Play 應用程式中建立表單 - 第 1 部分 和 在 Play 應用程式中建立表單 - 第 2 部分：Pedro Rijo 從基本範例到進階範例，展示 Play 在處理 HTML 表單時提供的輔助程式、如何驗證某些輸入，以及 Play 如何處理這些輸入錯誤。
- React 與 Play Framework 2.6.x：Yohan Gomez 說明整合 React 和 Play 時不同方法的優缺點，以及在同時使用兩者時如何建構專案。Java 和 Scala 都提供種子專案。
- Angular 6 與 Play Framework 2.6.x：Yohan Gomez 再次說明如何整合 Play 和現代前端框架，但這次使用 Angular 6。Java 和 Scala 都提供種子專案。
- 使用 Play Framework 進行國際化：Teena Vashist 示範您的應用程式如何使用 Play Framework 2.6 支援不同的語言。
- 在 Play Framework 中使用動作進行驗證：Geetika Gupta 示範如何在 Play 應用程式中使用動作組合處理驗證。
- 在 Play Framework 中使用 Akka Streams 和 Slick 從 PostgreSQL 串流資料：在這個部落格文章中，Sidharth Khattri 說明您可以使用 Scala Slick（Scala 的資料庫存取/查詢函式庫）和 Akka Streams 直接從 PostgreSQL 資料庫串流資料的流程。
- 使用 Akka Streams（透過 Alpakka）在 Play Framework 中串流檔案至 AWS S3：Sidharth Khattri 在這篇部落格文章中說明如何使用 Alpakka 的 AWS S3 連接器，從客戶端（例如：瀏覽器）串流檔案至 Amazon S3。
§2.5.x
§Play Framework 教學影片系列
Radix Code 的教學影片系列提供 Play 的初步概觀，逐步說明初始 IDE 設定、定義路由、建立 CRUD 應用程式、啟用 ORM 支援，以及使用 bootstrap 自訂檢視。
- 在 IntelliJ IDE 中偵錯 Play 應用程式
- 在 Eclipse IDE 中偵錯 Play 應用程式
- 路由運作方式
- 在 Play 中新增 MySQL 支援
- 包含 Bootstrap 和 jQuery
- 表單驗證
- 建立自訂錯誤頁面
§相依性注入
- 使用 Scala 在 Play Framework 中進行相依性注入，作者為 Krzysztof Pado。
§Akka Streams
- 在 Play Framework 2.5 中整合 Akka Streams，作者為 Loïc Descotte。
- 使用 Akka Streams 和 Twitter，作者為 Loïc Descotte。
§表單和驗證器
§REST API
- Play API REST 範本，作者為 Adrianhurt：展示如何實作完整的 JSON RESTful API，具備驗證權杖、分頁、篩選、排序和搜尋等特性，以及選用的封裝。
§子專案
- Play Multidomain Seed by Adrianhurt：嘗試成為一個簡單的多網域專案範本（www.myweb.com 和 admin.myweb.com）。它會告訴你如何使用子專案，以及如何共用共用程式碼。它也可以和 Webjars、CoffeeScript、LESS、RequireJS、資產 Gzip 和資產指紋辨識一起使用。請查看自述檔案以取得更多詳細資訊。
- Play Multidomain Auth by Adrianhurt：這是 play-multidomain-seed 專案的第二部分。這個專案嘗試成為一個使用 Silhouette 驗證函式庫實作驗證和授權層的範例。它也使用 Play-Bootstrap 以簡化範本架構。
§升級
- 從 Play 2.3 升級到 Play 2.5 by Gregg Hernandez：學習如何處理升級到 Play 2.5 時常見的問題，包括維持舊有行為、轉換到 Akka Streams，以及實作編譯時期依賴注入。
§2.4.x
§Semisafe
Semisafe 有關於 Play 的一系列優秀文章
§極簡 Play
- 38 行 Play 應用程式 by Lloyd Chan，展示「Sinatra」風格的 Play 應用程式。
§依賴注入
- Playframework 2.4 依賴注入 (DI) by Marius Soutier。
- 使用依賴注入進行測試 by Michael Pollmeier。
- Play 2.4 編譯時間相依性注入，作者 Loïc Descotte。
§REST API
SPR Consulting 的 Justin Rodenbostel 也有兩篇網誌文章，探討在 Play 中建置 REST API
§Slick
- Play 框架、Slick 和 MySQL 教學，作者 Pedro Rijo。
§RethinkDB
§表單
- 如何將表單新增至 Play 應用程式，作者為衛報的 Chris Birchall。
§AngularJS、RequireJS 和 sbt-web
Marius Soutier 有一系列精彩文章，說明如何使用 AngularJS 搭配 Play 和 sbt-web 設定 JavaScript 介面。文章最初寫於 Play 2.1.x，但已更新為 Play 2.4.x。
§React JS
- 使用 Play、Scala 和 WebJar 的 ReactJS 教學，作者 Fabio Tiriticco。
- 使用 Play 2.4.x、Scala 和 Anorm 呈現 UI 的基本範例，作者 Knoldus / activator 範本。
§2.3.x
§REST API
- 使用 Play Framework 2.3.x：REST、管線和 Scala，作者 Sampson Oliver。
§Anorm
Knoldus 有一系列關於 Anorm 的精彩網誌文章
- 員工自助服務 – 使用 Anorm SQL 資料存取建置反應式 Play 應用程式 –（第 1 部分）
- 員工自助服務 – 使用 Anorm SQL 資料存取建立 Reactive Play 應用程式 – (第 2 部分)
- 員工自助服務：使用 Play Framework 和 Anorm 的 Reactive 非封鎖資料庫存取 – (第 3 部分)
- 員工自助服務：使用 Play Framework 和 Anorm 的 Reactive 非封鎖資料庫存取 – (第 4 部分)
§表單
- 包含多個核取方塊和選取的範例表單，作者：Philip Johnson。
- Play 中使用者體驗友善的條件式表單對應，作者：Nick Tune。
§2.2.x
§進階路由
- Play Framework 中的進階路由，作者：James Roper。
- Play 路由 – 第 1 部分，基礎，作者：Marius Soutier。
- Play 路由 – 第 2 部分，進階使用案例，作者：Marius Soutier。
§路徑可繫結
- 如何使用 Play 2 實作自訂 PathBindable，作者：Julien Richard-Foy。
§範本
- Play Framework 2.0 範本 – 第 1 部分，參數，作者：Marius Soutier。
§使用者介面
- 使用 Play 2 建立無樣板程式碼的複合使用者介面，作者：Julien Foy。
§Play 實務
- Play 實務，作者：Will Sargent。
下一步：使用 Play
在此文件檔中發現錯誤？此頁面的原始程式碼可在此處找到這裡。在閱讀文件檔指南後，請隨時貢獻一個 pull request。有問題或建議要分享嗎？前往我們的社群論壇與社群展開對話。