/**
 * Connect to the server with the given credentials
 *
 * @param {string} userName - the user name or authentication ID of the user
 * @param {string} password - the user's password credentials
 * @param callback(err) - called when the connection is established
 */
OSLCServer.prototype.connect = function(userName, password, callback) {
	var _self = this; // needed to refer to this inside nested callback functions
	_self.userName = userName;
	_self.password = password;

	// Get the Jazz rootservices document for OSLC v2
	// This does not require authentication
	request.get(_self.serverURI+'/rootservices', function gotRootServices(err, response, body) {
		if (err || response.statusCode != 200) 
			return console.error('Failed to read the Jazz rootservices resource '+err);
		_self.rootServices = new RootServices(_self.serverURI+'/rootservices', body);

		// Now get the ServiceProviderCatalog so that we know what services are provided
		var catalogURI = _self.rootServices.serviceProviderCatalogURI(OSLCCM());
		//require('request-debug')(request);
		// This request will require authentication through FORM based challenge response
		request.get(catalogURI, gotServiceProviderCatalog);
	});
	
	// Parse the service provider catalog, it will be needed for any other request.
	function gotServiceProviderCatalog(err, response, body) {
		if (response &&  response.headers['x-com-ibm-team-repository-web-auth-msg'] === 'authrequired') {
			return request.post(_self.serverURI+'/j_security_check?j_username='+_self.userName+'&j_password='+_self.password, gotServiceProviderCatalog);
		} else if (!response || response.statusCode != 200) {
			return console.error('Failed to read the CM ServiceProviderCatalog '+err);
		}
		_self.serviceProviderCatalog = new ServiceProviderCatalog(response.request.uri.href, body);
		callback(null); // call the callback with no error
	}
}