http模块

http服务器和http客户端

node.js提供了http模块，其中封装了一个http服务器和一个建议的http客户端。
http.server是一个基于事件的http服务器，内部由c++实现，接口由JavaScript封装。
http.request则是一个http客户端工具，用户向服务器发送请求。

一、http服务器

http.Server实现的，它提供了一套封装级别很低的API，仅仅是流控制和简单的解析，所有的高层功能都需要通过它的接口。

//引入模块
var http = require('http');

// 创建服务
http.createServer(function(req, res) {

    //响应头
    res.writeHead(200, {'Content-Type':'text/html'});

    //响应内容
    res.write('<h1>Node.js</h1>');

    //结束响应
    res.end('<p>will will be well </p> ');

//监听端口
}).listen(3000);


console.log('http server is listening at port 3000');

代码分析：
http.createServer创建了一个http.Server的实例，将一个函数作为http请求处理函数，这个函数接受两个参数：请求对象req和响应对象res。

res显式写入了，响应代码200（表示请求成功），指定响应头，写入响应体，调用end结束并且发送。

该实例调用listen函数，启动服务器并且监听3000端口。

结果

1、http.server的事件

http.server是一个基于事件的http服务器，所有请求都被封装成独立的事件，开发者只有对它的事件编写相应函数，实现http服务器的所有功能。它继承于EventEmitter，提供了以下事件：

——request：当客户端请求到来时，该事件被触发，提供两个参数req和res，分别是http.ServerRequest和http.ServerResponse的实例，表示请求和响应信息

——connection：当TCP连接建立时，该事件被触发，提供一个参数socket，为net.Socket的实例(底层协议底下)

——close：当服务器关闭时，该事件被触发

除此之外还有checkContinue、upgrade、clientError事件

最常用和关心的是“request事件”，http提供了一个捷径：http.createServer([requestListener])

 案例 server.js

var http = require('http');
var server = new http.Server();

server.on('request',function(req,res){
    req.writeHead(200,{'Content-Type':'text/html'});
    req.write('<h1>we are node coder<h1>');
    res.end('<p>node coding is end</p>');
});

结果

2、http.Serverrequest（请求的信息）

此对象是后端开发者最关注的内容，它一般由http.Server的request事件发送，作为第一个参数传递，通常简写成request或req。

http请求分为两部分：请求头和请求体。

请求内容端的直接在请求头解析完成后立即读取，而请求体可能相对较长，需要一定的事件传输，因为提供了三个事件用于控制请求体传输：
（1）data：当请求体数据到来时，该事件被触发，该事件只有一个参数chunk，表示接受到的数据
（2）end：当请求体数据传输完成时，该事件被触发，此后将不会再有数据的到来
（3）close：当前用户请求结束时，该事件被触发，不同于end，如果用户强制终止了传输，也会触发close

serverRequest的属性：

　　——complete：客户端请求是否已经发送完成
　　——httpVersion：HTTP协议版本，通常是1.0或者1.1
　　——method:：Http请求方法，如GET、POST
　　——url：原始的请求路径 例如 pc/getUser或者、user？name=will
　　——headers：HTTP请求头
　　——trails：HTTP请求尾（不常见）
　　——connection： 当前http连接套间字，为net.Socket的实例
　　——socket：connection属性的别名
　　——client：client属性的别名

3、获取GET请求内容

由于GET请求直接被嵌入在路径中，URL完整的请求路径，包含了？后面的部分，因此你可以手动解析后面的内容作为GET的参数，Node.js的url模块中的parse函数提供了这个功能

//引入模块
var http = require('http');
var urls = require('url');
var util = require('util');

//创建服务
http.createServer(function(req,res){

    res.writeHead(200,{'Content-Type':'text/plain'});

    //解析并且打成字符串形式返回给客户端
    res.end(util.inspect(urls.parse(req.url,true)));

}).listen(3000);

结果

4、获取POST请求内容

POST请求内容全部在请求体中，http.serverRequest并没有一个属性内容为请求体，原因是等待请求体传输可能是一件耗时的工作，比如上传文件，恶意的POST请求会大大消耗服务器的资源，所以Node.js是不会解析请求体的当你需要的时候，需要手动来做

//引入模块
var http = require('http');
var querystring = require('querystring');
var util = require('util');

http.createServer(function(req,res){
    var post ='';

    //注册data事件监听函数，每当接受请求体的数据
    req.on('data',function(chunk){
        post += chunk;
    });

    req.on('end',function(){
        //解析成真正的post请求格式
        post = querystring.parse(post);

        //向前端返回
        res.end(util.inspect(post));
    });
}).listen(3000);

结果如下，因为没有请求体

5、http.ServerResponse（返回给客户端的信息）

决定了用户最终能得到的结果。它是由http.Server的request事件发送的，作为第一个参数传递，一般为response或res。

主要的是三个函数：

reponse.writeHead(statusCode, [headers]：向请求的客户端发送响应头

　　——Statuscode是http的状态码，如200为成功，404未找到等

　　——headers是一个类似关联数组的对象，表示响应头的每个属性

response.write(data,[encoding])：向请求客户端发送响应内容

　　——data是buffer或字符串

　　——encoding为编码

response.end([data],[encoding])：响应结束，告知用户所有发送已经完成，当所有要返回的内容发送完毕，该函数必须被调用一次，如果不调用，客户端永远处于等待的状态

二、http客户端

http模块提供了两个函数http.request和http.get，作为客户端向http服务器发起请求。

1、http.request(options,callback)

发起http请求。

接收两个参数：option是一个类似关联数组的对象，表示请求的参数；callback是请求的回调函数

option常用的参数如下：

　　——host：请求网站的域名或者ip地址

　　——port：请求网站的端口，默认是80

　　——path：请求的相对于根的路径，默认"/"。QueryString应该包含在其中，例如/search?query=will

　　——method：HTTP请求方法，默认为GET

　　——headers：一个关联数组对象，为请求头的内容

callback传递一个参数为http.ClientResponse的实例

http.request返回一个http.ClientRequest的实例

clientRequest.js

/// <reference path="typings/node/node.d.ts"/>
var http=require('http');
var querystring=require('querystring');

//启动服务
http.createServer(function(req,res){
    console.log('请求到来，解析参数');

    //解析post请求
    var post='';

    req.on('data',function(chunk){
        post+=chunk;
    });

    req.on('end',function(){
        post = querystring.parse(post);

        //解析完成
        console.log('参数解析完成，返回name参数');
        res.end(post.name);
    });

}).listen(3000);


// 客户端请求
var contents =querystring.stringify({
    name:'will',
    age:21,
    address:'shanghai'
});

//声明请求参数
var options={
    host:'localhost',
    path:'/',
    port:3000,
    method:'POST',
    headers:{
        'Content-Type':'application/x-www-form-urlencoded',
        'Content-length':contents.length
    }
};

//发送请求
var req=http.request(options,function(res){
    res.setEncoding('utf-8');
    res.on('data',function(data){
        console.log('后台返回数据');
        console.log(data);
    }) 
});

req.write(contents);

//必须结束
req.end();

结果

2、http.get

它是http.request的简化版，唯一的区别在于http.get自动将请求方法设为GET请求，同时不需要手动调用req.end()

 

clientGet.js

///<reference path="typings/node/node.d.ts"/>
var http = require('http');
var url = require('url');
var util = require('util');

//启动服务
http.createServer(function(req,res){
    console.log('请求到来 解析参数');
    var params =url.parse(req.url,true);
    console.log('解析完成');
    console.log(util.inspect(params));
    console.log('向客户端返回');
    res.end(params.query.name);
}).listen(3000);

//客户端请求
http.get({
    host:'localhost',
    path:'/user?name=will&age=21',
    port:3000},
    function (res) {
        res.setEncoding('utf-8');
        res.on('data',function (data) {
            console.log('服务端返回响应回来的数据'+data);
        })
});

结果

3、 http.ClientRequest

该对象还是由http.request或http.get返回产生对象，表示一个已经产生而且真正进行的HTTP请求 ，它提供了response事件，即http.request或http.get 第二个参数指定的回调函数的绑定对象，请求必须调用end方法结束请求。

提供的函数：

request.abort() ：终止正在发送的请求

request.setTimeout(timeout,[callback])：设置请求超时时间，timeout为毫秒数，当请求超时后，callback将会被调用

其他：request.setNoDelay([noDelay])、request.setSocketKeepAlive([enable],[initialDelay])等函数

4、http.ClientResponse

http.ClientResponse是与http.ServerResponse相似，提供三个事件。data事件、end事件和close事件分别在数据到达、数据传输完成和连接结束时触发，其中data事件传递一个参数chunk，表示接收到的数据

属性：表示请求结果的状态

　　——statusCode：HTTP状态码，如200，404，500

　　——httpVersion：HTTP协议版本

　　——headers：http请求头

　　——trailers：http请求尾

函数：
　　——response.setEncoding([encoding])：设置默认的编码，当data事件被触发时，数据将以encoding编码，默认值为null，以buffer的形式存储

　　——response.pause() ：暂停以接受数据和发送事件，方便实现下载功能

　　——response.resume()：从暂停的状态中恢复