--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerpluginsandutils/httptransportplugins/httptransporthandler/csocketconnector.h	Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,183 @@
+// Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __CSOCKETCONNECTOR_H__
+#define __CSOCKETCONNECTOR_H__
+
+#include <e32base.h>
+#include <in_sock.h>
+#include <http/framework/logging.h>
+
+#include "msocketconnector.h"
+
+class CSocket;
+class MSocketConnectorStore;
+class MSocketConnectObserver;
+class MSocketControllerFactory;
+class MCommsInfoProvider;
+
+
+class CSocketConnector : public CActive,
+						 public	MSocketConnector
+/**	
+	The CSocketConnector class provides socket connecting behaviour. Once the
+	socket connector object has been started (ConnectL() API) it will notify its
+	observer when it has established a connection with the specified remote host.
+
+	The socket connector initially does a DNS lookup for the host name provided
+	in the ConnectL() API. Once the IP address has been found for the host name
+	the socket connector will attempt to establish a TCP connection with the 
+	remote host.
+
+	When a connection has been established a socket controller object is created
+	by the socket controller factory to encapsulate the connected socket. This
+	provides the input and output streams for the socket.
+
+	The observer, an MSocketConnectObserver object, is notified of a connection
+	using the MSocketConnectObserver::ConnectionMadeL() API. The input and output
+	streams that encapsulate the connected socket are passed to the observer.
+
+	The connected socket is then placed in the socket controller store by the 
+	socket controller factory. This transfers the ownership of the socket
+	controller object to the store.
+
+	After the socket controller ownership has been transferred, the socket 
+	connector removes itself from the socket connector store and then suicides.
+
+	If the socket connector encounters any problems it notifies its observer using
+	the MSocketConnectObserver::HandleConnectError(TInt aError) API. If a problem 
+	does occur the socket connector will suicide after handling the error.
+	@internalComponent
+*/
+	{
+public:	// methods
+
+	static CSocketConnector* NewL(
+								 MSocketConnectorStore&		aStore,
+								 MSocketControllerFactory&	aSocketControllerFactory,
+								 MCommsInfoProvider&		aCommsInfoProvider,
+								 TBool aPriority
+								 );
+
+	virtual ~CSocketConnector();
+
+	void ConnectL(MSocketConnectObserver& aObserver, const TDesC8& aRemoteHost, TUint16 aRemotePort, TInetAddr* aRemoteAddress);
+
+private:	// methods from MSocketConnector
+
+	virtual void StopConnect();
+
+	virtual void MSocketConnector_Reserved();
+
+private:	// methods from CActive
+
+	virtual void RunL();
+	
+	virtual void DoCancel();
+	
+	virtual TInt RunError(TInt aError);
+
+private:	// methods
+
+	CSocketConnector(
+					MSocketConnectorStore&		aStore,
+					MSocketControllerFactory&	aSocketControllerFactory,
+					MCommsInfoProvider&			aCommsInfoProvider,
+					TBool aPriority
+					);
+
+	void CompleteSelf();
+
+	void Suicide();
+
+private:	// enums
+
+/**	
+	The state machine for the socket connector.
+*/
+	enum TConnectState
+		{
+		/** The socket connector is idle.
+		*/
+		EIdle				= 0,
+		/** A connection has been requested. The DNS lookup needs to be initiated
+			to find the IP address of the remote host.
+		*/
+		EPendingDNSLookup,
+		/**	The IP address of the remote host has been found. Initiated a TCP
+			connection to that remote host.
+		*/
+		EConnecting,
+		/**	The connection has been established. Ownership of the connected socket
+			must be passed to the observer.
+		*/
+		EConnected,
+		};
+
+private:	// attributes
+
+/** The socket connector store.
+*/
+	MSocketConnectorStore&		iStore;
+
+/**	The socket controller factory.
+*/
+	MSocketControllerFactory&	iSocketControllerFactory;
+
+/** The comms info provider.
+*/
+	MCommsInfoProvider&			iCommsInfoProvider;
+
+/** The state of the socket connector.
+*/
+	TConnectState				iState;
+
+/** The host resolver session.
+*/
+	RHostResolver				iHostResolver;
+
+/** The socket connect observer.
+*/
+	MSocketConnectObserver*		iObserver;
+
+/**	The host name/IP address for the remote client.
+*/
+	HBufC*						iHost;
+
+/**	The port number on remote host with which to connect to
+*/
+	TUint16						iPort;
+
+/** The DNS entry object for the remote client
+*/
+	TNameEntry					iHostDnsEntry;
+	
+/** The address of the remote host
+*/
+	TInetAddr					iAddress;
+
+/**	The socket object that is connecting to the remote client
+*/
+	CSocket*					iConnectingSocket;
+
+public:	// attributes
+
+/** Logger handle
+*/
+	__FLOG_DECLARATION_MEMBER2
+
+	};
+
+#endif	// __CSOCKETCONNECTOR_H__