API локализации Java Properties

Localization.One предлагает нативную поддержку Java Resource Bundles. Забудьте о ручном редактировании файлов .properties и проблемах с кодировкой. Экспортируйте ваши переводы напрямую в стандартном формате, необходимом для JVM, Spring Boot и Kotlin.

Почему разработчики выбирают наш Java API?

  • Ключевая безопасность: Мы автоматически экранируем специальные символы в ключах (пробелы, двоеточия, знаки равенства), что гарантирует правильную загрузку вашего ResourceBundle.
  • Готовность к UTF-8: Мы генерируем современные, чистые файлы, подходящие для Spring Boot и современных Java приложений, устраняя необходимость в конвертации native2ascii.
  • Комментированные заголовки: Файлы включают заголовки с временными метками, что упрощает отслеживание времени последней генерации файла локализации.

Расширенное управление проектом

Мы предоставляем мощные инструменты для организации вашей локализации, независимо от того, насколько велик ваш проект.

Категоризация: Группируйте ваши строки в логическую структуру папок (например, сообщения, валидация, ошибки), чтобы соответствовать структуре вашего ресурсного пакета.

Метки и теги: Помечайте строки пользовательскими метками для фильтрации экспорта через API.

Роли и разрешения: Приглашайте неограниченное количество участников команды и назначайте детализированные роли (Владелец, Администратор, Менеджер, Переводчик).

Webhooks: Получайте уведомления на вашем сервере всякий раз, когда переводы обновляются или утверждаются.

Как интегрировать

Вариант 1: Ручной экспорт (UI)

Полезно для локальной разработки или проверки контента.

  1. Перейдите на ваш Панель управления проектом.
  2. Нажмите кнопку Скачать .
  3. Выберите Java Properties из выпадающего списка форматов.
  4. Выберите язык и скачайте файл .properties.

Вариант 2: Автоматизация с помощью API (CI/CD)

Получите последние переводы напрямую в вашем конвейере сборки Maven или Gradle. Передайте параметр format=properties.

bash\r\n# Скачать английские ресурсы\r\ncurl "https:\/\/api.localization.one\/{YOUR_API_KEY}\/getTranslations?translation_language=1&format=properties" > src\/main\/resources\/messages_en.properties\r\n\r\n# Скачать французские ресурсы\r\ncurl "https:\/\/api.localization.one\/{YOUR_API_KEY}\/getTranslations?translation_language=3&format=properties" > src\/main\/resources\/messages_fr.properties

Вариант 3: Отправка через Webhooks

Настройте Webhook URL в настройках вашего проекта, чтобы полностью автоматизировать процесс.

  • Быстрые обновления: Ваш сервер получает POST-запрос вскоре после изменений (обычно в течение 5 минут).
  • Горячая перезагрузка: Запустите ваше приложение для перезагрузки ресурсных пакетов, когда новые переводы доступны.

Часто задаваемые вопросы

Нужно ли мне запускать native2ascii?

Нет. Мы экспортируем файлы в современном кодировании UTF-8. Большинство современных Java фреймворков (Spring Boot 2+, Java 9+) по умолчанию читают файлы свойств UTF-8. Если вы находитесь на очень старой устаревшей системе, вам все же может понадобиться этап конвертации.

Как обрабатываются пробелы в ключах?

Формат .properties не допускает пробелов в ключах. Наш API автоматически экранирует пробелы и специальные символы (такие как = или :) в ключах, чтобы предотвратить синтаксические ошибки.

Мобильная разработка:

Готовы оптимизировать вашу локализацию Java? Создайте свою бесплатную учетную запись сегодня.