nodejs--（一）http模板篇

Nodejs http模块可以创建服务器应用实例，也能发送http请求

1.http.get(options[, callback])

发送简单Get请求，并响应

var http=require('http');
//get 请求外网
http.get('http://www.gongjuji.net',function(req,res){
    var html='';
    req.on('data',function(data){
        html+=data;
    });
    req.on('end',function(){
        console.info(html);
    });
});

2.http.request(options[, callback])  // 使用详细配置，发送Get或Post请求

 

发送Post实例：注http请求头使用headers指定

 

var http=require('http');
var querystring=require('querystring');
//发送 http Post 请求
var postData=querystring.stringify({
    msg:'中文内容'
});
var options={
   hostname:'www.gongjuji.net',
   port:80,
   path:'/',
   method:'POST',
   headers:{
    //'Content-Type':'application/x-www-form-urlencoded',
    'Content-Type':'application/x-www-form-urlencoded; charset=UTF-8',
    'Content-Length':Buffer.byteLength(postData)
   }
}
var req=http.request(options, function(res) {
    console.log('Status:',res.statusCode);
    console.log('headers:',JSON.stringify(res.headers));
    res.setEncoding('utf-8');
    res.on('data',function(chun){
        console.log('body分隔线---------------------------------\r\n');
        console.info(chun);
    });
    res.on('end',function(){
        console.log('No more data in response.********');
    });
});
req.on('error',function(err){
    console.error(err);
});
req.write(postData);
req.end();

发送Get请求实例：

 

 

//发送Get请求
var http=require('http');
var querystring=require('querystring');
var data={
    age:13,
    time:new Date().getTime()
};
var content=querystring.stringify(data);
var options={
    hostname:'www.gongjuji.net',
    port:80,
    path:'/',
    method:'GET'
}
//创建请求
var req=http.request(options,function(res){
    console.log('STATUS:'+res.statusCode);
    console.log('HEADERS:'+JSON.stringify(res.headers));
    res.setEncoding('utf-8');
    res.on('data',function(chunk){
        console.log('数据片段分隔-----------------------\r\n');
        console.log(chunk);
    });
    res.on('end',function(){
        console.log('响应结束********');
    });
});
req.on('error',function(err){
    console.error(err);
});
req.end();

参数说明：

 

 

options can be an object or a string. If options is a string, it is automatically parsed with url.parse().

Options:

• protocol: Protocol to use. Defaults to 'http:'.
• host: A domain name or IP address of the server to issue the request to. Defaults to 'localhost'.
• hostname: Alias for host. To support url.parse() hostname is preferred over host.
• family: IP address family to use when resolving host and hostname. Valid values are 4 or 6. When unspecified, both IP v4 and v6 will be used.
• port: Port of remote server. Defaults to 80.
• localAddress: Local interface to bind for network connections.
• socketPath: Unix Domain Socket (use one of host:port or socketPath).
• method: A string specifying the HTTP request method. Defaults to 'GET'.
• path: Request path. Defaults to '/'. Should include query string if any. E.G. '/index.html?page=12'. An exception is thrown when the request path contains illegal characters. Currently, only spaces are rejected but that may change in the future.
• headers: An object containing request headers.
• auth: Basic authentication i.e. 'user:password' to compute an Authorization header.
• agent: Controls Agent behavior. When an Agent is used request will default to Connection: keep-alive. Possible values:
  • undefined (default): use http.globalAgent for this host and port.
  • Agent object: explicitly use the passed in Agent.
  • false: opts out of connection pooling with an Agent, defaults request to Connection: close.

 

一，开篇分析

首先“Http”这个概念大家应该比较熟悉了，它不是基于特定语言的，是一个通用的应用层协议，不同语言有不同的实现细节，但是万变不离其宗，思想是相同的，

NodeJS作为一个宿主运行环境，以JavaScript为宿主语言，它也有自己实现的一套标准，这篇文章我们就一起来学习一下 “Http模块” 。但是作为前提来说，

希望大家可以先阅读一下官网提供的api，有一个前置了解，这样就方便多了，以下是Http部分的api概览：

 

复制代码代码如下:

HTTP
    http.STATUS_CODES
    http.createServer([requestListener])
    http.createClient([port], [host])
    Class: http.Server
    事件 : 'request'
    事件: 'connection'
    事件: 'close'
    Event: 'checkContinue'
    事件: 'connect'
    Event: 'upgrade'
    Event: 'clientError'
    server.listen(port, [hostname], [backlog], [callback])
    server.listen(path, [callback])
    server.listen(handle, [callback])
    server.close([callback])
    server.maxHeadersCount
    server.setTimeout(msecs, callback)
    server.timeout
    Class: http.ServerResponse
        事件: 'close'
        response.writeContinue()
        response.writeHead(statusCode, [reasonPhrase], [headers])
        response.setTimeout(msecs, callback)
        response.statusCode
        response.setHeader(name, value)
        response.headersSent
        response.sendDate
        response.getHeader(name)
        response.removeHeader(name)
        response.write(chunk, [encoding])
        response.addTrailers(headers)
        response.end([data], [encoding])
        http.request(options, callback)
        http.get(options, callback)
    Class: http.Agent
        new Agent([options])
        agent.maxSockets
        agent.maxFreeSockets
        agent.sockets
        agent.freeSockets
        agent.requests
        agent.destroy()
        agent.getName(options)
        http.globalAgent
    Class: http.ClientRequest
        Event 'response'
        Event: 'socket'
        事件: 'connect'
        Event: 'upgrade'
        Event: 'continue'
        request.write(chunk, [encoding])
        request.end([data], [encoding])
        request.abort()
        request.setTimeout(timeout, [callback])
        request.setNoDelay([noDelay])
        request.setSocketKeepAlive([enable], [initialDelay])
    http.IncomingMessage
        事件: 'close'
        message.httpVersion
        message.headers
        message.rawHeaders
        message.trailers
        message.rawTrailers
        message.setTimeout(msecs, callback)
        message.method
        message.url
        message.statusCode
        message.socket

 

让我们先从一个简单例子开始，创建一个叫server.js的文件，并写入以下代码：

 

复制代码代码如下:

 var http = require('http') ;
 var server = http.createServer(function(req,res){
 res.writeHeader(200,{
     'Content-Type' : 'text/plain;charset=utf-8'  // 添加charset=utf-8
 }) ;
 res.end("Hello,大熊！") ;
 }) ;
 server.listen(8888) ;
 console.log("http server running on port 8888 ...") ;

 

（node server.js）以下是运行结果：

 

二，细节分析实例

具体看一下这个小例子：

（1行）：通过"require"引入NodeJS自带的"http"模块，并且把它赋值给http变量。

（2行）：调用http模块提供的函数："createServer" 。这个函数会返回一个新的web服务器对象。

　　参数 "requestListener" 是一个函数，它将会自动加入到 "request" 事件的监听队列。

　　当一个request到来时，Event-Loop会将这个Listener回调函数放入执行队列， node中所有的代码都是一个一个从执行队列中拿出来执行的。

　　这些执行都是在工作线程上(Event Loop本身可以认为在一个独立的线程中，我们一般不提这个线程，而将node称呼为一个单线程的执行环境),

　　所有的回调都是在一个工作线程上运行。

　　我们在再来看一下"requestListener"这个回调函数，它提供了两个参数（request，response），

　　每次收到一个请求时触发。注意每个连接又可能有多个请求(在keep-alive的连接中)。

　　"request"是http.IncomingMessage的一个实例。"response"是http.ServerResponse的一个实例。

　　一个http request对象是可读流，而http response对象则是可写流。

　　一个"IncomingMessage"对象是由http.Server或http.ClientRequest创建的，

　　并作为第一参数分别传递给"request"和"response"事件。

　　它也可以被用来访问应答的状态，头文件和数据。

　　它实现了 "Stream" 接口以及以下额外的事件，方法和属性。（具体参考api）。

（3行）：“writeHeader”，使用 "response.writeHead()"  函数发送一个Http状态200和Http头的内容类型（content-type）。

　　向请求回复响应头。"statusCode"是一个三位是的HTTP状态码，例如 404 。最后一个参数，"headers"，是响应头的内容。

　　举个栗子：

 

复制代码代码如下:

 var body = 'hello world' ;
 response.writeHead(200, {
      'Content-Length': body.length,
      'Content-Type': 'text/plain' 
 }) ;

 

　注意：Content-Length 是以字节(byte)计算，而不是以字符(character)计算。

　　之前的例子原因是字符串 “Hello World !” 只包含了单字节的字符。

　　如果body包含了多字节编码的字符，就应当使用Buffer.byteLength()来确定在多字节字符编码情况下字符串的字节数。

　　需要进一步说明的是Node不检查Content-Lenth属性和已传输的body长度是否吻合。

　statusCode是一个三位是的HTTP状态码, 例如："404" 。这里要说的是 "http.STATUS_CODES" ，全部标准"Http"响应状态码的集合和简短描述都在里面。

　如下是源码参考：

 

复制代码代码如下:

var STATUS_CODES = exports.STATUS_CODES = {
  100 : 'Continue',
  101 : 'Switching Protocols',
  102 : 'Processing',                 // RFC 2518, obsoleted by RFC 4918
  200 : 'OK',
  201 : 'Created',
  202 : 'Accepted',
  203 : 'Non-Authoritative Information',
  204 : 'No Content',
  205 : 'Reset Content',
  206 : 'Partial Content',
  207 : 'Multi-Status',               // RFC 4918
  300 : 'Multiple Choices',
  301 : 'Moved Permanently',
  302 : 'Moved Temporarily',
  303 : 'See Other',
  304 : 'Not Modified',
  305 : 'Use Proxy',
  307 : 'Temporary Redirect',
  400 : 'Bad Request',
  401 : 'Unauthorized',
  402 : 'Payment Required',
  403 : 'Forbidden',
  404 : 'Not Found',
  405 : 'Method Not Allowed',
  406 : 'Not Acceptable',
  407 : 'Proxy Authentication Required',
  408 : 'Request Time-out',
  409 : 'Conflict',
  410 : 'Gone',
  411 : 'Length Required',
  412 : 'Precondition Failed',
  413 : 'Request Entity Too Large',
  414 : 'Request-URI Too Large',
  415 : 'Unsupported Media Type',
  416 : 'Requested Range Not Satisfiable',
  417 : 'Expectation Failed',
  418 : 'I\'m a teapot',              // RFC 2324
  422 : 'Unprocessable Entity',       // RFC 4918
  423 : 'Locked',                     // RFC 4918
  424 : 'Failed Dependency',          // RFC 4918
  425 : 'Unordered Collection',       // RFC 4918
  426 : 'Upgrade Required',           // RFC 2817
  500 : 'Internal Server Error',
  501 : 'Not Implemented',
  502 : 'Bad Gateway',
  503 : 'Service Unavailable',
  504 : 'Gateway Time-out',
  505 : 'HTTP Version not supported',
  506 : 'Variant Also Negotiates',    // RFC 2295
  507 : 'Insufficient Storage',       // RFC 4918
  509 : 'Bandwidth Limit Exceeded',
  510 : 'Not Extended'                // RFC 2774
};

 

节选自，Nodejs源码 ”http.js“ 143行开始。

其实从客户端应答结果也不难看出：

 

（6行）：”response.end“------当所有的响应报头和报文被发送完成时这个方法将信号发送给服务器。服务器会认为这个消息完成了。

　 每次响应完成之后必须调用该方法。如果指定了参数 “data” ，就相当于先调用  “response.write(data, encoding) ” 之后再调用 “response.end()” 。

（8行）：”server.listen(8888)“ ------ 服务器用指定的句柄接受连接，绑定在特定的端口。

以上就是一个比较详细的分析过程，希望有助于加深理解，代码虽然不多，但是重在理解一些细节机制，以便日后高效的开发NodeJS应用。

三，实例

除了可以使用"request"对象访问请求头数据外，还能把"request"对象当作一个只读数据流来访问请求体数据。

这是一个"POST"请求的例子：

 

复制代码代码如下:

 http.createServer(function (request, response) {
     var body = [];
     console.log(request.method) ;
     console.log(request.headers) ;
     request.on('data', function (chunk) {
         body.push(chunk);
     }) ;
     request.on('end', function () {
         body = Buffer.concat(body) ;
         console.log(body.toString()) ;
     });
 }).listen(8888) ;

 

下是一个完整的“Http”请求数据内容。

 

复制代码代码如下:

 POST / HTTP/1.1
 User-Agent: curl/7.26.0
 Host: localhost
 Accept: */*
 Content-Length: 11
 Content-Type: application/x-www-form-urlencoded
 Hello World

 

四，总结一下

（1），理解 "Http" 概念。
（2），熟练使用 "Http" 相关的api。
（3），注意细节的把控，比如：“POST，GET” 之间的处理细节。
（4），"requestListener"的理解。
（5），强调一个概念：一个http request对象是可读流，而http response对象则是可写流 。