play框架使用起来（5）
1、逆向生成URL
Play路由器是按照Java调用生成URL的，所以可以将URI表达式都集中到同个配置文件中，使得重构应用变得更加便捷。比如，为conf/routes文件添加如下路由配置：
GET /clients/{id} Clients.show
之后在Java代码中，就可以调用Client.show来生成URL：
map.put("id", 1541);
String url = Router.reverse("Clients.show", map).url; // GET /clients/1541
URL的生成已经集成到框架的大部分组件当中，一般我们不需要直接调用Router.reverse方法。
如果增加的参数不包含在URI表达式中，这些参数会被添加到查询字符串中：
map.put("id", 1541);
map.put("display", "full");
String url = Router.reverse("Clients.show", map).url; // GET /clients/1541?display=full
同样地，路由器会根据优先顺序匹配最适的URL。
2、设置content type
Play会根据request.format设定的值，选择指定的media类型来响应HTTP请求。该值通过文件扩展名来决定使用何种视图模板进行渲染，并且通过Play框架中的mime-types.properties文件进行映射处理(映射关系详见play\framework\src\play\libs\mime-types.properties文件)，为media类型设定Content-type响应。
Play请求的默认格式为html，因此index()控制器方法默认的渲染模板文件为index.html。如果需要指定其他的格式，有以下四种方式：
（1）可以在程序代码调用render()方法之前进行格式设置。比如将media类型设置为text/css，就可以使用CSS文件进行渲染：
public static void index() {
request.format = "css";
render();
}
（2）推荐一种更直接的做法，直接在routes文件中使用URL来指定格式。以下列路由配置为例：首先客户端通过index.xml请求服务器，服务器端将响应格式设置为xml，最后使用index.xml模版进行渲染。
GET /index.xml Application.index(format:'xml')
同样地，我们也可以使用CSS进行渲染：
GET /stylesheets/dynamic_css css.SiteCSS(format:'css')
（3）Play还可以直接从URL中获取请求格式，动态指定渲染的模板类型。参考如下路由配置：
GET /index.{format} Application.index
当请求为/index.xml时，服务器会将返回格式设置为xml并使用相应的XMl文件进行渲染；请求为/index.txt时，则会使用文本进行渲染。
（4）使用Play中的HTTP内容协商进行格式设置，详见以后更新的内容。
3、HTTP内容协商
Play与其他REST架构的框架一样，直接使用HTTP方法，而不是试图隐藏HTTP或者在上面构建抽象层。内容协商是HTTP的特性，它允许HTTP服务器根据客户端的请求类型，实现同个URL提供不同的media类型响应。客户端可以在Accept header中设置media属性，指定可接收的响应类型。如果用户需要XML响应，则进行如下设置：
Accept:application/xml
客户端可以指定多种media类型，或使用cacth-all通配符（*/*）来指定任何media类型。
Accept:application/xml,image/png,*/*
3.1 在HTTP头中设置content type#
如果Accept header中包含了text/html，application/xhtml或者通配符 */*，Play会选择使用其默认的请求格式(即HTML)。只有当通配符的值被显式指定时，Play才会选择其默认的请求格式。
Play内置了一些常规格式支持：html、txt、json、xml。下例代码定义了控制器方法(Action)进行数据渲染：
public static void index() {
final String name = "Peter Hilton";
final String organisation = "Lunatech Research";
final String url = "http://www.lunatech-research.com/";
render(name, organisation, url);
}
如果在浏览器中访问http://localhost:9000，Play默认会使用index.html模板进行渲染，因为浏览器发送了包含text/html的Accept header。
通过将请求的格式设置为xml，可以使用index.xml模板响应标识为Accept: text/xml的请求：
<?xml version="1.0"?>
<contact>
<name>${name}</name>
<organisation>${organisation}</organisation>
<url>${url}</url>
</contact>
下表针对index()控制器方法给出了Play内置的Accept header请求格式映射：Accept header包含了Play能够映射成的所有格式（最后转化为相应的模板文件），如表3.1：
(表3.1 Play内置的Accept header请求格式映射)
| Accept header | Format | Template file name | mapping |
|---|---|---|---|
| null | null | index.html | null格式请求提供默认模版扩展 |
| image/png | null | index.html | media类型没有映射为指定格式 |
| */*, image/png | html | index.html | 默认将media类型映射为html格式 |
| text/html | html | index.html | 内置映射 |
| application/xhtml | html | index.html | 内置映射 |
| text/xml | xml | index.xml | 内置映射 |
| application/xml | xml | index.xml | 内置映射 |
| text/plain | txt | index.txt | 内置映射 |
| text/javascript | json | index.json | 内置映射 |
| application/json, */* | json | index.json | 内置映射, 忽略默认media类型 |
3.2 自定义格式#
在Play中可以通过检查HTTP请求头，为应用选择相应的media类型来实现自定义格式。比如使用@Before标签拦截该控制器下的所有Action，检查请求的media类型是否为text/x-vcard：
@Before
static void setFormat() {
if (request.headers.get("accept").value().equals("text/x-vcard")) {
request.format = "vcf";
}
}
如果检查后发现请求头中media类型为text/x-vcard时，将调用index.vcf模板渲染：
BEGIN:VCARD
VERSION:3.0
N:${name}
FN:${name}
ORG:${organisation}
URL:${url}
END:VCARD
4 关于REST
REST全称为Representational State Transfer，即表述性状态传输。它是一种为分布式超媒体系统（比如万维网）而设计的软件架构方式。REST定义了一些关键的规则：
- 应用的所有功能都被划分为资源。
- 每个资源都使用URI来唯一访问。
- 所有资源共享统一的接口用于客户端与资源之间进行状态传输。
如果应用使用的是HTTP协议，那么这些接口是通过一系列可用的HTTP方法来定义的。HTTP协议往往通过以下方法来使用资源的状态：
- 客户端-服务器模式。
- 无状态模式。
- 缓存模式。
- 分层模式。
如果应用遵循了REST设计规则，那么该应用就可以被称为RESTful了。Play框架可以很容易地构建RESTful应用：
- Play的路由器通过解析URI和HTTP方法，将请求路由至Action方法。基于正则表达形式的URI为开发提供了更好的灵活性。
- 协议是无状态的，这意味着在两次成功的请求之间不会把任何状态保存在服务器中。
- Play将HTTP作为关键的特性，因此框架提供了对HTTP信息的完全访问。