play framework（翻译）

源https://www.playframework.com/documentation/2.5.x/RequestBinders#/conf/routes

自定义路由

Play提供了一套机制绑定来自路径或者查询的string参数的类型。

PathBindable

PathBindable允许来自URL路径的对象；这意味着我们能够定义像/user/3这样的路由来调用下面的action：

controller

public Result user(User user){    return ok(user.name);}  

用户参数将自动提取URL路径中id，例如，下面的路由定义

/conf/routes

GET     /user/:user            controllers.BinderApplication.user(user: javaguide.binder.models.User)

实现了PathBindable接口的类型T都能绑定为路径的参数。它定义了抽象方法bind（绑定来自路径的值）和unbind（从一个值中建立路径片段）
例如下面的类

public class User implements PathBindable<User> {    public Long id;    public String name;}

一个binder绑定路径中:id参数的简单的例子

@Overridepublic User bind(String key, String id) {    // findById meant to be lightweight operation    User user = findById(new Long(id));    if (user == null) {        throw new IllegalArgumentException("User with id " + id + " not found");    }    return user;}@Overridepublic String unbind(String key) {    return String.valueOf(id);}

在这个例子中，findById方法被用来获取User实例。
注意：在真正的application中，这个方法应该是轻量级并且不涉及（e.g.数据库）接入，因为这段代码被调用在服务器IO线程并且必须是完全非阻塞的。因此你例如使用简单的对象识别符作为路径绑定，使用action组合获取真实值。

QueryStringBindable

query 字符串参数使用了相似的机制；类似/age的路由能够调用如下action

controller

public Result age(AgeRange ageRange){    return ok(String.valueOf(ageRange.from));}    

age参数可以自动从如/age?from=1&to=10的查询中抽取。
Any type T that implements QueryStringBindable can be bound to/from query one or more query string parameters. Similar to PathBindable, it defines abstract methods bind and unbind.
实现了QueryStringBindable的任何类型T都可以被绑定到query的to/from参数。类似于PathBindable，它定义了抽象方法bind和unbind。
例如这个类：

public class AgeRange implements QueryStringBindable<AgeRange> {    public Integer from;    public Integer to;}

binder绑定:from和:to query参数的例子：

@Overridepublic Optional<AgeRange> bind(String key, Map<String, String[]> data) {    try{        from = new Integer(data.get("from")[0]);        to = new Integer(data.get("to")[0]);        return Optional.of(this);    } catch (Exception e){ // no parameter match return None        return Optional.empty();    }}@Overridepublic String unbind(String key) {    return new StringBuilder()        .append("from=")        .append(from)        .append("&to=")        .append(to)        .toString();}

PS:稍后我们会讨论一下源码和实现