# Dynamic Query
It's a library that allows you to easily query a queryable using a criteria object.
It also offers, to intercept the query using **IQueryInterceptor** implementations.
## Breaking Changes
If you are moving up from v1, the breaking changes details are lower.
## Getting Started
> Install nuget package to your awesome project.
Full Version | NuGet | NuGet Install
------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------:
PoweredSoft.DynamicQuery | [](https://www.nuget.org/packages/PoweredSoft.DynamicQuery/) | ```PM> Install-Package PoweredSoft.DynamicQuery```
PoweredSoft.DynamicQuery.Core | [](https://www.nuget.org/packages/PoweredSoft.DynamicQuery.Core/) | ```PM> Install-Package PoweredSoft.DynamicQuery.Core```
PoweredSoft.DynamicQuery.AspNetCore | [](https://www.nuget.org/packages/PoweredSoft.DynamicQuery.AspNetCore/) | ```PM> Install-Package PoweredSoft.DynamicQuery.AspNetCore```
PoweredSoft.DynamicQuery.AspNetCore.NewtonsoftJson | [](https://www.nuget.org/packages/PoweredSoft.DynamicQuery.AspNetCore.NewtonsoftJson/) | ```PM> Install-Package PoweredSoft.DynamicQuery.AspNetCore.NewtonsoftJson```
## Using in ASP.NET Core
The package Asp.net core of dynamic query will help you start to use Dynamic Query faster in your web project.
> For NET CORE 2.x look at v2.0 branch.
### New in 2.1.3
You may now add a ```IQueryInterceptorProvider``` to return interceptors on top of being able to use AddInterceptor.
```csharp
public interface IQueryInterceptorProvider
{
IEnumerable GetInterceptors(IQueryCriteria queryCriteria, IQueryable queryable);
}
```
### How to configure during startup (NET Core 3)
```csharp
using PoweredSoft.DynamicQuery.AspNetCore.NewtonsoftJson;
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services
.AddMvc()
.AddPoweredSoftJsonNetDynamicQuery();
}
}
```
> How to use in a controller
```csharp
[HttpGet]
public IQueryExecutionResult Get(
[FromServices]YourContext context,
[FromServices]IQueryHandler handler,
[FromServices]IQueryCriteria criteria,
int? page = null,
int? pageSize = null)
{
criteria.Page = page;
criteria.PageSize = pageSize;
IQueryable query = context.Somethings;
var result = handler.Execute(query, criteria);
return result;
}
[HttpPost]
public IQueryExecutionResult Read(
[FromServices]YourContext context,
[FromServices]IQueryHandler handler,
[FromBody]IQueryCriteria criteria)
{
IQueryable query = context.Somethings;
var result = handler.Execute(query, criteria);
return result;
}
```
> New support for async
```csharp
[HttpPost]
public async Task> Read(
[FromServices]YourContext context,
[FromServices]IQueryHandlerAsync handler,
[FromBody]IQueryCriteria criteria)
{
IQueryable query = context.Somethings;
var result = await handler.ExecuteAsync(query, criteria);
return result;
}
```
### Sample Web Project - ASP.NET CORE + EF Core
Visit: https://github.com/PoweredSoft/DynamicQueryAspNetCoreSample
### Breaking Changes if you are migrating from 1.x
Response interface, is now generic ```IQueryResult``` which impacts the way to execute the handler.
#### Grouping results
Since the results are now generic, it's no longer a List