Play2.0文档-面临JAVA开发者(1)

Play2.0文档-面向JAVA开发者(1)
大东哥已经翻译了面向scala开发者的部分http://my.oschina.net/dongming/blog?catalog=153394

我打算翻译一下java部分,如果错误请予以指正,谢谢!
Actions, Controllers and Results

Action 是什么?

一个play应用程序收到的大部分请求都会被Action处理。

一个action就是一个用来处理请求参数的基本java方法,并且它还会生成一个返回到客户端的result。

public static Result index() {
   return ok("Got request " + request() + "!");
 }


一个action 返回一个play.mvc.Result 值,这个值代表了发送到web客户端的HTTP应答。在这个例子中,ok 构造了一个200 OK 应答,这个应答包含了一个text/plain的应答体。

Controllers

一个controller只不过是一个继承自 play.mvc.Controller 包含了几个action方法的类。


最简单的定义一个action的语法是一个没有参数的静态方法,他返回一个 Result 值:

public static Result index() { 
  return ok("It works!");
 }


action方法也可以有参数:

public static Result index(String name) {   return ok("Hello" + name); }



这些参数将会被 Router 解析,并通过请求的URL来填充。参数值可以从URL路径或者URL查询字符串中提取。

Results

让我们从简单的results开始:一个带有状态码、HTTP头,以及需要返回发送到web客户端的body的HTTP result。

这些results 是由play.mvc.Result 定义的, play.mvc.Results 类提供了一些辅助方法来生成标准的HTTP results,就像前一部分用到的 ok 方法:

public static Result index() {   return ok("Hello world!"); }


这有几个创建各种类型results的例子:

Result ok = ok("Hello world!");

Result notFound = notFound();

Result pageNotFound = notFound("<h1>Page not found</h1>").as("text/html");

Result badRequest = badRequest(views.html.form.render(formWithErrors));

Result oops = internalServerError("Oops");

Result anyStatus = status(488, "Strange response type");



所有这些辅助方法都可以从 play.mvc.Results 类中找到。

Redirects(重定向)也是简单的results
.

重定向浏览器到一个新的URL仅仅是另一种的简单result。然而,这些result类型是没有应答体的。

这有几个用来创建重定向results的辅助方法:
public static Result index() {   return redirect("/user/home"); }


这个默认值一般会使用 303 SEE_OTHER 应答类型,但是你也可以设定一个特定的状态码:

public static Result index() { return temporaryRedirect("/user/home"); }

--------------------------以下做个小广告-------------------------
NoSQL系列技术扣扣群:
一群:23152359(满员)
二群:193713524(强烈推荐,即将突破400人)
三群:79377097(新建)
四群:191845335(新建)

本群汇聚了包括百度、创新工厂、IBM、阿里、淘宝、京东、盛大等诸多知名企业的高端技术人才,
以各种NoSQL技术为主的大型交流群,欢迎各种猴子占领本群。