How spotify/java-locales works
Java Locales is a library for locale negotiation, locale affinity, and Unicode locale utilities. Its main workflow is to provide supported locales and resolve the best matching translation and formatting locales for an application-defined context; the README also documents audience-specific locale lists. Separate affinity operations compare one locale against a configured set or compare two locales. The graph reflects README-documented capabilities and relationships only; no source excerpts were provided, so internal calls and implementation details are not asserted.
Main entry points: LocalesResolver.java Locale resolution · SupportedLocalesSupplier.java Supported locales · ContextBasedSupportedLocalesSupplier.java Audience locales · LocaleAffinityCalculator.java Set affinity
Components 14
Locale negotiation
- Supported locales
locales-common/src/main/java/com/spotify/i18n/locales/common/SupportedLocalesSupplier.java - Audience locales
locales-common/src/main/java/com/spotify/i18n/locales/common/ContextBasedSupportedLocalesSupplier.java - Locale resolution
locales-common/src/main/java/com/spotify/i18n/locales/common/LocalesResolver.java - Resolution context
locales-common/src/main/java/com/spotify/i18n/locales/common/ContextBasedLocalesResolver.java
Locale affinity
- Set affinity
locales-common/src/main/java/com/spotify/i18n/locales/common/LocaleAffinityCalculator.java - Pair affinity
locales-common/src/main/java/com/spotify/i18n/locales/common/LocaleAffinityBiCalculator.java
Locale utilities
- Accept-Language
locales-utils/src/main/java/com/spotify/i18n/locales/utils/acceptlanguage/AcceptLanguageUtils.java - Available locales
locales-utils/src/main/java/com/spotify/i18n/locales/utils/available/AvailableLocalesUtils.java - Language lookup
locales-utils/src/main/java/com/spotify/i18n/locales/utils/language/LanguageUtils.java - Language tags
locales-utils/src/main/java/com/spotify/i18n/locales/utils/languagetag/LanguageTagUtils.java - Locale hierarchy
locales-utils/src/main/java/com/spotify/i18n/locales/utils/hierarchy/LocalesHierarchyUtils.java
Domain model
- Resolved locale
locales-common/src/main/java/com/spotify/i18n/locales/common/model/ResolvedLocale.java - Affinity result
locales-common/src/main/java/com/spotify/i18n/locales/common/model/LocaleAffinityResult.java
Other components
- Application caller
Connections 15
- Application caller → Supported locales: requests locales
README.md - Application caller → Audience locales: selects audience
README.md - Application caller → Locale resolution: requests resolution
README.md - Supported locales → Locale resolution: provides candidates
README.md - Audience locales → Locale resolution: provides candidates
README.md - Application caller → Set affinity: compares locale
README.md - Application caller → Pair affinity: compares locales
README.md - Application caller → Accept-Language: parses header
README.md - Application caller → Available locales: retrieves locales
README.md - Application caller → Language lookup: looks up language
README.md - Application caller → Language tags: normalizes tags
README.md - Application caller → Locale hierarchy: navigates hierarchy
README.md - Locale resolution → Resolved locale: selects locales
- Set affinity → Affinity result: returns affinity
- Pair affinity → Affinity result: returns affinity