added connection pooling for non-cached setups

Author: berb

README.md

@@ -65,6 +65,18 @@ Note that you can also use `cradle.setup` to set a global configuration:
     var c = new(cradle.Connection),
        cc = new(cradle.Connection)('173.45.66.92');
 
+### Connection pooling ###
+
+Due to cache coherence issues, connection pooling is currently only available for non-caching instances. If caching is enabled, only one client will be used internally.
+Otherwise, the number of client connections to be used for handling requests can be set using the `poolsize` variable. The following example creates a cradle connection handle with 32 parallel HTTP connections:
+
+	var c = new (cradle.Connection)("localhost", 5984, {
+		cache : false,
+		raw : false,
+		poolsize : 32
+	});
+
+
 ### creating a database ###
 
     var db = c.database('starwars');

lib/cradle.js

@@ -25,6 +25,7 @@ cradle.auth = null;
 cradle.options = {
     cache: true,
     raw: false,
+    poolsize : 1,
     timeout: 0,
     secure: false,
     headers: {}
@@ -61,7 +62,9 @@ cradle.Connection = function Connection(/* variable args */) {
     this.host = host || cradle.host;
     this.port = port || cradle.port;
     this.auth = auth || cradle.auth;
+    
     this.options = cradle.merge({}, cradle.options, options);
+    
 
     this.options.secure = this.options.secure || this.options.ssl;
 
@@ -80,6 +83,14 @@ cradle.Connection = function Connection(/* variable args */) {
     }
 
     this.socket = (this.options.secure) ? https : http;
+    
+    this.agent = new (this.socket).Agent({
+    		host: this.host,
+    		port: this.port	
+    });
+    
+	this.agent.maxSockets = ((!this.options.cache) ? this.options.poolsize : 1);
+    
 };
 
 //
@@ -119,8 +130,7 @@ cradle.Connection.prototype.rawRequest = function (method, path, options, data,
     }
 
     request = this.socket.request({
-        host:    this.host,
-        port:    this.port,
+    	agent:   this.agent,
         method:  method.toUpperCase(),
         path:    path,
         headers: headers
@@ -134,6 +144,7 @@ cradle.Connection.prototype.rawRequest = function (method, path, options, data,
         promise.emit('response', res);
         res.on('data', function (chunk) { promise.emit('data', chunk) });
         res.on('end',  function () { promise.emit('end') });
+        console.log(that.agent.sockets.length);
     });
 
     if (data) {