Nodejs的http模块

一、http服务器

　　我们知道传统的HTTP服务器是由Aphche、Nginx、IIS之类的软件来搭建的，但是Nodejs并不需要，Nodejs提供了http模块，自身就可以用来构建服务器。例如，下面的代码就是使用Nodejs搭建了一个简易的服务器：

/**
 *main.js
 *在终端输入node main.js，打开浏览器在地址栏输入localhost:3000
 *浏览器显示Hello Nodejs
 */

//获取http模块
var http = require("http");
//获取http.Server对象
var server = new http.Server();

//创建服务器，并监听3000端口
server.on("request",function(req,res) {
    res.writeHead(200,{
        "content-type":"text/plain"
    });
    res.write("Hello Nodejs");
    res.end();
}).listen(3000);

 

　　http模块中封装了一个HTTP服务器和一个简易的HTTP客户端：使用http.Server类创建一个基于事件的HTTP服务器，而使用http.request()和http.get()方法则可以作为HTTP客户端向服务器发起请求。

　　上面的示例代码创建了一个http.Server对象，然后为其添加request事件监听，这个事件会在每次接收到请求时触发。text/plain的意思是将文件设置为纯文本格式，浏览器在获取到这种文件时并不会对其进行处理，如果将content-type设置为text/html，浏览器在获取到这种文件时会自动调用HTML的解析器对文件进行相应的处理。另外，也可以使用createServer()方法简化这一过程：

var http = require("http");

//createServer()方法创建的http.Server对象默认添加了一个request事件监听
http.createServer(function(req,res) {
    res.writeHead(200,{
        "content-type":"text/plain"
    });
    res.write("Hello Nodejs");
    res.end();
}).listen(3000);

　　上面说到了http.Server类的事件，http.Server类最常用的事件是"request"事件。在"request"事件中，传入回调函数的参数req和res分别是http.IncomingMessage类（它实现了可读流的接口）和http.ServerResponse类（它实现了可写流的接口）的实例。

　　1、IncomingMessage对象包含了从客户端发来的http请求信息，它可以用来访问响应状态、消息头、以及数据等，例如：

var http = require("http");

http.createServer(function(req,res) {
    console.log(req.httpVersion);//http协议版本，可能的值有"1.1"或"1.0"
    console.log(req.method);//请求的方法，例如"GET"、"POST"等
    console.log(req.statusCode);//http响应状态码
    console.log(req.statusMessage);//http响应状态消息
    console.log(req.headers);//请求头或响应头的对象
    console.log(req.url);//发送http请求的客户端的url
}).listen(3000);

　　

　　IncomingMessage对象包含的事件、方法以及属性参考手册：http://nodejs.cn/api/http.html#http_class_http_incomingmessage

　　2、http.ServerResponse类是返回给客户端的信息，它有三个重要的方法，用于返回响应头、响应内容以及结束请求：
　　writeHead(statusCode[, statusMessage][, headers])：向请求的客户端发送响应头，该函数在一个请求中最多调用一次，如果不调用，则会自动生成一个响应头。statusCode是一个三位数的http状态码，如“200”表示请求成功、“404”表示请求的资源不存在；statusMessage是一个字符串，用来描述状态；headers是一个对象，即响应头。
　　write(chunk[, encoding][, callback])：向请求的客户端发送响应体，在end()方法被调用前可以多次调用。chunk是一个buffer或者字符串，如果chunk是字符串，则在第二个参数需要指定编码方式，默认为utf-8。
　　end([chunk][, encoding][, callback])：该方法会通知服务器，所有响应头和响应主体都已被发送，每次响应都必须调用end()方法来结束。
　　ServerResponse对象包含的事件、方法以及属性参考手册：http://nodejs.cn/api/http.html#http_class_http_serverresponse

http.Server类的事件参考手册：http://nodejs.cn/api/http.html#http_class_http_server

 

二、http客户端

　　http模块提供了http.request()和http.get()两个方法，功能是作为客户端向http服务器发起请求。

　　1、关于http.request(options[, callback])
　　options是一个对象，包含了请求的相关参数：http://nodejs.cn/api/http.html#http_http_request_options_callback

　　可选参数callback会作为单次监听器被添加到”response“事件，即当请求的响应被接收到时就会调用该回调函数。它在被执行时带有一个参数res，该参数是一个 http.IncomingMessage类的实例
　　返回值是一个http.ClientRequest 类的实例，它表示着一个正在处理的请求

例如：

/**
 *c.js
 *HTTP客户端，发送HTTP请求
 *控制台输出返回的响应内容
 */
var http = require("http");
var options = {
    host: "localhost",
    port: 3000
}

var req = http.request(options,function(res) {
    res.on("data",function(chunk) {
        console.log(chunk.toString("utf-8"));
    });
    res.on("end",function() {
        console.log("----请求结束！----");
    });
});

req.on("error",function(err) {
    console.log(err.message);
});

req.end();

 

/**
 *s.js
 *HTTP服务器
 */
var http = require("http");

http.createServer(function(req,res) {
    res.writeHead(200,{
        "content-type":"text/plain"
    });
    res.write("Hello Nodejs");
    res.end();
}).listen(3000);

 

　　如果请求过程中遇到任何错误，则在返回的请求对象中会触发"error"事件；
　　使用http.request()必须总是调用req.end()来表明请求的结束，即使没有数据被写入请求体；

　　2、关于http.get(options[,callback])方法
　　http.get()方法是http.request()方法的简化版，主要区别是http.get()自动将请求方法设为了"GET"，同时不需要手动调用req.end()。

 

三、总结

　　Nodejs的http模块常用的类和方法：

　　1、http.Server 类：用于创建HTTP服务器，使用时需要先实例化；

　　2、http.ClientRequest 类：该对象在 http.request() 内部被创建并返回。它表示着一个正在处理的请求；

　　3、http.IncomingMessage 类：IncomingMessage对象由 http.Server 或 http.ClientRequest 创建，并作为第一个参数分别传递给 'request' 和 'response' 事件。 它可以用来访问响应状态、消息头、以及数据。它实现了可读流接口；

　　4、http.ServerResponse 类：ServerResponse对象由http.Server创建，并作为第二个参数传递给 'request' 事件。它实现了可写流接口；

　　5、http.createServer( [callback] )方法：返回一个http.Server对象，callback会被自动添加到 'request' 事件中；

　　6、http.request( options[, callback] )方法：作为http客户端，向服务器发送请求，可选参数callback会被自动添加到 'response'事件中；

　　7、http.get( options[, callback] )方法：http.request()方法的简化版，主要区别是http.get()自动将请求方法设为了"GET"，同时不需要手动调用req.end()；