Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > by-pkgid > 98d6b53e11e983e268c3e19f14e091a0 > files > 3738

kdepim-devel-doc-3.5.9-9mdv2008.1.x86_64.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">

<head>
  <title>kpilot/lib: recordConduit.cc Source File (kpilot/lib)</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

  <meta http-equiv="Content-Style-Type" content="text/css" />

  <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org"  r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org"  r (n 0 s 0 v 0 l 0))' />

  <meta name="trademark" content="KDE e.V." />
  <meta name="description" content="K Desktop Environment Homepage, KDE.org" />
  <meta name="MSSmartTagsPreventParsing" content="true" />
  <meta name="robots" content="all" />

  <link rel="shortcut icon" href="../../../favicon.ico" />

<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />



<style type="text/css">
<!--
hr { display: none; }
#content h2 { margin-left: 0px; }
table.mdTable { background-color: #f8f8f8; border: .2em solid #d7d7d7; }
td.mdRow { padding: 8px 20px; }
td.md { font-weight: bold; }
td.mdname1 { font-weight: bold; color: #602020; }
td.mdname { font-weight: bold; color: #602020;  }

-->
</style>

</head>

<body>

<div id="nav_header_top" align="right">
  <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>

  <a href="../../.."><img id="nav_header_logo" alt="Home" align="left" src="../../../kde_gear_64.png" border="0" /></a>
  <span class="doNotDisplay">::</span>
  <img id="nav_header_logo_right" alt="" align="right" src="../../../pimlogo.png" border="0" />

  <div id="nav_header_title" align="left">KDE PIM API Reference</div>


</div>

<div id="nav_header_bottom" align="right">
  <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
  <div id="nav_header_bottom_left" style="text-align: left;">
/ <a href="../../../">API Reference</a>
 / <a href="../../html/index.html">kpilot</a> / <a href=".">lib</a>
  </div>
</div>


<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
      <td valign="top" class="menuheader" height="0"></td>

  <td id="contentcolumn" valign="top" rowspan="2" >
    <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
    <h2><a name="content"></a>kpilot/lib</h2>


<!-- Generated by Doxygen 1.5.5 -->
<h1>recordConduit.cc</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* KPilot</span>
<a name="l00002"></a>00002 <span class="comment">**</span>
<a name="l00003"></a>00003 <span class="comment">** Copyright (C) 2004 by Reinhold Kainhofer</span>
<a name="l00004"></a>00004 <span class="comment">** Based on the addressbook conduit:</span>
<a name="l00005"></a>00005 <span class="comment">** Copyright (C) 2000,2001 by Dan Pilone</span>
<a name="l00006"></a>00006 <span class="comment">** Copyright (C) 2000 Gregory Stern</span>
<a name="l00007"></a>00007 <span class="comment">** Copyright (C) 2002-2003 by Reinhold Kainhofer</span>
<a name="l00008"></a>00008 <span class="comment">**</span>
<a name="l00009"></a>00009 <span class="comment">** This conduit is the base class for all record-based conduits.</span>
<a name="l00010"></a>00010 <span class="comment">** all the sync logic is included in this class, and all child classes</span>
<a name="l00011"></a>00011 <span class="comment">** just have to implement some specific copying and conflict resolution</span>
<a name="l00012"></a>00012 <span class="comment">** methods.</span>
<a name="l00013"></a>00013 <span class="comment">*/</span>
<a name="l00014"></a>00014 
<a name="l00015"></a>00015 <span class="comment">/*</span>
<a name="l00016"></a>00016 <span class="comment">** This program is free software; you can redistribute it and/or modify</span>
<a name="l00017"></a>00017 <span class="comment">** it under the terms of the GNU General Public License as published by</span>
<a name="l00018"></a>00018 <span class="comment">** the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00019"></a>00019 <span class="comment">** (at your option) any later version.</span>
<a name="l00020"></a>00020 <span class="comment">**</span>
<a name="l00021"></a>00021 <span class="comment">** This program is distributed in the hope that it will be useful,</span>
<a name="l00022"></a>00022 <span class="comment">** but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00023"></a>00023 <span class="comment">** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span>
<a name="l00024"></a>00024 <span class="comment">** GNU General Public License for more details.</span>
<a name="l00025"></a>00025 <span class="comment">**</span>
<a name="l00026"></a>00026 <span class="comment">** You should have received a copy of the GNU General Public License</span>
<a name="l00027"></a>00027 <span class="comment">** along with this program in a file called COPYING; if not, write to</span>
<a name="l00028"></a>00028 <span class="comment">** the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,</span>
<a name="l00029"></a>00029 <span class="comment">** MA 02110-1301, USA.</span>
<a name="l00030"></a>00030 <span class="comment">*/</span>
<a name="l00031"></a>00031 
<a name="l00032"></a>00032 <span class="comment">/*</span>
<a name="l00033"></a>00033 <span class="comment">** Bug reports and questions can be sent to kde-pim@kde.org.</span>
<a name="l00034"></a>00034 <span class="comment">*/</span>
<a name="l00035"></a>00035 
<a name="l00036"></a>00036 
<a name="l00037"></a>00037 
<a name="l00038"></a>00038 <span class="preprocessor">#include "options.h"</span>
<a name="l00039"></a>00039 
<a name="l00040"></a>00040 <span class="preprocessor">#include &lt;qtimer.h&gt;</span>
<a name="l00041"></a>00041 <span class="preprocessor">#include &lt;qfile.h&gt;</span>
<a name="l00042"></a>00042 
<a name="l00043"></a>00043 <span class="preprocessor">#include "pilotAppCategory.h"</span>
<a name="l00044"></a>00044 <span class="preprocessor">#include "<a class="code" href="pilotSerialDatabase_8h.html" title="Database class for a database on the pilot connected via the serial port (ie: hot-sync...">pilotSerialDatabase.h</a>"</span>
<a name="l00045"></a>00045 <span class="preprocessor">#include "<a class="code" href="pilotLocalDatabase_8h.html" title="Defines the PilotLocalDatabase class, for databases stored on disk (as opposed to...">pilotLocalDatabase.h</a>"</span>
<a name="l00046"></a>00046 <span class="preprocessor">#include "<a class="code" href="recordConduit_8h.html" title="This file defines a generic syncing framework for Palm Pilot oriented data.">recordConduit.h</a>"</span>
<a name="l00047"></a>00047 
<a name="l00048"></a>00048 
<a name="l00049"></a>00049 <span class="comment">// Something to allow us to check what revision</span>
<a name="l00050"></a>00050 <span class="comment">// the modules are that make up a binary distribution.</span>
<a name="l00051"></a>00051 <span class="comment">//</span>
<a name="l00052"></a>00052 <span class="comment">//</span>
<a name="l00053"></a>00053 <span class="keyword">extern</span> <span class="stringliteral">"C"</span>
<a name="l00054"></a>00054 {
<a name="l00055"></a>00055 <span class="keywordtype">long</span> version_record_conduit = <a class="code" href="namespacePilot.html#747e9f7c7d7ce5e5b599fa1a70e15d40" title="As the API for conduits may change in the course of time, identify them and refuse...">Pilot::PLUGIN_API</a>;
<a name="l00056"></a>00056 }
<a name="l00057"></a>00057 
<a name="l00058"></a>00058 
<a name="l00059"></a>00059 <span class="comment">/* virtual */</span> <span class="keywordtype">bool</span> RecordConduitBase::exec()
<a name="l00060"></a>00060 {
<a name="l00061"></a>00061     FUNCTIONSETUP;
<a name="l00062"></a>00062     fState = Initialize;
<a name="l00063"></a>00063 
<a name="l00064"></a>00064     setFirstSync(<span class="keyword">false</span>);
<a name="l00065"></a>00065 
<a name="l00066"></a>00066     <span class="keywordtype">bool</span> retrieved = <span class="keyword">false</span>;
<a name="l00067"></a>00067     <span class="keywordflow">if</span> (!<a class="code" href="classConduitAction.html#43ee0ddf1b028e4facf382735d265220" title="Open both the local copy of database dbName and the version on the Pilot.">openDatabases</a>( fDBName, &amp;retrieved))
<a name="l00068"></a>00068     {
<a name="l00069"></a>00069         emit logError(i18n(<span class="stringliteral">"Unable to open the %1 database on the handheld."</span>).arg( fDBName ) );
<a name="l00070"></a>00070         <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00071"></a>00071     }
<a name="l00072"></a>00072     <span class="keywordflow">if</span> (retrieved) setFirstSync(<span class="keyword">true</span>);
<a name="l00073"></a>00073 
<a name="l00074"></a>00074     <span class="keywordflow">if</span> (<a class="code" href="classConduitAction.html#d20a164b45e1f71ba6875246f53e5d4a" title="A first sync (i.e.">isFirstSync</a>()) fIDList=fDatabase-&gt;<a class="code" href="classPilotDatabase.html#14470b7fcd6e6ecc6b1349709f122533" title="Returns a QValueList of all record ids in the database.">idList</a>();
<a name="l00075"></a>00075     <span class="keywordflow">else</span> fIDList=fDatabase-&gt;<a class="code" href="classPilotDatabase.html#0fbcca5afb6abd1213e09093c1b3737c" title="Returns a list of all record ids that have been modified in the database.">modifiedIDList</a>();
<a name="l00076"></a>00076     fIDListIterator = fIDList.begin();
<a name="l00077"></a>00077 
<a name="l00078"></a>00078     fTimer = <span class="keyword">new</span> QTimer(<span class="keyword">this</span>);
<a name="l00079"></a>00079     connect(fTimer,SIGNAL(timeout()),<span class="keyword">this</span>,SLOT(<a class="code" href="classRecordConduitBase.html#94ef5284514abdc0b4b75ac6256c3020" title="Slot used for the implementation of a state machine: calls each of the relevant other...">process</a>()));
<a name="l00080"></a>00080     fTimer-&gt;start(0,<span class="keyword">false</span>); <span class="comment">// Fire as often as possible to prompt processing</span>
<a name="l00081"></a>00081     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00082"></a>00082 }
<a name="l00083"></a>00083 
<a name="l00084"></a><a class="code" href="classRecordConduitBase.html#94ef5284514abdc0b4b75ac6256c3020">00084</a> <span class="comment">/* virtual */</span> <span class="keywordtype">void</span> <a class="code" href="classRecordConduitBase.html#94ef5284514abdc0b4b75ac6256c3020" title="Slot used for the implementation of a state machine: calls each of the relevant other...">RecordConduitBase::process</a>()
<a name="l00085"></a>00085 {
<a name="l00086"></a>00086     FUNCTIONSETUP;
<a name="l00087"></a>00087     <a class="code" href="classRecordConduitBase.html#7742f57d67cb7255643a21921192a3dd" title="Return values for the processing functions.">SyncProgress</a> p = Error;
<a name="l00088"></a>00088 
<a name="l00089"></a>00089 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00090"></a>00090 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": From state "</span> &lt;&lt; <a class="code" href="classRecordConduitBase.html#d3c91af90d82f0473fb74eec11faea80" title="Returns a human-readable name for the progress indicator s.">name</a>(fState) &lt;&lt; endl;
<a name="l00091"></a>00091 <span class="preprocessor">#endif</span>
<a name="l00092"></a>00092 <span class="preprocessor"></span>
<a name="l00093"></a>00093     <span class="keywordflow">switch</span>(fState)
<a name="l00094"></a>00094     {
<a name="l00095"></a>00095     <span class="keywordflow">case</span> Initialize :
<a name="l00096"></a>00096         p = <a class="code" href="classRecordConduitBase.html#46d53de983a92c4c60f59c6c2cc2ab34" title="Function called at the beginning of a sync to load data from the PC.">loadPC</a>();
<a name="l00097"></a>00097         <span class="keywordflow">break</span>;
<a name="l00098"></a>00098     <span class="keywordflow">case</span> PalmToPC :
<a name="l00099"></a>00099         p = <a class="code" href="classRecordConduitBase.html#d3311bbc11c7758f26dc51981e5c53d4" title="Function called repeatedly to fetch the next modified entry from the Palm and sync...">palmRecToPC</a>();
<a name="l00100"></a>00100         <span class="keywordflow">break</span>;
<a name="l00101"></a>00101     <span class="keywordflow">case</span> PCToPalm :
<a name="l00102"></a>00102         p = <a class="code" href="classRecordConduitBase.html#bc33f656a98a63d998940908951f4662" title="Function called repeatedly to fetch the next modified entry from the PC and sync...">pcRecToPalm</a>();
<a name="l00103"></a>00103         <span class="keywordflow">break</span>;
<a name="l00104"></a>00104     <span class="keywordflow">case</span> Cleanup :
<a name="l00105"></a>00105         p = <a class="code" href="classRecordConduitBase.html#118ec8b0b7111d2f0edae30f91309ed4" title="Function called at the end of this conduit&amp;#39;s sync, which should reset DB flags...">cleanup</a>();
<a name="l00106"></a>00106         <span class="keywordflow">break</span>;
<a name="l00107"></a>00107     }
<a name="l00108"></a>00108 
<a name="l00109"></a>00109 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00110"></a>00110 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": Step returned "</span> &lt;&lt; <a class="code" href="classRecordConduitBase.html#d3c91af90d82f0473fb74eec11faea80" title="Returns a human-readable name for the progress indicator s.">name</a>(p) &lt;&lt; endl;
<a name="l00111"></a>00111 <span class="preprocessor">#endif</span>
<a name="l00112"></a>00112 <span class="preprocessor"></span>
<a name="l00113"></a>00113     <span class="keywordflow">switch</span>(p)
<a name="l00114"></a>00114     {
<a name="l00115"></a>00115     <span class="keywordflow">case</span> Error :
<a name="l00116"></a>00116         fTimer-&gt;stop();
<a name="l00117"></a>00117         delayDone();
<a name="l00118"></a>00118         <span class="keywordflow">return</span>;
<a name="l00119"></a>00119     <span class="keywordflow">case</span> NotDone :
<a name="l00120"></a>00120         <span class="comment">// Return so we get called again.</span>
<a name="l00121"></a>00121         <span class="keywordflow">return</span>;
<a name="l00122"></a>00122     <span class="keywordflow">case</span> Done :
<a name="l00123"></a>00123         <span class="comment">// Get on with it.</span>
<a name="l00124"></a>00124         <span class="keywordflow">break</span>;
<a name="l00125"></a>00125     }
<a name="l00126"></a>00126 
<a name="l00127"></a>00127 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00128"></a>00128 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": Step is done, moving to next state."</span> &lt;&lt; endl;
<a name="l00129"></a>00129 <span class="preprocessor">#endif</span>
<a name="l00130"></a>00130 <span class="preprocessor"></span>
<a name="l00131"></a>00131     <span class="comment">// Here the previous call was done.</span>
<a name="l00132"></a>00132     <span class="keywordflow">switch</span>(fState)
<a name="l00133"></a>00133     {
<a name="l00134"></a>00134     <span class="keywordflow">case</span> Initialize :
<a name="l00135"></a>00135         <span class="keywordflow">switch</span> (<a class="code" href="classConduitAction.html#6e7135853f9089e68351ce0850c02b83" title="Retrieve the sync mode set for this action.">syncMode</a>().mode())
<a name="l00136"></a>00136         {
<a name="l00137"></a>00137         <span class="keywordflow">case</span> SyncMode::eRestore :
<a name="l00138"></a>00138         <span class="keywordflow">case</span> SyncMode::eCopyPCToHH : <span class="comment">/* These two don't copy Palm records to the PC */</span>
<a name="l00139"></a>00139             fState = PCToPalm;
<a name="l00140"></a>00140             <span class="keywordflow">break</span>;
<a name="l00141"></a>00141         <span class="keywordflow">default</span> :
<a name="l00142"></a>00142             fState = PalmToPC;
<a name="l00143"></a>00143         }
<a name="l00144"></a>00144         <span class="keywordflow">break</span>;
<a name="l00145"></a>00145     <span class="keywordflow">case</span> PalmToPC :
<a name="l00146"></a>00146         <span class="keywordflow">switch</span> (<a class="code" href="classConduitAction.html#6e7135853f9089e68351ce0850c02b83" title="Retrieve the sync mode set for this action.">syncMode</a>().mode())
<a name="l00147"></a>00147         {
<a name="l00148"></a>00148         <span class="keywordflow">case</span> SyncMode::eBackup :
<a name="l00149"></a>00149         <span class="keywordflow">case</span> SyncMode::eCopyHHToPC : <span class="comment">/* These modes don't copy PC records back */</span>
<a name="l00150"></a>00150             fState = Cleanup;
<a name="l00151"></a>00151             <span class="keywordflow">break</span>;
<a name="l00152"></a>00152         <span class="keywordflow">default</span> :
<a name="l00153"></a>00153             fState = PCToPalm;
<a name="l00154"></a>00154         }
<a name="l00155"></a>00155         <span class="keywordflow">break</span>;
<a name="l00156"></a>00156     <span class="keywordflow">case</span> PCToPalm :
<a name="l00157"></a>00157         fState = Cleanup;
<a name="l00158"></a>00158         <span class="keywordflow">break</span>;
<a name="l00159"></a>00159     <span class="keywordflow">case</span> Cleanup :
<a name="l00160"></a>00160         fTimer-&gt;stop();
<a name="l00161"></a>00161         delayDone();
<a name="l00162"></a>00162         <span class="comment">// No change in state, timer stopped and we're done.</span>
<a name="l00163"></a>00163         <span class="keywordflow">break</span>;
<a name="l00164"></a>00164     }
<a name="l00165"></a>00165 
<a name="l00166"></a>00166 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00167"></a>00167 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": Next state is "</span> &lt;&lt; <a class="code" href="classRecordConduitBase.html#d3c91af90d82f0473fb74eec11faea80" title="Returns a human-readable name for the progress indicator s.">name</a>(fState) &lt;&lt; endl;
<a name="l00168"></a>00168 <span class="preprocessor">#endif</span>
<a name="l00169"></a>00169 <span class="preprocessor"></span>
<a name="l00170"></a>00170 }
<a name="l00171"></a>00171 
<a name="l00172"></a>00172 
<a name="l00173"></a><a class="code" href="classRecordConduitBase.html#d3c91af90d82f0473fb74eec11faea80">00173</a> QString <a class="code" href="classRecordConduitBase.html#d3c91af90d82f0473fb74eec11faea80" title="Returns a human-readable name for the progress indicator s.">RecordConduitBase::name</a>(<a class="code" href="classRecordConduitBase.html#7742f57d67cb7255643a21921192a3dd" title="Return values for the processing functions.">RecordConduitBase::SyncProgress</a> s)
<a name="l00174"></a>00174 {
<a name="l00175"></a>00175     <span class="keywordflow">switch</span>(s)
<a name="l00176"></a>00176     {
<a name="l00177"></a>00177     <span class="keywordflow">case</span> RecordConduitBase::NotDone:
<a name="l00178"></a>00178         <span class="keywordflow">return</span> CSL1(<span class="stringliteral">"NotDone"</span>);
<a name="l00179"></a>00179     <span class="keywordflow">case</span> RecordConduitBase::Done:
<a name="l00180"></a>00180         <span class="keywordflow">return</span> CSL1(<span class="stringliteral">"Done"</span>);
<a name="l00181"></a>00181     <span class="keywordflow">case</span> RecordConduitBase::Error:
<a name="l00182"></a>00182         <span class="keywordflow">return</span> CSL1(<span class="stringliteral">"Error"</span>);
<a name="l00183"></a>00183     }
<a name="l00184"></a>00184 }
<a name="l00185"></a>00185 
<a name="l00186"></a>00186 
<a name="l00187"></a>00187 QString <a class="code" href="classRecordConduitBase.html#d3c91af90d82f0473fb74eec11faea80" title="Returns a human-readable name for the progress indicator s.">RecordConduitBase::name</a>(<a class="code" href="classRecordConduitBase.html#2bd949f937a98ab87c2f2ff3c0bc32d6" title="State of the conduit&amp;#39;s sync.">RecordConduitBase::States</a> s)
<a name="l00188"></a>00188 {
<a name="l00189"></a>00189     <span class="keywordflow">switch</span>(s)
<a name="l00190"></a>00190     {
<a name="l00191"></a>00191     <span class="keywordflow">case</span> RecordConduitBase::Initialize:
<a name="l00192"></a>00192         <span class="keywordflow">return</span> CSL1(<span class="stringliteral">"Initialize"</span>);
<a name="l00193"></a>00193     <span class="keywordflow">case</span> RecordConduitBase::PalmToPC:
<a name="l00194"></a>00194         <span class="keywordflow">return</span> CSL1(<span class="stringliteral">"Handheld-to-PC"</span>);
<a name="l00195"></a>00195     <span class="keywordflow">case</span> RecordConduitBase::PCToPalm:
<a name="l00196"></a>00196         <span class="keywordflow">return</span> CSL1(<span class="stringliteral">"PC-to-Handheld"</span>);
<a name="l00197"></a>00197     <span class="keywordflow">case</span> RecordConduitBase::Cleanup:
<a name="l00198"></a>00198         <span class="keywordflow">return</span> CSL1(<span class="stringliteral">"Cleanup"</span>);
<a name="l00199"></a>00199     }
<a name="l00200"></a>00200 }
<a name="l00201"></a>00201 
<a name="l00202"></a>00202 
<a name="l00203"></a>00203 <span class="preprocessor">#if 0</span>
<a name="l00204"></a>00204 <span class="preprocessor"></span>
<a name="l00206"></a>00206 <span class="keywordtype">bool</span> RecordConduit::PCData::makeArchived( RecordConduit::PCEntry *pcEntry )
<a name="l00207"></a>00207 {
<a name="l00208"></a>00208     <span class="keywordflow">if</span> ( pcEntry ) {
<a name="l00209"></a>00209         pcEntry-&gt;makeArchived();
<a name="l00210"></a>00210         setChanged( <span class="keyword">true</span> );
<a name="l00211"></a>00211         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00212"></a>00212     } <span class="keywordflow">else</span> <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00213"></a>00213 }
<a name="l00214"></a>00214 
<a name="l00215"></a>00215 
<a name="l00216"></a>00216 <span class="comment">/* Builds the map which links record ids to uid's of PCEntry. This is the slow implementation,</span>
<a name="l00217"></a>00217 <span class="comment"> * that should always work. subclasses should reimplement it to speed things up.</span>
<a name="l00218"></a>00218 <span class="comment">*/</span>
<a name="l00219"></a>00219 <span class="keywordtype">bool</span> RecordConduit::PCData::mapContactsToPilot( QMap&lt;recordid_t,QString&gt; &amp;idContactMap )
<a name="l00220"></a>00220 {
<a name="l00221"></a>00221     FUNCTIONSETUP;
<a name="l00222"></a>00222 
<a name="l00223"></a>00223     idContactMap.clear();
<a name="l00224"></a>00224 
<a name="l00225"></a>00225     Iterator it = begin();
<a name="l00226"></a>00226     PCEntry *ent;
<a name="l00227"></a>00227     <span class="keywordflow">while</span> ( !atEnd( it ) ) {
<a name="l00228"></a>00228         ent = *it;
<a name="l00229"></a>00229         recordid_t id( ent-&gt;recid() );
<a name="l00230"></a>00230         <span class="keywordflow">if</span> ( <span class="keywordtype">id</span> != 0 ) {
<a name="l00231"></a>00231             idContactMap.insert( <span class="keywordtype">id</span>, ent-&gt;uid() );
<a name="l00232"></a>00232         }
<a name="l00233"></a>00233         ++it;
<a name="l00234"></a>00234     }
<a name="l00235"></a>00235 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00236"></a>00236 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": Loaded "</span> &lt;&lt; idContactMap.size() &lt;&lt;
<a name="l00237"></a>00237         <span class="stringliteral">" Entries on the pc and mapped them to records on the handheld. "</span> &lt;&lt; endl;
<a name="l00238"></a>00238 <span class="preprocessor">#endif</span>
<a name="l00239"></a>00239 <span class="preprocessor"></span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00240"></a>00240 }
<a name="l00241"></a>00241 
<a name="l00242"></a>00242 
<a name="l00243"></a>00243 
<a name="l00244"></a>00244 <span class="comment">/*********************************************************************</span>
<a name="l00245"></a>00245 <span class="comment">                        C O N S T R U C T O R</span>
<a name="l00246"></a>00246 <span class="comment"> *********************************************************************/</span>
<a name="l00247"></a>00247 
<a name="l00248"></a>00248 
<a name="l00249"></a>00249 
<a name="l00250"></a>00250 <span class="keywordtype">bool</span> RecordConduit::mArchiveDeleted = <span class="keyword">false</span>;
<a name="l00251"></a>00251 
<a name="l00252"></a>00252 RecordConduit::RecordConduit(QString <a class="code" href="classRecordConduitBase.html#d3c91af90d82f0473fb74eec11faea80" title="Returns a human-readable name for the progress indicator s.">name</a>, <a class="code" href="classKPilotDeviceLink.html" title="Definition of the device link class for physical handheld devices, which communicate...">KPilotDeviceLink</a> * o, <span class="keyword">const</span> <span class="keywordtype">char</span> *n, <span class="keyword">const</span> QStringList &amp; a):
<a name="l00253"></a>00253         <a class="code" href="classConduitAction.html" title="The SyncActions created by the factory should obey at least the argument test, indicating...">ConduitAction</a>(o, n, a),
<a name="l00254"></a>00254         mPCData(0), mPalmIndex(0),
<a name="l00255"></a>00255         mEntryMap(), mSyncedIds(), mAllIds()
<a name="l00256"></a>00256 {
<a name="l00257"></a>00257     FUNCTIONSETUP;
<a name="l00258"></a>00258     <a class="code" href="classConduitAction.html#f9cddaa3f482518889ad9f881ed71eec" title="Name of the conduit; might be changed by subclasses.">fConduitName</a> = name;
<a name="l00259"></a>00259 }
<a name="l00260"></a>00260 
<a name="l00261"></a>00261 
<a name="l00262"></a>00262 
<a name="l00263"></a>00263 RecordConduit::~RecordConduit()
<a name="l00264"></a>00264 {
<a name="l00265"></a>00265     <span class="keywordflow">if</span> ( mPCData ) KPILOT_DELETE(mPCData);
<a name="l00266"></a>00266 }
<a name="l00267"></a>00267 
<a name="l00268"></a>00268 
<a name="l00269"></a>00269 
<a name="l00270"></a>00270 
<a name="l00271"></a>00271 
<a name="l00272"></a>00272 
<a name="l00273"></a>00273 <span class="comment">/*********************************************************************</span>
<a name="l00274"></a>00274 <span class="comment">                S Y N C   S T R U C T U R E</span>
<a name="l00275"></a>00275 <span class="comment"> *********************************************************************/</span>
<a name="l00276"></a>00276 
<a name="l00277"></a>00277 
<a name="l00278"></a>00278 
<a name="l00279"></a>00279 <span class="comment">/* virtual */</span> <span class="keywordtype">bool</span> RecordConduit::exec()
<a name="l00280"></a>00280 {
<a name="l00281"></a>00281     FUNCTIONSETUP;
<a name="l00282"></a>00282 
<a name="l00283"></a>00283     <span class="keywordflow">if</span> ( !_prepare() ) <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00284"></a>00284 
<a name="l00285"></a>00285     fFirstSync = <span class="keyword">false</span>;
<a name="l00286"></a>00286     <span class="comment">// Database names probably in latin1.</span>
<a name="l00287"></a>00287     <span class="keywordflow">if</span>( !<a class="code" href="classConduitAction.html#43ee0ddf1b028e4facf382735d265220" title="Open both the local copy of database dbName and the version on the Pilot.">openDatabases</a>( dbName(), &amp;fFirstSync ) )
<a name="l00288"></a>00288     {
<a name="l00289"></a>00289         emit logError(i18n(<span class="stringliteral">"Unable to open the %1 database on the handheld."</span>).arg( dbName() ) );
<a name="l00290"></a>00290         <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00291"></a>00291     }
<a name="l00292"></a>00292     _getAppInfo();
<a name="l00293"></a>00293     <span class="keywordflow">if</span>( !mPCData-&gt;loadData() )
<a name="l00294"></a>00294     {
<a name="l00295"></a>00295         emit logError( i18n(<span class="stringliteral">"Unable to open %1."</span>).arg( mPCData-&gt;description() ) );
<a name="l00296"></a>00296         <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00297"></a>00297     }
<a name="l00298"></a>00298     <span class="comment">// get the addresseMap which maps Pilot unique record(address) id's to</span>
<a name="l00299"></a>00299     <span class="comment">// a Abbrowser Addressee; allows for easy lookup and comparisons</span>
<a name="l00300"></a>00300     <span class="keywordflow">if</span> ( mPCData-&gt;isEmpty() )
<a name="l00301"></a>00301         fFirstSync = <span class="keyword">true</span>;
<a name="l00302"></a>00302     <span class="keywordflow">else</span>
<a name="l00303"></a>00303         mPCData-&gt;mapContactsToPilot( mEntryMap );
<a name="l00304"></a>00304     fFirstSync = fFirstSync || ( mPCData-&gt;isEmpty() );
<a name="l00305"></a>00305 
<a name="l00306"></a>00306     <span class="comment">// perform syncing from palm to abbrowser</span>
<a name="l00307"></a>00307     <span class="comment">// iterate through all records in palm pilot</span>
<a name="l00308"></a>00308     mPalmIndex = 0;
<a name="l00309"></a>00309 
<a name="l00310"></a>00310 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00311"></a>00311 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": fullsync="</span> &lt;&lt; <a class="code" href="classConduitAction.html#4eeba6c5c267e44874481697dc953e51" title="A full sync happens for eFullSync, eCopyPCToHH and eCopyHHToPC.">isFullSync</a>() &lt;&lt; <span class="stringliteral">", firstSync="</span> &lt;&lt; <a class="code" href="classConduitAction.html#d20a164b45e1f71ba6875246f53e5d4a" title="A first sync (i.e.">isFirstSync</a>() &lt;&lt; endl;
<a name="l00312"></a>00312     DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": "</span>
<a name="l00313"></a>00313         &lt;&lt; <span class="stringliteral">"syncDirection="</span> &lt;&lt; getSyncDirection() &lt;&lt; <span class="stringliteral">", "</span>
<a name="l00314"></a>00314 <span class="comment">//      &lt;&lt; "archive = " &lt;&lt; AbbrowserSettings::archiveDeleted()</span>
<a name="l00315"></a>00315         &lt;&lt; endl;
<a name="l00316"></a>00316     DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": conflictRes="</span>&lt;&lt; <a class="code" href="classConduitAction.html#2ee5a1cd25966132a08714d99d26bd7b" title="Retrieve the conflict resolution setting for this action.">getConflictResolution</a>() &lt;&lt; endl;
<a name="l00317"></a>00317 <span class="comment">//  DEBUGKPILOT &lt;&lt; fname &lt;&lt; ": PilotStreetHome=" &lt;&lt; AbbrowserSettings::pilotStreet() &lt;&lt; ", PilotFaxHOme" &lt;&lt; AbbrowserSettings::pilotFax() &lt;&lt; endl;</span>
<a name="l00318"></a>00318 <span class="preprocessor">#endif</span>
<a name="l00319"></a>00319 <span class="preprocessor"></span>
<a name="l00320"></a>00320     <span class="keywordflow">if</span> ( !<a class="code" href="classConduitAction.html#d20a164b45e1f71ba6875246f53e5d4a" title="A first sync (i.e.">isFirstSync</a>() )
<a name="l00321"></a>00321         mAllIds=fDatabase-&gt;<a class="code" href="classPilotDatabase.html#14470b7fcd6e6ecc6b1349709f122533" title="Returns a QValueList of all record ids in the database.">idList</a>();
<a name="l00322"></a>00322 
<a name="l00323"></a>00323     <span class="comment">/* Note:</span>
<a name="l00324"></a>00324 <span class="comment">       if eCopyPCToHH or eCopyHHToPC, first sync everything, then lookup</span>
<a name="l00325"></a>00325 <span class="comment">       those entries on the receiving side that are not yet syncced and delete</span>
<a name="l00326"></a>00326 <span class="comment">       them. Use slotDeleteUnsyncedPCRecords and slotDeleteUnsyncedHHRecords</span>
<a name="l00327"></a>00327 <span class="comment">       for this, and no longer purge the whole addressbook before the sync to</span>
<a name="l00328"></a>00328 <span class="comment">       prevent data loss in case of connection loss. */</span>
<a name="l00329"></a>00329 
<a name="l00330"></a>00330     QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(slotPalmRecToPC()));
<a name="l00331"></a>00331 
<a name="l00332"></a>00332     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00333"></a>00333 }
<a name="l00334"></a>00334 
<a name="l00335"></a>00335 
<a name="l00336"></a>00336 
<a name="l00337"></a>00337 <span class="keywordtype">void</span> RecordConduit::slotPalmRecToPC()
<a name="l00338"></a>00338 {
<a name="l00339"></a>00339     FUNCTIONSETUP;
<a name="l00340"></a>00340     <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *palmRec = 0L, *backupRec = 0L;
<a name="l00341"></a>00341 
<a name="l00342"></a>00342     <span class="keywordflow">if</span> ( getSyncDirection() == SyncAction::eCopyPCToHH )
<a name="l00343"></a>00343     {
<a name="l00344"></a>00344         mPCIter = mPCData-&gt;begin();
<a name="l00345"></a>00345         QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(slotPCRecToPalm()));
<a name="l00346"></a>00346         <span class="keywordflow">return</span>;
<a name="l00347"></a>00347     }
<a name="l00348"></a>00348 
<a name="l00349"></a>00349     <span class="keywordflow">if</span> ( <a class="code" href="classConduitAction.html#4eeba6c5c267e44874481697dc953e51" title="A full sync happens for eFullSync, eCopyPCToHH and eCopyHHToPC.">isFullSync</a>() )
<a name="l00350"></a>00350         palmRec = fDatabase-&gt;<a class="code" href="classPilotDatabase.html#eaadc91b9377769c34527474812ed49f" title="Reads a record from database, returns the record length.">readRecordByIndex</a>( mPalmIndex++ );
<a name="l00351"></a>00351     <span class="keywordflow">else</span>
<a name="l00352"></a>00352         palmRec = dynamic_cast &lt;<a class="code" href="classPilotSerialDatabase.html" title="PilotSerialDatabase represents databases stored on the handheld and accessed through...">PilotSerialDatabase</a> * &gt;(fDatabase)-&gt;readNextModifiedRec();
<a name="l00353"></a>00353 
<a name="l00354"></a>00354     <span class="keywordflow">if</span> ( !palmRec )
<a name="l00355"></a>00355     {
<a name="l00356"></a>00356         mPCIter = mPCData-&gt;begin();
<a name="l00357"></a>00357         QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotPCRecToPalm() ) );
<a name="l00358"></a>00358         <span class="keywordflow">return</span>;
<a name="l00359"></a>00359     }
<a name="l00360"></a>00360 
<a name="l00361"></a>00361     <span class="comment">// already synced, so skip:</span>
<a name="l00362"></a>00362     <span class="keywordflow">if</span> ( mSyncedIds.contains( palmRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() ) )
<a name="l00363"></a>00363     {
<a name="l00364"></a>00364         KPILOT_DELETE( palmRec );
<a name="l00365"></a>00365         QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotPalmRecToPC() ) );
<a name="l00366"></a>00366         <span class="keywordflow">return</span>;
<a name="l00367"></a>00367     }
<a name="l00368"></a>00368 
<a name="l00369"></a>00369     backupRec = fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#4de980c912281991628b51f10c3afa52" title="Reads a record from database by id, returns record length.">readRecordById</a>( palmRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() );
<a name="l00370"></a>00370     <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *compareRec = backupRec ? backupRec : palmRec;
<a name="l00371"></a>00371     PilotAppCategory *compareEntry = createPalmEntry( compareRec );
<a name="l00372"></a>00372     PCEntry *pcEntry = findMatch( compareEntry );
<a name="l00373"></a>00373     KPILOT_DELETE( compareEntry );
<a name="l00374"></a>00374 
<a name="l00375"></a>00375     PilotAppCategory *backupEntry=0L;
<a name="l00376"></a>00376     <span class="keywordflow">if</span> ( backupRec )
<a name="l00377"></a>00377         backupEntry = createPalmEntry( backupRec );
<a name="l00378"></a>00378     PilotAppCategory *palmEntry=0L;
<a name="l00379"></a>00379     <span class="keywordflow">if</span> ( palmRec )
<a name="l00380"></a>00380         palmEntry = createPalmEntry( palmRec );
<a name="l00381"></a>00381 
<a name="l00382"></a>00382     syncEntry( pcEntry, backupEntry, palmEntry );
<a name="l00383"></a>00383 
<a name="l00384"></a>00384     mSyncedIds.append( palmRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() );
<a name="l00385"></a>00385 
<a name="l00386"></a>00386     KPILOT_DELETE( pcEntry );
<a name="l00387"></a>00387     KPILOT_DELETE( palmEntry );
<a name="l00388"></a>00388     KPILOT_DELETE( backupEntry );
<a name="l00389"></a>00389     KPILOT_DELETE( palmRec );
<a name="l00390"></a>00390     KPILOT_DELETE( backupRec );
<a name="l00391"></a>00391 
<a name="l00392"></a>00392     QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(slotPalmRecToPC()));
<a name="l00393"></a>00393 }
<a name="l00394"></a>00394 
<a name="l00395"></a>00395 
<a name="l00396"></a>00396 
<a name="l00397"></a>00397 <span class="keywordtype">void</span> RecordConduit::slotPCRecToPalm()
<a name="l00398"></a>00398 {
<a name="l00399"></a>00399     FUNCTIONSETUP;
<a name="l00400"></a>00400 
<a name="l00401"></a>00401     <span class="keywordflow">if</span> ( ( getSyncDirection()==SyncAction::eCopyHHToPC ) ||
<a name="l00402"></a>00402         mPCData-&gt;atEnd( mPCIter ) )
<a name="l00403"></a>00403     {
<a name="l00404"></a>00404         mPalmIndex = 0;
<a name="l00405"></a>00405         QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotDeletedRecord() ) );
<a name="l00406"></a>00406         <span class="keywordflow">return</span>;
<a name="l00407"></a>00407     }
<a name="l00408"></a>00408 
<a name="l00409"></a>00409     <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *backupRec=0L;
<a name="l00410"></a>00410     PCEntry *pcEntry = *mPCIter;
<a name="l00411"></a>00411     ++mPCIter;
<a name="l00412"></a>00412 
<a name="l00413"></a>00413     <span class="comment">// If marked as archived, don't sync!</span>
<a name="l00414"></a>00414     <span class="keywordflow">if</span> ( isArchived( pcEntry ) )
<a name="l00415"></a>00415     {
<a name="l00416"></a>00416 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00417"></a>00417 <span class="preprocessor"></span>        DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": address with id "</span> &lt;&lt; pcEntry-&gt;uid() &lt;&lt;
<a name="l00418"></a>00418             <span class="stringliteral">" marked archived, so don't sync."</span> &lt;&lt; endl;
<a name="l00419"></a>00419 <span class="preprocessor">#endif</span>
<a name="l00420"></a>00420 <span class="preprocessor"></span>        KPILOT_DELETE( pcEntry );
<a name="l00421"></a>00421         QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotPCRecToPalm() ) );
<a name="l00422"></a>00422         <span class="keywordflow">return</span>;
<a name="l00423"></a>00423     }
<a name="l00424"></a>00424 
<a name="l00425"></a>00425     recordid_t recID( pcEntry-&gt;recid() );
<a name="l00426"></a>00426     <span class="keywordflow">if</span> ( recID == 0 )
<a name="l00427"></a>00427     {
<a name="l00428"></a>00428         <span class="comment">// it's a new item(no record ID and not inserted by the Palm -&gt; PC sync), so add it</span>
<a name="l00429"></a>00429         syncEntry( pcEntry, 0L, 0L );
<a name="l00430"></a>00430         KPILOT_DELETE( pcEntry );
<a name="l00431"></a>00431         QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotPCRecToPalm() ) );
<a name="l00432"></a>00432         <span class="keywordflow">return</span>;
<a name="l00433"></a>00433     }
<a name="l00434"></a>00434 
<a name="l00435"></a>00435     <span class="comment">// look into the list of already synced record ids to see if the PCEntry hasn't already been synced</span>
<a name="l00436"></a>00436     <span class="keywordflow">if</span> ( mSyncedIds.contains( recID ) )
<a name="l00437"></a>00437     {
<a name="l00438"></a>00438 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00439"></a>00439 <span class="preprocessor"></span>        DEBUGKPILOT &lt;&lt; <span class="stringliteral">": address with id "</span> &lt;&lt; recID &lt;&lt; <span class="stringliteral">" already synced."</span> &lt;&lt; endl;
<a name="l00440"></a>00440 <span class="preprocessor">#endif</span>
<a name="l00441"></a>00441 <span class="preprocessor"></span>        KPILOT_DELETE( pcEntry );
<a name="l00442"></a>00442         QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotPCRecToPalm() ) );
<a name="l00443"></a>00443         <span class="keywordflow">return</span>;
<a name="l00444"></a>00444     }
<a name="l00445"></a>00445 
<a name="l00446"></a>00446 
<a name="l00447"></a>00447     backupRec = fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#4de980c912281991628b51f10c3afa52" title="Reads a record from database by id, returns record length.">readRecordById</a>( recID );
<a name="l00448"></a>00448     <span class="comment">// only update if no backup record or the backup record is not equal to the PCEntry</span>
<a name="l00449"></a>00449 
<a name="l00450"></a>00450     PilotAppCategory*backupEntry=0L;
<a name="l00451"></a>00451     <span class="keywordflow">if</span> ( backupRec )
<a name="l00452"></a>00452         backupEntry = createPalmEntry( backupRec );
<a name="l00453"></a>00453     <span class="keywordflow">if</span>( !backupRec || <a class="code" href="classConduitAction.html#d20a164b45e1f71ba6875246f53e5d4a" title="A first sync (i.e.">isFirstSync</a>() || !_equal( backupEntry, pcEntry ) )
<a name="l00454"></a>00454     {
<a name="l00455"></a>00455         <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *palmRec = fDatabase-&gt;<a class="code" href="classPilotDatabase.html#4de980c912281991628b51f10c3afa52" title="Reads a record from database by id, returns record length.">readRecordById</a>( recID );
<a name="l00456"></a>00456         PilotAppCategory *palmEntry=0L;
<a name="l00457"></a>00457         <span class="keywordflow">if</span> (palmRec)
<a name="l00458"></a>00458             palmEntry = createPalmEntry( palmRec );
<a name="l00459"></a>00459         syncEntry( pcEntry, backupEntry, palmEntry );
<a name="l00460"></a>00460         <span class="comment">// update the id just in case it changed</span>
<a name="l00461"></a>00461         <span class="keywordflow">if</span> ( palmRec )
<a name="l00462"></a>00462             recID = palmRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>();
<a name="l00463"></a>00463         KPILOT_DELETE( palmRec );
<a name="l00464"></a>00464         KPILOT_DELETE( palmEntry );
<a name="l00465"></a>00465     }
<a name="l00466"></a>00466 
<a name="l00467"></a>00467     KPILOT_DELETE( pcEntry );
<a name="l00468"></a>00468     KPILOT_DELETE( backupEntry );
<a name="l00469"></a>00469     KPILOT_DELETE( backupRec );
<a name="l00470"></a>00470     mSyncedIds.append( recID );
<a name="l00471"></a>00471 
<a name="l00472"></a>00472     <span class="comment">// done with the sync process, go on with the next one:</span>
<a name="l00473"></a>00473     QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotPCRecToPalm() ) );
<a name="l00474"></a>00474 }
<a name="l00475"></a>00475 
<a name="l00476"></a>00476 
<a name="l00477"></a>00477 
<a name="l00478"></a>00478 <span class="keywordtype">void</span> RecordConduit::slotDeletedRecord()
<a name="l00479"></a>00479 {
<a name="l00480"></a>00480     FUNCTIONSETUP;
<a name="l00481"></a>00481 
<a name="l00482"></a>00482     <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *backupRec = fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#eaadc91b9377769c34527474812ed49f" title="Reads a record from database, returns the record length.">readRecordByIndex</a>( mPalmIndex++ );
<a name="l00483"></a>00483     <span class="keywordflow">if</span>( !backupRec || <a class="code" href="classConduitAction.html#d20a164b45e1f71ba6875246f53e5d4a" title="A first sync (i.e.">isFirstSync</a>() )
<a name="l00484"></a>00484     {
<a name="l00485"></a>00485         KPILOT_DELETE(backupRec);
<a name="l00486"></a>00486         QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotDeleteUnsyncedPCRecords() ) );
<a name="l00487"></a>00487         <span class="keywordflow">return</span>;
<a name="l00488"></a>00488     }
<a name="l00489"></a>00489 
<a name="l00490"></a>00490     <span class="comment">// already synced, so skip this record:</span>
<a name="l00491"></a>00491     <span class="keywordflow">if</span> ( mSyncedIds.contains( backupRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() ) )
<a name="l00492"></a>00492     {
<a name="l00493"></a>00493         KPILOT_DELETE( backupRec );
<a name="l00494"></a>00494         QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotDeletedRecord() ) );
<a name="l00495"></a>00495         <span class="keywordflow">return</span>;
<a name="l00496"></a>00496     }
<a name="l00497"></a>00497 
<a name="l00498"></a>00498     QString uid = mEntryMap[ backupRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() ];
<a name="l00499"></a>00499     PCEntry *pcEntry = mPCData-&gt;findByUid( uid );
<a name="l00500"></a>00500     <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *palmRec = fDatabase-&gt;<a class="code" href="classPilotDatabase.html#4de980c912281991628b51f10c3afa52" title="Reads a record from database by id, returns record length.">readRecordById</a>( backupRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() );
<a name="l00501"></a>00501     PilotAppCategory *backupEntry = 0L;
<a name="l00502"></a>00502     <span class="keywordflow">if</span> (backupRec)
<a name="l00503"></a>00503         backupEntry = createPalmEntry( backupRec );
<a name="l00504"></a>00504     PilotAppCategory*palmEntry=0L;
<a name="l00505"></a>00505     <span class="keywordflow">if</span> (palmRec)
<a name="l00506"></a>00506         palmEntry = createPalmEntry( palmRec );
<a name="l00507"></a>00507 
<a name="l00508"></a>00508     mSyncedIds.append( backupRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() );
<a name="l00509"></a>00509     syncEntry( pcEntry, backupEntry, palmEntry );
<a name="l00510"></a>00510 
<a name="l00511"></a>00511     KPILOT_DELETE( pcEntry );
<a name="l00512"></a>00512     KPILOT_DELETE( palmEntry );
<a name="l00513"></a>00513     KPILOT_DELETE( backupEntry );
<a name="l00514"></a>00514     KPILOT_DELETE( palmRec );
<a name="l00515"></a>00515     KPILOT_DELETE( backupRec );
<a name="l00516"></a>00516     QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotDeletedRecord() ) );
<a name="l00517"></a>00517 }
<a name="l00518"></a>00518 
<a name="l00519"></a>00519 
<a name="l00520"></a>00520 
<a name="l00521"></a>00521 <span class="keywordtype">void</span> RecordConduit::slotDeleteUnsyncedPCRecords()
<a name="l00522"></a>00522 {
<a name="l00523"></a>00523     FUNCTIONSETUP;
<a name="l00524"></a>00524     <span class="keywordflow">if</span> ( getSyncDirection() == SyncAction::eCopyHHToPC )
<a name="l00525"></a>00525     {
<a name="l00526"></a>00526         QStringList uids;
<a name="l00527"></a>00527         RecordIDList::iterator it;
<a name="l00528"></a>00528         QString uid;
<a name="l00529"></a>00529         <span class="keywordflow">for</span> ( it = mSyncedIds.begin(); it != mSyncedIds.end(); ++it)
<a name="l00530"></a>00530         {
<a name="l00531"></a>00531             uid = mEntryMap[ *it ];
<a name="l00532"></a>00532             <span class="keywordflow">if</span> ( !uid.isEmpty() ) uids.append( uid );
<a name="l00533"></a>00533         }
<a name="l00534"></a>00534         <span class="comment">// TODO: Does this speed up anything?</span>
<a name="l00535"></a>00535         <span class="comment">// qHeapSort( uids );</span>
<a name="l00536"></a>00536         <span class="keyword">const</span> QStringList alluids( mPCData-&gt;uids() );
<a name="l00537"></a>00537         QStringList::ConstIterator uidit;
<a name="l00538"></a>00538         <span class="keywordflow">for</span> ( uidit = alluids.constBegin(); uidit != alluids.constEnd(); ++uidit )
<a name="l00539"></a>00539         {
<a name="l00540"></a>00540             <span class="keywordflow">if</span> ( !uids.contains( *uidit ) )
<a name="l00541"></a>00541             {
<a name="l00542"></a>00542 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00543"></a>00543 <span class="preprocessor"></span>                DEBUGKPILOT &lt;&lt; <span class="stringliteral">"Deleting PCEntry with uid "</span> &lt;&lt; (*uidit) &lt;&lt; <span class="stringliteral">" from PC (is not on HH, and syncing with HH-&gt;PC direction)"</span> &lt;&lt; endl;
<a name="l00544"></a>00544 <span class="preprocessor">#endif</span>
<a name="l00545"></a>00545 <span class="preprocessor"></span>                mPCData-&gt;removeEntry( *uidit );
<a name="l00546"></a>00546             }
<a name="l00547"></a>00547         }
<a name="l00548"></a>00548     }
<a name="l00549"></a>00549     QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(slotDeleteUnsyncedHHRecords()));
<a name="l00550"></a>00550 }
<a name="l00551"></a>00551 
<a name="l00552"></a>00552 
<a name="l00553"></a>00553 
<a name="l00554"></a>00554 <span class="keywordtype">void</span> RecordConduit::slotDeleteUnsyncedHHRecords()
<a name="l00555"></a>00555 {
<a name="l00556"></a>00556     FUNCTIONSETUP;
<a name="l00557"></a>00557     <span class="keywordflow">if</span> ( getSyncDirection() == SyncAction::eCopyPCToHH )
<a name="l00558"></a>00558     {
<a name="l00559"></a>00559         RecordIDList ids = fDatabase-&gt;<a class="code" href="classPilotDatabase.html#14470b7fcd6e6ecc6b1349709f122533" title="Returns a QValueList of all record ids in the database.">idList</a>();
<a name="l00560"></a>00560         RecordIDList::iterator it;
<a name="l00561"></a>00561         <span class="keywordflow">for</span> ( it = ids.begin(); it != ids.end(); ++it )
<a name="l00562"></a>00562         {
<a name="l00563"></a>00563             <span class="keywordflow">if</span> ( !mSyncedIds.contains(*it) )
<a name="l00564"></a>00564             {
<a name="l00565"></a>00565 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00566"></a>00566 <span class="preprocessor"></span>                DEBUGKPILOT &lt;&lt; <span class="stringliteral">"Deleting record with ID "</span> &lt;&lt; *it &lt;&lt; <span class="stringliteral">" from handheld (is not on PC, and syncing with PC-&gt;HH direction)"</span> &lt;&lt; endl;
<a name="l00567"></a>00567 <span class="preprocessor">#endif</span>
<a name="l00568"></a>00568 <span class="preprocessor"></span>                fDatabase-&gt;<a class="code" href="classPilotDatabase.html#e7e2e329de660b00b202af22e7e6f992" title="Deletes a record with the given recordid_t from the database, or all records, if...">deleteRecord</a>(*it);
<a name="l00569"></a>00569                 fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#e7e2e329de660b00b202af22e7e6f992" title="Deletes a record with the given recordid_t from the database, or all records, if...">deleteRecord</a>(*it);
<a name="l00570"></a>00570             }
<a name="l00571"></a>00571         }
<a name="l00572"></a>00572     }
<a name="l00573"></a>00573     QTimer::singleShot( 0, <span class="keyword">this</span>, SLOT( slotCleanup() ) );
<a name="l00574"></a>00574 }
<a name="l00575"></a>00575 
<a name="l00576"></a>00576 
<a name="l00577"></a>00577 <span class="keywordtype">void</span> RecordConduit::slotCleanup()
<a name="l00578"></a>00578 {
<a name="l00579"></a>00579     FUNCTIONSETUP;
<a name="l00580"></a>00580 
<a name="l00581"></a>00581     <span class="comment">// Set the appInfoBlock, just in case the category labels changed</span>
<a name="l00582"></a>00582     _setAppInfo();
<a name="l00583"></a>00583     doPostSync();
<a name="l00584"></a>00584     <span class="keywordflow">if</span>(fDatabase)
<a name="l00585"></a>00585     {
<a name="l00586"></a>00586         fDatabase-&gt;<a class="code" href="classPilotDatabase.html#9543bcac4220b5356bcd238435b3c68a" title="Resets all records in the database to not dirty.">resetSyncFlags</a>();
<a name="l00587"></a>00587         fDatabase-&gt;<a class="code" href="classPilotDatabase.html#cb57840cbb710cb4788296b0a938e0cf" title="Purges all Archived/Deleted records from Palm Pilot database.">cleanup</a>();
<a name="l00588"></a>00588     }
<a name="l00589"></a>00589     <span class="keywordflow">if</span>(fLocalDatabase)
<a name="l00590"></a>00590     {
<a name="l00591"></a>00591         fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#9543bcac4220b5356bcd238435b3c68a" title="Resets all records in the database to not dirty.">resetSyncFlags</a>();
<a name="l00592"></a>00592         fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#cb57840cbb710cb4788296b0a938e0cf" title="Purges all Archived/Deleted records from Palm Pilot database.">cleanup</a>();
<a name="l00593"></a>00593     }
<a name="l00594"></a>00594     KPILOT_DELETE( fDatabase );
<a name="l00595"></a>00595     KPILOT_DELETE( fLocalDatabase );
<a name="l00596"></a>00596     <span class="comment">// TODO: do something if saving fails!</span>
<a name="l00597"></a>00597     mPCData-&gt;saveData();
<a name="l00598"></a>00598     mPCData-&gt;cleanup();
<a name="l00599"></a>00599     emit syncDone(<span class="keyword">this</span>);
<a name="l00600"></a>00600 }
<a name="l00601"></a>00601 
<a name="l00602"></a>00602 
<a name="l00605"></a>00605 <span class="keyword">const</span> QStringList RecordConduit::categories()<span class="keyword"> const</span>
<a name="l00606"></a>00606 <span class="keyword"></span>{
<a name="l00607"></a>00607     QStringList cats;
<a name="l00608"></a>00608     <span class="keywordflow">for</span> ( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> j = 0; j &lt; <a class="code" href="namespacePilot.html#9a9cc19ceb012416519a533ec4829a44" title="Maximum number of categories the handheld has.">Pilot::CATEGORY_COUNT</a>; j++ ) {
<a name="l00609"></a>00609         QString catName( category( j ) );
<a name="l00610"></a>00610         <span class="keywordflow">if</span> ( !catName.isEmpty() ) cats &lt;&lt; catName;
<a name="l00611"></a>00611     }
<a name="l00612"></a>00612     <span class="keywordflow">return</span> cats;
<a name="l00613"></a>00613 }
<a name="l00614"></a>00614 <span class="keywordtype">int</span> RecordConduit::findFlags()<span class="keyword"> const</span>
<a name="l00615"></a>00615 <span class="keyword"></span>{
<a name="l00616"></a>00616     <span class="keywordflow">return</span> eqFlagsAlmostAll;
<a name="l00617"></a>00617 }
<a name="l00618"></a>00618 
<a name="l00619"></a>00619 
<a name="l00620"></a>00620 <span class="keywordtype">bool</span> RecordConduit::isDeleted( <span class="keyword">const</span> PilotAppCategory *palmEntry )
<a name="l00621"></a>00621 {
<a name="l00622"></a>00622     <span class="keywordflow">if</span> ( !palmEntry )
<a name="l00623"></a>00623         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00624"></a>00624     <span class="keywordflow">if</span> ( palmEntry-&gt;isDeleted() &amp;&amp; !palmEntry-&gt;isArchived() )
<a name="l00625"></a>00625         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00626"></a>00626     <span class="keywordflow">if</span> ( palmEntry-&gt;isArchived() )
<a name="l00627"></a>00627         <span class="keywordflow">return</span> !archiveDeleted();
<a name="l00628"></a>00628     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00629"></a>00629 }
<a name="l00630"></a>00630 <span class="keywordtype">bool</span> RecordConduit::isArchived( <span class="keyword">const</span> PilotAppCategory *palmEntry )
<a name="l00631"></a>00631 {
<a name="l00632"></a>00632     <span class="keywordflow">if</span> ( palmEntry &amp;&amp; palmEntry-&gt;isArchived() )
<a name="l00633"></a>00633         <span class="keywordflow">return</span> archiveDeleted();
<a name="l00634"></a>00634     <span class="keywordflow">else</span>
<a name="l00635"></a>00635         <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00636"></a>00636 }
<a name="l00637"></a>00637 
<a name="l00638"></a>00638 
<a name="l00639"></a>00639 
<a name="l00640"></a>00640 
<a name="l00641"></a>00641 <span class="comment">/*********************************************************************</span>
<a name="l00642"></a>00642 <span class="comment">                L O A D I N G   T H E   D A T A</span>
<a name="l00643"></a>00643 <span class="comment"> *********************************************************************/</span>
<a name="l00644"></a>00644 
<a name="l00645"></a>00645 
<a name="l00646"></a>00646 
<a name="l00647"></a>00647 <span class="keywordtype">bool</span> RecordConduit::_prepare()
<a name="l00648"></a>00648 {
<a name="l00649"></a>00649     FUNCTIONSETUP;
<a name="l00650"></a>00650 
<a name="l00651"></a>00651     readConfig();
<a name="l00652"></a>00652     mSyncedIds.clear();
<a name="l00653"></a>00653     mPCData = initializePCData();
<a name="l00654"></a>00654 
<a name="l00655"></a>00655     <span class="keywordflow">return</span> mPCData &amp;&amp; doPrepare();
<a name="l00656"></a>00656 }
<a name="l00657"></a>00657 
<a name="l00658"></a>00658 
<a name="l00659"></a>00659 <span class="keywordtype">void</span> RecordConduit::_getAppInfo()
<a name="l00660"></a>00660 {
<a name="l00661"></a>00661     FUNCTIONSETUP;
<a name="l00662"></a>00662     <span class="comment">// get the address application header information</span>
<a name="l00663"></a>00663     <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buffer = <span class="keyword">new</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span>[<a class="code" href="namespacePilot.html#8f4195399f8299777272c29eff80ffbc" title="Maximum size of an AppInfo block, taken roughly from the pilot-link source.">Pilot::MAX_APPINFO_SIZE</a>];
<a name="l00664"></a>00664     <span class="keywordtype">int</span> appLen=fDatabase-&gt;<a class="code" href="classPilotDatabase.html#8c8ba52882f589437a7b3f7d016bdc1b" title="Reads the application block info, returns size.">readAppBlock</a>(buffer, <a class="code" href="namespacePilot.html#8f4195399f8299777272c29eff80ffbc" title="Maximum size of an AppInfo block, taken roughly from the pilot-link source.">Pilot::MAX_APPINFO_SIZE</a>);
<a name="l00665"></a>00665 
<a name="l00666"></a>00666     doUnpackAppInfo( buffer, appLen );
<a name="l00667"></a>00667     <span class="keyword">delete</span>[] buffer;
<a name="l00668"></a>00668     buffer = 0;
<a name="l00669"></a>00669 }
<a name="l00670"></a>00670 
<a name="l00671"></a>00671 <span class="keywordtype">void</span> RecordConduit::_setAppInfo()
<a name="l00672"></a>00672 {
<a name="l00673"></a>00673     FUNCTIONSETUP;
<a name="l00674"></a>00674     <span class="comment">// get the address application header information</span>
<a name="l00675"></a>00675     <span class="keywordtype">int</span> appLen = 0;
<a name="l00676"></a>00676     <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buffer = doPackAppInfo( &amp;appLen );
<a name="l00677"></a>00677     <span class="keywordflow">if</span> ( buffer )
<a name="l00678"></a>00678     {   <span class="keywordflow">if</span> (fDatabase)
<a name="l00679"></a>00679             fDatabase-&gt;<a class="code" href="classPilotDatabase.html#1404eedc672242ed7e9760abf40419b2" title="Writes the application block info.">writeAppBlock</a>( buffer, appLen );
<a name="l00680"></a>00680         <span class="keywordflow">if</span> (fLocalDatabase)
<a name="l00681"></a>00681             fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#1404eedc672242ed7e9760abf40419b2" title="Writes the application block info.">writeAppBlock</a>( buffer, appLen );
<a name="l00682"></a>00682         <span class="keyword">delete</span>[] buffer;
<a name="l00683"></a>00683     }
<a name="l00684"></a>00684 }
<a name="l00685"></a>00685 
<a name="l00686"></a>00686 
<a name="l00687"></a>00687 <span class="keywordtype">int</span> RecordConduit::compareStr( <span class="keyword">const</span> QString &amp; str1, <span class="keyword">const</span> QString &amp; str2 )
<a name="l00688"></a>00688 {
<a name="l00689"></a>00689 <span class="comment">//  FUNCTIONSETUP;</span>
<a name="l00690"></a>00690     <span class="keywordflow">if</span> ( str1.isEmpty() &amp;&amp; str2.isEmpty() )
<a name="l00691"></a>00691         <span class="keywordflow">return</span> 0;
<a name="l00692"></a>00692     <span class="keywordflow">else</span>
<a name="l00693"></a>00693         <span class="keywordflow">return</span> str1.compare( str2 );
<a name="l00694"></a>00694 }
<a name="l00695"></a>00695 
<a name="l00696"></a>00696 
<a name="l00704"></a>00704 QString RecordConduit::getCatForHH( <span class="keyword">const</span> QStringList cats, <span class="keyword">const</span> QString curr )<span class="keyword"> const</span>
<a name="l00705"></a>00705 <span class="keyword"></span>{
<a name="l00706"></a>00706     FUNCTIONSETUP;
<a name="l00707"></a>00707     <span class="keywordflow">if</span> ( cats.size() &lt; 1 )
<a name="l00708"></a>00708         <span class="keywordflow">return</span> QString::null;
<a name="l00709"></a>00709     <span class="keywordflow">if</span> ( cats.contains( curr ) )
<a name="l00710"></a>00710         <span class="keywordflow">return</span> curr;
<a name="l00711"></a>00711     <span class="keywordflow">for</span> ( QStringList::ConstIterator it = cats.begin(); it != cats.end(); ++it)
<a name="l00712"></a>00712     {
<a name="l00713"></a>00713         <span class="keywordflow">for</span> ( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> j = 0; j &lt; Pilot::CATEGORY_COUNT; j++ )
<a name="l00714"></a>00714         {
<a name="l00715"></a>00715             QString catnm( category( j ) );
<a name="l00716"></a>00716             <span class="keywordflow">if</span> ( !(*it).isEmpty() &amp;&amp; ( (*it)==catnm ) )
<a name="l00717"></a>00717             {
<a name="l00718"></a>00718                 <span class="keywordflow">return</span> catnm;
<a name="l00719"></a>00719             }
<a name="l00720"></a>00720         }
<a name="l00721"></a>00721     }
<a name="l00722"></a>00722     <span class="comment">// If we have a free label, return the first possible cat</span>
<a name="l00723"></a>00723     QString lastCat( category( Pilot::CATEGORY_COUNT-1 ) );
<a name="l00724"></a>00724     <span class="keywordflow">return</span> ( lastCat.isEmpty() ) ? ( cats.first() ) : ( QString::null );
<a name="l00725"></a>00725 }
<a name="l00726"></a>00726 
<a name="l00727"></a>00727 <span class="keywordtype">void</span> RecordConduit::setCategory(PCEntry * pcEntry, QString cat)
<a name="l00728"></a>00728 {
<a name="l00729"></a>00729     <span class="keywordflow">if</span> ( !cat.isEmpty() &amp;&amp; cat!=category( 0 ) )
<a name="l00730"></a>00730         pcEntry-&gt;insertCategory(cat);
<a name="l00731"></a>00731 }
<a name="l00732"></a>00732 
<a name="l00733"></a>00733 
<a name="l00734"></a>00734 
<a name="l00735"></a>00735 
<a name="l00736"></a>00736 
<a name="l00737"></a>00737 
<a name="l00738"></a>00738 <span class="comment">/*********************************************************************</span>
<a name="l00739"></a>00739 <span class="comment">              G E N E R A L   S Y N C   F U N C T I O N</span>
<a name="l00740"></a>00740 <span class="comment">         These functions modify the Handheld and the addressbook</span>
<a name="l00741"></a>00741 <span class="comment"> *********************************************************************/</span>
<a name="l00742"></a>00742 
<a name="l00743"></a>00743 
<a name="l00744"></a>00744 
<a name="l00745"></a>00745 <span class="keywordtype">bool</span> RecordConduit::syncEntry( PCEntry *pcEntry, PilotAppCategory*backupEntry,
<a name="l00746"></a>00746     PilotAppCategory*palmEntry)
<a name="l00747"></a>00747 {
<a name="l00748"></a>00748     FUNCTIONSETUP;
<a name="l00749"></a>00749 
<a name="l00750"></a>00750     <span class="keywordflow">if</span> ( getSyncDirection() == SyncAction::eCopyPCToHH )
<a name="l00751"></a>00751     {
<a name="l00752"></a>00752         <span class="keywordflow">if</span> ( pcEntry-&gt;isEmpty() )
<a name="l00753"></a>00753         {
<a name="l00754"></a>00754             <span class="keywordflow">return</span> pcDeleteEntry( pcEntry, backupEntry, palmEntry );
<a name="l00755"></a>00755         }
<a name="l00756"></a>00756         <span class="keywordflow">else</span>
<a name="l00757"></a>00757         {
<a name="l00758"></a>00758             <span class="keywordflow">return</span> pcCopyToPalm( pcEntry, backupEntry, palmEntry );
<a name="l00759"></a>00759         }
<a name="l00760"></a>00760     }
<a name="l00761"></a>00761 
<a name="l00762"></a>00762     <span class="keywordflow">if</span> ( getSyncDirection() == SyncAction::eCopyHHToPC )
<a name="l00763"></a>00763     {
<a name="l00764"></a>00764         <span class="keywordflow">if</span> (!palmEntry)
<a name="l00765"></a>00765             <span class="keywordflow">return</span> pcDeleteEntry(pcEntry, backupEntry, palmEntry);
<a name="l00766"></a>00766         <span class="keywordflow">else</span>
<a name="l00767"></a>00767             <span class="keywordflow">return</span> palmCopyToPC(pcEntry, backupEntry, palmEntry);
<a name="l00768"></a>00768     }
<a name="l00769"></a>00769 
<a name="l00770"></a>00770     <span class="keywordflow">if</span> ( !backupEntry || <a class="code" href="classConduitAction.html#d20a164b45e1f71ba6875246f53e5d4a" title="A first sync (i.e.">isFirstSync</a>() )
<a name="l00771"></a>00771     {
<a name="l00772"></a>00772         <span class="comment">/*</span>
<a name="l00773"></a>00773 <span class="comment">        Resolution matrix (0..does not exist, E..exists, D..deleted flag set, A..archived):</span>
<a name="l00774"></a>00774 <span class="comment">          HH    PC  | Resolution</span>
<a name="l00775"></a>00775 <span class="comment">          ------------------------------------------------------------</span>
<a name="l00776"></a>00776 <span class="comment">           0     A  |  -</span>
<a name="l00777"></a>00777 <span class="comment">           0     E  |  PC -&gt; HH, reset ID if not set correctly</span>
<a name="l00778"></a>00778 <span class="comment">           D     0  |  delete (error, should never occur!!!)</span>
<a name="l00779"></a>00779 <span class="comment">           D     E  |  CR (ERROR)</span>
<a name="l00780"></a>00780 <span class="comment">           E/A   0  |  HH -&gt; PC</span>
<a name="l00781"></a>00781 <span class="comment">           E/A   E/A|  merge/CR</span>
<a name="l00782"></a>00782 <span class="comment">         */</span>
<a name="l00783"></a>00783         <span class="keywordflow">if</span>  ( !palmEntry &amp;&amp; isArchived( pcEntry ) )
<a name="l00784"></a>00784         {
<a name="l00785"></a>00785             <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00786"></a>00786         }
<a name="l00787"></a>00787         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( !palmEntry &amp;&amp; !pcEntry-&gt;isEmpty() )
<a name="l00788"></a>00788         {
<a name="l00789"></a>00789             <span class="comment">// PC-&gt;HH</span>
<a name="l00790"></a>00790             <span class="keywordtype">bool</span> res = pcCopyToPalm( pcEntry, 0L, 0L );
<a name="l00791"></a>00791             <span class="keywordflow">return</span> res;
<a name="l00792"></a>00792         }
<a name="l00793"></a>00793         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( !palmEntry &amp;&amp; pcEntry-&gt;isEmpty() )
<a name="l00794"></a>00794         {
<a name="l00795"></a>00795             <span class="comment">// everything's empty -&gt; ERROR</span>
<a name="l00796"></a>00796             <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00797"></a>00797         }
<a name="l00798"></a>00798         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ( isDeleted( palmEntry ) || isArchived( palmEntry ) ) &amp;&amp; pcEntry-&gt;isEmpty())
<a name="l00799"></a>00799         {
<a name="l00800"></a>00800             <span class="keywordflow">if</span> ( isArchived( palmEntry ) )
<a name="l00801"></a>00801                 <span class="keywordflow">return</span> palmCopyToPC( pcEntry, 0L, palmEntry );
<a name="l00802"></a>00802             <span class="keywordflow">else</span>
<a name="l00803"></a>00803                 <span class="comment">// this happens if you add a record on the handheld and delete it again before you do the next sync</span>
<a name="l00804"></a>00804                 <span class="keywordflow">return</span> pcDeleteEntry( pcEntry, 0L, palmEntry );
<a name="l00805"></a>00805         }
<a name="l00806"></a>00806         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ( isDeleted(palmEntry) || isArchived( palmEntry ) ) &amp;&amp; !pcEntry-&gt;isEmpty() )
<a name="l00807"></a>00807         {
<a name="l00808"></a>00808             <span class="comment">// CR (ERROR)</span>
<a name="l00809"></a>00809             <span class="keywordflow">return</span> smartMergeEntry( pcEntry, 0L, palmEntry );
<a name="l00810"></a>00810         }
<a name="l00811"></a>00811         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( pcEntry-&gt;isEmpty() )
<a name="l00812"></a>00812         {
<a name="l00813"></a>00813             <span class="comment">// HH-&gt;PC</span>
<a name="l00814"></a>00814             <span class="keywordflow">return</span> palmCopyToPC( pcEntry, 0L, palmEntry );
<a name="l00815"></a>00815         }
<a name="l00816"></a>00816         <span class="keywordflow">else</span>
<a name="l00817"></a>00817         {
<a name="l00818"></a>00818             <span class="comment">// Conflict Resolution</span>
<a name="l00819"></a>00819             <span class="keywordflow">return</span> smartMergeEntry( pcEntry, 0L, palmEntry );
<a name="l00820"></a>00820         }
<a name="l00821"></a>00821     } <span class="comment">// !backupEntry</span>
<a name="l00822"></a>00822     <span class="keywordflow">else</span>
<a name="l00823"></a>00823     {
<a name="l00824"></a>00824         <span class="comment">/*</span>
<a name="l00825"></a>00825 <span class="comment">        Resolution matrix:</span>
<a name="l00826"></a>00826 <span class="comment">          1) if HH.(empty| (deleted &amp;! archived) ) -&gt; { if (PC==B) -&gt; delete, else -&gt; CR }</span>
<a name="l00827"></a>00827 <span class="comment">             if HH.archived -&gt; {if (PC==B) -&gt; copyToPC, else -&gt; CR }</span>
<a name="l00828"></a>00828 <span class="comment">             if PC.empty -&gt; { if (HH==B) -&gt; delete, else -&gt; CR }</span>
<a name="l00829"></a>00829 <span class="comment">             if PC.archived -&gt; {if (HH==B) -&gt; delete on HH, else CR }</span>
<a name="l00830"></a>00830 <span class="comment">          2) if PC==HH -&gt; { update B, update ID of PC if needed }</span>
<a name="l00831"></a>00831 <span class="comment">          3) if PC==B -&gt; { HH!=PC, thus HH modified, so copy HH-&gt;PC }</span>
<a name="l00832"></a>00832 <span class="comment">             if HH==B -&gt; { PC!=HH, thus PC modified, so copy PC-&gt;HH }</span>
<a name="l00833"></a>00833 <span class="comment">          4) else: all three PCEntrys are different -&gt; CR</span>
<a name="l00834"></a>00834 <span class="comment">        */</span>
<a name="l00835"></a>00835 
<a name="l00836"></a>00836         <span class="keywordflow">if</span> ( !palmEntry || isDeleted(palmEntry) )
<a name="l00837"></a>00837         {
<a name="l00838"></a>00838             <span class="keywordflow">if</span> ( _equal( backupEntry, pcEntry ) || pcEntry-&gt;isEmpty() )
<a name="l00839"></a>00839             {
<a name="l00840"></a>00840                 <span class="keywordflow">return</span> pcDeleteEntry( pcEntry, backupEntry, 0L );
<a name="l00841"></a>00841             }
<a name="l00842"></a>00842             <span class="keywordflow">else</span>
<a name="l00843"></a>00843             {
<a name="l00844"></a>00844                 <span class="keywordflow">return</span> smartMergeEntry( pcEntry, backupEntry, 0L );
<a name="l00845"></a>00845             }
<a name="l00846"></a>00846         }
<a name="l00847"></a>00847         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( pcEntry-&gt;isEmpty() )
<a name="l00848"></a>00848         {
<a name="l00849"></a>00849             <span class="keywordflow">if</span> (*palmEntry == *backupEntry)
<a name="l00850"></a>00850             {
<a name="l00851"></a>00851                 <span class="keywordflow">return</span> pcDeleteEntry( pcEntry, backupEntry, palmEntry );
<a name="l00852"></a>00852             }
<a name="l00853"></a>00853             <span class="keywordflow">else</span>
<a name="l00854"></a>00854             {
<a name="l00855"></a>00855                 <span class="keywordflow">return</span> smartMergeEntry( pcEntry, backupEntry, palmEntry );
<a name="l00856"></a>00856             }
<a name="l00857"></a>00857         }
<a name="l00858"></a>00858         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( _equal( palmEntry, pcEntry ) )
<a name="l00859"></a>00859         {
<a name="l00860"></a>00860             <span class="comment">// update Backup, update ID of PC if neededd</span>
<a name="l00861"></a>00861             <span class="keywordflow">return</span> backupSaveEntry( palmEntry );
<a name="l00862"></a>00862         }
<a name="l00863"></a>00863         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( _equal( backupEntry, pcEntry ) )
<a name="l00864"></a>00864         {
<a name="l00865"></a>00865 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00866"></a>00866 <span class="preprocessor"></span>            DEBUGKPILOT &lt;&lt; <span class="stringliteral">"Flags: "</span> &lt;&lt; palmEntry-&gt;getAttrib() &lt;&lt; <span class="stringliteral">", isDeleted="</span> &lt;&lt;
<a name="l00867"></a>00867                 isDeleted( palmEntry ) &lt;&lt; <span class="stringliteral">", isArchived="</span> &lt;&lt; isArchived( palmEntry )
<a name="l00868"></a>00868                 &lt;&lt; endl;
<a name="l00869"></a>00869 <span class="preprocessor">#endif</span>
<a name="l00870"></a>00870 <span class="preprocessor"></span>            <span class="keywordflow">if</span> ( isDeleted( palmEntry ) )
<a name="l00871"></a>00871             {
<a name="l00872"></a>00872                 <span class="keywordflow">return</span> pcDeleteEntry( pcEntry, backupEntry, palmEntry );
<a name="l00873"></a>00873             }
<a name="l00874"></a>00874             <span class="keywordflow">else</span>
<a name="l00875"></a>00875             {
<a name="l00876"></a>00876                 <span class="keywordflow">return</span> palmCopyToPC( pcEntry, backupEntry, palmEntry );
<a name="l00877"></a>00877             }
<a name="l00878"></a>00878         }
<a name="l00879"></a>00879         <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( *palmEntry == *backupEntry )
<a name="l00880"></a>00880         {
<a name="l00881"></a>00881             <span class="keywordflow">return</span> pcCopyToPalm( pcEntry, backupEntry, palmEntry );
<a name="l00882"></a>00882         }
<a name="l00883"></a>00883         <span class="keywordflow">else</span>
<a name="l00884"></a>00884         {
<a name="l00885"></a>00885             <span class="comment">// CR, since all are different</span>
<a name="l00886"></a>00886             <span class="keywordflow">return</span> smartMergeEntry( pcEntry, backupEntry, palmEntry );
<a name="l00887"></a>00887         }
<a name="l00888"></a>00888     } <span class="comment">// backupEntry</span>
<a name="l00889"></a>00889     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00890"></a>00890 }
<a name="l00891"></a>00891 
<a name="l00892"></a>00892 <span class="keywordtype">bool</span> RecordConduit::pcCopyToPalm( PCEntry *pcEntry, PilotAppCategory *backupEntry,
<a name="l00893"></a>00893         PilotAppCategory*palmEntry )
<a name="l00894"></a>00894 {
<a name="l00895"></a>00895     FUNCTIONSETUP;
<a name="l00896"></a>00896 
<a name="l00897"></a>00897     <span class="keywordflow">if</span> ( pcEntry-&gt;isEmpty() ) <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00898"></a>00898     PilotAppCategory *hhEntry = palmEntry;
<a name="l00899"></a>00899     <span class="keywordtype">bool</span> hhEntryCreated = <span class="keyword">false</span>;
<a name="l00900"></a>00900     <span class="keywordflow">if</span> ( !hhEntry )
<a name="l00901"></a>00901     {
<a name="l00902"></a>00902         hhEntry = createPalmEntry( 0 );
<a name="l00903"></a>00903         hhEntryCreated=<span class="keyword">true</span>;
<a name="l00904"></a>00904     }
<a name="l00905"></a>00905     _copy( hhEntry, pcEntry );
<a name="l00906"></a>00906 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00907"></a>00907 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; <span class="stringliteral">"palmEntry-&gt;id="</span> &lt;&lt; hhEntry-&gt;id() &lt;&lt; <span class="stringliteral">", pcEntry.ID="</span> &lt;&lt;
<a name="l00908"></a>00908         pcEntry-&gt;uid() &lt;&lt; endl;
<a name="l00909"></a>00909 <span class="preprocessor">#endif</span>
<a name="l00910"></a>00910 <span class="preprocessor"></span>
<a name="l00911"></a>00911     <span class="keywordflow">if</span>( palmSaveEntry( hhEntry, pcEntry ) )
<a name="l00912"></a>00912     {
<a name="l00913"></a>00913 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00914"></a>00914 <span class="preprocessor"></span>        DEBUGKPILOT &lt;&lt; <span class="stringliteral">"Entry palmEntry-&gt;id="</span> &lt;&lt;
<a name="l00915"></a>00915         hhEntry-&gt;id() &lt;&lt; <span class="stringliteral">"saved to palm, now updating pcEntry-&gt;uid()="</span> &lt;&lt; pcEntry-&gt;uid() &lt;&lt; endl;
<a name="l00916"></a>00916 <span class="preprocessor">#endif</span>
<a name="l00917"></a>00917 <span class="preprocessor"></span>        pcSaveEntry( pcEntry, backupEntry, hhEntry );
<a name="l00918"></a>00918     }
<a name="l00919"></a>00919     <span class="keywordflow">if</span> ( hhEntryCreated ) KPILOT_DELETE( hhEntry );
<a name="l00920"></a>00920     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00921"></a>00921 }
<a name="l00922"></a>00922 
<a name="l00923"></a>00923 
<a name="l00924"></a>00924 
<a name="l00925"></a>00925 
<a name="l00926"></a>00926 <span class="keywordtype">bool</span> RecordConduit::palmCopyToPC( PCEntry *pcEntry, PilotAppCategory *backupEntry,
<a name="l00927"></a>00927         PilotAppCategory *palmEntry )
<a name="l00928"></a>00928 {
<a name="l00929"></a>00929     FUNCTIONSETUP;
<a name="l00930"></a>00930     <span class="keywordflow">if</span> ( !palmEntry )
<a name="l00931"></a>00931     {
<a name="l00932"></a>00932         <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00933"></a>00933     }
<a name="l00934"></a>00934     _copy( pcEntry, palmEntry );
<a name="l00935"></a>00935     pcSaveEntry( pcEntry, backupEntry, palmEntry );
<a name="l00936"></a>00936     backupSaveEntry( palmEntry );
<a name="l00937"></a>00937     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00938"></a>00938 }
<a name="l00939"></a>00939 
<a name="l00940"></a>00940 
<a name="l00941"></a>00941 
<a name="l00942"></a>00942 <span class="comment">/*********************************************************************</span>
<a name="l00943"></a>00943 <span class="comment">                 l o w - l e v e l   f u n c t i o n s   f o r</span>
<a name="l00944"></a>00944 <span class="comment">                   adding / removing palm/pc records</span>
<a name="l00945"></a>00945 <span class="comment"> *********************************************************************/</span>
<a name="l00946"></a>00946 
<a name="l00947"></a>00947 
<a name="l00948"></a>00948 
<a name="l00949"></a>00949 <span class="keywordtype">bool</span> RecordConduit::palmSaveEntry( PilotAppCategory *palmEntry, PCEntry *pcEntry )
<a name="l00950"></a>00950 {
<a name="l00951"></a>00951     FUNCTIONSETUP;
<a name="l00952"></a>00952 
<a name="l00953"></a>00953 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00954"></a>00954 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; <span class="stringliteral">"Saving to pilot "</span> &lt;&lt; palmEntry-&gt;id() &lt;&lt; endl;
<a name="l00955"></a>00955 <span class="preprocessor">#endif</span>
<a name="l00956"></a>00956 <span class="preprocessor"></span>
<a name="l00957"></a>00957     <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *pilotRec = palmEntry-&gt;pack();
<a name="l00958"></a>00958     recordid_t pilotId = fDatabase-&gt;<a class="code" href="classPilotDatabase.html#974c3b97cfb107386929c108a67def14" title="Writes a new record to database (if &amp;#39;id&amp;#39; == 0, one will be assigned to newRecord)...">writeRecord</a>(pilotRec);
<a name="l00959"></a>00959 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00960"></a>00960 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; <span class="stringliteral">"PilotRec nach writeRecord ("</span> &lt;&lt; pilotId &lt;&lt;
<a name="l00961"></a>00961         <span class="stringliteral">": ID="</span> &lt;&lt; pilotRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() &lt;&lt; endl;
<a name="l00962"></a>00962 <span class="preprocessor">#endif</span>
<a name="l00963"></a>00963 <span class="preprocessor"></span>    fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#974c3b97cfb107386929c108a67def14" title="Writes a new record to database (if &amp;#39;id&amp;#39; == 0, one will be assigned to newRecord)...">writeRecord</a>( pilotRec );
<a name="l00964"></a>00964     KPILOT_DELETE( pilotRec );
<a name="l00965"></a>00965 
<a name="l00966"></a>00966     <span class="comment">// pilotId == 0 if using local db, so don't overwrite the valid id</span>
<a name="l00967"></a>00967     <span class="keywordflow">if</span> ( pilotId != 0 )
<a name="l00968"></a>00968     {
<a name="l00969"></a>00969         palmEntry-&gt;setID( pilotId );
<a name="l00970"></a>00970         <span class="keywordflow">if</span> ( !mSyncedIds.contains( pilotId ) )
<a name="l00971"></a>00971         {
<a name="l00972"></a>00972             mSyncedIds.append( pilotId );
<a name="l00973"></a>00973         }
<a name="l00974"></a>00974     }
<a name="l00975"></a>00975 
<a name="l00976"></a>00976     recordid_t hhId( pcEntry-&gt;recid() );
<a name="l00977"></a>00977     <span class="keywordflow">if</span> ( hhId != pilotId )
<a name="l00978"></a>00978     {
<a name="l00979"></a>00979         pcEntry-&gt;setRecid( pilotId );
<a name="l00980"></a>00980         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00981"></a>00981     }
<a name="l00982"></a>00982 
<a name="l00983"></a>00983     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00984"></a>00984 }
<a name="l00985"></a>00985 
<a name="l00986"></a>00986 
<a name="l00987"></a>00987 
<a name="l00988"></a>00988 <span class="keywordtype">bool</span> RecordConduit::backupSaveEntry( PilotAppCategory *backup )
<a name="l00989"></a>00989 {
<a name="l00990"></a>00990     FUNCTIONSETUP;
<a name="l00991"></a>00991     <span class="keywordflow">if</span> ( !backup ) <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00992"></a>00992 
<a name="l00993"></a>00993 
<a name="l00994"></a>00994 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l00995"></a>00995 <span class="preprocessor"></span><span class="comment">//  showPilotAppCategory( backup );</span>
<a name="l00996"></a>00996 <span class="preprocessor">#endif</span>
<a name="l00997"></a>00997 <span class="preprocessor"></span>    <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *pilotRec = backup-&gt;pack();
<a name="l00998"></a>00998     fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#974c3b97cfb107386929c108a67def14" title="Writes a new record to database (if &amp;#39;id&amp;#39; == 0, one will be assigned to newRecord)...">writeRecord</a>( pilotRec );
<a name="l00999"></a>00999     KPILOT_DELETE( pilotRec );
<a name="l01000"></a>01000     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01001"></a>01001 }
<a name="l01002"></a>01002 
<a name="l01003"></a>01003 
<a name="l01004"></a>01004 
<a name="l01005"></a>01005 <span class="keywordtype">bool</span> RecordConduit::pcSaveEntry( PCEntry *pcEntry, PilotAppCategory *,
<a name="l01006"></a>01006     PilotAppCategory * )
<a name="l01007"></a>01007 {
<a name="l01008"></a>01008     FUNCTIONSETUP;
<a name="l01009"></a>01009 
<a name="l01010"></a>01010 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l01011"></a>01011 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; <span class="stringliteral">"Before _savepcEntry, pcEntry-&gt;uid()="</span> &lt;&lt;
<a name="l01012"></a>01012         pcEntry-&gt;uid() &lt;&lt; endl;
<a name="l01013"></a>01013 <span class="preprocessor">#endif</span>
<a name="l01014"></a>01014 <span class="preprocessor"></span>    <span class="keywordflow">if</span> ( pcEntry-&gt;recid() != 0 )
<a name="l01015"></a>01015     {
<a name="l01016"></a>01016         mEntryMap.insert( pcEntry-&gt;recid(), pcEntry-&gt;uid() );
<a name="l01017"></a>01017     }
<a name="l01018"></a>01018 
<a name="l01019"></a>01019     mPCData-&gt;updateEntry( pcEntry );
<a name="l01020"></a>01020     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01021"></a>01021 }
<a name="l01022"></a>01022 
<a name="l01023"></a>01023 
<a name="l01024"></a>01024 
<a name="l01025"></a>01025 <span class="keywordtype">bool</span> RecordConduit::pcDeleteEntry( PCEntry *pcEntry, PilotAppCategory *backupEntry,
<a name="l01026"></a>01026     PilotAppCategory *palmEntry )
<a name="l01027"></a>01027 {
<a name="l01028"></a>01028     FUNCTIONSETUP;
<a name="l01029"></a>01029 
<a name="l01030"></a>01030     <span class="keywordflow">if</span> ( palmEntry )
<a name="l01031"></a>01031     {
<a name="l01032"></a>01032         <span class="keywordflow">if</span> ( !mSyncedIds.contains( palmEntry-&gt;id() ) )
<a name="l01033"></a>01033         {
<a name="l01034"></a>01034             mSyncedIds.append(palmEntry-&gt;id());
<a name="l01035"></a>01035         }
<a name="l01036"></a>01036         palmEntry-&gt;makeDeleted();
<a name="l01037"></a>01037         <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *pilotRec = palmEntry-&gt;pack();
<a name="l01038"></a>01038         pilotRec-&gt;<a class="code" href="classPilotRecordBase.html#1d573a1e1235c4aa5996fa89fc9b904a" title="Mark a record as deleted (or not).">setDeleted</a>();
<a name="l01039"></a>01039         mPalmIndex--;
<a name="l01040"></a>01040         fDatabase-&gt;<a class="code" href="classPilotDatabase.html#974c3b97cfb107386929c108a67def14" title="Writes a new record to database (if &amp;#39;id&amp;#39; == 0, one will be assigned to newRecord)...">writeRecord</a>( pilotRec );
<a name="l01041"></a>01041         fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#974c3b97cfb107386929c108a67def14" title="Writes a new record to database (if &amp;#39;id&amp;#39; == 0, one will be assigned to newRecord)...">writeRecord</a>( pilotRec );
<a name="l01042"></a>01042         mSyncedIds.append( pilotRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() );
<a name="l01043"></a>01043         KPILOT_DELETE( pilotRec );
<a name="l01044"></a>01044     }
<a name="l01045"></a>01045     <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( backupEntry )
<a name="l01046"></a>01046     {
<a name="l01047"></a>01047         <span class="keywordflow">if</span> ( !mSyncedIds.contains( backupEntry-&gt;id() ) )
<a name="l01048"></a>01048         {
<a name="l01049"></a>01049             mSyncedIds.append( backupEntry-&gt;id() );
<a name="l01050"></a>01050         }
<a name="l01051"></a>01051         backupEntry-&gt;makeDeleted();
<a name="l01052"></a>01052         <a class="code" href="classPilotRecord.html" title="An &amp;quot;uninterpreted&amp;quot; representation of the bits comprising a HH record.">PilotRecord</a> *pilotRec = backupEntry-&gt;pack();
<a name="l01053"></a>01053         pilotRec-&gt;<a class="code" href="classPilotRecordBase.html#1d573a1e1235c4aa5996fa89fc9b904a" title="Mark a record as deleted (or not).">setDeleted</a>();
<a name="l01054"></a>01054         mPalmIndex--;
<a name="l01055"></a>01055         fLocalDatabase-&gt;<a class="code" href="classPilotDatabase.html#974c3b97cfb107386929c108a67def14" title="Writes a new record to database (if &amp;#39;id&amp;#39; == 0, one will be assigned to newRecord)...">writeRecord</a>( pilotRec );
<a name="l01056"></a>01056         mSyncedIds.append( pilotRec-&gt;<a class="code" href="classPilotRecordBase.html#cda8a86f61e1b991071e0a6f9acc3fe7" title="Returns the record ID for this record.">id</a>() );
<a name="l01057"></a>01057         KPILOT_DELETE( pilotRec );
<a name="l01058"></a>01058     }
<a name="l01059"></a>01059     <span class="keywordflow">if</span> ( !pcEntry-&gt;isEmpty() )
<a name="l01060"></a>01060     {
<a name="l01061"></a>01061 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l01062"></a>01062 <span class="preprocessor"></span>        DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">" removing "</span> &lt;&lt; pcEntry-&gt;uid() &lt;&lt; endl;
<a name="l01063"></a>01063 <span class="preprocessor">#endif</span>
<a name="l01064"></a>01064 <span class="preprocessor"></span>        mPCData-&gt;removeEntry( pcEntry );
<a name="l01065"></a>01065     }
<a name="l01066"></a>01066     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01067"></a>01067 }
<a name="l01068"></a>01068 
<a name="l01069"></a>01069 
<a name="l01070"></a>01070 
<a name="l01071"></a>01071 <span class="comment">/*********************************************************************</span>
<a name="l01072"></a>01072 <span class="comment">                   C O P Y   R E C O R D S</span>
<a name="l01073"></a>01073 <span class="comment"> *********************************************************************/</span>
<a name="l01074"></a>01074 
<a name="l01075"></a>01075 
<a name="l01076"></a>01076 
<a name="l01077"></a>01077 
<a name="l01078"></a>01078 
<a name="l01079"></a>01079 <span class="comment">/*********************************************************************</span>
<a name="l01080"></a>01080 <span class="comment"> C O N F L I C T   R E S O L U T I O N   a n d   M E R G I N G</span>
<a name="l01081"></a>01081 <span class="comment"> *********************************************************************/</span>
<a name="l01082"></a>01082 
<a name="l01083"></a>01083 
<a name="l01084"></a>01084 
<a name="l01085"></a>01085 
<a name="l01086"></a>01086 <span class="comment">// TODO: right now entries are equal if both first/last name and organization are</span>
<a name="l01087"></a>01087 <span class="comment">//  equal. This rules out two entries for the same person(e.g. real home and weekend home)</span>
<a name="l01088"></a>01088 <span class="comment">//  or two persons with the same name where you don't know the organization.!!!</span>
<a name="l01089"></a>01089 RecordConduit::PCEntry *RecordConduit::findMatch( PilotAppCategory *palmEntry )<span class="keyword"> const</span>
<a name="l01090"></a>01090 <span class="keyword"></span>{
<a name="l01091"></a>01091     FUNCTIONSETUP;
<a name="l01092"></a>01092     <span class="keywordflow">if</span> ( !palmEntry )
<a name="l01093"></a>01093         <span class="keywordflow">return</span> 0;
<a name="l01094"></a>01094 
<a name="l01095"></a>01095     <span class="comment">// TODO: also search with the pilotID</span>
<a name="l01096"></a>01096     <span class="comment">// first, use the pilotID to UID map to find the appropriate record</span>
<a name="l01097"></a>01097     <span class="keywordflow">if</span>( !<a class="code" href="classConduitAction.html#d20a164b45e1f71ba6875246f53e5d4a" title="A first sync (i.e.">isFirstSync</a>() &amp;&amp; ( palmEntry-&gt;id() &gt; 0) )
<a name="l01098"></a>01098     {
<a name="l01099"></a>01099         QString id( mEntryMap[palmEntry-&gt;id()] );
<a name="l01100"></a>01100 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l01101"></a>01101 <span class="preprocessor"></span>        DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": PilotRecord has id "</span> &lt;&lt; palmEntry-&gt;id() &lt;&lt; <span class="stringliteral">", mapped to "</span> &lt;&lt; <span class="keywordtype">id</span> &lt;&lt; endl;
<a name="l01102"></a>01102 <span class="preprocessor">#endif</span>
<a name="l01103"></a>01103 <span class="preprocessor"></span>        <span class="keywordflow">if</span>( !<span class="keywordtype">id</span>.isEmpty() )
<a name="l01104"></a>01104         {
<a name="l01105"></a>01105             PCEntry *res = mPCData-&gt;findByUid( <span class="keywordtype">id</span> );
<a name="l01106"></a>01106             <span class="keywordflow">if</span> ( !res &amp;&amp; !res-&gt;isEmpty() ) <span class="keywordflow">return</span> res;
<a name="l01107"></a>01107             KPILOT_DELETE( res );
<a name="l01108"></a>01108 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l01109"></a>01109 <span class="preprocessor"></span>            DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": PilotRecord has id "</span> &lt;&lt; palmEntry-&gt;id() &lt;&lt;
<a name="l01110"></a>01110                 <span class="stringliteral">", but could not be found on the PC side"</span> &lt;&lt; endl;
<a name="l01111"></a>01111 <span class="preprocessor">#endif</span>
<a name="l01112"></a>01112 <span class="preprocessor"></span>        }
<a name="l01113"></a>01113     }
<a name="l01114"></a>01114 
<a name="l01115"></a>01115     <span class="keywordflow">for</span> ( PCData::Iterator iter = mPCData-&gt;begin(); !mPCData-&gt;atEnd( iter ); ++iter )
<a name="l01116"></a>01116     {
<a name="l01117"></a>01117         PCEntry *abEntry = *iter;
<a name="l01118"></a>01118         recordid_t rid( abEntry-&gt;recid() );
<a name="l01119"></a>01119         <span class="keywordflow">if</span> ( rid&gt;0 )
<a name="l01120"></a>01120         {
<a name="l01121"></a>01121             <span class="keywordflow">if</span> ( rid == palmEntry-&gt;id() )
<a name="l01122"></a>01122                 <span class="keywordflow">return</span> abEntry;<span class="comment">// yes, we found it</span>
<a name="l01123"></a>01123             <span class="comment">// skip this PCEntry, as it has a different corresponding address on the handheld</span>
<a name="l01124"></a>01124             <span class="comment">//if ( mAllIds.contains( rid ) ) continue;</span>
<a name="l01125"></a>01125         }
<a name="l01126"></a>01126 
<a name="l01127"></a>01127         <span class="keywordflow">if</span> ( _equal( palmEntry, abEntry, eqFlagsAlmostAll ) )
<a name="l01128"></a>01128         {
<a name="l01129"></a>01129             <span class="keywordflow">return</span> abEntry;
<a name="l01130"></a>01130         }
<a name="l01131"></a>01131         KPILOT_DELETE( abEntry );
<a name="l01132"></a>01132     }
<a name="l01133"></a>01133 <span class="preprocessor">#ifdef DEBUG</span>
<a name="l01134"></a>01134 <span class="preprocessor"></span>    DEBUGKPILOT &lt;&lt; fname &lt;&lt; <span class="stringliteral">": Could not find any entry matching Palm record with id "</span> &lt;&lt; QString::number( palmEntry-&gt;id() ) &lt;&lt; endl;
<a name="l01135"></a>01135 <span class="preprocessor">#endif</span>
<a name="l01136"></a>01136 <span class="preprocessor"></span>    <span class="keywordflow">return</span> 0;
<a name="l01137"></a>01137 }
<a name="l01138"></a>01138 
<a name="l01139"></a>01139 <span class="preprocessor">#endif</span>
<a name="l01140"></a>01140 <span class="preprocessor"></span>
<a name="l01141"></a>01141 
<a name="l01142"></a>01142 
<a name="l01143"></a>01143 
<a name="l01144"></a>01144 <span class="preprocessor">#include "recordConduit.moc"</span>
<a name="l01145"></a>01145 
</pre></div></div>
    </div></div>


      </td>
  </tr>
  <tr>
    <td valign="top" id="leftmenu" width="25%">
      <a name="navigation"></a>
      <div class="menu_box"><h2>kpilot/lib</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
  <option value="classActionQueue.html">actionqueue</option>,  <option value="classCleanupAction.html">cleanupaction</option>,  <option value="classConduitAction.html">conduitaction</option>,  <option value="classConduitConfigBase.html">conduitconfigbase</option>,  <option value="classConduitFactory.html">conduitfactory</option>,  <option value="classConduitProxy.html">conduitproxy</option>,  <option value="classCUDCounter.html">cudcounter</option>,  <option value="classDatabaseInterpreter.html">databaseinterpreter</option>,  <option value="classDeviceCommThread.html">devicecommthread</option>,  <option value="classIDMapper.html">idmapper</option>,  <option value="classKPilotDeviceLink.html">kpilotdevicelink</option>,  <option value="classKPilotLink.html">kpilotlink</option>,  <option value="classKPilotLocalLink.html">kpilotlocallink</option>,  <option value="classNullMapper.html">nullmapper</option>,  <option value="classPhoneSlot.html">phoneslot</option>,  <option value="classPilotAddress.html">pilotaddress</option>,  <option value="classPilotAppInfo.html">pilotappinfo</option>,  <option value="classPilotAppInfoBase.html">pilotappinfobase</option>,  <option value="classPilotDatabase.html">pilotdatabase</option>,  <option value="classPilotDateEntry.html">pilotdateentry</option>,  <option value="classPilotLocalDatabase.html">pilotlocaldatabase</option>,  <option value="classPilotRecord.html">pilotrecord</option>,  <option value="classPilotRecordBase.html">pilotrecordbase</option>,  <option value="classPilotSerialDatabase.html">pilotserialdatabase</option>,  <option value="classPilotTodoEntry.html">pilottodoentry</option>,  <option value="classRecordConduitBase.html">recordconduitbase</option>,  <option value="classSorryAction.html">sorryaction</option>,  <option value="classSyncAction_1_1SyncMode.html">syncaction::syncmode</option>,  <option value="classTestLink.html">testlink</option>,  <option value="classWelcomeAction.html">welcomeaction</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../../akregator/html/index.html">akregator</a></li><li>&nbsp;&nbsp;<a href="../../../akregator/src/html/index.html">src</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../../akregator/src/librss/html/index.html">librss</a></li><li><a href="../../../certmanager/html/index.html">certmanager</a></li><li>&nbsp;&nbsp;<a href="../../../certmanager/lib/html/index.html">lib</a></li><li><a href="../../../kaddressbook/html/index.html">kaddressbook</a></li><li><a href="../../../kalarm/html/index.html">kalarm</a></li><li>&nbsp;&nbsp;<a href="../../../kalarm/lib/html/index.html">lib</a></li><li><a href="../../../kandy/html/index.html">kandy</a></li><li><a href="../../../karm/html/index.html">karm</a></li><li><a href="../../../kdgantt/html/index.html">kdgantt</a></li><li><a href="../../../kgantt/html/index.html">kgantt</a></li><li><a href="../../../kioslaves/html/index.html">kioslaves</a></li><li>&nbsp;&nbsp;<a href="../../../kioslaves/imap4/html/index.html">imap4</a></li><li>&nbsp;&nbsp;<a href="../../../kioslaves/mbox/html/index.html">mbox</a></li><li><a href="../../../kitchensync/html/index.html">kitchensync</a></li><li><a href="../../../kmail/html/index.html">kmail</a></li><li><a href="../../../knotes/html/index.html">knotes</a></li><li><a href="../../../konsolekalendar/html/index.html">konsolekalendar</a></li><li><a href="../../../kontact/html/index.html">kontact</a></li><li><a href="../../../korganizer/html/index.html">korganizer</a></li><li><a href="../../../kpilot/html/index.html">kpilot</a></li><li>&nbsp;&nbsp;<a href="../../../kpilot/kpilot/html/index.html">kpilot</a></li><li>&nbsp;&nbsp;<a href="../../../kpilot/lib/html/index.html">lib</a></li><li><a href="../../../libemailfunctions/html/index.html">libemailfunctions</a></li><li><a href="../../../libkcal/html/index.html">libkcal</a></li><li><a href="../../../libkdepim/html/index.html">libkdepim</a></li><li><a href="../../../libkholidays/html/index.html">libkholidays</a></li><li><a href="../../../libkmime/html/index.html">libkmime</a></li><li><a href="../../../libkpgp/html/index.html">libkpgp</a></li><li><a href="../../../libkpimidentities/html/index.html">libkpimidentities</a></li>
</ul></div></div>


        </td>
</tr>
</table>

<span class="doNotDisplay">
  <a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
  <a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
  <a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>


<div style="height: 8px"></div>

<div id="footer">
  <div id="footer_left">
    Maintained by <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;groo&#116;&#64;kde&#46;or&#x67;">Adriaan de Groot</a>
and
<a href="&#109;a&#105;&#108;&#116;&#111;&#58;w&#105;nter&#64;kde&#46;or&#x67">Allen Winter</a>.
<br/>
    KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
    <a href="http://www.kde.org/contact/impressum.php">Legal</a>
  </div>
  <div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>

<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->

</body>
</html>