Chuyển đổi JSON sang TOML

Chuyển đổi JSON sang TOML là gì?

Chuyển đổi JSON sang TOML là quá trình biến đổi dữ liệu từ JavaScript Object Notation sang Tom's Obvious Minimal Language. JSON sử dụng dấu ngoặc nhọn, dấu ngoặc vuông và khóa được trích dẫn để biểu diễn dữ liệu có cấu trúc. TOML sử dụng cú pháp khóa-giá trị phẳng với các tiêu đề phần (gọi là bảng) — đọc giống tệp INI nhưng có kiểu dữ liệu chặt chẽ. TOML được thiết kế đặc biệt cho các tệp cấu hình, nơi khả năng đọc của con người quan trọng hơn khả năng trao đổi dữ liệu máy móc.

TOML đã trở thành định dạng cấu hình mặc định cho Rust (Cargo.toml), đóng gói Python (pyproject.toml), trang web tĩnh Hugo, cài đặt triển khai Netlify và nhiều công cụ dòng lệnh. Khi dữ liệu nguồn của bạn tồn tại dưới dạng JSON — từ phản hồi API, cấu hình được xuất ra, hoặc tệp được tạo tự động — và hệ thống đích yêu cầu TOML, bạn cần một bộ chuyển đổi ánh xạ đối tượng JSON thành bảng TOML, mảng JSON thành mảng TOML, và bảo toàn chính xác mọi kiểu dữ liệu.

Chuyển đổi JSON sang TOML trực tuyến là cách nhanh nhất để tạo TOML hợp lệ từ dữ liệu JSON hiện có. Quá trình chuyển đổi xử lý ánh xạ kiểu dữ liệu tự động: chuỗi JSON thành chuỗi TOML, số JSON thành số nguyên hoặc số thực TOML, boolean ánh xạ trực tiếp, và đối tượng JSON thành bảng TOML. Ngoại lệ duy nhất là null — TOML không có kiểu null, vì vậy các giá trị null được bỏ qua hoặc chuyển thành chuỗi rỗng tùy theo bộ chuyển đổi.

Tại sao sử dụng bộ chuyển đổi JSON sang TOML này?

TOML là định dạng mà các tệp cấu hình yêu cầu; JSON là định dạng mà các API và công cụ tạo ra. Bộ chuyển đổi này lấp đầy khoảng cách để bạn có thể di chuyển dữ liệu giữa hai định dạng mà không cần viết lại thủ công.

Các trường hợp sử dụng JSON sang TOML

So sánh JSON và TOML

JSON và TOML có khả năng tương đồng nhưng khác nhau về cú pháp, hỗ trợ kiểu dữ liệu và mục đích sử dụng. Bảng này cho thấy những khác biệt ảnh hưởng đến quá trình chuyển đổi.

Những điểm cần lưu ý khi chuyển đổi TOML

TOML có các quy tắc khác với JSON theo những cách ảnh hưởng đến kết quả chuyển đổi. Bốn vấn đề sau gây ra nhầm lẫn nhiều nhất.

Ví dụ mã nguồn

Chuyển đổi JSON sang TOML theo chương trình yêu cầu thư viện tuần tự hóa TOML trong hầu hết các ngôn ngữ. Thư viện chuẩn phân tích JSON; kết quả TOML cần một gói chuyên dụng.

import { stringify } from '@iarna/toml'

const json = '{"title":"My App","database":{"host":"localhost","port":5432}}'
const obj = JSON.parse(json)
const toml = stringify(obj)
console.log(toml)
// → title = "My App"
// →
// → [database]
// → host = "localhost"
// → port = 5432

import json
import tomli_w  # pip install tomli_w

json_str = '{"title": "My App", "database": {"host": "localhost", "port": 5432}}'
data = json.loads(json_str)
toml_str = tomli_w.dumps(data)
print(toml_str)
# → title = "My App"
# →
# → [database]
# → host = "localhost"
# → port = 5432

package main

import (
    "encoding/json"
    "fmt"
    "github.com/pelletier/go-toml/v2"
)

func main() {
    jsonStr := `{"title":"My App","database":{"host":"localhost","port":5432}}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    tomlBytes, _ := toml.Marshal(data)
    fmt.Println(string(tomlBytes))
    // → title = 'My App'
    // →
    // → [database]
    // → host = 'localhost'
    // → port = 5432
}

# Using yj (https://github.com/sclevine/yj)
echo '{"title":"My App","port":3000}' | yj -jt
# → title = "My App"
# → port = 3000

# Using remarshal (pip install remarshal)
echo '{"title":"My App","port":3000}' | remarshal -if json -of toml
# → title = "My App"
# → port = 3000

Câu hỏi thường gặp