Octave avanzato A05 — Errori del Bridge e recupero controllato
Corso avanzato di GNU Octave con GX-TXT · Modulo 01
Un’API inesistente, un’operazione non registrata e un errore del provider richiedono risposte diverse. Octave permette di intercettare un errore, ma la scelta di continuare o interrompere l’analisi dipende dal suo significato.
Obiettivi e prerequisiti
Dopo il corso base e le lezioni precedenti, sappiamo controllare le dipendenze. Ora esaminiamo l’identificativo e il messaggio di un errore reale, provocato intenzionalmente senza modificare dati. La prova usa GX-TXT dev112-P011-bis e GNU Octave 9.4.0.
Un’operazione volutamente inesistente
Importa errori_bridge.m, salvalo nella Session ed eseguilo con il Runner.
% Advanced Octave course A05: handle API discovery and call errors.
% SPDX-License-Identifier: GPL-3.0-or-later
api = 'CANONICAL_DATASET_API_v2';
operation = 'operazione_inesistente';
fprintf('Known API: %d\n', gxtxt_api_has(api));
fprintf('Requested operation available: %d\n', gxtxt_api_has_operation(api, operation));
try
gxtxt_api_call(api, operation, {});
error('Unexpected success in the demonstration.');
catch err
fprintf('Caught error identifier: %s\n', err.identifier);
fprintf('Caught error message: %s\n', err.message);
end_try_catch
fprintf('Demonstration completed; no data were changed.\n');
L’esempio controlla prima l’esistenza dell’API e poi quella
dell’operazione inventata. La chiamata successiva è intenzionalmente
errata per mostrare cosa restituisce il Bridge: catch err
riceve l’errore e ne stampa identificativo e messaggio.
Nella prova l’API è presente (1), l’operazione non lo è
(0) e la chiamata segnala
GXTXT:ScriptBridge:UnknownOperation. Il Job completa la
dimostrazione perché l’errore previsto è stato intercettato; questo non
significa che la chiamata sia riuscita.
Gestire gli errori senza nasconderli
In una pipeline reale è preferibile controllare i requisiti prima della chiamata e fermarsi se manca un’operazione necessaria. Il Bridge distingue anche altri casi documentati, come API sconosciuta, argomenti non validi, errore di trasporto e fallimento del provider. Conserva identificativo e messaggio, e riporta il contesto necessario a capire quale operazione è fallita.
Questo piccolo catch stampa qualunque errore, incluso
quello sollevato dal ramo «successo inatteso»: è adeguato a un
esperimento che mostra la diagnostica, ma non costituisce un gestore
selettivo per un’analisi. Nel codice di produzione verifica
l’identificativo atteso e rilancia gli errori inattesi con
rethrow(err). Non sostituire un errore con un array vuoto o
con zero: sarebbe impossibile distinguere un guasto da un risultato
valido.
Esercizio
- Perché il Job mostrato può essere completato anche se la chiamata solleva un errore?
- Come distingueresti un’operazione non registrata da un risultato numerico vuoto?
- Che cosa dovrebbe fare una pipeline se un’operazione indispensabile non è disponibile?
Soluzione ragionata
- Perché il blocco
catchintercetta l’errore e la dimostrazione termina dopo averlo stampato. - Nel primo caso il Bridge produce un errore con identificativo; nel secondo occorre interpretare un risultato effettivamente restituito secondo il contratto.
- Interrompersi e indicare quale dipendenza manca, senza presentare come completa un’analisi parziale.