---

clientconnector.h

Go to the documentation of this file.

/********************************************************************
        Copyright (c) 2001, Lee Patterson & Ant Works Software
        http://ssobjects.sourceforge.net

        filename :  clientconnector.h
        author   :  Lee Patterson (lee@antws.com)
        
        purpose  :  A client uses this to connect to a server.
                    Provides abilty to direct packets via << & >>
                    operators.
*********************************************************************/

#ifndef CLIENTCONNECTOR_H
#define CLIENTCONNECTOR_H

#include "ssobjects.h"
#include "bufferedsocket.h"

namespace ssobjects
{

#define throwClientConnectorException(m) (throw ClientConnectorException(m,__FILE__,__LINE__))

class ClientConnectorException : public GeneralException
{
  public: // Constructor/destructor
    ClientConnectorException(char* pchMessage,const char* pFname,const int iLine) 
      : GeneralException(pchMessage,pFname,iLine){};
};

class ClientConnector
{

#ifdef _WIN32
  public:
    WSADATA             m_wsd;              
    static bool         m_bWSAStarted;      
#endif

  protected:  //attributes
    unsigned16  m_wPort;                    
    CStr        m_strHost;                  
    BufferedSocket*   m_pSocket;                  

  protected:
    void        cleanup();                  

  public:     //overridables
    void handleException(GeneralException& e);   
    void sendPacket(PacketBuffer* pPkt);        
    void sendPacket(PacketBuffer& pPkt);        
    PacketBuffer* recvPacket();                 
    void operator << (PacketBuffer&);           
    void operator << (PacketBuffer*);           
    void operator >> (PacketBuffer&);           

//TODO: add setTimeout() method

  public:     //construction
    ClientConnector();                       
    ClientConnector(const char* pszHost,word wPort); 
    ~ClientConnector();                              

  public:     //methods
    CONSTCHAR*  getServer()     {return m_strHost;}                 
    word        getPort()       {return m_wPort;}                   
    bool        isConnected()   {return m_pSocket ? true:false;}    
    BufferedSocket*   getSocket();

    void        reconnect();                                        
    void        connect();                                          
    void        connect(const char* szHost,const unsigned wPort);   
    void        close();                                            

  private:
    //unused overloads
    ClientConnector(const ClientConnector&);
    ClientConnector& operator=(const ClientConnector&);
};

};

#endif  //CLIENTCONNECTOR_H

---