指南, 教程 & 参考手册

Browse

Contents

好书推荐

国内书籍(将于2012年出版)

国外书籍(电子图书)

文档

欢迎大家阅读《Play1.2RC 中文文档》。这份文档是关于Play框架的 1.2 release版本 的,它可能会在较大程度上不同于1.2版本之前的文档。
具体请参看 version 1.2 release notes.

开始

以下是入门 Play 的第一步,可以当作是5分钟的趣味阅读

  1. Play framework 概览
  2. 观看截屏
  3. Play 可以做的 5 件很酷的事
  4. 易用性 - 细节和特性一样重要
  5. 常见问题
  6. 安装指南
  7. 配置你喜欢的 IDE
  8. 开始第一个应用 — ‘Hello World’ 入门指南
  9. 示例应用

教程 — Play入门指导,一步步教你创建一个实际的应用

通过从头到尾按照教程编写程序 ‘Yet Another Blog Engine’ 来学习Play。每一章节的练习都有机会学会Play的一两个很酷的特性。

  1. 创建工程
  2. 数据模型(Data Model)
  3. 构建第一个视图
  4. 评论页面
  5. 创建验证码
  6. 添加tag标签
  7. 使用CRUD创建基本的管理后台
  8. 添加权限控制
  9. 创建自定义的编辑区域
  10. 完成应用的测试
  11. 产品化的准备
  12. 国际化和本地化

重要文档

涵盖所有你需要了解的Play的知识。

  1. 主要的概念
    1. MVC应用模型
    2. 一个请求的生命周期
    3. 应用的布局和结构
    4. 开发流程的周期
  2. HTTP路由
    1. 路由文件的语法
    2. 路由的优先级
    3. 处理静态资源
    4. Reverse routing: generate some URL
    5. Setting content types
    6. Content negotiation
  3. 控制器层(Controllers)
    1. Controller综述
    2. 获取HTTP参数
    3. HTTP to Java 高级绑定
    4. 结果类型
    5. 拦截器(Interceptions)
    6. Session 和 Flash scopes
  4. The template engine
    1. Template syntax
    2. Template inheritance
    3. Create tags
    4. Extending the templates language
    5. Implicit objects
  5. HTTP form data validation
    1. How does it work?
    2. Retrieving error messages
    3. Displaying errors in the template
    4. Using annotations
    5. Validating objects
    6. Custom validation
  6. 领域对象模型(domain object model)
    1. 属性(Properties)模拟
    2. 设置一个数据库来持久化你的模型对象
    3. 使用Hibernate来持久化模型对象
    4. 保持模型为“无状态”(stateless)
  7. JPA persistence
    1. Starting the JPA entity manager
    2. Obtaining the JPA entity manager
    3. Transaction management
    4. The play.db.jpa.Model support class
    5. Finding objects
    6. Counting objects
    7. Explicit save
    8. More about generic typing problems
  8. Play libs
    1. XML parsing using XPath
    2. Web Service client
    3. Functional programming with Java
    4. OAuth
    5. OpenID
  9. Asynchronous Jobs
    1. Bootstrap jobs
    2. Scheduled jobs
    3. Triggering task jobs
  10. 使用HTTP异步编程
    1. 延缓(Suspending) HTTP 请求
    2. HTTP 输出流
    3. 使用 WebSockets
  11. Play 中如何使用 Ajax
    1. 配合jQuery使用jsAction标签
  12. 国际化支持(I18N)
    1. 只允许使用UTF-8
    2. 外部化Message
    3. 定义程序支持的语言类型
    4. 利用locale设置日期格式
    5. 获取本地化消息
  13. Cache
    1. The cache API
    2. Don’t use the Session as a cache
    3. Configure memcached
  14. Sending e-mail
    1. Mail and MVC integration
    2. SMTP configuration
    3. More about configuration
    4. Using Gmail
  15. Testing the application
    1. Writing tests
    2. Fixtures
    3. Running the tests
    4. Continuous integration
  16. 安全指导
    1. Sessions
    2. 跨站脚本攻击
    3. SQL 注入
    4. CSRF-跨站请求伪造
  17. Modules and the module repository
    1. What is a module?
    2. How to load a module from an application
    3. Load default routes from modules
    4. Using the module repository
    5. Contributing a new module to the module repository
  18. Dependency management
    1. Dependency format
    2. dependencies.yml
    3. Conflict resolution
    4. Adding new repositories
  19. Managing your database evolutions
    1. Evolutions scripts
    2. Synchronizing concurrent changes
    3. Inconsistent states
    4. Evolutions commands
  20. Logging configuration
    1. Logging from your application
    2. Configure log levels
  21. Configuration in several environments
    1. The framework ID
    2. Setting the framework ID from the command line
  22. Production deployment
    1. Configure your application.conf
    2. Configure logging
    3. Set-up a front-end HTTP server
  23. Deployment options
    1. Standalone Play application
    2. Running on JEE application servers
    3. Google Application Engine
    4. Stax cloud hosting platform

References

Extended references for day-to-day hacking.

  1. Quick index
  2. API documentation (Javadoc)
  3. Cheat sheets
    1. Command Line
    2. Controllers
    3. Templates
    4. Model
    5. Testing
    6. Multi-environment
  4. Built-in extensions
    1. Template tags
    2. Java extensions
    3. Validations

Distribution Modules

These optional modules are included with the standard distribution. More modules.

  1. CRUD
  2. Secure

Version notes

New versions of Play include certain changes. Check older release notes for:

  1. Play 1.1
  2. Play 1.0.3
  3. Play 1.0.2
  4. Play 1.0.1