Initiator.h
Go to the documentation of this file.
1 /* -*- C++ -*- */
2 
3 /****************************************************************************
4 ** Copyright (c) 2001-2014
5 **
6 ** This file is part of the QuickFIX FIX Engine
7 **
8 ** This file may be distributed under the terms of the quickfixengine.org
9 ** license as defined by quickfixengine.org and appearing in the file
10 ** LICENSE included in the packaging of this file.
11 **
12 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
13 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
14 **
15 ** See http://www.quickfixengine.org/LICENSE for licensing information.
16 **
17 ** Contact ask@quickfixengine.org if any conditions of this licensing are
18 ** not clear to you.
19 **
20 ****************************************************************************/
21 
22 #ifndef FIX_INITIATOR_H
23 #define FIX_INITIATOR_H
24 
25 #ifdef _MSC_VER
26 #pragma warning( disable : 4503 4355 4786 4290 )
27 #endif
28 
29 #include "Application.h"
30 #include "MessageStore.h"
31 #include "Log.h"
32 #include "Responder.h"
33 #include "SessionSettings.h"
34 #include "Exceptions.h"
35 #include "Mutex.h"
36 #include "Session.h"
37 #include <set>
38 #include <map>
39 #include <string>
40 
41 namespace FIX
42 {
43 class Client;
44 
51 class Initiator
52 {
53 public:
54  Initiator( Application&, MessageStoreFactory&,
55  const SessionSettings& ) throw( ConfigError );
56  Initiator( Application&, MessageStoreFactory&,
57  const SessionSettings&, LogFactory& ) throw( ConfigError );
58 
59  virtual ~Initiator();
60 
62  void start() throw ( ConfigError, RuntimeError );
64  void block() throw ( ConfigError, RuntimeError );
66  bool poll( double timeout = 0.0 ) throw ( ConfigError, RuntimeError );
67 
69  void stop( bool force = false );
70 
72  bool isLoggedOn();
73 
74  Session* getSession( const SessionID& sessionID, Responder& );
75 
76  const std::set<SessionID>& getSessions() const { return m_sessionIDs; }
77  Session* getSession( const SessionID& sessionID ) const;
78  const Dictionary* const getSessionSettings( const SessionID& sessionID ) const;
79 
80  bool has( const SessionID& id )
81  { return m_sessions.find( id ) != m_sessions.end(); }
82 
83  bool isStopped() { return m_stop; }
84 
85 public:
86  Application& getApplication() { return m_application; }
87  MessageStoreFactory& getMessageStoreFactory()
88  { return m_messageStoreFactory; }
89 
90  Log* getLog()
91  {
92  if( m_pLog ) return m_pLog;
93  return &m_nullLog;
94  }
95 
96 protected:
97  void setPending( const SessionID& );
98  void setConnected( const SessionID& );
99  void setDisconnected( const SessionID& );
100 
101  bool isPending( const SessionID& );
102  bool isConnected( const SessionID& );
103  bool isDisconnected( const SessionID& );
104  void connect();
105 
106 private:
107  void initialize() throw ( ConfigError );
108 
110  virtual void onConfigure( const SessionSettings& ) throw ( ConfigError ) {};
112  virtual void onInitialize( const SessionSettings& ) throw ( RuntimeError ) {};
114  virtual void onStart() = 0;
116  virtual bool onPoll( double timeout ) = 0;
118  virtual void onStop() = 0;
120  virtual void doConnect( const SessionID&, const Dictionary& ) = 0;
121 
122  static THREAD_PROC startThread( void* p );
123 
124  typedef std::set < SessionID > SessionIDs;
125  typedef std::map < SessionID, int > SessionState;
126  typedef std::map < SessionID, Session* > Sessions;
127 
134 
138 protected:
140 private:
144  bool m_firstPoll;
145  bool m_stop;
147 };
149 }
150 
151 #endif // FIX_INITIATOR_H
FIX::thread_id
pthread_t thread_id
Definition: Utility.h:190
FIX::Initiator::start
void start()
Start initiator.
Definition: Initiator.cpp:207
FIX::Initiator::SessionIDs
std::set< SessionID > SessionIDs
Definition: Initiator.h:141
FIX::Initiator::m_stop
bool m_stop
Definition: Initiator.h:162
FIX::Initiator::stop
void stop(bool force=false)
Stop initiator.
Definition: Initiator.cpp:243
FIX::Initiator::m_disconnected
SessionIDs m_disconnected
Definition: Initiator.h:149
SessionSettings.h
FIX::MessageStoreFactory
This interface must be implemented to create a MessageStore.
Definition: MessageStore.h:58
FIX::Initiator::m_pLogFactory
LogFactory * m_pLogFactory
Definition: Initiator.h:158
FIX::Initiator::~Initiator
virtual ~Initiator()
Definition: Initiator.cpp:105
FIX::Initiator::getSession
Session * getSession(const SessionID &sessionID, Responder &)
Definition: Initiator.cpp:115
FIX::Initiator::m_sessions
Sessions m_sessions
Definition: Initiator.h:145
FIX::Initiator::getMessageStoreFactory
MessageStoreFactory & getMessageStoreFactory()
Definition: Initiator.h:104
FIX::Initiator::isDisconnected
bool isDisconnected(const SessionID &)
Definition: Initiator.cpp:201
FIX::Initiator::isPending
bool isPending(const SessionID &)
Definition: Initiator.cpp:189
FIX::Mutex
Portable implementation of a mutex.
Definition: Mutex.h:47
FIX::Initiator::connect
void connect()
Definition: Initiator.cpp:148
FIX::Initiator::poll
bool poll(double timeout=0.0)
Poll the initiator.
Definition: Initiator.cpp:229
FIX::Initiator::getLog
Log * getLog()
Definition: Initiator.h:107
FIX::Initiator::Sessions
std::map< SessionID, Session * > Sessions
Definition: Initiator.h:143
FIX::Initiator::m_firstPoll
bool m_firstPoll
Definition: Initiator.h:161
FIX::Initiator::Initiator
Initiator(Application &, MessageStoreFactory &, const SessionSettings &)
Definition: Initiator.cpp:53
FIX::Application
This interface must be implemented to define what your FIX application does.
Definition: Application.h:60
FIX::Initiator::m_pLog
Log * m_pLog
Definition: Initiator.h:159
FIX::ConfigError
Application is not configured correctly
Definition: Exceptions.h:104
FIX::RuntimeError
Application encountered serious error during runtime
Definition: Exceptions.h:111
FIX::SessionID
Unique session id consists of BeginString, SenderCompID and TargetCompID.
Definition: SessionID.h:47
FIX::Initiator::isLoggedOn
bool isLoggedOn()
Check to see if any sessions are currently logged on.
Definition: Initiator.cpp:292
FIX::Initiator::onPoll
virtual bool onPoll(double timeout)=0
Implemented to connect and poll for events.
FIX::Initiator::onStop
virtual void onStop()=0
Implemented to stop a running initiator.
FIX::Initiator::m_mutex
Mutex m_mutex
Definition: Initiator.h:163
FIX::Initiator::m_settings
SessionSettings m_settings
Definition: Initiator.h:156
FIX::SessionSettings
Container for setting dictionaries mapped to sessions.
Definition: SessionSettings.h:237
Mutex.h
THREAD_PROC
#define THREAD_PROC
Definition: Utility.h:184
FIX::Initiator::onStart
virtual void onStart()=0
Implemented to start connecting to targets.
FIX::Initiator::getSessions
const std::set< SessionID > & getSessions() const
Definition: Initiator.h:93
FIX::Initiator::setDisconnected
void setDisconnected(const SessionID &)
Definition: Initiator.cpp:180
FIX::Initiator::m_messageStoreFactory
MessageStoreFactory & m_messageStoreFactory
Definition: Initiator.h:154
FIX::Initiator::m_sessionIDs
SessionIDs m_sessionIDs
Definition: Initiator.h:146
Application.h
FIX::Initiator::m_application
Application & m_application
Definition: Initiator.h:153
FIX::Initiator::setPending
void setPending(const SessionID &)
Definition: Initiator.cpp:162
FIX::Initiator::initialize
void initialize()
Definition: Initiator.cpp:80
FIX::Initiator::m_threadid
thread_id m_threadid
Definition: Initiator.h:152
FIX
Definition: Acceptor.cpp:34
FIX::Initiator::setConnected
void setConnected(const SessionID &)
Definition: Initiator.cpp:171
FIX::Initiator::getApplication
Application & getApplication()
Definition: Initiator.h:103
FIX::Initiator::has
bool has(const SessionID &id)
Definition: Initiator.h:97
Session.h
FIX::Initiator::m_nullLog
NullLog m_nullLog
Definition: Initiator.h:160
FIX::Initiator::onInitialize
virtual void onInitialize(const SessionSettings &)
Implemented to initialize initiator.
Definition: Initiator.h:129
FIX::NullLog
Null implementation of Log.
Definition: Log.h:117
FIX::Initiator::getSessionSettings
const Dictionary *const getSessionSettings(const SessionID &sessionID) const
Definition: Initiator.cpp:136
Responder.h
FIX::Initiator::m_sessionState
SessionState m_sessionState
Definition: Initiator.h:150
FIX::Initiator::doConnect
virtual void doConnect(const SessionID &, const Dictionary &)=0
Implemented to connect a session to its target.
Exceptions.h
FIX::Initiator::SessionState
std::map< SessionID, int > SessionState
Definition: Initiator.h:142
FIX::LogFactory
This interface must be implemented to create a Log.
Definition: Log.h:59
FIX::Initiator::m_pending
SessionIDs m_pending
Definition: Initiator.h:147
FIX::Initiator::startThread
static THREAD_PROC startThread(void *p)
Definition: Initiator.cpp:306
FIX::Initiator::isStopped
bool isStopped()
Definition: Initiator.h:100
FIX::Initiator::m_connected
SessionIDs m_connected
Definition: Initiator.h:148
FIX::Log
This interface must be implemented to log messages and events.
Definition: Log.h:98
FIX::Initiator::block
void block()
Block on the initiator.
Definition: Initiator.cpp:220
Log.h
MessageStore.h
FIX::Initiator::onConfigure
virtual void onConfigure(const SessionSettings &)
Implemented to configure acceptor.
Definition: Initiator.h:127
FIX::Initiator::isConnected
bool isConnected(const SessionID &)
Definition: Initiator.cpp:195

Generated on Wed Apr 29 2020 19:41:30 for QuickFIX by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2001