doc/www/doxygen/html/m__desktop_8cc-source.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
   3 <title>Barry: m_desktop.cc Source File</title>
   4 <link href="doxygen.css" rel="stylesheet" type="text/css">
   5 <link href="tabs.css" rel="stylesheet" type="text/css">
   6 </head><body>
   7 <!-- Generated by Doxygen 1.5.6 -->
   8 <div class="navigation" id="top">
   9   <div class="tabs">
  10     <ul>
  11       <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
  12       <li><a href="modules.html"><span>Modules</span></a></li>
  13       <li><a href="namespaces.html"><span>Namespaces</span></a></li>
  14       <li><a href="classes.html"><span>Classes</span></a></li>
  15       <li class="current"><a href="files.html"><span>Files</span></a></li>
  16       <li><a href="dirs.html"><span>Directories</span></a></li>
  17     </ul>
  18   </div>
  19   <div class="navpath"><a class="el" href="dir_edc0f428e3eefcfdce9c25befd901c57.html">src</a>
  20   </div>
  21 </div>
  22 <div class="contents">
  23 <h1>m_desktop.cc</h1><a href="m__desktop_8cc.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">///</span>
  24 <a name="l00002"></a>00002 <span class="comment"></span><span class="comment">/// \file       m_desktop.cc</span>
  25 <a name="l00003"></a>00003 <span class="comment"></span><span class="comment">///             Mode class for the Desktop mode</span>
  26 <a name="l00004"></a>00004 <span class="comment"></span><span class="comment">///</span>
  27 <a name="l00005"></a>00005 <span class="comment"></span>
  28 <a name="l00006"></a>00006 <span class="comment">/*</span>
  29 <a name="l00007"></a>00007 <span class="comment">    Copyright (C) 2005-2011, Net Direct Inc. (http://www.netdirect.ca/)</span>
  30 <a name="l00008"></a>00008 <span class="comment"></span>
  31 <a name="l00009"></a>00009 <span class="comment">    This program is free software; you can redistribute it and/or modify</span>
  32 <a name="l00010"></a>00010 <span class="comment">    it under the terms of the GNU General Public License as published by</span>
  33 <a name="l00011"></a>00011 <span class="comment">    the Free Software Foundation; either version 2 of the License, or</span>
  34 <a name="l00012"></a>00012 <span class="comment">    (at your option) any later version.</span>
  35 <a name="l00013"></a>00013 <span class="comment"></span>
  36 <a name="l00014"></a>00014 <span class="comment">    This program is distributed in the hope that it will be useful,</span>
  37 <a name="l00015"></a>00015 <span class="comment">    but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
  38 <a name="l00016"></a>00016 <span class="comment">    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</span>
  39 <a name="l00017"></a>00017 <span class="comment"></span>
  40 <a name="l00018"></a>00018 <span class="comment">    See the GNU General Public License in the COPYING file at the</span>
  41 <a name="l00019"></a>00019 <span class="comment">    root directory of this project for more details.</span>
  42 <a name="l00020"></a>00020 <span class="comment">*/</span>
  43 <a name="l00021"></a>00021
  44 <a name="l00022"></a>00022 <span class="preprocessor">#include "<a class="code" href="m__desktop_8h.html" title="Mode class for the Desktop mode.">m_desktop.h</a>"</span>
  45 <a name="l00023"></a>00023 <span class="preprocessor">#include "<a class="code" href="data_8h.html" title="Class to deal with pre-saved data files.">data.h</a>"</span>
  46 <a name="l00024"></a>00024 <span class="preprocessor">#include "<a class="code" href="protocol_8h.html" title="USB Blackberry bulk protocol API constants.">protocol.h</a>"</span>
  47 <a name="l00025"></a>00025 <span class="preprocessor">#include "<a class="code" href="protostructs_8h.html" title="USB Blackberry bulk protocol API.">protostructs.h</a>"</span>
  48 <a name="l00026"></a>00026 <span class="preprocessor">#include "<a class="code" href="packet_8h.html" title="Low level protocol packet builder class.">packet.h</a>"</span>
  49 <a name="l00027"></a>00027 <span class="preprocessor">#include "<a class="code" href="endian_8h.html" title="Endian conversion macros.">endian.h</a>"</span>
  50 <a name="l00028"></a>00028 <span class="preprocessor">#include "<a class="code" href="error_8h.html" title="Common exception classes for the Barry library.">error.h</a>"</span>
  51 <a name="l00029"></a>00029 <span class="preprocessor">#include "<a class="code" href="usbwrap_8h.html" title="USB API wrapper.">usbwrap.h</a>"</span>
  52 <a name="l00030"></a>00030 <span class="preprocessor">#include "<a class="code" href="controller_8h.html" title="High level BlackBerry API class.">controller.h</a>"</span>
  53 <a name="l00031"></a>00031 <span class="preprocessor">#include "<a class="code" href="parser_8h.html" title="Virtual parser wrapper.">parser.h</a>"</span>
  54 <a name="l00032"></a>00032 <span class="preprocessor">#include &lt;stdexcept&gt;</span>
  55 <a name="l00033"></a>00033 <span class="preprocessor">#include &lt;sstream&gt;</span>
  56 <a name="l00034"></a>00034
  57 <a name="l00035"></a>00035 <span class="preprocessor">#include "debug.h"</span>
  58 <a name="l00036"></a>00036
  59 <a name="l00037"></a>00037 <span class="keyword">namespace </span>Barry { <span class="keyword">namespace </span>Mode {
  60 <a name="l00038"></a>00038
  61 <a name="l00039"></a>00039 <span class="comment"></span>
  62 <a name="l00040"></a>00040 <span class="comment">///////////////////////////////////////////////////////////////////////////////</span>
  63 <a name="l00041"></a>00041 <span class="comment"></span><span class="comment">// Desktop Mode class</span>
  64 <a name="l00042"></a>00042
  65 <a name="l00043"></a>00043 Desktop::Desktop(Controller &amp;con)
  66 <a name="l00044"></a>00044         : Mode(con, Controller::Desktop)
  67 <a name="l00045"></a>00045         , m_ic(0)
  68 <a name="l00046"></a>00046 {
  69 <a name="l00047"></a>00047 }
  70 <a name="l00048"></a>00048
  71 <a name="l00049"></a>00049 Desktop::Desktop(Controller &amp;con, <span class="keyword">const</span> IConverter &amp;ic)
  72 <a name="l00050"></a>00050         : Mode(con, Controller::Desktop)
  73 <a name="l00051"></a>00051         , m_ic(&amp;ic)
  74 <a name="l00052"></a>00052 {
  75 <a name="l00053"></a>00053 }
  76 <a name="l00054"></a>00054
  77 <a name="l00055"></a>00055 Desktop::~Desktop()
  78 <a name="l00056"></a>00056 {
  79 <a name="l00057"></a>00057 }
  80 <a name="l00058"></a>00058 <span class="comment"></span>
  81 <a name="l00059"></a>00059 <span class="comment">///////////////////////////////////////////////////////////////////////////////</span>
  82 <a name="l00060"></a>00060 <span class="comment"></span><span class="comment">// protected members</span>
  83 <a name="l00061"></a>00061
  84 <a name="l00062"></a>00062 <span class="keywordtype">void</span> Desktop::LoadCommandTable()
  85 <a name="l00063"></a>00063 {
  86 <a name="l00064"></a>00064         <span class="keywordtype">char</span> rawCommand[] = { 6, 0, 0x0a, 0, 0x40, 0, 0, 1, 0, 0 };
  87 <a name="l00065"></a>00065         *((uint16_t*) rawCommand) = htobs(m_socket-&gt;GetSocket());
  88 <a name="l00066"></a>00066
  89 <a name="l00067"></a>00067         Data command(rawCommand, <span class="keyword">sizeof</span>(rawCommand));
  90 <a name="l00068"></a>00068
  91 <a name="l00069"></a>00069         <span class="keywordflow">try</span> {
  92 <a name="l00070"></a>00070                 m_socket-&gt;Packet(command, m_response);
  93 <a name="l00071"></a>00071
  94 <a name="l00072"></a>00072                 MAKE_PACKET(rpack, m_response);
  95 <a name="l00073"></a>00073                 <span class="keywordflow">while</span>( rpack-&gt;command != SB_COMMAND_DB_DONE ) {
  96 <a name="l00074"></a>00074                         m_socket-&gt;NextRecord(m_response);
  97 <a name="l00075"></a>00075
  98 <a name="l00076"></a>00076                         rpack = (<span class="keyword">const</span> Protocol::Packet *) m_response.GetData();
  99 <a name="l00077"></a>00077                         <span class="keywordflow">if</span>( rpack-&gt;command == SB_COMMAND_DB_DATA &amp;&amp; btohs(rpack-&gt;size) &gt; 10 ) {
 100 <a name="l00078"></a>00078                                 <span class="comment">// second packet is generally large, and contains</span>
 101 <a name="l00079"></a>00079                                 <span class="comment">// the command table</span>
 102 <a name="l00080"></a>00080                                 m_commandTable.Clear();
 103 <a name="l00081"></a>00081                                 m_commandTable.Parse(m_response, 6);
 104 <a name="l00082"></a>00082                         }
 105 <a name="l00083"></a>00083                 }
 106 <a name="l00084"></a>00084
 107 <a name="l00085"></a>00085                 ddout(m_commandTable);
 108 <a name="l00086"></a>00086
 109 <a name="l00087"></a>00087         }
 110 <a name="l00088"></a>00088         <span class="keywordflow">catch</span>( <a class="code" href="classUsb_1_1Error.html" title="Thrown on low level USB errors.">Usb::Error</a> &amp; ) {
 111 <a name="l00089"></a>00089                 eout(<span class="stringliteral">"Desktop: error getting command table"</span>);
 112 <a name="l00090"></a>00090                 eeout(command, m_response);
 113 <a name="l00091"></a>00091                 <span class="keywordflow">throw</span>;
 114 <a name="l00092"></a>00092         }
 115 <a name="l00093"></a>00093 }
 116 <a name="l00094"></a>00094
 117 <a name="l00095"></a>00095 <span class="keywordtype">void</span> Desktop::LoadDBDB()
 118 <a name="l00096"></a>00096 {
 119 <a name="l00097"></a>00097         DBPacket packet(*<span class="keyword">this</span>, m_command, m_response);
 120 <a name="l00098"></a>00098         packet.GetDBDB();
 121 <a name="l00099"></a>00099
 122 <a name="l00100"></a>00100         m_socket-&gt;Packet(packet);
 123 <a name="l00101"></a>00101
 124 <a name="l00102"></a>00102         <span class="keywordflow">while</span>( packet.Command() != SB_COMMAND_DB_DONE ) {
 125 <a name="l00103"></a>00103                 <span class="keywordflow">if</span>( packet.Command() == SB_COMMAND_DB_DATA ) {
 126 <a name="l00104"></a>00104                         m_dbdb.Clear();
 127 <a name="l00105"></a>00105                         m_dbdb.Parse(m_response);
 128 <a name="l00106"></a>00106                 }
 129 <a name="l00107"></a>00107
 130 <a name="l00108"></a>00108                 <span class="comment">// advance!</span>
 131 <a name="l00109"></a>00109                 m_socket-&gt;NextRecord(m_response);
 132 <a name="l00110"></a>00110         }
 133 <a name="l00111"></a>00111 }
 134 <a name="l00112"></a>00112
 135 <a name="l00113"></a>00113 <span class="keywordtype">void</span> Desktop::OnOpen()
 136 <a name="l00114"></a>00114 {
 137 <a name="l00115"></a>00115         <span class="comment">// get command table and database database</span>
 138 <a name="l00116"></a>00116         LoadCommandTable();
 139 <a name="l00117"></a>00117         LoadDBDB();
 140 <a name="l00118"></a>00118 }
 141 <a name="l00119"></a>00119 <span class="comment"></span>
 142 <a name="l00120"></a>00120 <span class="comment">///////////////////////////////////////////////////////////////////////////////</span>
 143 <a name="l00121"></a>00121 <span class="comment"></span><span class="comment">// public API</span>
 144 <a name="l00122"></a>00122
 145 <a name="l00123"></a>00123 <span class="comment">//</span>
 146 <a name="l00124"></a>00124 <span class="comment">// GetDBID</span>
 147 <a name="l00125"></a>00125 <span class="comment">//</span><span class="comment"></span>
 148 <a name="l00126"></a>00126 <span class="comment">/// Get numeric database ID by name.</span>
 149 <a name="l00127"></a>00127 <span class="comment">///</span>
 150 <a name="l00128"></a>00128 <span class="comment">/// \param[in]  name            Name of database, which matches one of the</span>
 151 <a name="l00129"></a>00129 <span class="comment">///                             names listed in GetDBDB()</span>
 152 <a name="l00130"></a>00130 <span class="comment">///</span>
 153 <a name="l00131"></a>00131 <span class="comment">/// \exception  Barry::Error</span>
 154 <a name="l00132"></a>00132 <span class="comment">///             Thrown if name not found.</span>
 155 <a name="l00133"></a>00133 <span class="comment">///</span>
 156 <a name="l00134"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#4e1dad976351ad48029dc80d5f05fae3">00134</a> <span class="comment"></span><span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> Desktop::GetDBID(<span class="keyword">const</span> std::string &amp;name)<span class="keyword"> const</span>
 157 <a name="l00135"></a>00135 <span class="keyword"></span>{
 158 <a name="l00136"></a>00136         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> ID = 0;
 159 <a name="l00137"></a>00137         <span class="comment">// FIXME - this needs a better error handler...</span>
 160 <a name="l00138"></a>00138         <span class="keywordflow">if</span>( !m_dbdb.GetDBNumber(name, ID) ) {
 161 <a name="l00139"></a>00139                 <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(<span class="stringliteral">"Desktop: database name not found: "</span> + name);
 162 <a name="l00140"></a>00140         }
 163 <a name="l00141"></a>00141         <span class="keywordflow">return</span> ID;
 164 <a name="l00142"></a>00142 }
 165 <a name="l00143"></a>00143
 166 <a name="l00144"></a>00144 <span class="comment">//</span>
 167 <a name="l00145"></a>00145 <span class="comment">// GetDBCommand</span>
 168 <a name="l00146"></a>00146 <span class="comment">//</span><span class="comment"></span>
 169 <a name="l00147"></a>00147 <span class="comment">/// Get database command from command table.  Must call Open()</span>
 170 <a name="l00148"></a>00148 <span class="comment">/// before this.</span>
 171 <a name="l00149"></a>00149 <span class="comment">///</span>
 172 <a name="l00150"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#b1d7a169122aae509924729aedfeb24f">00150</a> <span class="comment"></span><span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classBarry_1_1Mode_1_1Desktop.html#b1d7a169122aae509924729aedfeb24f" title="Get database command from command table.">Desktop::GetDBCommand</a>(CommandType ct)
 173 <a name="l00151"></a>00151 {
 174 <a name="l00152"></a>00152         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> cmd = 0;
 175 <a name="l00153"></a>00153         <span class="keyword">const</span> <span class="keywordtype">char</span> *cmdName = <span class="stringliteral">"Unknown"</span>;
 176 <a name="l00154"></a>00154
 177 <a name="l00155"></a>00155         <span class="keywordflow">switch</span>( ct )
 178 <a name="l00156"></a>00156         {
 179 <a name="l00157"></a>00157         <span class="keywordflow">case</span> DatabaseAccess:
 180 <a name="l00158"></a>00158                 cmdName = <span class="stringliteral">"Database Access"</span>;
 181 <a name="l00159"></a>00159                 cmd = m_commandTable.GetCommand(cmdName);
 182 <a name="l00160"></a>00160                 <span class="keywordflow">break</span>;
 183 <a name="l00161"></a>00161         <span class="keywordflow">default</span>:
 184 <a name="l00162"></a>00162                 <span class="keywordflow">throw</span> std::logic_error(<span class="stringliteral">"Desktop: unknown command type"</span>);
 185 <a name="l00163"></a>00163         }
 186 <a name="l00164"></a>00164
 187 <a name="l00165"></a>00165         <span class="keywordflow">if</span>( cmd == 0 ) {
 188 <a name="l00166"></a>00166                 std::ostringstream oss;
 189 <a name="l00167"></a>00167                 oss &lt;&lt; <span class="stringliteral">"Desktop: unable to get command code: "</span> &lt;&lt; cmdName;
 190 <a name="l00168"></a>00168                 <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(oss.str());
 191 <a name="l00169"></a>00169         }
 192 <a name="l00170"></a>00170
 193 <a name="l00171"></a>00171         <span class="keywordflow">return</span> cmd;
 194 <a name="l00172"></a>00172 }
 195 <a name="l00173"></a>00173
 196 <a name="l00174"></a>00174 <span class="keywordtype">void</span> Desktop::SetIConverter(<span class="keyword">const</span> <a class="code" href="classBarry_1_1IConverter.html" title="Main charset conversion class, primarily focused on converting between the Blackberry...">IConverter</a> &amp;ic)
 197 <a name="l00175"></a>00175 {
 198 <a name="l00176"></a>00176         m_ic = &amp;ic;
 199 <a name="l00177"></a>00177 }
 200 <a name="l00178"></a>00178
 201 <a name="l00179"></a>00179 <span class="comment">//</span>
 202 <a name="l00180"></a>00180 <span class="comment">// GetRecordStateTable</span>
 203 <a name="l00181"></a>00181 <span class="comment">//</span><span class="comment"></span>
 204 <a name="l00182"></a>00182 <span class="comment">/// Retrieve the record state table from the handheld device, using the given</span>
 205 <a name="l00183"></a>00183 <span class="comment">/// database ID.  Results will be stored in result, which will be cleared</span>
 206 <a name="l00184"></a>00184 <span class="comment">/// before adding.</span>
 207 <a name="l00185"></a>00185 <span class="comment">///</span>
 208 <a name="l00186"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#047fe0a4a6dff740822451ffd38ddd84">00186</a> <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="classBarry_1_1Mode_1_1Desktop.html#047fe0a4a6dff740822451ffd38ddd84" title="Retrieve the record state table from the handheld device, using the given database...">Desktop::GetRecordStateTable</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId, RecordStateTable &amp;result)
 209 <a name="l00187"></a>00187 {
 210 <a name="l00188"></a>00188         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 211 <a name="l00189"></a>00189
 212 <a name="l00190"></a>00190         <span class="comment">// start fresh</span>
 213 <a name="l00191"></a>00191         result.Clear();
 214 <a name="l00192"></a>00192
 215 <a name="l00193"></a>00193         <a class="code" href="classBarry_1_1DBPacket.html" title="Provides an API for building and analyzing raw DB protocol packets.">DBPacket</a> packet(*<span class="keyword">this</span>, m_command, m_response);
 216 <a name="l00194"></a>00194         packet.<a class="code" href="classBarry_1_1DBPacket.html#07e2e8ca566a1f4d7cc493983b56c32b" title="Builds a command packet in the send buffer for the GET_RECORD_STATE_TABLE command...">GetRecordStateTable</a>(dbId);
 217 <a name="l00195"></a>00195
 218 <a name="l00196"></a>00196         m_socket-&gt;Packet(packet);
 219 <a name="l00197"></a>00197         result.Parse(m_response);
 220 <a name="l00198"></a>00198
 221 <a name="l00199"></a>00199         <span class="comment">// flush the command sequence</span>
 222 <a name="l00200"></a>00200         <span class="keywordflow">while</span>( packet.Command() != SB_COMMAND_DB_DONE )
 223 <a name="l00201"></a>00201                 m_socket-&gt;NextRecord(m_response);
 224 <a name="l00202"></a>00202 }
 225 <a name="l00203"></a>00203
 226 <a name="l00204"></a>00204 <span class="comment">//</span>
 227 <a name="l00205"></a>00205 <span class="comment">// AddRecord</span>
 228 <a name="l00206"></a>00206 <span class="comment">//</span><span class="comment"></span>
 229 <a name="l00207"></a>00207 <span class="comment">/// Adds a record to the specified database.  RecordId is</span>
 230 <a name="l00208"></a>00208 <span class="comment">/// retrieved from build, and duplicate IDs are allowed by the device</span>
 231 <a name="l00209"></a>00209 <span class="comment">/// (i.e. you can have two records with the same ID)</span>
 232 <a name="l00210"></a>00210 <span class="comment">/// but *not* recommended!</span>
 233 <a name="l00211"></a>00211 <span class="comment"></span><span class="comment">//</span>
 234 <a name="l00212"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#0fec0d31ff496974acfc15fdc75f074a">00212</a> <span class="keywordtype">void</span> <a class="code" href="classBarry_1_1Mode_1_1Desktop.html#0fec0d31ff496974acfc15fdc75f074a" title="Adds a record to the specified database.">Desktop::AddRecord</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId, <a class="code" href="classBarry_1_1Builder.html" title="Base class for the builder functor hierarchy.">Builder</a> &amp;build)
 235 <a name="l00213"></a>00213 {
 236 <a name="l00214"></a>00214         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 237 <a name="l00215"></a>00215
 238 <a name="l00216"></a>00216         <a class="code" href="classBarry_1_1DBPacket.html" title="Provides an API for building and analyzing raw DB protocol packets.">DBPacket</a> packet(*<span class="keyword">this</span>, m_command, m_response);
 239 <a name="l00217"></a>00217
 240 <a name="l00218"></a>00218         <span class="keywordflow">if</span>( packet.<a class="code" href="classBarry_1_1DBPacket.html#26c4025403d129f658c1919190c0a0f0" title="Builds a command packet in the m_send buffer for the SET_RECORD command code.">SetRecord</a>(dbId, build, m_ic) ) {
 241 <a name="l00219"></a>00219
 242 <a name="l00220"></a>00220                 std::ostringstream oss;
 243 <a name="l00221"></a>00221
 244 <a name="l00222"></a>00222                 m_socket-&gt;Packet(packet);
 245 <a name="l00223"></a>00223
 246 <a name="l00224"></a>00224                 <span class="comment">// successful packet transfer, so check the network return code</span>
 247 <a name="l00225"></a>00225                 <span class="keywordflow">if</span>( packet.Command() != SB_COMMAND_DB_DONE ) {
 248 <a name="l00226"></a>00226                         oss &lt;&lt; <span class="stringliteral">"Desktop: device responded with unexpected packet command code: "</span>
 249 <a name="l00227"></a>00227                             &lt;&lt; <span class="stringliteral">"0x"</span> &lt;&lt; std::hex &lt;&lt; packet.Command();
 250 <a name="l00228"></a>00228                         <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(oss.str());
 251 <a name="l00229"></a>00229                 }
 252 <a name="l00230"></a>00230
 253 <a name="l00231"></a>00231                 <span class="keywordflow">if</span>( packet.<a class="code" href="classBarry_1_1DBPacket.html#580e45267843fc6d43ca13c009e98978">ReturnCode</a>() != 0 ) {
 254 <a name="l00232"></a>00232                         oss &lt;&lt; <span class="stringliteral">"Desktop: device responded with error code (command: "</span>
 255 <a name="l00233"></a>00233                             &lt;&lt; packet.Command() &lt;&lt; <span class="stringliteral">", code: "</span>
 256 <a name="l00234"></a>00234                             &lt;&lt; packet.<a class="code" href="classBarry_1_1DBPacket.html#580e45267843fc6d43ca13c009e98978">ReturnCode</a>() &lt;&lt; <span class="stringliteral">")"</span>;
 257 <a name="l00235"></a>00235                         <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(oss.str());
 258 <a name="l00236"></a>00236                 }
 259 <a name="l00237"></a>00237         }
 260 <a name="l00238"></a>00238 }
 261 <a name="l00239"></a>00239
 262 <a name="l00240"></a>00240 <span class="comment">//</span>
 263 <a name="l00241"></a>00241 <span class="comment">// GetRecord</span>
 264 <a name="l00242"></a>00242 <span class="comment">//</span><span class="comment"></span>
 265 <a name="l00243"></a>00243 <span class="comment">/// Retrieves a specific record from the specified database.</span>
 266 <a name="l00244"></a>00244 <span class="comment">/// The stateTableIndex comes from the GetRecordStateTable()</span>
 267 <a name="l00245"></a>00245 <span class="comment">/// function.  GetRecord() does not clear the dirty flag.</span>
 268 <a name="l00246"></a>00246 <span class="comment">///</span>
 269 <a name="l00247"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#2420208d094c0195dd41b5836f54dc10">00247</a> <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="classBarry_1_1Mode_1_1Desktop.html#2420208d094c0195dd41b5836f54dc10" title="Retrieves a specific record from the specified database.">Desktop::GetRecord</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId,
 270 <a name="l00248"></a>00248                            <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> stateTableIndex,
 271 <a name="l00249"></a>00249                            <a class="code" href="classBarry_1_1Parser.html" title="Base class for the parser hierarchy.">Parser</a> &amp;parser)
 272 <a name="l00250"></a>00250 {
 273 <a name="l00251"></a>00251         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 274 <a name="l00252"></a>00252
 275 <a name="l00253"></a>00253         std::string dbName;
 276 <a name="l00254"></a>00254         m_dbdb.GetDBName(dbId, dbName);
 277 <a name="l00255"></a>00255
 278 <a name="l00256"></a>00256         <a class="code" href="classBarry_1_1DBPacket.html" title="Provides an API for building and analyzing raw DB protocol packets.">DBPacket</a> packet(*<span class="keyword">this</span>, m_command, m_response);
 279 <a name="l00257"></a>00257         packet.<a class="code" href="classBarry_1_1DBPacket.html#95355f6de0ab12e9eacd0727e8a66965" title="Builds a command packet in the send buffer for the GET_RECORD_BY_INDEX command code...">GetRecordByIndex</a>(dbId, stateTableIndex);
 280 <a name="l00258"></a>00258
 281 <a name="l00259"></a>00259         m_socket-&gt;Packet(packet);
 282 <a name="l00260"></a>00260
 283 <a name="l00261"></a>00261         <span class="comment">// perform copious packet checks</span>
 284 <a name="l00262"></a>00262         <span class="keywordflow">if</span>( m_response.GetSize() &lt; SB_PACKET_RESPONSE_HEADER_SIZE ) {
 285 <a name="l00263"></a>00263                 eeout(m_command, m_response);
 286 <a name="l00264"></a>00264
 287 <a name="l00265"></a>00265                 std::ostringstream oss;
 288 <a name="l00266"></a>00266                 oss &lt;&lt; <span class="stringliteral">"Desktop: invalid response packet size of "</span>
 289 <a name="l00267"></a>00267                     &lt;&lt; std::dec &lt;&lt; m_response.GetSize();
 290 <a name="l00268"></a>00268                 eout(oss.str());
 291 <a name="l00269"></a>00269                 <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(oss.str());
 292 <a name="l00270"></a>00270         }
 293 <a name="l00271"></a>00271         <span class="keywordflow">if</span>( packet.Command() != SB_COMMAND_DB_DATA ) {
 294 <a name="l00272"></a>00272                 eeout(m_command, m_response);
 295 <a name="l00273"></a>00273
 296 <a name="l00274"></a>00274                 std::ostringstream oss;
 297 <a name="l00275"></a>00275                 oss &lt;&lt; <span class="stringliteral">"Desktop: unexpected command of 0x"</span>
 298 <a name="l00276"></a>00276                     &lt;&lt; std::setbase(16) &lt;&lt; packet.Command()
 299 <a name="l00277"></a>00277                     &lt;&lt; <span class="stringliteral">" instead of expected 0x"</span>
 300 <a name="l00278"></a>00278                     &lt;&lt; std::setbase(16) &lt;&lt; (<span class="keywordtype">unsigned</span> int)SB_COMMAND_DB_DATA;
 301 <a name="l00279"></a>00279                 eout(oss.str());
 302 <a name="l00280"></a>00280                 <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(oss.str());
 303 <a name="l00281"></a>00281         }
 304 <a name="l00282"></a>00282
 305 <a name="l00283"></a>00283         <span class="comment">// grab that data</span>
 306 <a name="l00284"></a>00284         packet.<a class="code" href="classBarry_1_1DBPacket.html#fd64b6c98e7ad1d482a8339e0283ff90" title="Parses the data in the receive buffer, and attempts to be smart about it, using the...">Parse</a>(parser, dbName, m_ic);
 307 <a name="l00285"></a>00285
 308 <a name="l00286"></a>00286         <span class="comment">// flush the command sequence</span>
 309 <a name="l00287"></a>00287         <span class="keywordflow">while</span>( packet.Command() != SB_COMMAND_DB_DONE )
 310 <a name="l00288"></a>00288                 m_socket-&gt;NextRecord(m_response);
 311 <a name="l00289"></a>00289 }
 312 <a name="l00290"></a>00290
 313 <a name="l00291"></a>00291 <span class="comment">//</span>
 314 <a name="l00292"></a>00292 <span class="comment">// SetRecord</span>
 315 <a name="l00293"></a>00293 <span class="comment">//</span><span class="comment"></span>
 316 <a name="l00294"></a>00294 <span class="comment">/// Overwrites a specific record in the device as identified by the</span>
 317 <a name="l00295"></a>00295 <span class="comment">/// stateTableIndex.</span>
 318 <a name="l00296"></a>00296 <span class="comment">///</span>
 319 <a name="l00297"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#bf813b7fb04062515369209c8073dab0">00297</a> <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="classBarry_1_1Mode_1_1Desktop.html#bf813b7fb04062515369209c8073dab0" title="Overwrites a specific record in the device as identified by the stateTableIndex.">Desktop::SetRecord</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> stateTableIndex,
 320 <a name="l00298"></a>00298                            <a class="code" href="classBarry_1_1Builder.html" title="Base class for the builder functor hierarchy.">Builder</a> &amp;build)
 321 <a name="l00299"></a>00299 {
 322 <a name="l00300"></a>00300         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId &lt;&lt; <span class="stringliteral">" Index: "</span> &lt;&lt; stateTableIndex);
 323 <a name="l00301"></a>00301
 324 <a name="l00302"></a>00302         <a class="code" href="classBarry_1_1DBPacket.html" title="Provides an API for building and analyzing raw DB protocol packets.">DBPacket</a> packet(*<span class="keyword">this</span>, m_command, m_response);
 325 <a name="l00303"></a>00303
 326 <a name="l00304"></a>00304         <span class="comment">// write only if builder object has data</span>
 327 <a name="l00305"></a>00305         <span class="keywordflow">if</span>( !packet.<a class="code" href="classBarry_1_1DBPacket.html#7a41833dcc12c2823cd54991161e8d26" title="Builds a command packet in the m_send buffer for the SET_RECORD_BY_INDEX command...">SetRecordByIndex</a>(dbId, stateTableIndex, build, m_ic) ) {
 328 <a name="l00306"></a>00306                 <span class="keywordflow">throw</span> std::logic_error(<span class="stringliteral">"Desktop: no data available in SetRecord"</span>);
 329 <a name="l00307"></a>00307         }
 330 <a name="l00308"></a>00308
 331 <a name="l00309"></a>00309         m_socket-&gt;Packet(packet);
 332 <a name="l00310"></a>00310
 333 <a name="l00311"></a>00311         std::ostringstream oss;
 334 <a name="l00312"></a>00312
 335 <a name="l00313"></a>00313         <span class="comment">// successful packet transfer, so check the network return code</span>
 336 <a name="l00314"></a>00314         <span class="keywordflow">if</span>( packet.Command() != SB_COMMAND_DB_DONE ) {
 337 <a name="l00315"></a>00315                 oss &lt;&lt; <span class="stringliteral">"Desktop: device responded with unexpected packet command code: "</span>
 338 <a name="l00316"></a>00316                     &lt;&lt; <span class="stringliteral">"0x"</span> &lt;&lt; std::hex &lt;&lt; packet.Command();
 339 <a name="l00317"></a>00317                 <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(oss.str());
 340 <a name="l00318"></a>00318         }
 341 <a name="l00319"></a>00319
 342 <a name="l00320"></a>00320         <span class="keywordflow">if</span>( packet.<a class="code" href="classBarry_1_1DBPacket.html#580e45267843fc6d43ca13c009e98978">ReturnCode</a>() != 0 ) {
 343 <a name="l00321"></a>00321                 oss &lt;&lt; <span class="stringliteral">"Desktop: device responded with error code (command: "</span>
 344 <a name="l00322"></a>00322                     &lt;&lt; packet.Command() &lt;&lt; <span class="stringliteral">", code: "</span>
 345 <a name="l00323"></a>00323                     &lt;&lt; packet.<a class="code" href="classBarry_1_1DBPacket.html#580e45267843fc6d43ca13c009e98978">ReturnCode</a>() &lt;&lt; <span class="stringliteral">")"</span>;
 346 <a name="l00324"></a>00324                 <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(oss.str());
 347 <a name="l00325"></a>00325         }
 348 <a name="l00326"></a>00326 }
 349 <a name="l00327"></a>00327
 350 <a name="l00328"></a>00328 <span class="comment">//</span>
 351 <a name="l00329"></a>00329 <span class="comment">// ClearDirty</span>
 352 <a name="l00330"></a>00330 <span class="comment">//</span><span class="comment"></span>
 353 <a name="l00331"></a>00331 <span class="comment">/// Clears the dirty flag on the specified record in the specified database.</span>
 354 <a name="l00332"></a>00332 <span class="comment">///</span>
 355 <a name="l00333"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#a766fb027d28f7cf4bb069eb0991baaa">00333</a> <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="classBarry_1_1Mode_1_1Desktop.html#a766fb027d28f7cf4bb069eb0991baaa" title="Clears the dirty flag on the specified record in the specified database.">Desktop::ClearDirty</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> stateTableIndex)
 356 <a name="l00334"></a>00334 {
 357 <a name="l00335"></a>00335         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 358 <a name="l00336"></a>00336
 359 <a name="l00337"></a>00337         <a class="code" href="classBarry_1_1DBPacket.html" title="Provides an API for building and analyzing raw DB protocol packets.">DBPacket</a> packet(*<span class="keyword">this</span>, m_command, m_response);
 360 <a name="l00338"></a>00338         packet.<a class="code" href="classBarry_1_1DBPacket.html#9f0237393389b714f30bf56e616183dd" title="Builds a command packet in the send buffer for the SET_RECORD_FLAGS command code...">SetRecordFlags</a>(dbId, stateTableIndex, 0);
 361 <a name="l00339"></a>00339
 362 <a name="l00340"></a>00340         m_socket-&gt;Packet(packet);
 363 <a name="l00341"></a>00341
 364 <a name="l00342"></a>00342         <span class="comment">// flush the command sequence</span>
 365 <a name="l00343"></a>00343         <span class="keywordflow">while</span>( packet.Command() != SB_COMMAND_DB_DONE )
 366 <a name="l00344"></a>00344                 m_socket-&gt;NextRecord(m_response);
 367 <a name="l00345"></a>00345 }
 368 <a name="l00346"></a>00346
 369 <a name="l00347"></a>00347 <span class="comment">//</span>
 370 <a name="l00348"></a>00348 <span class="comment">// DeleteRecord</span>
 371 <a name="l00349"></a>00349 <span class="comment">//</span><span class="comment"></span>
 372 <a name="l00350"></a>00350 <span class="comment">/// Deletes the specified record in the specified database.</span>
 373 <a name="l00351"></a>00351 <span class="comment">///</span>
 374 <a name="l00352"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#04cd4063958483b31cc98a353f335fe0">00352</a> <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="classBarry_1_1Mode_1_1Desktop.html#04cd4063958483b31cc98a353f335fe0" title="Deletes the specified record in the specified database.">Desktop::DeleteRecord</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> stateTableIndex)
 375 <a name="l00353"></a>00353 {
 376 <a name="l00354"></a>00354         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 377 <a name="l00355"></a>00355
 378 <a name="l00356"></a>00356         <a class="code" href="classBarry_1_1DBPacket.html" title="Provides an API for building and analyzing raw DB protocol packets.">DBPacket</a> packet(*<span class="keyword">this</span>, m_command, m_response);
 379 <a name="l00357"></a>00357         packet.<a class="code" href="classBarry_1_1DBPacket.html#fb9625f072f936a03ebee1ac64b78bf4" title="Builds a command packet in the send buffer for the DELETE_RECORD_BY_INDEX command...">DeleteRecordByIndex</a>(dbId, stateTableIndex);
 380 <a name="l00358"></a>00358
 381 <a name="l00359"></a>00359         m_socket-&gt;Packet(packet);
 382 <a name="l00360"></a>00360
 383 <a name="l00361"></a>00361         <span class="comment">// flush the command sequence</span>
 384 <a name="l00362"></a>00362         <span class="keywordflow">while</span>( packet.Command() != SB_COMMAND_DB_DONE )
 385 <a name="l00363"></a>00363                 m_socket-&gt;NextRecord(m_response);
 386 <a name="l00364"></a>00364 }
 387 <a name="l00365"></a>00365
 388 <a name="l00366"></a>00366 <span class="comment">//</span>
 389 <a name="l00367"></a>00367 <span class="comment">// LoadDatabase</span>
 390 <a name="l00368"></a>00368 <span class="comment">//</span><span class="comment"></span>
 391 <a name="l00369"></a>00369 <span class="comment">/// Retrieve a database from the handheld device, using the given parser</span>
 392 <a name="l00370"></a>00370 <span class="comment">/// to parse the resulting data, and optionally store it.</span>
 393 <a name="l00371"></a>00371 <span class="comment">///</span>
 394 <a name="l00372"></a>00372 <span class="comment">/// See the RecordParser&lt;&gt; template to create a parser object.  The</span>
 395 <a name="l00373"></a>00373 <span class="comment">/// RecordParser&lt;&gt; template allows custom storage based on the type of</span>
 396 <a name="l00374"></a>00374 <span class="comment">/// database record retrieved.  The database ID and the parser Record</span>
 397 <a name="l00375"></a>00375 <span class="comment">/// type must match.</span>
 398 <a name="l00376"></a>00376 <span class="comment">///</span>
 399 <a name="l00377"></a>00377 <span class="comment">/// \param[in]  dbId            Database Database ID - use GetDBID()</span>
 400 <a name="l00378"></a>00378 <span class="comment">/// \param[out] parser          Parser object which parses the resulting</span>
 401 <a name="l00379"></a>00379 <span class="comment">///                             protocol data, and optionally stores it in</span>
 402 <a name="l00380"></a>00380 <span class="comment">///                             a custom fashion.  See the RecordParser&lt;&gt;</span>
 403 <a name="l00381"></a>00381 <span class="comment">///                             template.</span>
 404 <a name="l00382"></a>00382 <span class="comment">///</span>
 405 <a name="l00383"></a>00383 <span class="comment">/// \exception  Barry::Error</span>
 406 <a name="l00384"></a>00384 <span class="comment">///             Thrown on protocol error.</span>
 407 <a name="l00385"></a>00385 <span class="comment">///</span>
 408 <a name="l00386"></a>00386 <span class="comment">/// \exception  std::logic_error</span>
 409 <a name="l00387"></a>00387 <span class="comment">///             Thrown if not in Desktop mode.</span>
 410 <a name="l00388"></a>00388 <span class="comment">///</span>
 411 <a name="l00389"></a><a class="code" href="classBarry_1_1Mode_1_1Desktop.html#6bb1c96d6082575b5fa684dee2af51a6">00389</a> <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="classBarry_1_1Mode_1_1Desktop.html#6bb1c96d6082575b5fa684dee2af51a6" title="Retrieve a database from the handheld device, using the given parser to parse the...">Desktop::LoadDatabase</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId, <a class="code" href="classBarry_1_1Parser.html" title="Base class for the parser hierarchy.">Parser</a> &amp;parser)
 412 <a name="l00390"></a>00390 {
 413 <a name="l00391"></a>00391         <a class="code" href="classBarry_1_1DBData.html" title="Database record data class.">DBData</a> data;
 414 <a name="l00392"></a>00392         <a class="code" href="classBarry_1_1Mode_1_1DBLoader.html" title="Database Loader operation class.">DBLoader</a> loader(*<span class="keyword">this</span>);
 415 <a name="l00393"></a>00393         <span class="keywordtype">bool</span> loading = loader.<a class="code" href="classBarry_1_1Mode_1_1DBLoader.html#91865cdae00722a8c6fc53bcdf806a15">StartDBLoad</a>(dbId, data);
 416 <a name="l00394"></a>00394         <span class="keywordflow">while</span>( loading ) {
 417 <a name="l00395"></a>00395                 <span class="comment">// manual parser call</span>
 418 <a name="l00396"></a>00396                 parser.<a class="code" href="classBarry_1_1Parser.html#1d8325c74140cda51c5735c6f82b7511" title="Called to parse sub fields in the raw data packet.">ParseRecord</a>(data, m_ic);
 419 <a name="l00397"></a>00397
 420 <a name="l00398"></a>00398                 <span class="comment">// advance!</span>
 421 <a name="l00399"></a>00399                 loading = loader.<a class="code" href="classBarry_1_1Mode_1_1DBLoader.html#2f1152364ff8ea48e8735fe57fcaa15c">GetNextRecord</a>(data);
 422 <a name="l00400"></a>00400         }
 423 <a name="l00401"></a>00401 }
 424 <a name="l00402"></a>00402
 425 <a name="l00403"></a>00403 <span class="keywordtype">void</span> Desktop::ClearDatabase(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId)
 426 <a name="l00404"></a>00404 {
 427 <a name="l00405"></a>00405         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 428 <a name="l00406"></a>00406
 429 <a name="l00407"></a>00407         <a class="code" href="classBarry_1_1DBPacket.html" title="Provides an API for building and analyzing raw DB protocol packets.">DBPacket</a> packet(*<span class="keyword">this</span>, m_command, m_response);
 430 <a name="l00408"></a>00408         packet.ClearDatabase(dbId);
 431 <a name="l00409"></a>00409
 432 <a name="l00410"></a>00410         <span class="comment">// wait up to a minute here for old, slower devices with lots of data</span>
 433 <a name="l00411"></a>00411         m_socket-&gt;Packet(packet, 60000);
 434 <a name="l00412"></a>00412         <span class="keywordflow">if</span>( packet.ReturnCode() != 0 ) {
 435 <a name="l00413"></a>00413                 std::ostringstream oss;
 436 <a name="l00414"></a>00414                 oss &lt;&lt; <span class="stringliteral">"Desktop: could not clear database: (command: "</span>
 437 <a name="l00415"></a>00415                     &lt;&lt; <span class="stringliteral">"0x"</span> &lt;&lt; std::hex &lt;&lt; packet.Command() &lt;&lt; <span class="stringliteral">", code: "</span>
 438 <a name="l00416"></a>00416                     &lt;&lt; <span class="stringliteral">"0x"</span> &lt;&lt; std::hex &lt;&lt; packet.ReturnCode() &lt;&lt; <span class="stringliteral">")"</span>;
 439 <a name="l00417"></a>00417                 <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(oss.str());
 440 <a name="l00418"></a>00418         }
 441 <a name="l00419"></a>00419
 442 <a name="l00420"></a>00420         <span class="comment">// check response to clear command was successful</span>
 443 <a name="l00421"></a>00421         <span class="keywordflow">if</span>( packet.Command() != SB_COMMAND_DB_DONE ) {
 444 <a name="l00422"></a>00422                 eeout(m_command, m_response);
 445 <a name="l00423"></a>00423                 <span class="keywordflow">throw</span> <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Error</a>(<span class="stringliteral">"Desktop: error clearing database, bad response"</span>);
 446 <a name="l00424"></a>00424         }
 447 <a name="l00425"></a>00425 }
 448 <a name="l00426"></a>00426
 449 <a name="l00427"></a>00427 <span class="keywordtype">void</span> Desktop::SaveDatabase(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId, Builder &amp;builder)
 450 <a name="l00428"></a>00428 {
 451 <a name="l00429"></a>00429         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 452 <a name="l00430"></a>00430
 453 <a name="l00431"></a>00431         <span class="comment">// Protocol note: so far in testing, this CLEAR_DATABASE operation is</span>
 454 <a name="l00432"></a>00432         <span class="comment">//                required, since every record sent via SET_RECORD</span>
 455 <a name="l00433"></a>00433         <span class="comment">//                is treated like a hypothetical "ADD_RECORD" (perhaps</span>
 456 <a name="l00434"></a>00434         <span class="comment">//                SET_RECORD should be renamed)... I don't know if</span>
 457 <a name="l00435"></a>00435         <span class="comment">//                there is a real SET_RECORD... all I know is from</span>
 458 <a name="l00436"></a>00436         <span class="comment">//                the Windows USB captures, which uses this same</span>
 459 <a name="l00437"></a>00437         <span class="comment">//                technique.</span>
 460 <a name="l00438"></a>00438         ClearDatabase(dbId);
 461 <a name="l00439"></a>00439
 462 <a name="l00440"></a>00440         DBPacket packet(*<span class="keyword">this</span>, m_command, m_response);
 463 <a name="l00441"></a>00441
 464 <a name="l00442"></a>00442         <span class="comment">// loop until builder object has no more data</span>
 465 <a name="l00443"></a>00443         <span class="keywordtype">bool</span> first = <span class="keyword">true</span>;
 466 <a name="l00444"></a>00444         <span class="keywordflow">while</span>( packet.SetRecord(dbId, builder, m_ic) ) {
 467 <a name="l00445"></a>00445                 dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 468 <a name="l00446"></a>00446
 469 <a name="l00447"></a>00447                 m_socket-&gt;Packet(packet, first ? 60000 : -1);
 470 <a name="l00448"></a>00448                 first = <span class="keyword">false</span>;
 471 <a name="l00449"></a>00449
 472 <a name="l00450"></a>00450                 std::ostringstream oss;
 473 <a name="l00451"></a>00451                 <span class="comment">// successful packet transfer, so check the network return code</span>
 474 <a name="l00452"></a>00452                 <span class="keywordflow">if</span>( packet.Command() != SB_COMMAND_DB_DONE ) {
 475 <a name="l00453"></a>00453                         oss &lt;&lt; <span class="stringliteral">"Desktop: device responded with unexpected packet command code: "</span>
 476 <a name="l00454"></a>00454                             &lt;&lt; <span class="stringliteral">"0x"</span> &lt;&lt; std::hex &lt;&lt; packet.Command();
 477 <a name="l00455"></a>00455                         <span class="keywordflow">throw</span> Error(oss.str());
 478 <a name="l00456"></a>00456                 }
 479 <a name="l00457"></a>00457
 480 <a name="l00458"></a>00458                 <span class="keywordflow">if</span>( packet.ReturnCode() != 0 ) {
 481 <a name="l00459"></a>00459                         oss &lt;&lt; <span class="stringliteral">"Desktop: device responded with error code (command: "</span>
 482 <a name="l00460"></a>00460                             &lt;&lt; packet.Command() &lt;&lt; <span class="stringliteral">", code: "</span>
 483 <a name="l00461"></a>00461                             &lt;&lt; packet.ReturnCode() &lt;&lt; <span class="stringliteral">")"</span>;
 484 <a name="l00462"></a>00462                         <span class="keywordflow">throw</span> Error(oss.str());
 485 <a name="l00463"></a>00463                 }
 486 <a name="l00464"></a>00464         }
 487 <a name="l00465"></a>00465 }
 488 <a name="l00466"></a>00466
 489 <a name="l00467"></a>00467
 490 <a name="l00468"></a>00468 <span class="comment"></span>
 491 <a name="l00469"></a>00469 <span class="comment">//////////////////////////////////////////////////////////////////////////////</span>
 492 <a name="l00470"></a>00470 <span class="comment"></span><span class="comment">// DBLoader class</span>
 493 <a name="l00471"></a>00471
 494 <a name="l00472"></a>00472 <span class="keyword">struct </span>DBLoaderData
 495 <a name="l00473"></a>00473 {
 496 <a name="l00474"></a>00474         DBPacket m_packet;
 497 <a name="l00475"></a>00475         DBLoaderData(Desktop &amp;desktop, Data &amp;command, Data &amp;response)
 498 <a name="l00476"></a>00476                 : m_packet(desktop, command, response)
 499 <a name="l00477"></a>00477         {
 500 <a name="l00478"></a>00478         }
 501 <a name="l00479"></a>00479 };
 502 <a name="l00480"></a>00480
 503 <a name="l00481"></a>00481 DBLoader::DBLoader(Desktop &amp;desktop)
 504 <a name="l00482"></a>00482         : m_desktop(desktop)
 505 <a name="l00483"></a>00483         , m_loading(false)
 506 <a name="l00484"></a>00484         , m_loader(new DBLoaderData(desktop, m_send, m_send))
 507 <a name="l00485"></a>00485 {
 508 <a name="l00486"></a>00486 }
 509 <a name="l00487"></a>00487
 510 <a name="l00488"></a>00488 DBLoader::~DBLoader()
 511 <a name="l00489"></a>00489 {
 512 <a name="l00490"></a>00490         <span class="keyword">delete</span> m_loader;
 513 <a name="l00491"></a>00491 }
 514 <a name="l00492"></a>00492
 515 <a name="l00493"></a>00493 <span class="keywordtype">bool</span> DBLoader::StartDBLoad(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dbId, DBData &amp;data)
 516 <a name="l00494"></a>00494 {
 517 <a name="l00495"></a>00495         dout(<span class="stringliteral">"Database ID: "</span> &lt;&lt; dbId);
 518 <a name="l00496"></a>00496
 519 <a name="l00497"></a>00497         m_loading = <span class="keyword">true</span>;
 520 <a name="l00498"></a>00498         m_desktop.m_dbdb.GetDBName(dbId, m_dbName);
 521 <a name="l00499"></a>00499
 522 <a name="l00500"></a>00500         DBPacket &amp;packet = m_loader-&gt;m_packet;
 523 <a name="l00501"></a>00501         packet.SetNewReceive(data.UseData());
 524 <a name="l00502"></a>00502         packet.GetRecords(dbId);
 525 <a name="l00503"></a>00503         m_desktop.m_socket-&gt;Packet(packet);
 526 <a name="l00504"></a>00504
 527 <a name="l00505"></a>00505         <span class="keywordflow">while</span>( packet.Command() != SB_COMMAND_DB_DONE ) {
 528 <a name="l00506"></a>00506                 <span class="keywordflow">if</span>( packet.Command() == SB_COMMAND_DB_DATA ) {
 529 <a name="l00507"></a>00507                         packet.ParseMeta(data);
 530 <a name="l00508"></a>00508                         data.SetDBName(m_dbName);
 531 <a name="l00509"></a>00509                         <span class="keywordflow">return</span> <span class="keyword">true</span>;
 532 <a name="l00510"></a>00510                 }
 533 <a name="l00511"></a>00511
 534 <a name="l00512"></a>00512                 <span class="comment">// advance! (use the same data block as in packet)</span>
 535 <a name="l00513"></a>00513                 m_desktop.m_socket-&gt;NextRecord(data.UseData());
 536 <a name="l00514"></a>00514         }
 537 <a name="l00515"></a>00515
 538 <a name="l00516"></a>00516         m_loading = <span class="keyword">false</span>;
 539 <a name="l00517"></a>00517         <span class="keywordflow">return</span> <span class="keyword">false</span>;
 540 <a name="l00518"></a>00518 }
 541 <a name="l00519"></a>00519
 542 <a name="l00520"></a>00520 <span class="keywordtype">bool</span> DBLoader::GetNextRecord(DBData &amp;data)
 543 <a name="l00521"></a>00521 {
 544 <a name="l00522"></a>00522         <span class="keywordflow">if</span>( !m_loading )
 545 <a name="l00523"></a>00523                 <span class="keywordflow">return</span> <span class="keyword">false</span>;
 546 <a name="l00524"></a>00524
 547 <a name="l00525"></a>00525         DBPacket &amp;packet = m_loader-&gt;m_packet;
 548 <a name="l00526"></a>00526         packet.SetNewReceive(data.UseData());
 549 <a name="l00527"></a>00527
 550 <a name="l00528"></a>00528         <span class="keywordflow">do</span> {
 551 <a name="l00529"></a>00529                 <span class="comment">// advance! (use same data as in packet)</span>
 552 <a name="l00530"></a>00530                 m_desktop.m_socket-&gt;NextRecord(data.UseData());
 553 <a name="l00531"></a>00531
 554 <a name="l00532"></a>00532                 <span class="keywordflow">if</span>( packet.Command() == SB_COMMAND_DB_DATA ) {
 555 <a name="l00533"></a>00533                         packet.ParseMeta(data);
 556 <a name="l00534"></a>00534                         <span class="keywordflow">return</span> <span class="keyword">true</span>;
 557 <a name="l00535"></a>00535                 }
 558 <a name="l00536"></a>00536         } <span class="keywordflow">while</span>( m_loader-&gt;m_packet.Command() != SB_COMMAND_DB_DONE );
 559 <a name="l00537"></a>00537
 560 <a name="l00538"></a>00538         m_loading = <span class="keyword">false</span>;
 561 <a name="l00539"></a>00539         <span class="keywordflow">return</span> <span class="keyword">false</span>;
 562 <a name="l00540"></a>00540 }
 563 <a name="l00541"></a>00541
 564 <a name="l00542"></a>00542 } <span class="comment">// namespace Barry::Mode</span>
 565 <a name="l00543"></a>00543
 566 <a name="l00544"></a>00544
 567 <a name="l00545"></a>00545
 568 <a name="l00546"></a>00546
 569 <a name="l00547"></a>00547 <span class="comment"></span>
 570 <a name="l00548"></a>00548 <span class="comment">//////////////////////////////////////////////////////////////////////////////</span>
 571 <a name="l00549"></a>00549 <span class="comment"></span><span class="comment">// DeviceBuilder class</span>
 572 <a name="l00550"></a>00550
 573 <a name="l00551"></a>00551 DeviceBuilder::DeviceBuilder(Mode::Desktop &amp;desktop)
 574 <a name="l00552"></a>00552         : m_started(false)
 575 <a name="l00553"></a>00553         , m_desktop(desktop)
 576 <a name="l00554"></a>00554         , m_loader(desktop)
 577 <a name="l00555"></a>00555 {
 578 <a name="l00556"></a>00556         Restart();
 579 <a name="l00557"></a>00557 }
 580 <a name="l00558"></a>00558
 581 <a name="l00559"></a>00559 <span class="comment">// searches the dbdb from the desktop to find the dbId,</span>
 582 <a name="l00560"></a>00560 <span class="comment">// returns false if not found, and adds it to the list of</span>
 583 <a name="l00561"></a>00561 <span class="comment">// databases to retrieve if found</span>
 584 <a name="l00562"></a>00562 <span class="keywordtype">bool</span> DeviceBuilder::Add(<span class="keyword">const</span> std::string &amp;dbname)
 585 <a name="l00563"></a>00563 {
 586 <a name="l00564"></a>00564         <span class="keywordflow">try</span> {
 587 <a name="l00565"></a>00565                 DBLabel id(m_desktop.GetDBID(dbname), dbname);
 588 <a name="l00566"></a>00566                 m_dbIds.push_back(<span class="keywordtype">id</span>);
 589 <a name="l00567"></a>00567                 <span class="keywordflow">return</span> <span class="keyword">true</span>;
 590 <a name="l00568"></a>00568         }
 591 <a name="l00569"></a>00569         <span class="keywordflow">catch</span>( <a class="code" href="classBarry_1_1Error.html" title="The base class for any future derived exceptions.">Barry::Error</a> &amp; ) {
 592 <a name="l00570"></a>00570                 <span class="comment">// GetDBID() throws on error...</span>
 593 <a name="l00571"></a>00571                 <span class="keywordflow">return</span> <span class="keyword">false</span>;
 594 <a name="l00572"></a>00572         }
 595 <a name="l00573"></a>00573 }
 596 <a name="l00574"></a>00574
 597 <a name="l00575"></a>00575 <span class="keywordtype">void</span> DeviceBuilder::Add(<span class="keyword">const</span> Barry::DatabaseDatabase &amp;dbdb)
 598 <a name="l00576"></a>00576 {
 599 <a name="l00577"></a>00577         DatabaseDatabase::DatabaseArrayType::const_iterator
 600 <a name="l00578"></a>00578                 b = dbdb.Databases.begin(),
 601 <a name="l00579"></a>00579                 e = dbdb.Databases.end();
 602 <a name="l00580"></a>00580
 603 <a name="l00581"></a>00581         <span class="keywordflow">for</span>( ; b != e; ++b ) {
 604 <a name="l00582"></a>00582                 <span class="comment">// hmmm, could optimize this and only add ids</span>
 605 <a name="l00583"></a>00583                 <span class="comment">// with RecordCount &gt; 0, but let's stick with this</span>
 606 <a name="l00584"></a>00584                 <span class="comment">// for now... it might flush bugs out of the system</span>
 607 <a name="l00585"></a>00585                 DBLabel id(b-&gt;Number, b-&gt;Name);
 608 <a name="l00586"></a>00586                 m_dbIds.push_back(<span class="keywordtype">id</span>);
 609 <a name="l00587"></a>00587         }
 610 <a name="l00588"></a>00588 }
 611 <a name="l00589"></a>00589
 612 <a name="l00590"></a><a class="code" href="classBarry_1_1DeviceBuilder.html#292a7d4ee73590ce55c5d866739417ec">00590</a> <span class="keywordtype">bool</span> <a class="code" href="classBarry_1_1DeviceBuilder.html#292a7d4ee73590ce55c5d866739417ec" title="Called to build the record field data.">DeviceBuilder::BuildRecord</a>(<a class="code" href="classBarry_1_1DBData.html" title="Database record data class.">DBData</a> &amp;data,
 613 <a name="l00591"></a>00591                                 <span class="keywordtype">size_t</span> &amp;offset,
 614 <a name="l00592"></a>00592                                 <span class="keyword">const</span> <a class="code" href="classBarry_1_1IConverter.html" title="Main charset conversion class, primarily focused on converting between the Blackberry...">IConverter</a> *ic)
 615 <a name="l00593"></a>00593 {
 616 <a name="l00594"></a>00594         <a class="code" href="classBarry_1_1DBData.html" title="Database record data class.">DBData</a> temp;
 617 <a name="l00595"></a>00595         <span class="keywordflow">if</span>( !<a class="code" href="classBarry_1_1DeviceBuilder.html#3eb2238b584aadac8af2f511cd2ba245" title="Same as BuildRecord, but does not care about any offsets.">FetchRecord</a>(temp, ic) )
 618 <a name="l00596"></a>00596                 <span class="keywordflow">return</span> <span class="keyword">false</span>;
 619 <a name="l00597"></a>00597
 620 <a name="l00598"></a>00598         <span class="comment">// copy the metadata</span>
 621 <a name="l00599"></a>00599         data.<a class="code" href="classBarry_1_1DBData.html#d1a3e69cabea68e0a309459cd7c58e78">SetVersion</a>(temp.<a class="code" href="classBarry_1_1DBData.html#b49877d999de648fd9fefca049686437">GetVersion</a>());
 622 <a name="l00600"></a>00600         data.<a class="code" href="classBarry_1_1DBData.html#55d6bde680fe0b48d07882ade96ef9c3">SetDBName</a>(temp.<a class="code" href="classBarry_1_1DBData.html#37303ba0c4008a8afe0e5f09b823812e">GetDBName</a>());
 623 <a name="l00601"></a>00601         data.<a class="code" href="classBarry_1_1DBData.html#a46147fced1b122cb6a0e6d1cee3cb07">SetIds</a>(temp.<a class="code" href="classBarry_1_1DBData.html#07523eb3b1dcfd99a917a184b61cb10a">GetRecType</a>(), temp.<a class="code" href="classBarry_1_1DBData.html#2a0106c7330842c455fc5393a3abfbc7">GetUniqueId</a>());
 624 <a name="l00602"></a>00602         data.<a class="code" href="classBarry_1_1DBData.html#cb569139ee2d44442d4709ccf2a4ab3c">SetOffset</a>(offset);
 625 <a name="l00603"></a>00603
 626 <a name="l00604"></a>00604         <span class="comment">// copy data from temp into the given offset</span>
 627 <a name="l00605"></a>00605         <span class="keywordtype">size_t</span> tempsize = temp.<a class="code" href="classBarry_1_1DBData.html#a7cacc9655376447ffbf3aa4d664a03b">GetData</a>().GetSize() - temp.<a class="code" href="classBarry_1_1DBData.html#5b301bfdcda5a74ccfd3f7e54fd69d99">GetOffset</a>();
 628 <a name="l00606"></a>00606         data.<a class="code" href="classBarry_1_1DBData.html#3c1c4ad5ce85cef0ea85002a0fe07881">UseData</a>().MemCpy(offset,
 629 <a name="l00607"></a>00607                 temp.<a class="code" href="classBarry_1_1DBData.html#a7cacc9655376447ffbf3aa4d664a03b">GetData</a>().GetData() + temp.<a class="code" href="classBarry_1_1DBData.html#5b301bfdcda5a74ccfd3f7e54fd69d99">GetOffset</a>(), tempsize);
 630 <a name="l00608"></a>00608         data.<a class="code" href="classBarry_1_1DBData.html#3c1c4ad5ce85cef0ea85002a0fe07881">UseData</a>().ReleaseBuffer(offset + tempsize);
 631 <a name="l00609"></a>00609         <span class="keywordflow">return</span> <span class="keyword">true</span>;
 632 <a name="l00610"></a>00610 }
 633 <a name="l00611"></a>00611
 634 <a name="l00612"></a><a class="code" href="classBarry_1_1DeviceBuilder.html#3eb2238b584aadac8af2f511cd2ba245">00612</a> <span class="keywordtype">bool</span> <a class="code" href="classBarry_1_1DeviceBuilder.html#3eb2238b584aadac8af2f511cd2ba245" title="Same as BuildRecord, but does not care about any offsets.">DeviceBuilder::FetchRecord</a>(<a class="code" href="classBarry_1_1DBData.html" title="Database record data class.">DBData</a> &amp;data, <span class="keyword">const</span> <a class="code" href="classBarry_1_1IConverter.html" title="Main charset conversion class, primarily focused on converting between the Blackberry...">IConverter</a> *ic)
 635 <a name="l00613"></a>00613 {
 636 <a name="l00614"></a>00614         <span class="keywordtype">bool</span> ret;
 637 <a name="l00615"></a>00615
 638 <a name="l00616"></a>00616         <span class="keywordflow">if</span>( !m_dbIds.size() )
 639 <a name="l00617"></a>00617                 <span class="keywordflow">return</span> <span class="keyword">false</span>;   <span class="comment">// nothing to do</span>
 640 <a name="l00618"></a>00618
 641 <a name="l00619"></a>00619         <span class="keywordflow">if</span>( !m_started ) {
 642 <a name="l00620"></a>00620                 m_current = m_dbIds.begin();
 643 <a name="l00621"></a>00621                 ret = m_loader.<a class="code" href="classBarry_1_1Mode_1_1DBLoader.html#91865cdae00722a8c6fc53bcdf806a15">StartDBLoad</a>(m_current-&gt;id, data);
 644 <a name="l00622"></a>00622                 m_started = <span class="keyword">true</span>;
 645 <a name="l00623"></a>00623         }
 646 <a name="l00624"></a>00624         <span class="keywordflow">else</span> <span class="keywordflow">if</span>( m_loader.<a class="code" href="classBarry_1_1Mode_1_1DBLoader.html#951ebb66ec127c4ee47ead54ac21dbca" title="Do not call Desktop members if this is true.">IsBusy</a>() ) {
 647 <a name="l00625"></a>00625                 ret = m_loader.<a class="code" href="classBarry_1_1Mode_1_1DBLoader.html#2f1152364ff8ea48e8735fe57fcaa15c">GetNextRecord</a>(data);
 648 <a name="l00626"></a>00626         }
 649 <a name="l00627"></a>00627         <span class="keywordflow">else</span> {
 650 <a name="l00628"></a>00628                 <span class="comment">// don't do anything if we're at the end of our rope</span>
 651 <a name="l00629"></a>00629                 <span class="keywordflow">if</span>( <a class="code" href="classBarry_1_1DeviceBuilder.html#7310e46f1fa8ee6e65f0717a656a4d5d" title="Sometimes a builder can have multiple databases stored in it, so when Build/Fetch...">EndOfFile</a>() )
 652 <a name="l00630"></a>00630                         <span class="keywordflow">return</span> <span class="keyword">false</span>;
 653 <a name="l00631"></a>00631
 654 <a name="l00632"></a>00632                 <span class="comment">// advance and check again... m_current always points</span>
 655 <a name="l00633"></a>00633                 <span class="comment">// to our current DB</span>
 656 <a name="l00634"></a>00634                 ++m_current;
 657 <a name="l00635"></a>00635                 <span class="keywordflow">if</span>( <a class="code" href="classBarry_1_1DeviceBuilder.html#7310e46f1fa8ee6e65f0717a656a4d5d" title="Sometimes a builder can have multiple databases stored in it, so when Build/Fetch...">EndOfFile</a>() )
 658 <a name="l00636"></a>00636                         <span class="keywordflow">return</span> <span class="keyword">false</span>;
 659 <a name="l00637"></a>00637
 660 <a name="l00638"></a>00638                 ret = m_loader.<a class="code" href="classBarry_1_1Mode_1_1DBLoader.html#91865cdae00722a8c6fc53bcdf806a15">StartDBLoad</a>(m_current-&gt;id, data);
 661 <a name="l00639"></a>00639         }
 662 <a name="l00640"></a>00640
 663 <a name="l00641"></a>00641         <span class="comment">// fill in the DBname if successful</span>
 664 <a name="l00642"></a>00642         <span class="keywordflow">if</span>( ret ) {
 665 <a name="l00643"></a>00643                 data.<a class="code" href="classBarry_1_1DBData.html#55d6bde680fe0b48d07882ade96ef9c3">SetDBName</a>(m_current-&gt;name);
 666 <a name="l00644"></a>00644         }
 667 <a name="l00645"></a>00645         <span class="keywordflow">return</span> ret;
 668 <a name="l00646"></a>00646 }
 669 <a name="l00647"></a>00647
 670 <a name="l00648"></a><a class="code" href="classBarry_1_1DeviceBuilder.html#7310e46f1fa8ee6e65f0717a656a4d5d">00648</a> <span class="keywordtype">bool</span> <a class="code" href="classBarry_1_1DeviceBuilder.html#7310e46f1fa8ee6e65f0717a656a4d5d" title="Sometimes a builder can have multiple databases stored in it, so when Build/Fetch...">DeviceBuilder::EndOfFile</a>()<span class="keyword"> const</span>
 671 <a name="l00649"></a>00649 <span class="keyword"></span>{
 672 <a name="l00650"></a>00650         <span class="keywordflow">return</span> m_current == m_dbIds.end();
 673 <a name="l00651"></a>00651 }
 674 <a name="l00652"></a>00652
 675 <a name="l00653"></a>00653
 676 <a name="l00654"></a>00654 <span class="comment"></span>
 677 <a name="l00655"></a>00655 <span class="comment">//////////////////////////////////////////////////////////////////////////////</span>
 678 <a name="l00656"></a>00656 <span class="comment"></span><span class="comment">// DeviceParser class</span>
 679 <a name="l00657"></a>00657
 680 <a name="l00658"></a>00658 DeviceParser::DeviceParser(<a class="code" href="classBarry_1_1Mode_1_1Desktop.html" title="The main interface class to the device databases.">Mode::Desktop</a> &amp;desktop, WriteMode mode)
 681 <a name="l00659"></a>00659         : m_desktop(desktop)
 682 <a name="l00660"></a>00660         , m_mode(mode)
 683 <a name="l00661"></a>00661 {
 684 <a name="l00662"></a>00662 }
 685 <a name="l00663"></a>00663
 686 <a name="l00664"></a>00664 DeviceParser::~DeviceParser()
 687 <a name="l00665"></a>00665 {
 688 <a name="l00666"></a>00666 }
 689 <a name="l00667"></a>00667
 690 <a name="l00668"></a>00668 <span class="keywordtype">void</span> DeviceParser::StartDB(<span class="keyword">const</span> DBData &amp;data, <span class="keyword">const</span> IConverter *ic)
 691 <a name="l00669"></a>00669 {
 692 <a name="l00670"></a>00670         <span class="comment">// start fresh</span>
 693 <a name="l00671"></a>00671         m_rstate.Clear();
 694 <a name="l00672"></a>00672         m_current_db = data.GetDBName();
 695 <a name="l00673"></a>00673         <span class="keywordflow">if</span>( !m_desktop.GetDBDB().GetDBNumber(m_current_db, m_current_dbid) ) {
 696 <a name="l00674"></a>00674                 <span class="comment">// doh!  This database does not exist in this device</span>
 697 <a name="l00675"></a>00675                 dout(<span class="stringliteral">"Database '"</span> &lt;&lt; m_current_db &lt;&lt; <span class="stringliteral">"' does not exist in this device.  Dropping record."</span>);
 698 <a name="l00676"></a>00676                 m_current_db.clear();
 699 <a name="l00677"></a>00677                 m_current_dbid = 0;
 700 <a name="l00678"></a>00678                 <span class="keywordflow">return</span>;
 701 <a name="l00679"></a>00679         }
 702 <a name="l00680"></a>00680
 703 <a name="l00681"></a>00681         <span class="comment">// determine mode</span>
 704 <a name="l00682"></a>00682         WriteMode mode = m_mode;
 705 <a name="l00683"></a>00683         <span class="keywordflow">if</span>( mode == DECIDE_BY_CALLBACK )
 706 <a name="l00684"></a>00684                 mode = DecideWrite(data);
 707 <a name="l00685"></a>00685
 708 <a name="l00686"></a>00686         <span class="keywordflow">switch</span>( mode )
 709 <a name="l00687"></a>00687         {
 710 <a name="l00688"></a>00688         <span class="keywordflow">case</span> ERASE_ALL_WRITE_ALL:
 711 <a name="l00689"></a>00689                 m_desktop.ClearDatabase(m_current_dbid);
 712 <a name="l00690"></a>00690                 WriteNext(data, ic);
 713 <a name="l00691"></a>00691                 <span class="keywordflow">break</span>;
 714 <a name="l00692"></a>00692
 715 <a name="l00693"></a>00693         <span class="keywordflow">case</span> INDIVIDUAL_OVERWRITE:
 716 <a name="l00694"></a>00694         <span class="keywordflow">case</span> ADD_BUT_NO_OVERWRITE:
 717 <a name="l00695"></a>00695         <span class="keywordflow">case</span> ADD_WITH_NEW_ID:
 718 <a name="l00696"></a>00696                 m_desktop.GetRecordStateTable(m_current_dbid, m_rstate);
 719 <a name="l00697"></a>00697                 WriteNext(data, ic);
 720 <a name="l00698"></a>00698                 <span class="keywordflow">break</span>;
 721 <a name="l00699"></a>00699
 722 <a name="l00700"></a>00700         <span class="keywordflow">case</span> DROP_RECORD:
 723 <a name="l00701"></a>00701                 <span class="keywordflow">break</span>;
 724 <a name="l00702"></a>00702
 725 <a name="l00703"></a>00703         <span class="keywordflow">case</span> DECIDE_BY_CALLBACK:
 726 <a name="l00704"></a>00704         <span class="keywordflow">default</span>:
 727 <a name="l00705"></a>00705                 <span class="keywordflow">throw</span> std::logic_error(<span class="stringliteral">"DeviceParser: unknown mode"</span>);
 728 <a name="l00706"></a>00706         }
 729 <a name="l00707"></a>00707 }
 730 <a name="l00708"></a>00708
 731 <a name="l00709"></a>00709 <span class="keywordtype">void</span> DeviceParser::WriteNext(<span class="keyword">const</span> DBData &amp;data, <span class="keyword">const</span> IConverter *ic)
 732 <a name="l00710"></a>00710 {
 733 <a name="l00711"></a>00711         <span class="comment">// determine mode</span>
 734 <a name="l00712"></a>00712         WriteMode mode = m_mode;
 735 <a name="l00713"></a>00713         <span class="keywordflow">if</span>( mode == DECIDE_BY_CALLBACK )
 736 <a name="l00714"></a>00714                 mode = DecideWrite(data);
 737 <a name="l00715"></a>00715
 738 <a name="l00716"></a>00716         <span class="comment">// create fast copy with our own metadata</span>
 739 <a name="l00717"></a>00717         DBData local(data.GetVersion(), data.GetDBName(),
 740 <a name="l00718"></a>00718                 data.GetRecType(), data.GetUniqueId(), data.GetOffset(),
 741 <a name="l00719"></a>00719                 data.GetData().GetData(), data.GetData().GetSize());
 742 <a name="l00720"></a>00720         DBDataBuilder dbuild(local);
 743 <a name="l00721"></a>00721
 744 <a name="l00722"></a>00722         RecordStateTable::IndexType index;
 745 <a name="l00723"></a>00723
 746 <a name="l00724"></a>00724         <span class="keywordflow">switch</span>( mode )
 747 <a name="l00725"></a>00725         {
 748 <a name="l00726"></a>00726         <span class="keywordflow">case</span> ERASE_ALL_WRITE_ALL:
 749 <a name="l00727"></a>00727                 <span class="comment">// just do an AddRecord()</span>
 750 <a name="l00728"></a>00728                 m_desktop.AddRecord(m_current_dbid, dbuild);
 751 <a name="l00729"></a>00729                 <span class="keywordflow">break</span>;
 752 <a name="l00730"></a>00730
 753 <a name="l00731"></a>00731         <span class="keywordflow">case</span> INDIVIDUAL_OVERWRITE:
 754 <a name="l00732"></a>00732                 <span class="comment">// search the state table, overwrite existing, and add new</span>
 755 <a name="l00733"></a>00733                 <span class="keywordflow">if</span>( m_rstate.GetIndex(local.GetUniqueId(), &amp;index) ) {
 756 <a name="l00734"></a>00734                         <span class="comment">// found this record ID, use the index</span>
 757 <a name="l00735"></a>00735                         m_desktop.SetRecord(m_current_dbid, index, dbuild);
 758 <a name="l00736"></a>00736                 }
 759 <a name="l00737"></a>00737                 <span class="keywordflow">else</span> {
 760 <a name="l00738"></a>00738                         <span class="comment">// new record</span>
 761 <a name="l00739"></a>00739                         m_desktop.AddRecord(m_current_dbid, dbuild);
 762 <a name="l00740"></a>00740                 }
 763 <a name="l00741"></a>00741                 <span class="keywordflow">break</span>;
 764 <a name="l00742"></a>00742
 765 <a name="l00743"></a>00743         <span class="keywordflow">case</span> ADD_BUT_NO_OVERWRITE:
 766 <a name="l00744"></a>00744                 <span class="keywordflow">if</span>( !m_rstate.GetIndex(local.GetUniqueId()) ) {
 767 <a name="l00745"></a>00745                         <span class="comment">// no such record ID, so safe to add as new</span>
 768 <a name="l00746"></a>00746                         m_desktop.AddRecord(m_current_dbid, dbuild);
 769 <a name="l00747"></a>00747                 }
 770 <a name="l00748"></a>00748                 <span class="comment">// else, drop record</span>
 771 <a name="l00749"></a>00749                 <span class="keywordflow">break</span>;
 772 <a name="l00750"></a>00750
 773 <a name="l00751"></a>00751         <span class="keywordflow">case</span> ADD_WITH_NEW_ID:
 774 <a name="l00752"></a>00752                 <span class="comment">// use state table to create new id, and add as new</span>
 775 <a name="l00753"></a>00753                 local.SetIds(local.GetRecType(), m_rstate.MakeNewRecordId());
 776 <a name="l00754"></a>00754                 m_desktop.AddRecord(m_current_dbid, dbuild);
 777 <a name="l00755"></a>00755                 <span class="keywordflow">break</span>;
 778 <a name="l00756"></a>00756
 779 <a name="l00757"></a>00757         <span class="keywordflow">case</span> DROP_RECORD:
 780 <a name="l00758"></a>00758                 <span class="keywordflow">break</span>;
 781 <a name="l00759"></a>00759
 782 <a name="l00760"></a>00760         <span class="keywordflow">case</span> DECIDE_BY_CALLBACK:
 783 <a name="l00761"></a>00761         <span class="keywordflow">default</span>:
 784 <a name="l00762"></a>00762                 <span class="keywordflow">throw</span> std::logic_error(<span class="stringliteral">"DeviceParser: unknown mode"</span>);
 785 <a name="l00763"></a>00763         }
 786 <a name="l00764"></a>00764 }
 787 <a name="l00765"></a>00765
 788 <a name="l00766"></a><a class="code" href="classBarry_1_1DeviceParser.html#29558754a66d4f5c43c08af719a902c0">00766</a> <span class="keywordtype">void</span> <a class="code" href="classBarry_1_1DeviceParser.html#29558754a66d4f5c43c08af719a902c0" title="Parser overrides.">DeviceParser::ParseRecord</a>(<span class="keyword">const</span> <a class="code" href="classBarry_1_1DBData.html" title="Database record data class.">DBData</a> &amp;data, <span class="keyword">const</span> <a class="code" href="classBarry_1_1IConverter.html" title="Main charset conversion class, primarily focused on converting between the Blackberry...">IConverter</a> *ic)
 789 <a name="l00767"></a>00767 {
 790 <a name="l00768"></a>00768         <span class="keywordflow">if</span>( data.<a class="code" href="classBarry_1_1DBData.html#37303ba0c4008a8afe0e5f09b823812e">GetDBName</a>() == m_current_db ) {
 791 <a name="l00769"></a>00769                 WriteNext(data, ic);
 792 <a name="l00770"></a>00770         }
 793 <a name="l00771"></a>00771         <span class="keywordflow">else</span> {
 794 <a name="l00772"></a>00772                 StartDB(data, ic);
 795 <a name="l00773"></a>00773         }
 796 <a name="l00774"></a>00774 }
 797 <a name="l00775"></a>00775
 798 <a name="l00776"></a>00776 } <span class="comment">// namespace Barry</span>
 799 <a name="l00777"></a>00777
 800 </pre></div></div>
 801 <hr size="1"><address style="text-align: right;"><small>Generated on Thu Feb 10 16:13:58 2011 for Barry by&nbsp;
 802 <a href="http://www.doxygen.org/index.html">
 803 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
 804 </body>
 805 </html>