mtapi.be.mt4net 4.1440.0

Flowchart: Connecting via host and port, and handling server command queue

[Start]
   |
   V
[QuoteConnector.Run(msTimeout, host, port)]
   |
   |-> Validate host (no local IP if disallowed)
   |
   V
[Is already connected?]
   | Yes
   +--> [Return (Already connected)]
   |
   | No
   V
[Start ConnectThread]
   |
   V
[ConnectThread.ConnectToAccount()]
   |
   V
[Connection.ConnectAndLogin()]
   |
   V
[Open Socket (Proxy or Direct)]
   |
   V
[LoginServer()]
   |
   +--> [Send Login Request]
   +--> [Process Server Authentication (Keys, hashes)]
   +--> [Login Identification]
   +--> [Terminal Identification]
   |
   V
[Connection Established]
   |
   V
[LoadAccount()]
   |
   +--> If DataCenter = false:
   |      - ReceiveServersList()
   |      - Load & save server list
   |      - Receive Symbols
   |      - Receive Groups
   |      - Receive Mail History
   |      - Receive Orders History
   |      - Create Transaction Keys
   |
   +--> ReceiveAccount()
   +--> Load Account Details
   +--> UpdateSymbolsMargin()
   +--> Read & Update Orders
   |
   V
[Start QuoteCmdHandler]
   |
   V
[QuoteCmdHandler.run() Loop]
   |
   +--> Periodically send Ping()
   |
   +--> Wait for commands from server:
         |
         +--> 0x97: Update Quotes
         |
         +--> 0x98: Receive News
         |
         +--> 0x99: Receive Mail
         |
         +--> 0x9A: Symbol Updates (Disconnect if required)
         |
         +--> 0x9B: Orders Update
         |
         +--> 0x9C: Historical Quotes
         |
         +--> 0x9D: News Update Notification
         |
         +--> 0xAB: ConGroup Update (Margin & Symbols recalculation)
         |
         +--> 0xBE/0xD1: Order Notifications
         |
         +--> 0x0D: Server-Initiated Disconnect
         |
         +--> 0x02: Server Ping
         |
         +--> Default: Unknown command (Raise exception, disconnect)
   |
   V
[Client-side Disconnect Requested or Exception Occurs]
   |
   V
[Close Connection & Stop Threads]
   |
   V
[End]

Flow chart: Connection by server name

|
V
[QuoteClient.Connect()]
|
V
[Check if already connected?]
|
+-- Yes --> [Already Connected, End]
|
No
|
V
[Is Host specified?]
|
+-- Yes --> [QuoteConnector.Run(ConnectTimeout, Host, Port)]
|            |
|            +--> [Connection Successful?] -- Yes --> [Proceed to ConnectThread]
|                       |
|                       No (Store Exception, proceed)
|
No
|
V
[Is ServerName specified?]
|
+-- No --> [Exception: "Host or ServerName not set"]
|
Yes
|
V
[Broker.SearchHistory has recent entry? (within 4 hrs)]
|
+-- Yes --> [Use cached brokers]
|
No
|
V
[Broker.SearchAsync(ServerName)]
|
+--> [Successful within 10s?] -- Yes --> [Cache brokers & proceed]
|            |
|            No
|            |
|            V
|      [Broker.SearchMQ(ServerName)]
|            |
|            +--> [Success?] -- Yes --> [Cache brokers & proceed]
|                    |
|                    No
|                    |
|                    V
|      [Exception: "Server not found"]
|
V
[Iterate through retrieved Brokers & Addresses]
|
V
[Attempt QuoteConnector.Run() for each address]
|
+--> [Success?] -- Yes --> [Connected]
|        |
|        No (store exceptions)
|
V
[All addresses failed?]
|
+--> [Check if Try Cluster Members is allowed (Exception code?)]
|
+--> [Yes, Load LatestSrv cluster members]
|        |
|        V
| [Iterate servers and attempt QuoteConnector.Run()]
|        |
|        +--> [Success?] -- Yes --> [Connected]
|                |
|                No (store exception)
|
+--> [No or All failed]
|
V
[Still Not Connected?]
|
+--> [Throw Stored Exception / ConnectException]