Strumenti per i commenti JSON e i file JSON Lines
Altova XMLSpy e MapForce Strumenti per JSON Abbiamo a lungo supportato i formati JSON e JSON5 per l'editing, così come per la mappatura e la conversione dei dati. Man mano che emergono nuovi formati JSON in risposta all'utilizzo reale, il supporto in questi strumenti si sta ampliando.
Questo articolo illustrerà i vantaggi di due formati più recenti, JSON Comments e JSON Lines, e mostrerà come utilizzarli in XMLSpy e MapForce.
Come aggiungere commenti in formato JSON
Sebbene JSON sia stato creato come un formato di scambio dati puro, nel corso del tempo, la sua flessibilità e la facilità di implementazione hanno portato al suo utilizzo in una varietà di contesti diversi, ad esempio nei file di configurazione. Tuttavia, uno svantaggio di JSON in queste implementazioni è che il formato non supporta i commenti, rendendo molto difficile fornire la documentazione e le annotazioni necessarie nel codice.
JSON5, un'estensione di JSON, è stato introdotto per risolvere alcune delle limitazioni di JSON e, di fatto, permette l'uso di commenti. Tuttavia, le applicazioni basate su versioni precedenti di JSON necessitano ancora di un meccanismo per l'inserimento di commenti.
A tal fine, è stato introdotto il formato JSON Comments (JSONC) per consentire l'elaborazione di file JSON che includono commenti. Con JSONC, è possibile aggiungere commenti a blocchi e commenti su singole righe per descrivere la funzionalità del codice JSON, senza causare errori di elaborazione.
Oltre al supporto per JSON e JSON5, XMLSpy Editor JSON Fornisce supporto completo per la validazione e la modifica dei commenti JSON, riconoscibili tramite l'estensione del file .jsonc. Come mostrato di seguito, i commenti su una singola riga sono preceduti da "//", mentre i commenti multilinea o a blocco sono delimitati da "/" e "/".
Cos'è JSON Lines (JSONL)?
Conosciuto anche come JSON delimitato da nuove righe JSON Lines (JSONL) è un formato per l'archiviazione di dati strutturati in cui ogni record è contenuto in una riga separata. Grazie a questa caratteristica, i record possono essere elaborati uno alla volta, rendendo il formato particolarmente adatto per l'archiviazione o l'elaborazione di dati in cui i caratteri di fine riga sono importanti, come nel caso dei file di log. Ecco un esempio di un semplice documento JSON Lines (.jsonl) che viene modificato in XMLSpy:
JSON Lines è supportato anche da MapForce per Mappatura e conversione dei dati JSON. Una necessità comune è quella di convertire i file JSON Lines in formato CSV, o addirittura da JSON Lines a JSON. Tutto questo è semplice in MapForce, dove è possibile definire un progetto di mappatura dati grafico per convertire i file JSON Lines in o da qualsiasi altro formato dati supportato dal software: JSON, XML, database, CSV, Excel, EDI, e così via.
Per convertire i dati in formato JSON Lines, è sufficiente selezionare la casella "JSON Lines" nelle impostazioni del componente. Quando si seleziona il formato JSON Lines per un componente di destinazione JSON, una nuova riga JSON verrà creata nel file di output per ogni oggetto presente nel file di origine, durante l'esecuzione della mappatura.
Analogamente, se il vostro progetto di integrazione dati legge dati da un file sorgente in formato JSON Lines, l'esecuzione della mappatura creerà un numero di elementi nella destinazione pari al numero di righe JSON presenti nel file sorgente.
Caso di studio: JSON Lines
Ecco un'analisi più approfondita di conversione di file JSON Lines estrarre i dati da una tabella di un database e convertirli in un file JSON Lines per l'output.
Strumenti JSON - Prova gratuita
Il supporto per JSON con commenti e JSON Lines offerto dagli strumenti Altova JSON sta aiutando i clienti a sfruttare nuovi formati adatti alle implementazioni JSON reali. Potete provare sia XMLSpy che MapForce con una prova gratuita della suite Altova MissionKit, che comprende strumenti per l'integrazione di dati e JSON.