NodeJS http Client

使用服务器地址作为参数来构造一个HTTP client，
其返回的句柄可用来发出一个或者多个请求。

根据连接的服 务器不同，
这个客户端可以
1. 使用管道处理机制来处理请求
2. 每个请求重新构建stream
当前的实现方式并没有用管道处理机制处理请求.

Example of connecting to google.com:var http = require('http');var google = http.createClient(80, 'www.google.com');var request = google.request('GET', '/',{'host': 'www.google.com'});request.end();request.on('response', function (response){    console.log('STATUS: ' + response.statusCode);    console.log('HEADERS: ' + JSON.stringify(response.headers));    response.setEncoding('utf8');    //响应接收数据，输出到控制台    response.on('data', function (chunk){    console.log('BODY: ' + chunk);    });});

如上消息头应当注意：
1. Node 并不会添加’Host’，但是这个属性对于一个网站来说通常是必须的。
2. 发送'Connection: keep-alive'将告知Node 和服务器之间的连接应当是持久连接，直到下一次请求才断开。
3. 发送'Content-length'标记将禁用默认的消息体编码。

1. Event: ‘upgrade’

function (request, socket, head)

当服务器响应upgrade 请求时触发此事件，
如果这个消息没有被监听，
客户端接收到一个upgrade 头的话会导致 这个连接被关闭。

可以查看http.Server 关于upgrade 事件的解释来了解更多内容。

---

1. http.createClient(port, host=’localhost’, secure=false, [credentials])

构造一个新的HTTP 客户端.
port 和host 指明了将要连接的目标。
在发出请求之前不会建立流
(establishe a stream)。

secure 是一个可选的布尔值，
用来表示是否启用HTTPS。

credentials 是一个来自于crypto 模块的可选参数，
credentials 中可以包含client 的私钥，
证书以及一个可信任的数字认证中心的证书列表.

如果连接使用了secure 但是没有把数字认证中心证书传给credentials，

那么NODEJS 将缺省使用公开的可信任 数字认证中心整数列表,就比如点我进入列表

2. client.request(method=’GET’, path, [request_headers])

发出一个请求，
在必须时建立一个流。
该函数返回一个http.ClientRequest 对象。

1. method 是可选项，缺省会以 GET 方式发出请求
2. request_headers 是可选项。
   请求头的额外部分一般由NODE 内部实现。
   该函数返回一个ClientRequest 对象

☆ 1.
如果你就想要发送一个信息体，
记得要在头信息里包含Content-Length 项。

☆ 2.
如果你想要将BODY 通过流的方式 传输发送，
或许需要设置Transfer-Encoding: chunked.

大多数的站点相应用户请求时
发送的HTTP Headers 中包含Content-Length 头.
此头信息定义在HTTP1.0协 议RFC 1945 10.4章节中.

该信息是用来告知用户代理,
通常意义上就是浏览器,
服务端发送的文档内容长度.

浏览 器接受到此信息后,
接收完Content-Length 中定义的长度字节后开始解析页面.

如果服务端有部分数据延迟发送,
那么浏览器就会白屏.
这样导致比较糟糕的用户体验.

解决方法在HTTP1.1协议.RFC2616中14.41章节中定义的
Transfer-Encoding:chunked 的头信息.
chunked 编码定义在3.6.1中.

根据此定义浏览器不需要等到内容字节全部下载完成,
只要接收到一个chunked 块就可解析页面.
并且可以下载html 中定义的页面内容,包括js,css,image 等.

注意：这个请求并不完全。
这个方法仅仅发送了头和请求。
需要发送一个request.end()来真正的完成当前这个请求并且
接收回应。
（这听起来有点绕,
但是这正好就提供了用户通过使用request.write()方法来通过流方式发送 body 到服务器端的机会）

3.client.verifyPeer()

返回true/false 并在上下文附带服务器定义的
或者缺省数字认证中心的有效证书列表。

4. client.getPeerCertificate()

返回用JSON 结构详尽表述的服务器方证书，
其中包含证书的‘主题’，‘发布者’，’有效来源’,’有效目标’
（'subject', 'issuer', 'valid_from' and 'valid_to'）。