Come aprire file .NDJSON su iOS
Per aprire file .NDJSON su iOS, apri il file .ndjson in un'app con funzionalità di testo normale per visualizzare le righe; se è necessario interrogarlo/trasformarlo, trasferirlo in un ambiente desktop in cui gli strumenti NDJSON sono più comuni.
Istruzioni passo passo
- Apri il file .ndjson in un'app con funzionalità di testo normale per visualizzare le righe; se è necessario interrogarlo/trasformarlo, trasferirlo in un ambiente desktop in cui gli strumenti NDJSON sono più comuni.
Problemi comuni
"Errore di analisi JSON" quando si utilizza un normale parser JSON
Molti parser JSON si aspettano un singolo documento JSON (spesso un oggetto o un array). Un file NDJSON contiene più testi JSON separati da ritorni a capo, quindi un parser che prevede un documento potrebbe non riuscire dopo la prima riga.
- Conferma che il file sia NDJSON: ogni riga dovrebbe essere un valore JSON completo (comunemente un oggetto).
- Utilizza un lettore/parser che supporti NDJSON/JSON delimitato da nuova riga (streaming JSON riga per riga) oppure dividi il file per righe e analizza ciascuna riga separatamente.
Una riga non è un JSON valido, interrompendo l'elaborazione a metà
NDJSON richiede che ogni record sia un JSON valido su una singola riga. Se un record contiene un ritorno a capo senza caratteri di escape all'interno di una stringa o la riga è troncata/danneggiata, gli strumenti potrebbero non riuscire su quella riga.
- Individua il numero di riga errata (molti strumenti lo segnalano) e controlla quella riga specifica in un editor di testo.
- Correggere o rimuovere il record non valido; assicurarsi che i ritorni a capo incorporati nelle stringhe siano correttamente sottoposti a escape e che ogni valore JSON rimanga su una riga.
Il file si apre come testo normale, ma sembra "non formattato" o difficile da leggere
NDJSON è ottimizzato per lo streaming piuttosto che per la leggibilità umana. Ogni riga può essere minimizzata JSON senza rientro.
- Utilizza un editor di testo con funzionalità di formattazione JSON per stampare in modo gradevole singole righe (record per record).
- Se hai bisogno di un singolo documento JSON, converti le righe in un array JSON con uno strumento/flusso di lavoro che legge NDJSON e restituisce JSON standard.
Tipo di contenuto/aspettative di tipo MIME errate in un'API o in una pipeline
NDJSON utilizza comunemente il tipo di supporto application/x-ndjson secondo le specifiche ndjson, ma questo non è un sottotipo registrato IANA; alcuni sistemi potrebbero aspettarsi qualcos'altro o trattarlo come testo generico.
- Se controlli il mittente, imposta Content-Type su application/x-ndjson quando interagisci con sistemi che riconoscono la convenzione ndjson-spec.
- Se hai bisogno di un'alternativa standardizzata per lo streaming JSON, prendi in considerazione le sequenze di testo JSON RFC 7464 (application/json-seq) dove supportate.
Nota di sicurezza
NDJSON è testo semplice (senza macro), ma viene spesso utilizzato per flussi di dati di grandi dimensioni e non attendibili; JSON malformato o contraddittorio può innescare problemi di prestazioni o di memoria nei parser: è preferibile l'elaborazione in streaming/riga per riga piuttosto che caricare l'intero file in una sola volta.