Reo.Core.PredicateBuilder 10.0.11

Reo.Core.PredicateBuilder

Описание пакета

Reo.Core.PredicateBuilder — это утилита для создания динамических предикатов, которые можно использовать в LINQ-запросах для фильтрации данных. Пакет упрощает работу с условиями, особенно при построении сложных фильтров, которые могут изменяться в зависимости от входных параметров. Основные функции включают:

• Создание предикатов для строк (например, поиск с учетом регистра, проверка на пустоту).
• Проверка на наличие значений в коллекциях.
• Сравнение идентификаторов сущностей.
• Поддержка работы с nullable-типами.

Основные компоненты

• PredicateBuilder: Основной класс, предоставляющий методы для построения предикатов.
• CallStringMethodCaseInsensitive: Метод для выполнения строковых операций (например, Contains, StartsWith) с учетом регистра.
• CallSelectorWithEnumerableContainsMethod: Проверка наличия значения в коллекции.
• GetIdComparisonExpression: Создание выражения для сравнения идентификатора сущности с заданным значением.
• GetIsNullOrWhiteSpaceExpression: Проверка строки на пустоту или наличие только пробелов.
• GetHasValueExpression: Проверка nullable-типа на наличие значения.

Требования

• Совместимость с .NET:
  • .NET Standard 2.1
  • .NET 8.0
  • .NET 9.0
• Дополнительные зависимости: Пакет не требует внешних зависимостей.

Установка

NuGet Package Manager

Install-Package Reo.Core.PredicateBuilder

.NET CLI

dotnet add package Reo.Core.PredicateBuilder

Настройка

Пакет не требует регистрации в DI-контейнере. Его можно использовать напрямую в коде, создавая экземпляры PredicateBuilder и используя его методы.

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

Пример 1: Проверка строки на включение подстроки (не зависящее от регистра)

var predicate = PredicateBuilder.CallStringMethodCaseInsensitive(
    x => x.Name,
    "test",
    nameof(string.Contains)
);

Пример 2: Проверка, что строка не пустая и не состоит из пробелов

var predicate = PredicateBuilder.GetIsNullOrWhiteSpaceExpression(
    x => x.Description,
    applyNegative: true
);

Пример 3: Проверка наличия значения в коллекции

var predicate = PredicateBuilder.CallSelectorWithEnumerableContainsMethod(
    x => x.Tags,
    "Important",
    applyNegative: false
);

Пример 4: Сравнение идентификатора сущности

var predicate = PredicateBuilder.GetIdComparisonExpression(
    id: 123,
    selectorBody: x => x.Id
);

Лицензия

Данный пакет распространяется под лицензией MIT.