com.github._1c_syntax.bsl.languageserver.utils.Resources Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of bsl-language-server Show documentation
Language Server Protocol implementation for 1C (BSL) - 1C:Enterprise 8 and OneScript languages.
There is a newer version: 0.24.0-rc.1
/*
 * This file is a part of BSL Language Server.
 *
 * Copyright (c) 2018-2024
 * Alexey Sosnoviy , Nikita Fedkin  and contributors
 *
 * SPDX-License-Identifier: LGPL-3.0-or-later
 *
 * BSL Language Server is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 3.0 of the License, or (at your option) any later version.
 *
 * BSL Language Server is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with BSL Language Server.
 */
package com.github._1c_syntax.bsl.languageserver.utils;

import com.github._1c_syntax.bsl.languageserver.configuration.Language;
import com.github._1c_syntax.bsl.languageserver.configuration.LanguageServerConfiguration;
import com.github._1c_syntax.utils.StringInterner;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Component;

import java.util.Locale;
import java.util.ResourceBundle;

/**
 * Вспомогательный класс для оптимизированного чтения ресурсов прикладных классов с учетом {@link Language}.
 */
@Component
@RequiredArgsConstructor
public class Resources {

  private static final StringInterner stringInterner = new StringInterner();

  private final LanguageServerConfiguration configuration;

  /**
   * @param clazz    Класс, ресурсы которого необходимо прочитать.
   * @param key      Ключ из {@link ResourceBundle}.
   * @return Содержимое ресурса.
   */
  public String getResourceString(Class clazz, String key) {
    return getResourceString(configuration.getLanguage().getLocale(), clazz, key);
  }

  /**
   * @param clazz    Класс, ресурсы которого необходимо прочитать.
   * @param key      Ключ из {@link ResourceBundle}.
   * @param args     Аргументы для форматирования ресурсной строки.
   * @return Содержимое ресурса.
   */
  public String getResourceString(Class clazz, String key, Object... args) {
    return getResourceString(configuration.getLanguage().getLocale(), clazz, key, args);
  }

  /**
   * @param language Язык получения ресурсной строки.
   * @param clazz    Класс, ресурсы которого необходимо прочитать.
   * @param key      Ключ из {@link ResourceBundle}.
   * @return Содержимое ресурса.
   */
  public static String getResourceString(Language language, Class clazz, String key) {
    return getResourceString(language.getLocale(), clazz, key);
  }

  /**
   * @param locale Язык получения ресурсной строки.
   * @param clazz  Класс, ресурсы которого необходимо прочитать.
   * @param key    Ключ из {@link ResourceBundle}.
   * @return Содержимое ресурса.
   */
  public static String getResourceString(Locale locale, Class clazz, String key) {
    var resourceString = ResourceBundle.getBundle(clazz.getName(), locale, new UTF8Control()).getString(key);
    return stringInterner.intern(resourceString);
  }

  /**
   * @param language Язык получения ресурсной строки.
   * @param clazz    Класс, ресурсы которого необходимо прочитать.
   * @param key      Ключ из {@link ResourceBundle}.
   * @param args     Аргументы для форматирования ресурсной строки.
   * @return Содержимое ресурса.
   */
  public static String getResourceString(Language language, Class clazz, String key, Object... args) {
    return getResourceString(language.getLocale(), clazz, key, args);
  }

  /**
   * @param locale Язык получения ресурсной строки.
   * @param clazz  Класс, ресурсы которого необходимо прочитать.
   * @param key    Ключ из {@link ResourceBundle}.
   * @param args   Аргументы для форматирования ресурсной строки.
   * @return Содержимое ресурса.
   */
  public static String getResourceString(Locale locale, Class clazz, String key, Object... args) {
    var resourceString = String.format(getResourceString(locale, clazz, key), args);
    return stringInterner.intern(resourceString);
  }
}