OSCHINA-MIRROR/gl_git-Elasticsearch-Helper

Elasticsearch-Helper

— QQ群：199016700—

简介

Elasticsearch-Helper — это инструмент для работы с Java и Elasticsearch RHLC API, который упрощает использование официального API. Он снижает сложность изучения API, уменьшает объём кода и повышает эффективность работы.

Текущая версия Elasticsearch-Helper в основном упрощает операции фильтрации данных различных форматов. Инструмент упаковывает часто используемые типы данных и позволяет фильтровать их с помощью аннотаций. Это помогает сократить объём кода.

Проект создан на основе Springboot, поэтому требуется JDK версии 8 или выше.

Проект: зависимости и версии

 Java версия: 1.8
 ES версия: 7.2.1

Использование

Добавьте проект в существующий проект как модуль. Удалите файл конфигурации application.yml и настройте ES-узлы в файле конфигурации вашего основного проекта (elasticsearch.nodes). См. конфигурацию файла для получения подробной информации о настройке.
Создайте экземпляр вспомогательного класса:

@Bean("searchHelper")
public ElasticSearchHelper elasticSearchHelper(@Autowired RestHighLevelClient highLevelClient){
    return new ElasticSearchHelper(highLevelClient);
}

Внедрите searchHelper в другие классы.

Аннотации

В качестве примера рассмотрим класс FilterBean.java.

Аннотация @FilterType по умолчанию имеет строковый тип. Обратите внимание, что не следует определять другие типы для свойств. Поскольку при передаче значений в ES не требуется преобразование типов, рекомендуется использовать строки.

Наименование	Описание
value	Помечает тип значения. По умолчанию — строка. Для просмотра поддерживаемых типов обратитесь к аннотации @FType.
ignoreValue	Игнорирует значение фильтра. Например, если ignoreValue = "0", данные с нулевым значением в ES игнорируются. Подходит для случаев, когда нужно отфильтровать некоторые данные, но сохранить часть из них. Также применимо к случаям с использованием значений по умолчанию.
alias	Устанавливает псевдоним. Полезно, когда одно поле требует разных операций фильтрации. Можно создать несколько полей и установить значение псевдонима для поля, которое нужно фильтровать.
separator	Разделитель для нескольких данных. По умолчанию используется запятая.
exist	Определяет, использовать ли условие фильтрации. По умолчанию true.

Наименование	Описание
STRING	Строка. Тип по умолчанию. Рекомендуется использовать этот тип без особых условий.
DATE	Тип даты. Формат по умолчанию: #. Разделитель можно изменить с помощью свойства separator аннотации @FilterType. Пример формата: 2016#2019.
ARRAY	Тип значения. Значения разделяются запятой по умолчанию. Пример формата: a,b,c. Разделитель также можно изменить с помощью свойства separator аннотации @FilterType.
EXISTS	Определяет наличие поля. Значение true означает, что поле не пустое. Значение false означает, что поле пустое.
MUST_NOT	После установки этого значения все данные исключаются.
MATCHQUERY	Нечёткое соответствие запросу.