Skip to content

Commit

Permalink
refactor: Рефакторинг архитектуры
Browse files Browse the repository at this point in the history
  • Loading branch information
Stivo182 committed Feb 28, 2025
1 parent 2323944 commit f8d087a
Show file tree
Hide file tree
Showing 18 changed files with 704 additions and 291 deletions.
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ src/

## Глобальные локали

Глобальные локали необходимы для автоматического определения пакета ресурсов. Взаимодействие с ними происходит через статичный класс библиотеки `РегиональныеНастройки`.
Глобальные локали необходимы для автоматического определения пакета ресурсов. Взаимодействие с ними происходит через статичный класс библиотеки `Мультиязычность`.

### Текущая локаль

Expand All @@ -151,10 +151,10 @@ src/

``` bsl
// Получение
ТекущаяЛокаль = РегиональныеНастройки.ТекущаяЛокаль();
ТекущаяЛокаль = Мультиязычность.ТекущаяЛокаль();
// Установка
РегиональныеНастройки.УстановитьЛокаль("es_ES");
Мультиязычность.УстановитьЛокаль("es_ES");
```

### Локаль по умолчанию
Expand All @@ -164,10 +164,10 @@ src/

``` bsl
// Получение
ЛокальПоУмолчанию = РегиональныеНастройки.ЛокальПоУмолчанию();
ЛокальПоУмолчанию = Мультиязычность.ЛокальПоУмолчанию();
// Установка
РегиональныеНастройки.УстановитьЛокальПоУмолчанию("es_ES");
Мультиязычность.УстановитьЛокальПоУмолчанию("es_ES");
```

## Встраивание в код приложения
Expand Down
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
## Статичные классы (Модули)

- [МенеджерРесурсовЛокализации](МенеджерРесурсовЛокализации.md)
- [РегиональныеНастройки](РегиональныеНастройки.md)
- [Мультиязычность](Мультиязычность.md)

## Классы

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,11 @@
## Методы

[ДобавитьПакет](#добавитьпакет) </br>
[СодержитКлюч](#содержитключ) </br>
[Получить](#получить) </br>
[ПолучитьСтроку](#получитьстроку) </br>
[ЗаполнитьШаблон](#заполнитьшаблон) </br>
[УстановитьРодителя](#установитьродителя)
[ИспользоватьПоУмолчанию](#использоватьпоумолчанию)


## ДобавитьПакет
Expand Down Expand Up @@ -79,6 +81,30 @@
Получает значение ресурса по ключу. Возвращает `Неопределено` в случае, если ресурс не найден.


## ПолучитьСтроку

**Синтаксис:**

```bsl
ПолучитьСтроку(<ИмяРесурса>), <ЗначениеПараметра1-ЗначениеПараметра9>)
```

**Параметры:**

| Имя | Тип | Значение по умолчанию | Описание |
| -- | -- | -- | -- |
| **ИмяРесурса** | Строка | | Имя ресурса |
| ЗначениеПараметра1-ЗначениеПараметра9 | Строка | `Неопределено` | Параметры, содержащие произвольные значения, строковые представления которых должны быть подставлены в шаблон |

**Возвращаемое значение:**

Тип: Строка, Неопределено.

**Описание:**

Получает строковое значение ресурса с подставлением параметров по принципу функции `СтрШаблон`. Возвращает `Неопределено` в случае, если ресурс не найден.


## ЗаполнитьШаблон

**Синтаксис:**
Expand All @@ -96,3 +122,16 @@
**Описание:**

Заполняет шаблон ресурсами из пакета заменяя конструкцию `{t(ИмяРесурса)}` на значение ресурса.


## ИспользоватьПоУмолчанию

**Синтаксис:**

```bsl
ИспользоватьПоУмолчанию()
```

**Описание:**

Устанавливает группу пакетов ресурсов по умолчанию.
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
| Имя | Тип | Значение по умолчанию | Описание |
| -- | -- | -- | -- |
| **БазовоеИмя** | Строка | | Базовое имя пакета |
| КодЛокализации | Строка | `Неопределено` | Код локализации (ru_RU, en_US, de, nl). Если значение не указано, то используется [текущая локаль](РегиональныеНастройки.md#текущаялокаль). |
| КодЛокализации | Строка | `Неопределено` | Код локализации (ru_RU, en_US, de, nl). Если значение не указано, то используется [текущая локаль](Мультиязычность.md#текущаялокаль). |

**Возвращаемое значение:**

Expand All @@ -47,7 +47,7 @@
| Имя | Тип | Значение по умолчанию | Описание |
| -- | -- | -- | -- |
| **БазовыеИмена** | Строка | | Перечень имен пакетов через запятую |
| КодЛокализации | Строка | `Неопределено` | Код локализации (ru_RU, en_US, de, nl). Если значение не указано, то используется [текущая локаль](РегиональныеНастройки.md#текущаялокаль). |
| КодЛокализации | Строка | `Неопределено` | Код локализации (ru_RU, en_US, de, nl). Если значение не указано, то используется [текущая локаль](Мультиязычность.md#текущаялокаль). |

**Возвращаемое значение:**

Expand Down
224 changes: 224 additions & 0 deletions docs/Мультиязычность.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,224 @@
# Мультиязычность

## Методы

[ТекущаяЛокаль](#текущаялокаль) </br>
[УстановитьЛокаль](#установитьлокаль) </br>
[ЛокальПоУмолчанию](#локальпоумолчанию) </br>
[УстановитьЛокальПоУмолчанию](#установитьлокальпоумолчанию) </br>
[ТекущийЯзык](#текущийязык) </br>
[ТекущаяСтрана](#текущаястрана) </br>
[ПакетРесурсовПоУмолчанию](#пакетресурсовпоумолчанию) </br>
[УстановитьПакетРесурсовПоУмолчанию](#установитьпакетресурсовпоумолчанию) </br>
[ПолучитьРесурс](#получитьресурс) </br>
[ПолучитьСтроку](#получитьстроку) </br>
[ЗаполнитьШаблон](#заполнитьшаблон)


## ТекущаяЛокаль

**Синтаксис:**

```bsl
ТекущаяЛокаль()
```

**Возвращаемое значение:**

Тип: Строка.

**Описание:**

Получает текущую локаль.


## УстановитьЛокаль

**Синтаксис:**

```bsl
УстановитьЛокаль(<КодЛокализации>)
```

**Параметры:**

| Имя | Тип | Описание |
| -- | -- | -- |
| **КодЛокализации** | Строка | Код локализации (ru_RU, en_US, de, nl) |

**Описание:**

Устанавливает текущую локаль.


## ЛокальПоУмолчанию

**Синтаксис:**

```bsl
ЛокальПоУмолчанию()
```

**Возвращаемое значение:**

Тип: Строка.

**Описание:**

Получает локаль по умолчанию.


## УстановитьЛокальПоУмолчанию

**Синтаксис:**

```bsl
УстановитьЛокальПоУмолчанию(<КодЛокализации>)
```

**Параметры:**

| Имя | Тип | Описание |
| -- | -- | -- |
| **КодЛокализации** | Строка | Код локализации (ru_RU, en_US, de, nl) |

**Описание:**

Устанавливает локаль по умолчанию.


## ТекущийЯзык

**Синтаксис:**

```bsl
ТекущийЯзык()
```

**Возвращаемое значение:**

Тип: Строка.

**Описание:**

Получает код языка текущей локали.


## ТекущаяСтрана

**Синтаксис:**

```bsl
ТекущаяСтрана()
```

**Возвращаемое значение:**

Тип: Строка.

**Описание:**

Получает код страны текущей локали.


## ПакетРесурсовПоУмолчанию

**Синтаксис:**

```bsl
ПакетРесурсовПоУмолчанию()
```

**Возвращаемое значение:**

Тип: [ПакетРесурсовЛокализации](ПакетРесурсовЛокализации.md), [ГруппаПакетовРесурсовЛокализации](ГруппаПакетовРесурсовЛокализации.md).

**Описание:**

Получает пакет ресурсов по умолчанию.


## УстановитьПакетРесурсовПоУмолчанию

**Синтаксис:**

```bsl
УстановитьПакетРесурсовПоУмолчанию(<Пакет>)
```

**Параметры:**

| Имя | Тип | Описание |
| -- | -- | -- |
| **Пакет** | [ПакетРесурсовЛокализации](ПакетРесурсовЛокализации.md)</br> [ГруппаПакетовРесурсовЛокализации](ГруппаПакетовРесурсовЛокализации.md) | Пакет или группа пакетов ресурсов |

**Описание:**

Устанавливает пакет ресурсов по умолчанию.


## ПолучитьРесурс

**Синтаксис:**

```bsl
ПолучитьРесурс(<ИмяРесурса>)
```

**Параметры:**

| Имя | Тип | Описание |
| -- | -- | -- |
| **ИмяРесурса** | Строка | Имя ресурса |

**Возвращаемое значение:**

Тип: Проивзольный.

**Описание:**

Получает ресурс по имени из пакета ресурсов по умолчанию. Возвращает `Неопределено` в случае, если ресурс не найден.


## ПолучитьСтроку

**Синтаксис:**

```bsl
ПолучитьСтроку(<ИмяРесурса>), <ЗначениеПараметра1-ЗначениеПараметра9>)
```

**Параметры:**

| Имя | Тип | Значение по умолчанию | Описание |
| -- | -- | -- | -- |
| **ИмяРесурса** | Строка | | Имя ресурса |
| ЗначениеПараметра1-ЗначениеПараметра9 | Строка | `Неопределено` | Параметры, содержащие произвольные значения, строковые представления которых должны быть подставлены в шаблон |

**Возвращаемое значение:**

Тип: Строка, Неопределено.

**Описание:**

Получает строковое значение ресурса из пакета ресурсов по умолчанию с подставлением параметров по принципу функции `СтрШаблон`. Возвращает `Неопределено` в случае, если ресурс не найден.


## ЗаполнитьШаблон

**Синтаксис:**

```bsl
ЗаполнитьШаблон(<Шаблон>, <Пакет>)
```

**Параметры:**

| Имя | Тип | Значение по умолчанию | Описание |
| -- | -- | -- | -- |
| **Шаблон** | Строка | | Текст шаблона |
| Пакет | Строка | `Неопределено` | [ПакетРесурсовЛокализации](ПакетРесурсовЛокализации.md)</br> [ГруппаПакетовРесурсовЛокализации](ГруппаПакетовРесурсовЛокализации.md) | Пакет или группа пакетов ресурсов. Если пакет не указан, то используется пакет по умолчанию. |

**Описание:**

Заполняет шаблон ресурсами из пакета заменяя конструкцию `{t(ИмяРесурса)}` на значение ресурса.
Loading

0 comments on commit f8d087a

Please sign in to comment.