60 lines
5.3 KiB
HTML
60 lines
5.3 KiB
HTML
<!-- HTML header for doxygen 1.8.7-->
|
|
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
|
<meta name="generator" content="Doxygen 1.8.11"/>
|
|
<title>OnixS ICE iMpact Multicast Feed Handler for C++: Error handling and recovering</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
<link href="onixs-doxygen.css" rel="stylesheet" type="text/css"/>
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<header>
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr style="height: 56px;">
|
|
<td id="projectlogo"><a href="http://www.onixs.biz"><img alt="Logo" src="onixs.gif"/></a></td>
|
|
<td style="padding-left: 0.5em;">
|
|
<div id="projectname">OnixS ICE iMpact Multicast Feed Handler for C++
|
|
 <span id="projectnumber">3.13.0.0</span>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</header>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.8.11 -->
|
|
<div id="navrow1" class="tabs">
|
|
<ul class="tablist">
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li class="current"><a href="modules.html"><span>Modules</span></a></li>
|
|
<li><a href="annotated.html"><span>Classes</span></a></li>
|
|
</ul>
|
|
</div>
|
|
</div><!-- top -->
|
|
<div class="header">
|
|
<div class="headertitle">
|
|
<div class="title">Error handling and recovering<div class="ingroups"><a class="el" href="group__getting_started.html">Getting Started</a></div></div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
<h1><a class="anchor" id="errorHandlingConcept"></a>
|
|
Error handling concept</h1>
|
|
<p>Being C++ class library, the Handler uses exceptions to report about error occurred while performing certain action. For example, the Handler will raise regular exception to report about inability to connect to the Multicast Price Feed server or about failure in logon procedure. However, once subscribing to market data is succeeded, the Handler is not able to report about any further errors since it performs all handling asynchronously on a background. For this reason, the Handler exposes <a class="el" href="class_onix_s_1_1_i_c_e_1_1i_mpact_1_1_market_data_1_1_error_listener.html" title="Defines the interface through which the Handler notifies subscribers about errors occurred while proc...">OnixS::ICE::iMpact::MarketData::ErrorListener</a> interface and <a class="el" href="class_onix_s_1_1_i_c_e_1_1i_mpact_1_1_market_data_1_1_handler.html#a43efed399a2fe3ffe2e3e4b6f0c9f5a4" title="Registers the error listener. ">OnixS::ICE::iMpact::MarketData::Handler::registerErrorListener</a> member to be able to subscribe to and handle errors.</p>
|
|
<p>Once instance of <a class="el" href="class_onix_s_1_1_i_c_e_1_1i_mpact_1_1_market_data_1_1_error_listener.html" title="Defines the interface through which the Handler notifies subscribers about errors occurred while proc...">OnixS::ICE::iMpact::MarketData::ErrorListener</a> is assigned to the Handler, it will invoke <a class="el" href="class_onix_s_1_1_i_c_e_1_1i_mpact_1_1_market_data_1_1_error_listener.html#a1aa04cecceadb67e9d7536b46f44b07c" title="Implement this member to get notified about errors in subscriptions. ">OnixS::ICE::iMpact::MarketData::ErrorListener::onError</a> member each time error occurs. <a class="el" href="class_onix_s_1_1_i_c_e_1_1i_mpact_1_1_market_data_1_1_error_listener.html#a1aa04cecceadb67e9d7536b46f44b07c" title="Implement this member to get notified about errors in subscriptions. ">OnixS::ICE::iMpact::MarketData::ErrorListener::onError</a> member has couple of input parameters which define code (identifier) of error and human-readable explanation or description of the error. <a class="el" href="struct_onix_s_1_1_i_c_e_1_1i_mpact_1_1_market_data_1_1_known_errors.html" title="List of known errors. ">OnixS::ICE::iMpact::MarketData::KnownErrors</a> type contains constants and descriptions for the errors which may occur while processing market data from Multicast Price Feed.</p>
|
|
<p>An important aspect of the Handler's behaviour is that in usual case there's nothing special to be done to handle errors. In particular, once subscription for market data successfully started, Handler will process incoming market data and handle all failures by itself without any necessity in additional actions. That means, there's no need to restart subscription for market data manually, Handler will do everything by himself. Also, Handler perform recovering from errors in optimal way. For example, in case of network-related issues, Handler will rebuild only those books and market states which are based on market data from problematic Multicast Price Feed channel. It will not invalidate and rebuild entire subscription.</p>
|
|
<p>See <a class="el" href="group__event_listeners.html">Listening to Handler's events</a> topic for more information concerning how to subscribe to a particular event. </p>
|
|
</div><!-- contents -->
|
|
</ul>
|
|
<hr class="footer"/><address class="footer"><small>© <a href="http://www.onixs.biz">Onix Solutions [OnixS]</a>. All rights reserved.</small></address>
|
|
</div>
|
|
</body>
|
|
</html>
|