Properties to YAML 변환기 완벽 가이드
Java 프로퍼티 파일(.properties)은 Java 생태계에서 오랫동안 사용되어 온 설정 파일 형식입니다. key=value 쌍으로 구성되며, 점(.) 구분자를 사용하여 논리적 계층 구조를 표현합니다. 예를 들어 spring.datasource.url은 spring 하위의 datasource 하위에 url이라는 계층 구조를 의미합니다. 그러나 Properties 형식은 평면적(flat)인 구조이기 때문에 키가 길어지고, 같은 접두사가 반복되어 가독성이 떨어지는 단점이 있습니다.
YAML(YAML Ain't Markup Language)은 들여쓰기 기반의 계층적 데이터 표현 형식으로, 사람이 읽고 쓰기에 훨씬 직관적입니다. Spring Boot에서는 application.properties 대신 application.yml 파일을 사용할 수 있으며, 동일한 설정을 보다 깔끔하고 구조적으로 관리할 수 있습니다. 특히 마이크로서비스 아키텍처에서 다수의 프로필(profile)별 설정을 관리하거나, 복잡한 설정 구조를 다룰 때 YAML의 장점이 더욱 두드러집니다.
본 도구는 Properties 형식의 텍스트를 YAML로 자동 변환합니다. 점(.) 구분자를 기반으로 키를 분할하여 중첩된 YAML 계층 구조를 생성하고, 주석(# 또는 !)을 감지하여 보존 처리합니다. 또한 역방향 변환(YAML에서 Properties)도 지원하여 양방향으로 유연하게 포맷을 전환할 수 있습니다. 모든 변환은 브라우저 내 JavaScript로 처리되어 서버에 데이터가 전송되지 않으므로, 데이터베이스 비밀번호나 API 키가 포함된 설정 파일도 안심하고 변환할 수 있습니다.
Spring Boot 마이그레이션, Kubernetes ConfigMap 작성, Docker Compose 설정 파일 정리, CI/CD 파이프라인 구성 등 다양한 개발 시나리오에서 활용할 수 있습니다. 키 정렬 옵션을 사용하면 알파벳순으로 정렬된 깔끔한 결과를 얻을 수 있고, 들여쓰기 크기(2칸/4칸)를 선택하여 팀 코딩 컨벤션에 맞출 수 있습니다. 변환 결과는 클립보드 복사, SNS 공유, 이미지 카드 저장 기능으로 동료 개발자와 손쉽게 공유할 수 있으며, 입력 내용은 LocalStorage에 자동 보존되어 브라우저를 닫았다가 다시 열어도 이전 작업을 이어갈 수 있습니다.
주요 기능
- 양방향 변환: Properties에서 YAML로, YAML에서 Properties로 자유롭게 전환
- 계층 구조 자동 생성: 점(.) 구분자를 분석하여 중첩 YAML 구조를 자동으로 생성
- 주석 보존: # 또는 ! 으로 시작하는 주석을 YAML 주석으로 변환하여 보존
- 키 정렬: 알파벳순 정렬 옵션으로 깔끔한 결과 제공
- 들여쓰기 설정: 2칸 또는 4칸 들여쓰기 선택 가능
- 구문 하이라이팅: 키, 값, 타입별 색상 구분으로 직관적 결과 확인
- 다크 모드 지원: 시스템 테마에 따라 자동으로 밝은/어두운 모드 전환
- 입력 자동 저장: LocalStorage를 활용한 입력 내용 자동 보존
- 결과 공유: 복사, SNS 공유, 이미지 카드 저장 기능 제공
지원하는 Properties 문법
- key=value 형식 (등호 구분자)
- key:value 형식 (콜론 구분자)
- key value 형식 (공백 구분자)
- 점(.) 구분자 기반 계층적 키 (예: spring.datasource.url)
- # 또는 ! 으로 시작하는 주석
- 빈 줄 무시
- 값의 앞뒤 공백 자동 제거(trim)
- 역슬래시(\) 줄 이어쓰기 처리
자주 묻는 질문 (FAQ)
Q. Properties와 YAML의 차이점은 무엇인가요?
A. Properties는 평면적인 key=value 구조로, 점(.)을 사용하여 논리적 계층을 표현합니다. YAML은 들여쓰기로 실제 계층 구조를 표현하여 가독성이 뛰어나고, 리스트(배열), 멀티라인 문자열 등 더 풍부한 데이터 표현이 가능합니다. Spring Boot에서는 두 형식 모두 지원하며, 복잡한 설정에서는 YAML이 더 선호됩니다.
Q. application.properties를 application.yml로 변환하려면 어떻게 하나요?
A. application.properties 파일의 내용을 복사하여 입력란에 붙여넣고 "변환하기" 버튼을 클릭하면 됩니다. 변환된 YAML 결과를 복사하여 application.yml 파일로 저장하면 Spring Boot에서 바로 사용할 수 있습니다. 주석 보존 옵션을 활성화하면 원본의 주석도 함께 변환됩니다.
Q. 변환된 데이터는 서버로 전송되나요?
A. 아닙니다. 모든 변환 작업은 브라우저 내에서 순수 JavaScript로 처리됩니다. 입력된 데이터는 서버로 전송되지 않으며, LocalStorage에만 임시 보존됩니다. 데이터베이스 비밀번호, API 키 등 민감한 정보가 포함된 설정 파일도 안심하고 사용할 수 있습니다.
Q. 역방향 변환(YAML에서 Properties)도 가능한가요?
A. 네, 도구 상단의 "YAML → Properties" 버튼을 클릭하면 변환 방향이 전환됩니다. YAML 텍스트를 입력하고 변환하기 버튼을 누르면 평면적인 Properties 형식으로 변환된 결과를 확인할 수 있습니다.
Q. 배열(리스트)이 포함된 Properties도 변환할 수 있나요?
A. 네, items[0]=a, items[1]=b와 같은 인덱스 기반 배열 표기를 감지하여 YAML 리스트 형식으로 변환합니다. 역방향 변환 시에도 YAML 리스트를 인덱스 기반 Properties로 정확하게 변환합니다.