来玩Play框架02 响应

我上一章总结了Play框架的基本使用。这一章里,我将修改和增加响应。

HTTP协议是按照“请求-响应”的方式工作。Play框架的核心是用动作(Action)来完成“请求-响应”。一个动作负责处理一种请求。一个项目可能要定义许多动作。复杂的网站,可能要定义上百个动作。所以,Play使用控制器(Controller)和URL路由(URL routing)来组织管理动作。控制器用于给动作分类。URL路由(routes)记录了URL和动作的对应关系。

IDE

在开发代码之前,先简单介绍如何使用Eclipse,开发Play项目。

在项目的根目录下,使用命令:

play eclipse

成功后,打开Eclipse,在File->Import中,选择General->Existing Projects into Workspace。在Select root directory中,选择项目的根目录。随后,项目被引入Eclipse。

Java是静态语言,可以在编译时就决定对象的类型,因此能方便的实现代码自动提示补齐、自动寻找类所在的包并import。在写程序的过程中,也能有很多友好提示。

后面的代码中,如果没有写明import的包,可以在Eclipse环境下自动寻找。

理解响应

我先来介绍控制器和URL路由。我以Play默认生成的动作为例讲解。你可以在Play项目中找到下面文件。

一个请求进入服务器后,由URL路由引导到正确的动作来处理。URL路由根据请求的方法和URL来识别这一请求,再寻找对应动作。

URL路由是一个文件,即项目根目录下的conf/routes。文件的每一行是一条记录,规定了某个URL的对应动作。比如:

# Home page
GET     /                           controllers.Application.index()

#开始的行是注释

记录分为三个部分。第一部分为请求的方法,第二个部分为请求的URL,第三个是请求的对应动作。这里Application是一个控制器,位于app/controllers/Application.java中。一个控制器也是一个Java类。而动作index()是类的一个方法。

我对默认生成的Application.java略作修改。新的app/controllers/Application.java为:

package controllers;

import play.*;
import play.mvc.*;

import views.html.*;

public class Application extends Controller {

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

}

可以注意到,作为控制器的Application,需要继承自Controller类。

一个动作必须是一个静态(static)的方法。一个动作返回一个Result类型的对象。ok("Hello World!")返回的就是这么一个Result对象,代表了一个HTTP响应。ok()返回的响应都是200状态,即ok(正常回复)。在这个例子中,响应的主体内容为"Hello World!"。

你可以启动Play服务器,访问上面的URL(localhost:9000/)。使用Chrome的network工具监视回复。页面如下:

根据network工具的监视,响应的状态码为200。响应的类型为text/plain。这是ok()生成Result对象时自动决定的。我可以手动控制响应类型,比如将index()的返回语句改为:

return ok("Hello World!").as("text/html");

这样,响应的主体类型为html。

其它状态的响应

除了ok()之外,Play还提供了其他的一些便捷方法,用以生成不同状态的响应。这些方法的名字和状态的名字相同,比如:

return badRequest("bad request"); // 400, 坏请求
return unauthorized("You are forbidden"); // 401, 未授权
return redirect("/new");    // 303, 重新定向

这些方法返回对应的状态码。浏览器根据状态码和回复的内容,做出反应。比如收到303时,重新定向到新的URL。

此外,我还可以直接使用status()来说明数字形式的状态码

return status(200, "good");

更多的响应生成方式可参考Results

练习

在上面的控制器Application中,增加一个新的动作,用于显示

<p>See you!</p>

修改routes,并验证效果。

URL路由

URL路由是由一行一行的记录组成的。上面我们看到了GET方法,还可以是其它HTTP方法,比如POST:

POST    /somePost                   controllers.Application.somePost()

我要在Application类中增加somePost()动作来处理该请求,比如:

public static Result somePost() {
    return ok("posted");
}

POST方法常用于向服务器提交数据。我将在以后深入。

url还可以有用户定义的变量,从而让一行记录对应不止一个请求,比如:

GET    /record/:id            controllers.Application.record(id: Long)

上面的:id是一个名为id的变量。":"是一个提示符。id将从":"开始,直到结束或者另一个"/"。

当我们访问/record/1234时,id就是1234。对应的动作包含有一个参数,来接收id变量。我这里把参数类型定义为Long。Play将负责类型的转换。

相应的record()动作为:

public static Result record(Long id) {
    return ok("record:" + id.toString());
}

可以看到,该动作与之前的动作有点不一样,它接受一个参数,即来自url的变量。

除了":"之外,还有另一个提示符"*"。与":"不同,"*"表示的区间不受"/"限制。

GET    /newRecord/*name           controllers.Application.newRecord(name: String)

如果我们访问/newRecord/abc/def,那么name将对应字符串"abc/def"

总结

动作、控制器、URL路由

ok()

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Play & Scala 技术分享

PlayFramework 2.1 技巧-性能调优实战

3637
来自专栏专注数据中心高性能网络技术研发

Find命令-Linux系统搜索利器

1.Motivation ---- 搜索查找是管理文件系统常用的操作,虽然动作逻辑本质上是匹配,很简单,但搜索也有很多种花样,可以用来加速搜索,快速提取想要的内...

3085
来自专栏Petrichor的专栏

pycharm: 跳转 & 回退

1702
来自专栏Android-薛之涛

Android-多线程

        通俗的说:我们平日里打开的QQ,微信,简书,都是一个进程。进程是程序的一次动态执行过程,它需要经历从代码加载,代码执行到执行完毕的一个完整的过程...

1002
来自专栏cs

linux学习笔记三

文件组成 linux文件系统的运行和操作系统的文件组成有关,文件系统会将文件权限,属性放在inode(索引节点)中,至于实际的数据则放在block快中。另外还有...

35812
来自专栏python3

python3--中的进程操作--multiprocess模块

运行中的程序就是一个进程。所有的进程都是通过它的父进程来创建的。因此,运行起来的python程序也是一个进程,那么我们也可以在程序中再创建进程。多个进程可以实现...

1021
来自专栏云计算教程系列

如何在Ubuntu 18.04上使用RVM安装Ruby on Rails

Ruby on Rails是一个流行的Web应用程序框架,旨在帮助您开发成功的项目,同时编写更少的代码。为了使Web开发变得有趣并且受到强大社区的支持,Ruby...

4360
来自专栏Pythonista

python模块和包

一个模块就是一个包含了python定义和声明的文件,文件名就是模块名字加上.py 的后缀。

1751
来自专栏PHP在线

PHP使用SOAP调用.net的WebService问题

项目的需求,需要和一个.net系统进行数据交换,合作方提供了一个WebService接口。这个与一般的PHP POST或GET传值再查库拿数据的思路有点不一样,...

3596
来自专栏菩提树下的杨过

maven常用插件: 打包源码 / 跳过测试 / 单独打包依赖项

一、指定编译文件的编码 maven-compile-plugin 1 <plugin> 2 <gr...

2516

扫码关注云+社区

领取腾讯云代金券