Express 4.x API---(2)
来源:互联网 发布:amd显卡游戏优化软件 编辑:程序博客网 时间:2024/05/19 13:16
Request
req
对象代表了一个HTTP请求,其具有一些属性来保存请求中的一些数据,比如query string
,parameters
,body
,HTTP headers
等等。在本文档中,按照惯例,这个对象总是简称为req
(http响应简称为res
),但是它们实际的名字由这个回调方法在那么使用时的参数决定。
如下例子:
app.get('/user/:id', function(req, res) { res.send('user' + req.params.id); });
其实你也可以这样写:
app.get('/user/:id', function(request, response) { response.send('user' + request.params.id); });
Properties
在Express 4
中,req.files
默认在req
对象中不再是可用的。为了通过req.files
对象来获得上传的文件,你可以使用一个multipart-handling
(多种处理的工具集)中间件,比如busboy
,multer
,formidable
,multipraty
,connect-multiparty
或者pez
。
req.app
这个属性持有express
程序实例的一个引用,其可以作为中间件使用。
如果你按照这个模式,你创建一个模块导出一个中间件,这个中间件只在你的主文件中require()
它,那么这个中间件可以通过req.app
来获取express的实例。
例如:
// index.js app.get("/viewdirectory", require('./mymiddleware.js'));
req.baseUrl
一个路由实例挂载的Url路径。
var greet = express.Router(); greet.get('/jp', function(req, res) { console.log(req.baseUrl); // greet res.send('Konichiwa!'); }); app.use('/greet', greet);
即使你使用的路径模式或者一系列路径模式来加载路由,baseUrl
属性返回匹配的字符串,而不是路由模式。下面的例子,greet
路由被加载在两个路径模式上。
app.use(['/gre+t', 'hel{2}o'], greet); // load the on router on '/gre+t' and '/hel{2}o'
当一个请求路径是/greet/jp
,baseUrl
是/greet
,当一个请求路径是/hello/jp
,req.baseUrl
是/hello
。 req.baseUrl
和app
对象的mountpath属性相似,除了app.mountpath
返回的是路径匹配模式。
req.body
在请求的body中保存的是提交的一对对键值数据。默认情况下,它是undefined
,当你使用比如body-parser
和multer
解析body
数据的中间件时,它是填充的。
下面的例子,给你展示了怎么使用body-parser
中间件来填充req.body
。
var app = require('express'); var bodyParser = require('body-parser'); var multer = require('multer');// v1.0.5 var upload = multer(); // for parsing multipart/form-data app.use(bodyParser.json()); // for parsing application/json app.use(bodyParser.urlencoded({extended:true})); // for parsing application/x-www-form-urlencoded app.post('/profile', upload.array(), function(req, res, next) { console.log(req.body); res.json(req.body); });
req.cookies
当使用cookie-parser
中间件的时候,这个属性是一个对象,其包含了请求发送过来的cookies
。如果请求没有带cookies
,那么其值为{}
。
// Cookie: name=tj req.cookies.name // => "tj"
获取更多信息,问题,或者关注,可以查阅cookie-parser。
req.fresh
指示这个请求是否是新鲜的。其和req.stale
是相反的。
当cache-control
请求头没有no-cache
指示和下面中的任一一个条件为true
,那么其就为true
:
if-modified-since
请求头被指定,和last-modified
请求头等于或者早于modified
请求头。if-none-match
请求头是*
。if-none-match
请求头在被解析进它的指令之后,不匹配etag
回复头(完全不知道什么鬼)。
req.fresh // => true
req.hostname
包含了源自Host
HTTP头部的hostname
。
当trust proxy
设置项被设置为启用值,X-Forwarded-Host
头部被使用来代替Host
。这个头部可以被客户端或者代理设置。
// Host: "example.com"req.hostname// => "example.com"
req.ips
当trust proxy
设置项被设置为启用值,这个属性包含了一组在X_Forwarded-For
请求头中指定的IP地址。不然,其就包含一个空的数组。这个头部可以被客户端或者代理设置。
例如,如果X-Forwarded-For
是client
,proxy1
,proxy2
,req.ips
就是["clinet", "proxy1", "proxy2"]
,这里proxy2
就是最远的下游。
req.originalUrl
req.url
不是一个原生的Express
属性,它继承自Node’s http module。
这个属性很像req.url
;然而,其保留了原版的请求链接,允许你自由地重定向req.url
到内部路由。比如,app.use()
的mounting
特点可以重定向req.url
跳转到挂载点。
// GET /search?q=somethingreq.originalUrl// => "/search?q=something"
req.params
一个对象,其包含了一系列的属性,这些属性和在路由中命令的参数名是一一对应的。例如,如果你有/user/:name
路由,name
属性可作为req.params.name
。这个对象默认值为{}
。
// GET /user/tjreq.params.name// => "tj"
当你使用正则表达式来定义路由规则,捕获组的组合一般使用req.params[n]
,这里的n
是第几个捕获租。这个规则被施加在无名通配符匹配,比如/file/*
的路由:
// GET /file/javascripts/jquery.jsreq.params[0]// => "javascripts/jquery.js"
req.path
包含请求URL的部分路径。
// example.com/users?sort=descreq.path// => "/users"
当在一个中间件中被调用,挂载点不包含在
req.path
中。你可以查阅app.use()获得跟多的信息。
req.protocol
请求的协议,一般为http
,当启用TLS加密,则为https
。
当trust proxy
设置一个启用的参数,如果存在X-Forwarded-Proto
头部的话,其将被信赖和使用。这个头部可以被客户端或者代理设置。
req.ptotocol// => "http"
req.query
一个对象,为每一个路由中的query string
参数都分配一个属性。如果没有query string
,它就是一个空对象,{}
。
// GET /search?q=tobi+ferretreq.query.a// => "tobi ferret"// GET /shoes?order=desc&shoe[color]=blue&shoe[type]=conversereq.query.order// => "desc"req.query.shoe.color// => "blue"req.query.shoe.type// => "converse"
req.route
当前匹配的路由,其为一串字符。比如:
app.get('/user/:id?', function userIdHandler(req, res) { console.log(req.route); res.send('GET')})
前面片段的输出为:
{ path:"/user/:id?" stack: [ { handle:[Function:userIdHandler], name:"userIdHandler", params:undefined, path:undefined, keys:[], regexp:/^\/?$/i, method:'get' } ] methods:{get:true}}
req.secure
一个布尔值,如果建立的是TLS的连接,那么就为true
。等价与:
'https' == req.protocol;
req.signedCookies
当使用cookie-parser
中间件的时候,这个属性包含的是请求发过来的签名cookies
,不签名的并且为使用做好了准备(这句真不知道怎么翻译了…)。签名cookies
驻留在不同的对象中来体现开发者的意图;不然,一个恶意攻击可以被施加在req.cookie
值上(它是很容易被欺骗的).记住,签名一个cookie
不是把它藏起来或者加密;而是简单的防止篡改(因为签名使用的加密是私人的)。如果没有发送签名的cookie
,那么这个属性默认为{}
。
// Cookie: user=tobi.CP7AWaXDfAKIRfH49dQzKJx7sKzzSoPq7/AcBBRVwlI3req.signedCookies.user// => "tobi"
为了获取更多的信息,问题或者关注,可以参阅cookie-parser。
req.stale
指示这个请求是否是stale
(陈旧的),它与req.fresh
是相反的。更多信息,可以查看req.fresh。
req.stale// => true
req.subdomains
请求中域名的子域名数组。
// Host: "tobi.ferrets.example.com"req.subdomains// => ["ferrets", "tobi"]
req.xhr
一个布尔值,如果X-Requested-With
的值为XMLHttpRequest
,那么其为true
,其指示这个请求是被一个客服端库发送,比如jQuery
。
req.xhr// => true
Methods
req.accepts(types)
检查这个指定的内容类型是否被接受,基于请求的Accept
HTTP头部。这个方法返回最佳匹配,如果没有一个匹配,那么其返回undefined
(在这个case下,服务器端应该返回406和”Not Acceptable”)。 type
值可以是一个单的MIME type
字符串(比如application/json
),一个扩展名比如json
,一个逗号分隔的列表,或者一个数组。对于一个列表或者数组,这个方法返回最佳项(如果有的话)。
// Accept: text/htmlreq.accepts('html');// => "html"// Accept: text/*, application/jsonreq.accepts('html');// => "html"req.accepts('text/html');// => "text/html"req.accepts(['json', 'text']);// => "json"req.accepts('application/json');// => "application/json"// Accept: text/*, application/jsonreq.accepts('image/png');req.accepts('png');// => undefined// Accept: text/*;q=.5, application/jsonreq.accepts(['html', 'json']);// => "json"
获取更多信息,或者如果你有问题或关注,可以参阅accepts。
req.acceptsCharsets(charset[, …])
返回指定的字符集集合中第一个的配置的字符集,基于请求的Accept-Charset
HTTP头。如果指定的字符集没有匹配的,那么就返回false。
获取更多信息,或者如果你有问题或关注,可以参阅accepts。
req.acceptsEncodings(encoding[, …])
返回指定的编码集合中第一个的配置的编码集,基于请求的Accept-Encoding
HTTP头。如果指定的编码集没有匹配的,那么就返回false。
获取更多信息,或者如果你有问题或关注,可以参阅accepts。
req.acceptsLanguages(lang [, …])
返回指定的语言集合中第一个的配置的编码集,基于请求的Accept-Language
HTTP头。如果指定的语言集没有匹配的,那么就返回false。
获取更多信息,或者如果你有问题或关注,可以参阅accepts。
req.get(field)
返回请求指定的HTTP头部的域内容(不区分大小写)。Referrer
和Referer
的域内容可互换。
req.get('Content-type');// => "text/plain"req.get('content-type');// => "text/plain"req.get('Something')// => undefined
其是req.header(field)
的别名。
req.is(type)
如果进来的请求的Content-type
头部域匹配参数type
给定的MIME type
,那么其返回true
。否则返回false
。
// With Content-Type: text/html; charset=utf-8req.is('html');req.is('text/html');req.is('text/*');// => true// When Content-Type is application/jsonreq.is('json');req.is('application/json');req.is('application/*');// => truereq.is('html');// => false
获取更多信息,或者如果你有问题或关注,可以参阅type-is。
req.param(naem, [, defaultValue])
过时的。可以在适合的情况下,使用
req.params
,’req.body’或者req.query
。
返回当前参数name
的值。
// ?name=tobireq.param('name')// => "tobi"// POST name=tobireq.param('name')// => "tobi"// /user/tobi for /user/:namereq.param('name')// => "tobi"
按下面给出的顺序查找配置的:
- req.params
- req.body
- req.query
可选的,你可以指定一个默认值来设置一个默认值,如果这个参数在任何一个请求的对象中都不能找到。
直接通过
req.params
,’req.body’,’req.query’取得应该更加的清晰-除非你确定每一个对象的输入。
Body-parser
中间件必须加载,如果你使用req.param()
。详细请看req.body。
- Express 4.x API---(2)
- Express 4.x API
- Express 4.x API---(1)
- express 4.x Api 中文版
- Nodejs Express 4.X 中文API 2--- Request篇
- Nodejs Express 4.X 中文API
- Express 4.x API 中文文档
- Express 4.X API 翻译 [一] ——Application篇
- Nodejs Express 4.X 中文API 1--- Application篇
- Nodejs Express 4.X 中文API 3--- Response篇
- Nodejs Express 4.X 中文API 4--- Router篇
- Nodejs Express 4.X 中文API 3--- Response篇
- nodejs:express 4.x
- express 4x API 速查
- Express API 3.x 文档参考
- 解读express 4.x源码
- express 4.X cookie session
- express 4.x.x 文档翻译
- ubuntu mount VritualBox shared folders
- 解决eclipse自动联想闪退
- spring如何使用多个xml配置文件
- iOS 笔记
- dubbo通讯生产消费调用
- Express 4.x API---(2)
- 非主流自然语言处理——遗忘算法系列(一):算法概述
- NSTimer和CADisplayLink的基本用法
- Maven Lifecycle and Goals
- BASE64编码和解码
- 利用MQTT信息协议来控制piglow灯光
- C++ enum用法
- iOS毛玻璃效果的简单实现
- linux创建mysql命令链接