Cos’è il dot.case
Il convertitore dot case trasforma i nomi in dot.case, lo stile che mette un punto tra le parole e tiene tutte le lettere in minuscolo:
Database Connection Urldiventadatabase.connection.urlhomePageTitlediventahome.page.titleerror_message_requireddiventaerror.message.required
Di solito i punti esprimono una gerarchia. In app.server.port, “port” appartiene a “server”, che a sua volta appartiene ad “app”.
Come funziona il convertitore
Lo strumento trova le parole in ogni riga, le mette in minuscolo e le unisce con i punti. Le parole possono essere separate da spazi, underscore, trattini o barre, oppure dalle maiuscole dei nomi in camelCase e PascalCase. Ogni riga viene convertita per conto suo, quindi un elenco di chiavi resta un elenco.
| Testo inserito | Risultato |
|---|---|
| Database Connection Url | database.connection.url |
| homePageTitle | home.page.title |
| error_message_required | error.message.required |
| checkout-button-label | checkout.button.label |
Dove si usa il dot.case
- File di configurazione. I file
.propertiesdi Java e le impostazioni di Spring Boot usano chiavi comespring.datasource.urleserver.port. - File di traduzione. Chiavi come
checkout.button.labelraggruppano i testi per schermata ed elemento, così anche i file di traduzione più grandi restano ordinati. - Nomi dei package. I package Java e Kotlin sono parole minuscole unite da punti:
com.example.shop. - Log e metriche. I nomi dei logger e delle metriche seguono spesso lo schema
service.component.event. - Feature flag ed eventi di analytics. Nomi come
billing.invoice.sentsono facili da filtrare per prefisso.
Perché i team scelgono le chiavi con i punti
Le chiavi con i punti si ordinano bene. Tutte quelle che iniziano con checkout. finiscono vicine in un elenco alfabetico, così impostazioni e testi collegati restano uno accanto all’altro. Molti strumenti, poi, riconoscono i punti e possono mostrare le chiavi come un albero.
Cose a cui fare attenzione
- L’ordine conta. Vai dal generale al particolare:
email.subject.welcome, nonwelcome.subject.email. - Le parti di più parole richiedono un altro stile. Se un livello contiene due parole, combina gli stili:
checkout.shipping-address.labelocheckout.shippingAddress.label. Il convertitore mette un punto tra tutte le parole, quindi unisci quelle parti a mano. - Non per gli identificatori nel codice. Nel codice usa il camelCase o lo snake_case.