{"id":34936858,"url":"https://github.com/microsphere-projects/microsphere-i18n","last_synced_at":"2026-04-05T15:00:54.934Z","repository":{"id":212009448,"uuid":"720009747","full_name":"microsphere-projects/microsphere-i18n","owner":"microsphere-projects","description":"The microsphere projects for internationalisation","archived":false,"fork":false,"pushed_at":"2026-04-03T11:16:52.000Z","size":688,"stargazers_count":9,"open_issues_count":0,"forks_count":18,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T15:14:00.821Z","etag":null,"topics":["cloud-native","devops","i18n","internationalisation","java","microservices","microsphere","spring"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsphere-projects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-17T11:35:59.000Z","updated_at":"2026-04-03T09:25:46.000Z","dependencies_parsed_at":"2024-02-28T08:31:23.301Z","dependency_job_id":"b28f99eb-bcc1-4b8e-b5e7-a278053fd8b5","html_url":"https://github.com/microsphere-projects/microsphere-i18n","commit_stats":null,"previous_names":["microsphere-projects/microsphere-i18n"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/microsphere-projects/microsphere-i18n","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-i18n","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-i18n/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-i18n/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-i18n/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsphere-projects","download_url":"https://codeload.github.com/microsphere-projects/microsphere-i18n/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-i18n/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31439442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T13:13:19.330Z","status":"ssl_error","status_checked_at":"2026-04-05T13:13:17.778Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud-native","devops","i18n","internationalisation","java","microservices","microsphere","spring"],"created_at":"2025-12-26T18:16:00.258Z","updated_at":"2026-04-05T15:00:54.922Z","avatar_url":"https://github.com/microsphere-projects.png","language":"Java","readme":"# Microsphere Internationalisation\n\n\u003e Microsphere Projects for Internationalisation\n\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/microsphere-projects/microsphere-i18n)\n[![Maven Build](https://github.com/microsphere-projects/microsphere-i18n/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-i18n/actions/workflows/maven-build.yml)\n[![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-i18n/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-i18n)\n![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-i18n.svg)\n![License](https://img.shields.io/github/license/microsphere-projects/microsphere-i18n.svg)\n\nThe Microsphere Internationalisation project is a comprehensive internationalization (i18n) framework designed for Java\napplications, with particular emphasis on Spring-based ecosystems. It provides a modular, extensible architecture for\nmanaging localized messages across different deployment scenarios, from standalone applications to distributed\ncloud-native systems.\n\n## Purpose and Scope\n\nThe Microsphere Internationalisation project extends Spring Cloud Internationalisation with enhanced features including:\n\n- Message Source Hierarchy: The system provides a flexible hierarchy of message sources that can load localized content\n  from various sources including properties files, Spring's `Environment`, and external configuration systems. The\n  `ServiceMessageSource` interface serves as the primary abstraction, with specialized implementations for different\n  resource types.\n- Composite and Delegation Patterns: The `CompositeServiceMessageSource` allows multiple message sources to be combined\n  with configurable priority ordering. The `DelegatingServiceMessageSource` provides Spring Framework integration while\n  maintaining the core abstractions.\n- Dynamic Configuration Support: Through Spring Cloud integration, the system supports runtime updates to message\n  sources without requiring application restarts. This capability is essential for cloud-native applications where\n  configuration can change dynamically.\n- Spring Ecosystem Integration: Progressive integration layers provide seamless compatibility with Spring Framework,\n  Spring Boot auto-configuration, and Spring Cloud distributed configuration management. The system follows Spring\n  conventions and lifecycle patterns.\n\n## Modules\n\n| **Module**                               | **Purpose**                                                                         |\n|------------------------------------------|-------------------------------------------------------------------------------------|\n| **microsphere-i18n-parent**              | Defines the parent POM with dependency management and Spring Cloud version profiles |\n| **microsphere-i18n-dependencies**        | Centralizes dependency management for all project modules                           |\n| **microsphere-i18n-core**                | Provides fundamental i18n abstractions and message source implementations           |\n| **microsphere-i18n-openfeign**           | Message resolution for OpenFeign clients                                            |\n| **microsphere-i18n-spring**              | Integrates with Spring Framework's `MessageSource` and `Environment`                |\n| **microsphere-i18n-spring-boot**         | Auto-configuration and actuator endpoints                                           |\n| **microsphere-i18n-spring-cloud**        | Dynamic configuration updates via cloud config                                      |\n| **microsphere-i18n-spring-cloud-server** | Centralized i18n management server                                                  |\n\n## Getting Started\n\nThe easiest way to get started is by adding the Microsphere Internationalisation BOM (Bill of Materials) to your\nproject's pom.xml:\n\n```xml\n\n\u003cdependencyManagement\u003e\n    \u003cdependencies\u003e\n        ...\n        \u003c!-- Microsphere Internationalisation Dependencies --\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003eio.github.microsphere-projects\u003c/groupId\u003e\n            \u003cartifactId\u003emicrosphere-i18n-dependencies\u003c/artifactId\u003e\n            \u003cversion\u003e${microsphere-i18n.version}\u003c/version\u003e\n            \u003ctype\u003epom\u003c/type\u003e\n            \u003cscope\u003eimport\u003c/scope\u003e\n        \u003c/dependency\u003e\n        ...\n    \u003c/dependencies\u003e\n\u003c/dependencyManagement\u003e\n```\n\n`${microsphere-spring-boot.version}` has two branches:\n\n| **Branches** | **Purpose**                                      | **Latest Version** |\n|--------------|--------------------------------------------------|--------------------|\n| **0.2.x**    | Compatible with Spring Cloud 2022.0.x - 2025.0.x | 0.2.0              |\n| **0.1.x**    | Compatible with Spring Cloud Hoxton - 2021.0.x   | 0.1.0              |\n\nThen add the specific modules you need:\n\n### Spring Scenarios\n\n```xml\n\n\u003cdependencies\u003e\n    \u003cdependency\u003e\n        \u003c!-- Microsphere Internationalisation Spring --\u003e\n        \u003cgroupId\u003eio.github.microsphere-projects\u003c/groupId\u003e\n        \u003cartifactId\u003emicrosphere-i18n-spring\u003c/artifactId\u003e\n    \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\n### Spring Boot Scenarios\n\n```xml\n\n\u003cdependencies\u003e\n    \u003cdependency\u003e\n        \u003c!-- Microsphere Internationalisation Spring Boot --\u003e\n        \u003cgroupId\u003eio.github.microsphere-projects\u003c/groupId\u003e\n        \u003cartifactId\u003emicrosphere-i18n-spring-boot\u003c/artifactId\u003e\n    \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\n### Spring Cloud Scenarios\n\n```xml\n\n\u003cdependencies\u003e\n    \u003cdependency\u003e\n        \u003c!-- Microsphere Internationalisation Spring Cloud --\u003e\n        \u003cgroupId\u003eio.github.microsphere-projects\u003c/groupId\u003e\n        \u003cartifactId\u003emicrosphere-i18n-spring-cloud\u003c/artifactId\u003e\n    \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\n## Building from Source\n\nYou don't need to build from source unless you want to try out the latest code or contribute to the project.\n\nTo build the project, follow these steps:\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/microsphere-projects/microsphere-i18n.git\n```\n\n2. Build the source:\n\n- Linux/MacOS:\n\n```bash\n./mvnw package\n```\n\n- Windows:\n\n```powershell\nmvnw.cmd package\n```\n\n## Contributing\n\nWe welcome your contributions! Please read [Code of Conduct](./CODE_OF_CONDUCT.md) before submitting a pull request.\n\n## Reporting Issues\n\n* Before you log a bug, please search\n  the [issues](https://github.com/microsphere-projects/microsphere-i18n/issues)\n  to see if someone has already reported the problem.\n* If the issue doesn't already\n  exist, [create a new issue](https://github.com/microsphere-projects/microsphere-i18n/issues/new).\n* Please provide as much information as possible with the issue report.\n\n## Documentation\n\n### User Guide\n\n[DeepWiki Host](https://deepwiki.com/microsphere-projects/microsphere-i18n)\n\n[ZRead Host](https://zread.ai/microsphere-projects/microsphere-i18n)\n\n### Wiki\n\n[Github Host](https://github.com/microsphere-projects/microsphere-i18n/wiki)\n\n### JavaDoc\n\n- [microsphere-i18n-core](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-i18n-core)\n- [microsphere-i18n-openfeign](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-i18n-openfeign)\n- [microsphere-i18n-spring](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-i18n-spring)\n- [microsphere-i18n-spring-boot](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-i18n-spring-boot)\n- [microsphere-i18n-spring-cloud](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-i18n-spring-cloud)\n- [microsphere-i18n-spring-cloud-server](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-i18n-spring-cloud-server)\n\n## License\n\nThe Microsphere Spring is released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-i18n","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-i18n","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-i18n/lists"}