Click here to Skip to main content
Click here to Skip to main content
Add your own
alternative version

Push Framework - A C++ toolkit for high performance server development

, 23 May 2012 Apache
Write asynchronous, multithreaded servers in a few lines of code. Monitor realtime activity with a deploy-only dashboard.
ChatApplication.zip
ChatAPI
ChatClient
res
.svn
entries
prop-base
ChatClient.ico.svn-base
props
text-base
ChatClient.ico.svn-base
ChatClient.rc2.svn-base
tmp
prop-base
props
text-base
ChatClient.ico
ChatPackets
ChatProtocol
ChatServer
ChatServer.vcproj.INTERNAL.Ahmed.Charfeddine.user
output
ChatServer.ini
TCPSocket
TCPSocket.zip
XMLProtocol
XMLProtocol.zip
ChatRobots.zip
ChatRobots
ChatRobots.ini
ProtoBufExample.zip
ProtoBufExampleClient
ProtoBufExampleProtocol
requests.pb.cc
responses.pb.cc
ProtoBufExampleServer
PushFramework_Essentials.zip
include
PushFramework.dll
PushFramework.lib
PushFramework_Sources.zip
private
QoS.zip
QoSExampleClient
QoSExampleProtocol
QoSExampleServer
/********************************************************************
	File :			ClientFactory.h
	Creation date :	2010/6/27
		
	License :			Copyright 2010 Ahmed Charfeddine, http://www.pushframework.com

				   Licensed under the Apache License, Version 2.0 (the "License");
				   you may not use this file except in compliance with the License.
				   You may obtain a copy of the License at
				
					   http://www.apache.org/licenses/LICENSE-2.0
				
				   Unless required by applicable law or agreed to in writing, software
				   distributed under the License is distributed on an "AS IS" BASIS,
				   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
				   See the License for the specific language governing permissions and
				   limitations under the License.
	
	
*********************************************************************/
#ifndef ClientFactory__INCLUDED
#define ClientFactory__INCLUDED

#pragma once

#include "PushFramework.h"

namespace PushFramework{

class Client;
class ClientFactory;
class IncomingPacket;
class OutgoingPacket;
class ClientFactoryImpl;
class Dispatcher;
class Server;
class ServerImpl;

/**
	Contains the clients management logic (creation, login, disconnection, disposal, storage, ref count etc).
	*/
class PUSHFRAMEWORK_API ClientFactory
{
	friend Dispatcher;
	friend ServerImpl;
public:
	typedef enum
	{
		RefuseRequest = -2,
		RefuseAndClose,
		CreateClient,
		CreateAndRouteRequest,		
	}Result;

	ClientFactory(void);
	~ClientFactory(void);

	/**
		\param lpContext Used to store any contextual infos that can be provided to you back when the first request is received from the same connection.

		When a new connection is accepted, you can choose to send an outgoing packet before receiving a first request.
		You may need to push a dynamic context that can be provided to you when the first request is received.
		(used to separate legitemate users between illegetemate users).
		If you return NULL, the framework simply waits for client request and does not send anything untill then.
	*/
	virtual OutgoingPacket* onNewConnection(void*& lpContext) = 0;
	/**
		\param packet OutgoingPacket instance to encode.

		Override to encode the OutgoingPacket instance. Save the result into the same input.
	*/
	virtual void onClientDisconnected(ClientKey key) = 0;
	/**
		\param packet OutgoingPacket instance to encode.

		Override to encode the OutgoingPacket instance. Save the result into the same input.
	*/
	virtual void onBeforeDisposeClient(Client* pClient)=0;
	/**
		\param packet OutgoingPacket instance to encode.

		Override to encode the OutgoingPacket instance. Save the result into the same input.
	*/
	virtual void onClientReconnected(ClientKey key)=0;
	/**
		\param key Client key.

		Called after you successful login a Client in OnFirstRequest.
	*/
	virtual void onClientConnected(ClientKey key)=0;
	/**
		\param client key OutgoingPacket instance to encode.

		When the frameswork detects that an existing client has logged in through another connection,
		the past connection is closed and the new one is attached the existing Client structure.
		Furthermore, this function is triggered so you can perform certain logic.
	*/
	virtual void disposeClient(Client* pClient)=0;
	/**
	\param request A reference to the received request packet.
	\param lpContext reference to the context data that you supplied at ::onNewConnection.
	\param lpClient reference address to write your newly allocated Client structure to.
	\param lpPacket used to send a reply when the request is refused.

		Called for the first request received by an accepted connection.
		The function behaves like a login function. You may decide to create a new Client or refuse the request.
	*/
	virtual int onFirstRequest(IncomingPacket& request, void* lpContext, Client*& lpClient, OutgoingPacket*& lpPacket) = 0;



	Client* getClient(ClientKey clientKey);
	void returnClient(ClientKey clientKey);

	Server* getServer();
private:
	ClientFactoryImpl* pImpl;
};

}
#endif // ClientFactory__INCLUDED

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article, along with any associated source code and files, is licensed under The Apache License, Version 2.0

Share

About the Author

Ahmed Charfeddine
Technical Lead
Tunisia Tunisia
Services:
http://www.pushframework.com/?page_id=890
Follow on   Twitter

| Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.141220.1 | Last Updated 23 May 2012
Article Copyright 2011 by Ahmed Charfeddine
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid