Apache Sling I18N Support

Clone this repo:
  1. ec70d49 [maven-release-plugin] prepare for next development iteration by Joerg Hoh · 3 weeks ago master
  2. dfffcbb [maven-release-plugin] prepare release org.apache.sling.i18n-3.0.4 by Joerg Hoh · 3 weeks ago org.apache.sling.i18n-3.0.4
  3. b68af57 SLING-13171 use jakarta.json for JSON parsing (#28) by Eric Norman · 3 weeks ago
  4. 3f59e02 [maven-release-plugin] prepare for next development iteration by Joerg Hoh · 3 weeks ago
  5. ed90170 [maven-release-plugin] prepare release org.apache.sling.i18n-3.0.2 by Joerg Hoh · 3 weeks ago

Apache Sling

Build Status Test Status Coverage Sonarcloud Status JavaDoc Maven Central License

Apache Sling I18N Support

This module is part of the Apache Sling project.

Support for creating Java I18N ResourceBundles from repository resources. Further details in https://sling.apache.org/documentation/bundles/internationalization-support-i18n.html.

Dictionary updates

Entry additions, edits, and removals below known dictionary roots refresh only the bundles using those roots and their dependent locales, including all matching basenames. Unrelated cached bundles remain unchanged. Changes to dictionary roots (including locale or basename metadata), removal of their ancestors, and discovery of new dictionaries still trigger a full refresh. Observation respects the configured included and excluded paths. A legitimate full refresh still clears the cache before loading replacements; this does not eliminate the availability gap during that refresh.

JSON content events below a known file root are targeted. Providers that report content updates at the dictionary root, including the JCR provider's nt:file events, retain full-refresh behavior.

When preload.bundles is enabled, an individual bundle refresh reloads parents before their dependent locales so that refreshed bundles use current fallback translations. With preloading disabled, affected bundles are invalidated and loaded on demand. Existing bundle objects remain snapshots; callers should request a bundle again to obtain refreshed translations.