Documentazione incompleta loadFromDb() documenti

[sergio.dascia]

La documentazione della loadFromDB() dei documenti non è completa in quanto non riporta che, in caso di esecuzione durante gli eventi di sincronizzazione da app off-line, non viene più sollevata l'eccezione che normalmente verrebbe intercettata e gestita da Java per via del framework.

Ciò significa che (in caso di sincronizzazione):
1) viene eseguito il codice presente dopo la loadFromDB() che normalmente non verrebbe eseguito;
2) non viene eseguito il codice eventualmente presente nel catch().

La giustificazione di tale comportamento è stata: "velocizzare la sincronizzazione".

Ritengo non abbia senso, oltre che essere di una pericolosità estrema per chi sviluppa e non lo sa, giustificare tale comportamento con un miglioramento delle prestazioni (non richiesto per altro).
Inoltre deve essere messo a conoscenza al più presto con una integrazione della documentazione tale comportamento che risale alle versione 11.0 (o giù di lì). Cosa costa scrivere che con una semplice "SynchService.IsSynchronizing = false" si ripristina il normale comportamento?

[g.lanzi]

Il comportamento in questione non è stato scelto solo per motivi di performance, ma in prima istanza perché il framework di sincronizzazione stesso effettua delle loadFromDB per sapere quali istanze di oggetto devono essere inserite e quali invece solo aggiornate. Il comportamento era stato implementato per permettere alla sincronizzazione stessa di funzionare.

Non abbiamo ancora deciso che implementazione fare, ma abbiamo un'attività per valutare se e come permettere tale risultato: che le loadFromDB eseguite dal codice diano errore. L'attività generata dalla richiesta di assistenza di ieri ha priorità alta.

Per quanto riguarda la documentazione, non è per volontà che abbiamo tralasciato di scriverlo. È un effetto collaterale che non avevamo in mente.

Non penso che la soluzione sia nella documentazione, ma nel dare errore nelle loadFromDB effettuate da codice.