dot.case란
닷 케이스(dot.case)는 단어 사이에 마침표를 넣고 모든 글자를 소문자로 쓰는 표기법입니다. 닷 케이스 변환기에 넣으면 다음처럼 바뀝니다.
Database Connection Url은database.connection.url이 됩니다homePageTitle은home.page.title이 됩니다error_message_required는error.message.required가 됩니다
점은 보통 계층 구조를 나타냅니다. app.server.port에서 “port”는 “server”에 속하고, “server”는 “app”에 속합니다.
변환기 작동 방식
이 도구는 각 줄에서 단어를 찾아 소문자로 바꾸고 점으로 연결합니다. 단어는 공백, 밑줄, 하이픈, 슬래시로 나뉘어 있어도 되고, camelCase나 PascalCase 이름의 대문자로 구분되어 있어도 됩니다. 각 줄을 따로 변환하므로 키 목록은 목록 그대로 돌아옵니다.
| 입력 | 결과 |
|---|---|
| Database Connection Url | database.connection.url |
| homePageTitle | home.page.title |
| error_message_required | error.message.required |
| checkout-button-label | checkout.button.label |
한글 단어를 넣으면 한글은 그대로 두고 단어 사이에 점만 넣습니다. ‘회원 가입 버튼’은 회원.가입.버튼이 됩니다. 다만 번역 키는 보통 영어로 짓고, 한국어 문장은 키에 연결된 번역 값 쪽에 넣는 것이 일반적입니다.
dot.case를 쓰는 곳
- 설정 파일. Java
.properties파일과 Spring Boot 설정은spring.datasource.url,server.port같은 키를 씁니다. - 번역 파일.
checkout.button.label같은 키는 텍스트를 화면과 요소별로 묶어 주므로 큰 번역 파일도 깔끔하게 관리할 수 있습니다. - 패키지 이름. Java와 Kotlin 패키지는 소문자 단어를 점으로 연결합니다.
com.example.shop처럼 씁니다. - 로깅과 지표. 로거 이름과 지표 이름은
service.component.event패턴을 따르는 경우가 많습니다. - 기능 플래그와 분석 이벤트.
billing.invoice.sent같은 이름은 접두사로 걸러 보기 쉽습니다.
팀에서 점으로 구분한 키를 쓰는 이유
점으로 구분한 키는 정렬하기 좋습니다. checkout.으로 시작하는 키는 알파벳순 목록에서 모두 한데 모이므로 관련 설정과 문구가 나란히 놓입니다. 점을 인식해서 키를 트리 형태로 보여 주는 도구도 많습니다.
주의할 점
- 순서가 중요합니다. 넓은 범위에서 좁은 범위로 씁니다.
welcome.subject.email이 아니라email.subject.welcome입니다. - 두 단어로 된 단계에는 다른 표기를 섞습니다. 한 단계가 두 단어라면
checkout.shipping-address.label이나checkout.shippingAddress.label처럼 표기를 조합합니다. 이 변환기는 모든 단어 사이에 점을 넣으므로, 그런 부분은 직접 이어 붙여야 합니다. - 코드 식별자에는 쓰지 않습니다. 코드에서는 camelCase나 snake_case를 씁니다.