113
edits
Changes
on-demand sync state diagram
Addressing 3) is non-trivial and will be tackled at a later stage, in the meantime it may be possible to avoid current problems by increasing the cache size and configuring it to save to disk rather than memory ([https://bugzilla.mozilla.org/show_bug.cgi?id=439731#c12 bug 439731 #12]).
==== On-Demand Sync ====
===== State Diagram =====
<small>
<small>
<pre>
.---------------.
. --------------- .
|| SyncCompleted ||
' --------------- '
'---------------'
^
|
/
.
|
syncCompleted()
.
\ pendingHeaders() > 0 pendingMessages() > 0 downloadMessages()
------. \ .----------------. .----------------. .----------------.
/ ------------- / `-> --------------- / `-> --------------- / `-> ------------------
------>|IdleCompleted| |ReadyToDiscover| |ReadyToDownload| |DownloadInProgress|
------------- <- / --------------- <- / --------------- <- / ------------------
^ \ `-----------------' `-----------------' `-----------------' ^ \
| \ pendingHeaders() = 0 pendingMessages() = 0 downloadOK() | \
/ \ / \
/ . . .
/ | | downloadFail()
/ headersOutOfDate() | |
/ | | |
. | retriesRemaing() > 0 |
| . . .
updateOK() / \ /
| | \ |
| v \ v
| ------------- ------------
| |ReadyToUpdate| |DownloadFail|
| ------------- ------------
| \ \
| \ \
| . .
. | retriesRemaing() = 0
\ updateHeaders() |
\ | .
\ . /
\ / |
\ | updateFail() retriesRemaining() = 0 v
\ v .-------------------------------------. .----------------------------------------. .------------.
---------------- / `-> ---------- / `->. ------------ .
|UpdateInProgress| |UpdateFail| || SyncFailed ||
---------------- <- / ---------- ' ------------ '
`--------------------------------------' '------------'
retriesRemaing() > 0
</pre>
</small>
</small>
=== Milestones ===
