Play 2.0 中文资料 - 会话和 Flash 域

会话和 Flash 域在 Play 中有何不同

如果你不得不要跨多个 HTTP 请求来保存数据, 你可以存在会话或是 Flash 域中. 存储在会话中的数据在整个会话期间可用, 而存储在 Flash 域中数据只对下一次请求有效.

理解到会话和 Flash 数据不是由服务器来存储,而是以 Cookie 机制添加到每一次后续的 HTTP 请求是很重要的. 这也就意味着数据的大小是很受限的 (不到 4 KB) ,而且你只能存储字符串.

当然了, Cookie 值是由密钥签名了的,这使得客户端不存修改 Cookie 数据(或者说这样做会让它失效).

Play 会话不能当成缓存来用.  假如你需要缓存与某一会话相关的数据, 你可以使用 Play 内置的缓存机制并存储一个唯一的 ID 在用户会话中与之关联.

会话没有技术上的超时控制. 它在用户关闭 Web 浏览器后就会过期. 如果你的应用需要一种功能性的超时控制, 那就在用户会话中存储一个时间戳,并在应用需要的时候用它 (例如: 最大的会话持续时间, 最大的非活动时间, 等等.).

读取会话值

你可以从 HTTP 请求中获取传入的会话: 阅读全文 >>

Play 2.0 中文资料 - 操控 Result

改变默认的 Content-Type

结果内容的类型能够由你所指定的响应体的 Scala 值自动推断出来.

例如:

将会自动设置 Content-Type 头为 text/plain, 而:

会设置 Content-Type header 为 text/xml.

小贴士: 这是由 play.api.http.ContentTypeOf 类型类完成的.

这相当有用, 但是有时候你想手工改变它. 只需要调用 Result 的 as(newContentType) 方法来创建一个新的,类似的,具有不同 Content-Type  头的 Result:

或者更好点, 用: 阅读全文 >>

Play 2.0 中文资料 - HTTP 路由

内建的 HTTP 路由器

路由器组件掌管把传入的 HTTP 请求转发到 Action.

一个HTTP 请求可被 MVC 框架看成是一个事件. 这个事主要包含两方面的信息:

  • 请求路径 (如 /clients/1542, /photos/list), 包括查询字符串
  • HTTP 方法 (像 GET, POST, …).

路由定义在 conf/routes 文件中, 它会被编译. 这表明你可以直接在浏览器上看到路由错误信息: 阅读全文 >>

Play 2.0 中文资料 - Action, Controller 和 Result

什么是 Action?

多数的请求被 Play 应用接收到,并由  Action 进行处理.

一个 play.api.mvc.Action 简单说来就是一个 (play.api.mvc.Request => play.api.mvc.Result) 函数,它处理请求并产生一个 result 发送给客户端.

Action 返回一个 play.api.mvc.Result 值, 代表着发送给 Web 客户端的 HTTP 响应. 上面的例子中 Ok 构造了一个 200 OK 的响应,它包含了 text/plain 类型的响应体.

建造一个 Action

play.api.mvc.Action 伴生对象提供有多个帮助方法用于构建 Action 值.

最简单的一个方法是以返回值为 Result 的表达式块作为参数: 阅读全文 >>

Play 2.0 中文资料 - 搭建你偏爱的 IDE

用 Play 进行工作其实很简单的. 你甚至不需要一个复杂的 IDE, 因为 Play 会在你对源文件作了修改之后自动编译和刷新, 因此你可以很轻易的使用一个简单的文本编辑器来工作.

然而, 使用一个现代的 Java 或 Scala IDE 或给予你很 Cool 生产效率, 比如即时的编译, 良好的重构和调试功能.

Eclipse

生成配置

Play 提供了一条命令简化了 Eclipse 配置. 为转换一个 Play 应用为有效的 Eclipse 项目, 使用 eclipsify 命令:

无需关联下载依赖的源文件 jars 包:

Unmi 注: 对于一个新建的项目,执行 eclipsify 之后会产生 Eclipse 必须的 .project, .classpath 和 .settings 文件,并且这个命令还会创建 test 和 target 目录。Play 1.x 的 play eclipsify 命令有些不同,它会生成一个 eclipse 目录,里面有三个分别用于运行, 调试和测试用的 launch 文件。 阅读全文 >>

Play 2.0 中文资料 - 使用 Play 2.0 控制台

启动控制台

Play 2.0 控制台是基于 sbt 的为开发而准备的控制吧, 它允许你管理整个 Play 应用的开发周期.

要启动控制台, 进入到现有的 Play 应用的目录,然后运行 play 脚本:

Unmi 注: 虽然 sbt 是为 Scala 准备的构建工具,但是即使你创建的应用选的是 Java 语言, 我们仍然是要依赖于 sbt. 在 Play 1.x 的时候不存在 Play 控制台,要么就是直接把应用运行起来了。在 Play 1.x 的项目目录下运行 play 命令只会显示简单的帮助信息。

play 命令进入到当前应用的控制台下,提示符是 [应用的名称] $

阅读全文 >>

Play 2.0 中文资料 - 剖析 Play 2.0 应用

标准的应用目录布局

Play 应用的目录布局是标准化的,这样可保持尽量的简单. 一个标准的 Play 应用看起来如下:

阅读全文 >>

Play 2.0 中文资料 - 创建一个新的应用

用 play 命令创建一个应用

创建一个新应用最初的方式是用 play new 命令.

这会询问你一些信息.

  • 应用的名称 (仅用于显示, 这个名称后面将在几个消息中使用到).
  • 用于这个应用的模板. 你可以从 默认的 Scala 应用, 默认的 Java 应用, 和 空应用 三个选项目中选择.

Unmi 注: 新版 play new 命令允许你带上目录名,让你在指定的目录下创建应用,在 2.0-beta 版中,只是在当前目录下创建你的应用。运行 play help 看显示的 new 是否是: new [directory]    Create a new Play application in the specified directory. 就知道能否指定应用的目录。

并且此时的 play new 命令可以用

这样就会在 ~/Desktop/unmi 目录中创建应用,后面的提示是一样的. 在 ~/Desktop/unmi 目录下有应用所需的 app, conf, public 等目录。
阅读全文 >>

Play 2.0 中文资料 - 安装

系统要求

为了运行 Play 框架, 你需要 JDK 6 或更新的版本.

假如你正使用 MacOS, Java 已经内置了. 如果你正在使用 Linux, 请确认使用了 Sun  的 JDK 或 OpenJDK (不是 gcj, 它是许多 Linux 发行版的默认  Java 命令). 要是用的是 Windows, 只下载安装最新版的 JDK 安装包即可.

确可 javajavac 命令被设置到了当前路径下 (你可以在命令行提示符下通过输入 java -versionjavac 来检查它).

下载二进制包

下载 Play 2.0 的二进制包 (选择最新的 2.0 RC 版) 并解压到有读和写权限的目录下. (运行 play 会向安装目录中写入文件, 所以不要安装在 /opt, /usr/local 或任何你无需设置写入权限的目录中.)

Unmi 注: 当前最新的版本是 2.0.4。 阅读全文 >>