Chuyển đổi YAML ⇄ Properties
Chuyển application.yml của Spring Boot sang application.properties và ngược lại — xử lý key dạng dot-notation, chỉ số mảng và map lồng nhau cho cả hai chiều.
Giới thiệu công cụ
Spring Boot đọc cùng một cấu hình từ hai định dạng file: application.yml phân cấp và application.properties phẳng. Nhiều nhóm dùng lẫn cả hai, và người review thường cần nhìn định dạng này dưới dạng định dạng kia. Công cụ này chuyển YAML thành properties dạng dot-notation và dựng lại YAML từ properties mà bạn không phải gõ lại một khóa nào.
Nó xử lý đúng những phần dễ sai nếu chỉ tìm-thay thô: map lồng nhau thành khóa có dấu chấm, phần tử list thành khóa có chỉ số như servers[0].host, và giữ nguyên dấu nháy để giá trị như 3.10 vẫn là chuỗi chứ không bị biến thành số. Mọi thứ được phân tích và chuyển đổi ngay trong trình duyệt.
Cách sử dụng
- Chọn chiều bạn cần — YAML sang Properties, hoặc Properties sang YAML.
- Dán nội dung application.yml hoặc application.properties vào khung nhập.
- Kết quả chuyển đổi hiện ngay ở khung bên phải, không cần bấm nút.
- Kiểm tra cách khóa lồng nhau và chỉ số list được biểu diễn ở định dạng đích.
- Dùng nút copy để lấy kết quả và dán vào file cấu hình của bạn.
- Đổi chiều rồi dán ngược kết quả lại để kiểm tra một vòng chuyển đổi.
Tính năng
- Chuyển đổi hai chiều giữa YAML và file Java .properties trong cùng một chỗ.
- Map lồng nhau bung thành khóa dot-notation (spring.datasource.url) và gộp lại được.
- Sequence YAML ánh xạ sang khóa có chỉ số (items[0], items[1]) và dựng lại chính xác.
- Giữ nguyên giá trị có nháy để chuỗi giống số phiên bản không bị âm thầm biến thành số.
- Xử lý gọn comment và dòng trống thay vì làm hỏng quá trình phân tích.
- Tối ưu cho cấu hình Spring Boot thực tế, không chỉ dữ liệu key-value trừu tượng.
- Chạy hoàn toàn phía client — cấu hình của bạn không rời khỏi trình duyệt.
Câu hỏi thường gặp
Cấu hình của tôi có bị tải lên đâu không?
Không. Việc phân tích và chuyển đổi diễn ra hoàn toàn trong trình duyệt bằng JavaScript. Không gì được gửi lên server, điều này quan trọng vì file cấu hình thường chứa thông tin đăng nhập và chuỗi kết nối.
List trong YAML được chuyển sang properties thế nào?
Mỗi phần tử list thành một khóa có chỉ số. Một sequence YAML dưới servers sẽ thành servers[0], servers[1]… đúng cách Spring Boot bind các property có chỉ số trở lại thành một collection.
Công cụ có giữ giá trị của tôi là chuỗi khi cần không?
Có. Các scalar YAML có nháy được giữ nguyên nên giá trị như "1.10" vẫn là chuỗi thay vì bị hiểu thành số 1.1 — một lỗi cấu hình rất hay gặp.
Tôi có thể chuyển properties ngược về YAML không?
Có. Chọn chiều Properties sang YAML, các khóa có dấu chấm sẽ được lồng lại thành cấu trúc phân cấp, còn khóa có chỉ số được dựng lại thành list YAML.
Công cụ này chỉ dùng cho Spring Boot?
Nó được tối ưu theo quy ước Spring Boot, nhưng bất kỳ công cụ nào đọc file Java .properties chuẩn hoặc YAML key-value thuần cũng dùng được y như vậy.