Narzędzia do obsługi komentarzy w formacie JSON oraz plików JSON Lines
Altova XMLSpy i MapForce Narzędzia do obsługi formatu JSON Od dawna wspieramy formaty JSON i JSON5, zarówno pod kątem edycji, jak i mapowania oraz konwersji danych. Wraz z pojawianiem się nowych formatów JSON, wynikających z praktycznego zastosowania, wsparcie dla tych formatów w tych narzędziach jest stale rozszerzane.
W tym artykule wyjaśnimy zalety dwóch nowszych formatów – JSON Comments i JSON Lines – oraz pokażemy, jak można ich używać w programach XMLSpy i MapForce.
Jak dodawać komentarze w formacie JSON
Chociaż JSON został stworzony jako format wymiany danych, jego elastyczność i łatwość implementacji sprawiły, że z czasem zaczął być wykorzystywany w różnych zastosowaniach, na przykład w plikach konfiguracyjnych. Jednakże, wadą JSON w tych implementacjach jest to, że format ten nie obsługuje komentarzy, co utrudnia dodawanie niezbędnej dokumentacji i adnotacji do kodu.
JSON5, będący rozszerzeniem formatu JSON, został wprowadzony w celu rozwiązania niektórych ograniczeń tego formatu i faktycznie umożliwia dodawanie komentarzy. Niemniej jednak, aplikacje oparte na starszych wersjach JSON nadal potrzebują mechanizmu umożliwiającego dodawanie komentarzy.
W tym celu wprowadzono format JSON Comments (JSONC), który umożliwia przetwarzanie plików JSON zawierających komentarze. Dzięki JSONC można dodawać komentarze blokowe i jednolinijkowe, aby opisywać funkcjonalność kodu JSON, bez powodowania błędów podczas przetwarzania.
Oprócz obsługi formatów JSON i JSON5, program XMLSpy Edytor JSON Oferuje pełne wsparcie w zakresie walidacji i edycji plików JSON Comments, rozpoznawanych na podstawie rozszerzenia .jsonc. Jak pokazano poniżej, komentarze jednolinijkowe poprzedzone są znakiem //, a komentarze wieloliniowe lub blokowe są otoczone znakami /* i */.
Czym jest format JSON Lines (JSONL)?
Format znany również jako JSON z oddzielnikami nowej linii, JSON Lines (JSONL) to sposób przechowywania danych strukturalnych, w którym każdy rekord znajduje się w oddzielnej linii. Dzięki temu rekordy można przetwarzać pojedynczo, co czyni ten format wygodnym do przechowywania lub przetwarzania danych, gdzie istotne są znaki nowej linii, takie jak pliki dzienników. Poniżej znajduje się przykład prostego dokumentu JSON Lines (.jsonl) edytowanego w programie XMLSpy:
Format JSON Lines jest również obsługiwany przez MapForce do Mapowanie i konwersja danych JSON. Częstym wymaganiem jest konwersja formatu JSON Lines na CSV, a nawet na inny format JSON. Wszystko to jest łatwe do zrealizowania w MapForce, gdzie można zdefiniować projekt mapowania danych w sposób graficzny, aby przekształcić dane w formacie JSON Lines na dowolny inny format obsługiwany przez oprogramowanie: JSON, XML, bazy danych, CSV, Excel, EDI i inne.
Aby przekonwertować dane do formatu JSON Lines, wystarczy zaznaczyć odpowiednie pole w ustawieniach komponentu. Kiedy format JSON Lines jest wybrany dla komponentu generującego dane JSON, dla każdego obiektu w pliku źródłowym zostanie utworzona nowa linia w pliku wynikowym podczas wykonywania mapowania.
Podobnie, jeśli projekt integracji danych odczytuje dane z pliku źródłowego w formacie JSON Lines, wykonanie mapowania spowoduje utworzenie tyle elementów w danych docelowych, ile linii JSON znajduje się w pliku źródłowym.
Studium przypadku: format JSON Lines
Oto bardziej szczegółowe omówienie sposobu konwertowania danych w formacie JSON Lines poprzez pobieranie rekordów z tabeli bazy danych i mapowanie ich na plik JSON Lines, który będzie plikiem wynikowym.
Narzędzia do pracy z JSON - bezpłatny okres próbny
W narzędziach Altova JSON, wsparcie dla formatów JSON z komentarzami oraz JSON Lines pomaga klientom wykorzystać nowe formaty, które są lepiej dopasowane do rzeczywistych implementacji JSON. Można wypróbować zarówno XMLSpy, jak i MapForce Bezpłatny okres próbny z pakietu narzędzi Altova MissionKit, przeznaczonego do pracy z danymi JSON i integracji danych.