agile-dictionary : словарь парсер

    private String country;
    private String city;
    private String region;

    @Dictionary(fieldName = {"country"})
    private String countryValue;
    @Dictionary(fieldName = {"country", "city"})
    private String cityValue;
    @Dictionary(fieldName = {"country", "city", "region"})
    private String regionValue;

    private String countryName;

    @Dictionary(fieldName = "countryName", directionType = DirectionType.NameToCode)
    private String countryCode;

<!-- Объявление центрального репозитория -->
<repository>
    <id>central</id>
    <url>https://repo1.maven.org/maven2/</url>
</repository>

<!-- Добавление зависимости -->
<dependency>
    <groupId>cloud.agileframework</groupId>
    <artifactId>agile-dictionary</artifactId>
    <version>2.1.0.M5</version>
</dependency>

    /**
     * Преобразование объекта словаря
     *
     * @param fullCode полный путь словарной записи, например status.yes
     * @return объект данных словаря
     */
    public static DictionaryDataBase coverDicBean(String fullCode);

    /**
     * Преобразование объекта словаря
     *
     * @param fullCode  полный путь словарной записи, например status-yes
     * @param splitChar пользовательский разделитель, например '-'
     * @return объект данных словаря
     */
    public static DictionaryDataBase coverDicBean(String fullCode, String splitChar);
```    /**
     * Преобразование объекта словаря
     *
     * @param fullName полный путь значения словаря
     * @return объект данных словаря
     */
    public static DictionaryDataBase convertDictionaryBeanByFullName(String fullName);

    /**
     * Преобразование объекта словаря
     *
     * @param fullName  полный путь значения словаря
     * @param splitChar пользовательский разделитель
     * @return объект данных словаря
     */
    public static DictionaryDataBase convertDictionaryBeanByFullName(String fullName, String splitChar);

    /**
     * Получение словаря по родительской словарной записи и значению подсловаря
     *
     * @param parentCode родительская словарная запись
     * @param name       значение подсловаря
     * @return данные словаря
     */
    public static DictionaryDataBase convertDictionaryBeanByParent(String parentCode, String name);

    /**
     * Преобразование кода в значение словаря
     *
     * @param fullCodes полный путь словарной записи, поддерживаются множественные записи с разделителем запятой, результат - значения без полного пути, разделённые запятой
     * @return значения словаря
     */
    public static String convertDictionaryName(String fullCodes);

    /**
     * Преобразование кода в значение словаря
     *
     * @param fullCodes   полный путь словарной записи, поддерживаются множественные записи с разделителем запятой, результат - значения без полного пути, разделённые запятой
     * @param defaultName значение по умолчанию при отсутствии соответствия
     * @return значения словаря
     */
    public static String convertDictionaryName(String fullCodes, String defaultName);```java
    /**
     * Преобразование значений словаря на основе родительского словаря и нескольких дочерних словарей (разделены запятой)
     *
     * @param parentCode   Код полного пути родительского словаря
     * @param codes        Коллекция кодов дочерних словарей, разделённых запятой
     * @param defaultValue Значение по умолчанию
     * @return Коллекция значений дочерних словарей без полного пути, разделённых запятой
     */
    public static String coverDicNameByParent(String parentCode, String codes, String defaultValue);

    /**
     * Преобразование значений словарей на основе родительского словаря и множественного потомков (через запятую)
     *
     * @param parentCode   Полный путь родительского кода словаря
     * @param codes        Коллекция кодов потомков, разделённых запятыми
     * @param defaultValue Значение по умолчанию
     * @param isFull       Режим полного пути для перевода (true - да, false - нет)
     * @param splitChar    Пользовательский разделитель
     * @return Значения словаря, разделённые запятыми
     */
    public static String coverDicNameByParent(String parentCode, String codes, String defaultValue, boolean isFull, String splitChar);
```    /**
     * Преобразование кода в значение словаря
     *
     * @param fullCodes   Полный путь кода словаря, поддерживающий несколько полных путей через запятую, результат — значения словаря, разделённые запятыми
     * @param defaultName Значение по умолчанию при отсутствии словаря
     * @param isFull      true — полное имя, false — значение словаря
     * @param splitChar   Пользовательский разделитель
     * @return Значение словаря
     */
    public static String coverDicName(String fullCodes, String defaultName, boolean isFull, String splitChar);

    /**
     * Преобразование значения словаря в код словаря
     *
     * @param fullNames Полный путь значения словаря, поддерживающий несколько полных путей через запятую, результат — коллекция кодов словаря, разделённых запятыми
     * @return Код словаря
     */
    public static String coverDicCode(String fullNames);

    /**
     * Преобразование значения словаря в код словаря
     * @param defaultCode Значение по умолчанию при отсутствии словаря
     * @param fullNames Полный путь значения словаря, поддерживающий несколько полных путей через запятую, результат — коллекция кодов словаря, разделённых запятыми
     * @return Код словаря
     */
    public static String coverDicCode(String fullNames, String defaultCode);    /**
     * Преобразование значений словаря на основе родительского значения и множества потомков (через запятую)
     *
     * @param parentName Полный путь родительского значения словаря
     * @param names      Коллекция значений потомков, разделённых запятыми
     * @return Коллекция кодов потомков, разделённых запятыми, без полного пути
     */
    public static String coverDicCodeByParent(String parentName, String names);    /**
     * Преобразование значений словаря на основе родительского значения и множества потомков (через запятую)
     *
     * @param parentName   Полный путь родительского значения словаря
     * @param names        Коллекция значений потомков, разделённых запятыми
     * @param defaultValue Значение по умолчанию
     * @return Коллекция кодов потомков, разделённых запятыми, без полного пути
     */
    public static String coverDicCodeByParent(String parentName, String names, String defaultValue);
    
    /**
     * Преобразование словарной кодировки на основе значений родительского словаря и значений дочерних словарей (через запятую)
     *
     * @param parentName   Полное имя родительского словаря
     * @param names        Коллекция значений дочерних словарей, разделённых запятыми
     * @param defaultValue Значение по умолчанию
     * @param isFull       Признак полного пути при переводе
     * @param splitChar    Разделитель
     * @return Словарная кодировка, разделённая запятыми
     */
    public static String coverDicCodeByParent(String parentName, String names, String defaultValue, boolean isFull, String splitChar);

    /**
     * Преобразование кодировки в значение словаря
     *
     * @param fullNames    Полное имя словаря, поддерживающее несколько полных имён словарей через запятую, результат — кодировка словаря без полного имени, разделённая запятыми
     * @param defaultName  Значение по умолчанию
     * @param isFull       true если полное имя, false если значение словаря
     * @param splitChar    Разделитель
     * @return Кодировка словаря
     */
    public static String coverDicCode(String fullNames, String defaultName, boolean isFull, String splitChar);    /**
     * Инструмент преобразования коллекций в словарную кодировку, преобразует в тип List/Map
     *
     * @param list           Коллекция для преобразования
     * @param dictionaryCode Используемый словарь
     * @param suffix         Конечный суффикс для хранения значения словаря
     * @param column         Количество колонок для преобразования
     * @param <T>            Генерик
     * @return Возвращает тип List/Map с добавленным _text полем
     * @throws NoSuchFieldException   Исключение "нет такого поля"
     * @throws IllegalAccessException Исключение "недопустимый доступ"
     */
    public static <T> List<Map<String, Object>> coverMapDictionary(List<T> list, String dictionaryCode, String suffix, String column);```markdown
/**
 * Преобразование объекта в словарь
 *
 * @param o               Объект POJO или Map
 * @param dictionaryCodes Словарные кодировки для колонок, количество должно совпадать с количеством колонок
 * @param suffix          Заключительный суффикс для хранения значения словаря
 * @param columns         Колонки для преобразования
 * @param <T>             Генерик
 * @return Преобразованное значение Map
 * @throws NoSuchFieldException   Исключение "нет такого поля"
 * @throws IllegalAccessException Исключение "недопустимый доступ"
 */
public static <T> Map<String, Object> coverMapDictionary(T o, String[] dictionaryCodes, String suffix, String[] columns);

/**
 * Инструмент преобразования типов коллекций в список/List/T типа
 *
 * @param list            Коллекция, которую требуется преобразовать
 * @param dictionaryCodes Используемые коды словарей
 * @param columns         Набор полей для преобразования
 * @param <T>             Генерик
 * @return Возвращает список/List/Map типа, поля со словарными кодами автоматически преобразуются в значения словарей
 */
public static <T> List<T> coverBeanDictionary(List<T> list, String[] dictionaryCodes, String[] columns, String[] textColumns, String[] defaultValues);
```Примечание: В данном контексте "generic type" обычно не переводится, так как это общепринятый термин в программировании. Однако, если требуется более подробное объяснение, можно использовать "общий тип".

```markdown
/**
 * Автоматическое преобразование словарей, анализирует аннотацию Dictionary
 *
 * @param o   Целевой объект данных
 * @param <T> Общий тип
 */
public static <T> void cover(T o);

/**
 * Автоматическое преобразование словарей, анализирует аннотацию Dictionary
 *
 * @param list Целевой список объектов данных
 * @param <T>  Общий тип
 */
public static <T> void cover(List<T> list);

    public static class TuDou {
        /**
         * Ключ словаря
         */
        private String status;

        /**
         * Приведённое значение словаря после перевода
         */
        @Dictionary(fieldName = "status", isFull = true)
        private String text;
        ...
    }

```markdown
//DictionaryDataBase: базовый класс структурированных данных словаря (обычно используется для ORM отображения таблиц словарей в базе данных), предоставляет id, parentId, children, sort и другие свойства
@Entity
public class MyDictionaryDo extends DictionaryDataBase {
    //Примечание
    private String commit;
    //
}

//AbstractDictionaryDataManager: абстрактный менеджер данных словаря (предоставляет API взаимодействия с уровнем хранения, такие как операции CRUD словаря и синхронизация вторичного кэша)
@Service
public class MyDictionaryService extends AbstractDictionaryDataManager {
    ...
}

//Общее использование
//Обратите внимание, что методы add, update и другие в MyDictionaryService являются прямыми операциями уровня хранения, тогда как методы add, update и другие внутри sync() выполняют операции уровня хранения + синхронизацию первичного и вторичного кэшей
@Autowired
private MyDictionaryService service;

public void crud(MyDictionaryDo dic) {
    //Добавление
    service.sync().add(dic);
    //Редактирование
    service.sync().update(dic);
    //Удаление
    service.sync().delete(dic);
    //Запрос
    service.sync().all();
    service.sync().tree();
}

@Target({ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Dictionary {
```    String NULL = "null";

    /**
     * Код словаря
     */
    String dicCode() default "";

    /**
     * Название поля словаря
     */
    String[] fieldName();

    /**
     * Включает ли полное путь к значениям
     */
    boolean isFull() default false;

    /**
     * Разделитель полного пути к значениям
     */
    String split() default ".";

    /**
     * Направление перевода
     */
    DirectionType directionType() default DirectionType.CODE_TO_NAME;

    /**
     * Значение по умолчанию при отсутствии данных
     */
    String defaultValue() default NULL;

    /**
     * Является ли это первичным ключом
     *
     * Если является первичным ключом, то вызывается метод findById
     */
    boolean id() default false;

    /**
     * Определение источника данных
     */
    String dataSource() default Constant.AgileAbout.DIC_DATASOURCE;
}