视图与网址
【E2EE文档】

视图与网址

视图函数的作用是处理业务请求,渲染输出网页。

  1. 使用固定网址
  2. 使用RESTful风格网址
  3. 使用正则表达式网址

下载本章示例

注册视图函数(视图函数)的代码如下:

留言本服务器.订阅视图函数 (&留言本_登录页, “/login”, “/login.esp”, )

视图函数的网址允许以下三种形式来定义

  • 固定网址
  • RESTful风格网址
  • 正则表达式网址

普通页面的视图网址不建议使用中文或全角符号。

因为当您的网址在某些浏览器中进行复制的时候,保留原来的中文地址发送给别人时,别人的浏览器在做首次请求时是无法知道您的网站编码格式的,很有可能以和您网站不兼容的编码格式来创建请求,在编码格式不兼容时,是无法准确的定位到您的处理函数中的。

使用RESTFul和正则表达式类型的网址时,请尽量避免表达式之间不要产生冲突。

1. 使用固定网址

1.1 重定义网站访问首页

示例:/

留言本服务器.订阅视图函数 (&留言本_首页, “/”, “/index.esp”, )

当使用“/”网址的时候,客户浏览器输入您的域名网址就会进入到您注册的视图函数中。

在HTTP协议中是不存在空网址的情况的,所有网址必然是以“/”开头的。

例如您在浏览器输入百度网址:http://www.baidu.com 浏览器会自动在尾部加入“/”作为有效的地址发送请求到服务器。

1.2 重写静态文件地址

示例:/404.html

在E2EE框架中,/404.html 为默认找不到文件的时候的错误提示网页文件。通过注册这个网址,您能够将 404 页面重新定位到您的视图函数中,做动态自定义页面输出。

当您订阅视图函数传入某个已经存在的静态页面的地址,则对应的静态页面将不会发送给服务器,而是作为动态请求交给您的视图函数做自定义处理。

1.3 重写任意网址

示例:/user/login

框架对网址的后缀等没有限定,您可以使用任意形式的固定网址。

2. 使用RESTful风格网址

REST(英文:Representational State Transfer,简称REST)描述了一个架构样式的网络系统,比如 web 应用程序。它首次出现在 2000 年 Roy Fielding 的博士论文中,他是 HTTP 规范的主要编写者之一。在目前主流的三种Web服务交互方案中,REST相比于SOAP(Simple Object Access protocol,简单对象访问协议)以及XML-RPC更加简单明了,无论是对URL的处理还是对Payload的编码,REST都倾向于用更加简单轻量的方法设计和实现。值得注意的是REST并没有一个明确的标准,而更像是一种设计的风格。[了解更多]

在RESTful风格的设计中,每种资源对应一个固定的网址。

E2EE中建议您使用这种形式的网址做定义。由于浏览器对HTTP请求类型等兼容性的问题,您不一定需要完全的按照RESTful规范来设计您的WEB应用,但是网址定义的形式我们可以采取这种形式。

假设咱们做一个图书订阅的应用,而图书详情页咱们可以定义成以下这种格式:

/book/12366

其中 book 指图书,12366指图书在数据库中图书表的主键 book_id 字段,那么我们可以用以下的方式定义视图网址:

示例:/book/:book_id

此时我们可以通过 请求对象.取参数 获取到具体参数值:

请求.取参数 (“book_id”)

这里得到的 book_id 为 12366。

当您订阅视图函数的网址中“/”之间某个段的地址是以冒号“:”起始,文本结束时,那么系统会认为这是一个请求参数,参数名为文本名

根据以上这条约定,那么以下的网址定义也都是有效的。

示例: /book/list/:page/

得到分页位置。

示例: /:type/detail/:id/

得到实体类型,得到详情ID。

如果某个段的内容对您来说不重要,但是您想拦截某个网址段开始,某种规则的所有网址时,可以把对应的网址段设置为“*”,例如:

示例:/user/*

/user/ 开头有两段内容的所有请求。

“*”是以网址段为主体的,对前后位置顺序没有强制要求,所以以下的请求地址也是被允许的。

示例:/*/list

第二网址段为 list 的所有请求。

3. 使用正则表达式网址

示例:^/admin/(.*?)$

拦截 /admin/开头的所有请求

正则表达式网址形式这里就不做更多的说明了,大部分场景下建议使用 RESTful 风格的网址定义,使网址结构更加清晰,更加容易阅读。