مرتب سازی در ASP.NET Core Web API - آموزش برنامه نويسی و طراحی سايت

در این مقاله، ما میخواهیم در مورد مرتب سازی در ASP.NET Core Web API صحبت کنیم. مرتب سازی، یک مکانیسم رایجی است که هر API باید پیاده سازی کند. پیاده سازی آن در ASP.NET Core، به دلیل انعطاف LINQ و یکپارچگی خوب با EF Core، دشوار نیست.

اگر میخواهید ما را در این مقاله همراهی کنید، میتوانید از نقطه شروع پروژه استفاده کنید و اگر میخواهید solution نهایی را بگیرید یا اگر جایی در پروژه برایتان نامفهوم است میتوانید نقطه انتهایی پروژه را ببینید.

توجه: برای دنبال کردن این مقاله، کمی دانش پیشنیاز لازم است. اگر نحوه ایجاد دیتابیس یا نحوه کارکرد معماری مورد نظر را نمیدانید، به شدت توصیه میکنم که مقاله های مورد نظر را رصد نمایید.

در این مقاله ما یاد میگیریم که:

مرتب سازی چیست؟
نحوه پیاده سازی مرتب سازی در ASP.NET Core Web API
بهبود Solution
تست پیاده سازی

شروع کنیم.

مرتب سازی چیست؟

مرتب سازی، در این حالت، اشاره به چینش ترتیب نتایج ما به شیوه مورد نظر، با استفاده از پارامترهای query string دارد. ما نه در مورد الگوریتم های مرتب سازی صحبت می کنیم و نه به چگونگی پیاده سازی الگوریتم های مرتب سازی می پردازیم.

آنچه که ما دنبال آن هستیم این است که چطور کاری کنیم که API ما، نتایج را به آن صورتی که مدنظر ما است را مرتب سازی کند.

اجازه دهید بگوییم که میخواهیم API ما، owner ها را توسط نامشان در یک ترتیب صعودی (ascending) و سپس توسط تاریخ تولدشان به ترتیب نزولی مرتب کند.

به این منظور، API ما باید چیزی شبیه زیر باشد:

https://localhost:5001/api/owner?orderBy=name,dateOfBirth desc

1	https://localhost:5001/api/owner?orderBy=name,dateOfBirth desc

API ما باید تمام پارامترها را در نظر گرفته و نتایج ما را بر اساس آن مرتب کند. در این مورد ما، این به معنای مرتب سازی نتایج بر اساس نام آنها است و سپس اگر owner های همنام وجود داشته باشد ، آنها را بر اساس ویژگی DateOfBirth مرتب سازد.

یک یادآوری داشته باشیم که داده های مربوط به owner های ما در دیتابیس به چه صورت است:

برای نشان دادن این مثال، میخواهیم یک Anna Bosh دیگر به دیتابیس اضافه کنیم. برای آزمایش نتایج می توانید هر آنچه را که می خواهید را اضافه کنید.

بنابراین اجازه دهید تا Anna Bosh دیگری را اضافه کنیم:

این Anna جدید، 10 سال از Anna قبلی بزرگتر است و در یک آدرس متفاوت زندگی میکند.

عالی، حالا ما داده های مورد نیاز را برای تست ویژگی عملکردمان در اختیار داریم.

و البته همانند بقیه ویژگیهایی که تا الان پیاده سازی کردیم (صفحه بندی، فیلترینگ و جستجو)، برای خوب کار کردن با بقیه موارد، باید این مورد را نیز پیاده سازی کنیم. برای مثال، ما باید بتوانیم داده ها را صفحه بندی، فیلتر و مرتب سازی نماییم.

بریم تا راه پیاده سازی این ویژگی را با هم ببینیم.

نحوه پیاده سازی مرتب سازی در ASP.NET Core Web API

اول از همه، از آنجایی که می خواهیم هر موجودیتی براساس تعدادی معیار، قابلیت مرتب سازی داشته باشد، از این رو قصد داریم ویژگی OrderBy را به کلاس پایه QueryStringParameters اضافه کنیم:

public abstract class QueryStringParameters
{
    const int maxPageSize = 50;
    public int PageNumber { get; set; } = 1;

    private int _pageSize = 10;
    public int PageSize
    {
        get
        {
            return _pageSize;
        }
        set
        {
            _pageSize = (value > maxPageSize) ? maxPageSize : value;
        }
    }

    //افزودن این ویژگی برای مرتب سازی
    public string OrderBy { get; set; }
}

public abstract class QueryStringParameters

{

const int maxPageSize = 50;

public int PageNumber { get; set; } = 1;

private int _pageSize = 10;

public int PageSize

{

get

{

return _pageSize;

}

set

{

_pageSize = (value > maxPageSize) ? maxPageSize : value;

}

//افزودن این ویژگی برای مرتب سازی

public string OrderBy { get; set; }

}

ما هیچ مقدار پیشفرضی را برای آن تعیین نمیکنیم، به این دلیل که هر کلاسی میتواند مقادیر پیش فرض خودش را داشته باشد.

به عنوان مثال، میخواهیم OwnerParameters، به صورت پیشفرض، نتایج را بر اساس “name” مرتب سازی کند:

public class OwnerParameters : QueryStringParameters
{

    //name به OrderBy افزودن این متد سازنده جدید و ست کردن ویژگی 
    public OwnerParameters()
    {
        OrderBy = "name";
    }

    public uint MinYearOfBirth { get; set; }
    public uint MaxYearOfBirth { get; set; } = (uint)DateTime.Now.Year;

    public bool ValidYearRange => MaxYearOfBirth > MinYearOfBirth;

    public string Name { get; set; }
}

public class OwnerParameters : QueryStringParameters

{

//name به OrderBy افزودن این متد سازنده جدید و ست کردن ویژگی

public OwnerParameters()

{

OrderBy = "name";

}

public uint MinYearOfBirth { get; set; }

public uint MaxYearOfBirth { get; set; } = (uint)DateTime.Now.Year;

public bool ValidYearRange => MaxYearOfBirth > MinYearOfBirth;

public string Name { get; set; }

}

و میخواهیم Account های ما، توسط ویژگی DateCreated مرتب سازی شوند:

public class AccountParameters : QueryStringParameters
{
    public AccountParameters()
    {
        OrderBy = "DateCreated";
    }
}

public class AccountParameters : QueryStringParameters

{

public AccountParameters()

{

OrderBy = "DateCreated";

}

در مرحله بعد، میخواهیم به مکانیسم مرتب سازی بپردازیم.

نکته ای که باید به آن اشاره کنم این است که میخواهیم از System.Linq.Dynamic.Core NuGet package برای ایجاد کوئری OrderBy به طور داینامیک در آن واحد استفاده کنیم. بنابراین، در صورت تمایل آن را در پروژه Repository نصب کنید و using مورد نظر را در کلاس OwnerRepository اضافه کنید.

یک متد private جدید به نام ApplySort در کلاس OwnerRepository مان اضافه میکنیم:

private void ApplySort(ref IQueryable<Owner> owners, string orderByQueryString)
{
    if (!owners.Any())
        return;

    if (string.IsNullOrWhiteSpace(orderByQueryString))
    {
        owners = owners.OrderBy(x => x.Name);
        return;
    }

    var orderParams = orderByQueryString.Trim().Split(',');
    var propertyInfos = typeof(Owner).GetProperties(BindingFlags.Public | BindingFlags.Instance);
    var orderQueryBuilder = new StringBuilder();

    foreach (var param in orderParams)
    {
        if (string.IsNullOrWhiteSpace(param))
            continue;

        var propertyFromQueryName = param.Split(" ")[0];
        var objectProperty = propertyInfos.FirstOrDefault(pi => pi.Name.Equals(propertyFromQueryName, StringComparison.InvariantCultureIgnoreCase));

        if (objectProperty == null)
            continue;

        var sortingOrder = param.EndsWith(" desc") ? "descending" : "ascending";

        orderQueryBuilder.Append($"{objectProperty.Name.ToString()} {sortingOrder}, ");
    }

    var orderQuery = orderQueryBuilder.ToString().TrimEnd(',', ' ');

    if (string.IsNullOrWhiteSpace(orderQuery))
    {
        owners = owners.OrderBy(x => x.Name);
        return;
    }

    owners = owners.OrderBy(orderQuery);
}

private void ApplySort(ref IQueryable<Owner> owners, string orderByQueryString)

{

if (!owners.Any())

return;

if (string.IsNullOrWhiteSpace(orderByQueryString))

{

owners = owners.OrderBy(x => x.Name);

return;

}

var orderParams = orderByQueryString.Trim().Split(',');

var propertyInfos = typeof(Owner).GetProperties(BindingFlags.Public | BindingFlags.Instance);

var orderQueryBuilder = new StringBuilder();

foreach (var param in orderParams)

{

if (string.IsNullOrWhiteSpace(param))

continue;

var propertyFromQueryName = param.Split(" ")[0];

var objectProperty = propertyInfos.FirstOrDefault(pi => pi.Name.Equals(propertyFromQueryName, StringComparison.InvariantCultureIgnoreCase));

if (objectProperty == null)

continue;

var sortingOrder = param.EndsWith(" desc") ? "descending" : "ascending";

orderQueryBuilder.Append($"{objectProperty.Name.ToString()} {sortingOrder}, ");

}

var orderQuery = orderQueryBuilder.ToString().TrimEnd(',', ' ');

if (string.IsNullOrWhiteSpace(orderQuery))

{

owners = owners.OrderBy(x => x.Name);

return;

}

owners = owners.OrderBy(orderQuery);

}

خب، این یک متد عالی برای مرتب سازی است. ما اینجا در واقع داریم چند کار مختلف را انجام میدهیم تا نتایج را مرتب سازی کنیم، پس بیاید تا مرحله به مرحله آن را بررسی کنیم تا ببینیم دقیقا چه کاری انجام داده ایم.

حال بیاید تا متدمان را کالبدشکافی کنیم.

پیاده سازی – مرحله به مرحله

اول اجازه دهید تا با تعریف متد، کارمان را شروع کنیم. آن، دو ورودی میگیرد. اولی IQueryable<Owner> میباشد که برای گرفتن لیست owner هاست و دومی برای query string جهت مرتب سازی. اگر ما یک درخواست مانند https://localhost:5001/api/owner?orderBy=name,dateOfBirth desc بفرستیم، ورودی orderByQueryString ما، name,dateOfBirth desc خواهد بود.

ما پیاده سازی متدمان را با چند بررسی لازم برای owner ها و queryString شروع میکنیم. اگر هیچ owner ای وجود نداشته باشد، فورا از متد خارج میشویم. اگر لیست ما شامل owner باشد، اما query string خالی باشد، سپس owner ها را توسط نامشان مرتب میکنیم:

if (!owners.Any())
    return;

if (string.IsNullOrWhiteSpace(orderByQueryString))
{
    owners = owners.OrderBy(x => x.Name);
    return;
}

if (!owners.Any())

return;

if (string.IsNullOrWhiteSpace(orderByQueryString))

{

owners = owners.OrderBy(x => x.Name);

return;

}

در مرحله بعد، query string مان را برای گرفتن فیلدها به صورت جداگانه، split میکنیم:

var orderParams = orderByQueryString.Trim().Split(',');

1	var orderParams = orderByQueryString.Trim().Split(',');

همچنین برای تهیه لیست آبجکتهای PropertyInfo که ارائه دهنده خصوصیات کلاس Owner ما است کمی از reflection استفاده میکنیم. ما به آنها، برای اینکه بررسی کنیم که فیلد دریافت شده از طریق query string در کلاس Owner واقعا وجود دارد یا خیر، نیاز داریم:

var propertyInfos = typeof(Owner).GetProperties(BindingFlags.Public | BindingFlags.Instance);

1	var propertyInfos = typeof(Owner).GetProperties(BindingFlags.Public \| BindingFlags.Instance);

با داشتن این لیست، در واقع میتوانیم کل پارامترها را بررسی کنیم تا موجودیتشان را بررسی نماییم:

if (string.IsNullOrWhiteSpace(param))
    continue;

var propertyFromQueryName = param.Split(" ")[0];
var objectProperty = propertyInfos.FirstOrDefault(pi => pi.Name.Equals(propertyFromQueryName, StringComparison.InvariantCultureIgnoreCase));

if (string.IsNullOrWhiteSpace(param))

continue;

var propertyFromQueryName = param.Split(" ")[0];

var objectProperty = propertyInfos.FirstOrDefault(pi => pi.Name.Equals(propertyFromQueryName, StringComparison.InvariantCultureIgnoreCase));

اگر ما پارامتر فعلی را پیدا نکردیم، سپس این مرحله را در حلقه foreach رد میکنیم و به سراغ پارامتر بعدی در لیست میرویم:

if (objectProperty == null)
    continue;

1 2	if (objectProperty == null) continue;

اما اگر پارامتر مورد نظر در لیست پارامترها وجود داشت، آن را برگردانده و علاوه بر آن، بررسی میکنیم که آیا پارامتر ما در انتهای رشته، شامل “desc” است یا خیر. ما این کار را به این خاطر انجام میدهیم تا تعیین نماییم که مرتب سازیمان را بر اساس این ویژگی، به صورت صعودی انجام دهیم یا نزولی:

var sortingOrder = param.EndsWith(" desc") ? "descending" : "ascending";

1	var sortingOrder = param.EndsWith(" desc") ? "descending" : "ascending";

ما از StringBuilder برای ساخت query در هر تکرار از حلقه استفاده میگنیم:

orderQueryBuilder.Append($"{objectProperty.Name.ToString()} {sortingOrder}, ");

1	orderQueryBuilder.Append($"{objectProperty.Name.ToString()} {sortingOrder}, ");

حال که تمام فیلدها را در حلقه پیمایش کردیم، باید کاما اضافی را در انتهای رشته حذف کنیم و یک بررسی نهایی انجام دهیم و ببینیم که کوئری مورد نظر ما، آیا چیزی را شامل میشود یا خیر:

var orderQuery = orderQueryBuilder.ToString().TrimEnd(',', ' ');

if (string.IsNullOrWhiteSpace(orderQuery))
{
    owners = owners.OrderBy(x => x.Name);
    return;
}

var orderQuery = orderQueryBuilder.ToString().TrimEnd(',', ' ');

if (string.IsNullOrWhiteSpace(orderQuery))

{

owners = owners.OrderBy(x => x.Name);

return;

}

در آخر، میتوانیم کوئریمان را order کنیم:

owners = owners.OrderBy(orderQuery);

1	owners = owners.OrderBy(orderQuery);

در این مرحله ، متغیر orderQuery ما باید شامل رشته “Name ascending, DateOfBirth descending” باشد. این بدان معنی است که نتایج ما را ابتدا بر اساس Name به ترتیب صعودی ، و سپس براساس DateOfBirth به ترتیب نزولی مرتب سازی میکند.

کوئری استاندارد LINQ برای این مورد ما به این صورت میباشد:

owners.OrderBy(x => x.Name).ThenByDescending(o => o.DateOfBirth);

1	owners.OrderBy(x => x.Name).ThenByDescending(o => o.DateOfBirth);

این یک ترفند کوچک شسته و رفته به شکل یک کوئری برای زمانی است که از قبل نمی دانید که مرتب سازی بر اساس چه فیلدی باید انجام شود.

فراخوانی متد

اکنون که نحوه کارکرد متد را دیدیم، فقط باید آن را در متد GetOwners خود فراخوانی کنیم:

public PagedList<Owner> GetOwners(OwnerParameters ownerParameters)
{
    var owners = FindByCondition(o => o.DateOfBirth.Year >= ownerParameters.MinYearOfBirth &&
                                o.DateOfBirth.Year <= ownerParameters.MaxYearOfBirth);

    SearchByName(ref owners, ownerParameters.Name);

    //فراخوانی متد
    ApplySort(ref owners, ownerParameters.OrderBy);

    return PagedList<Owner>.ToPagedList(owners,
        ownerParameters.PageNumber,
        ownerParameters.PageSize);
}

public PagedList<Owner> GetOwners(OwnerParameters ownerParameters)

{

var owners = FindByCondition(o => o.DateOfBirth.Year >= ownerParameters.MinYearOfBirth &&

o.DateOfBirth.Year <= ownerParameters.MaxYearOfBirth);

SearchByName(ref owners, ownerParameters.Name);

//فراخوانی متد

ApplySort(ref owners, ownerParameters.OrderBy);

return PagedList<Owner>.ToPagedList(owners,

ownerParameters.PageNumber,

ownerParameters.PageSize);

}

ما لیستی از owner ها و query string OrderBy را به متد پاس می دهیم.

تمام کاری که باید برای پیاده سازی انجام میدادیم همین است. یا شاید نه؟ اگر بخواهیم از ApplySort در AccountRepository استفاده کنیم باید چیکار کنیم؟ آیا باید این logic را در کلاس repository مان نگه داریم؟

برای پاسخ به هر دو سوال باید بگوییم البته که نه.

بیاید ببینیم که چطور میتوانیم متدمان را عمومی تر بسازیم، طوریکه برای هر دو Account repository و Owner repository (یا هر repository دیگری که بعدا اضافه میشود) بتواند مورد استفاده قرار بگیرد.

بهبود Solution

دو چیز است که ما میخواهیم آن را بهبود دهیم. متد private ApplySort را از OwnerRepository خارج کنید و ApplySort را به صورت generic ایجاد کنید.

اجازه دهید کارمان را با تعریف کلاس SortHelper و اینترفیس ISortHelper در پوشه Helpers پروژه Entities شروع کنیم.

اینترفیس ISortHelper باید یک متد ApplySort را تعریف کند:

public interface ISortHelper<T>
{
    IQueryable<T> ApplySort(IQueryable<T> entities, string orderByQueryString);
}

public interface ISortHelper<T>

{

IQueryable<T> ApplySort(IQueryable<T> entities, string orderByQueryString);

}

همانطور که میبینید، ISortHelper یک اینترفیس generic است و میتواند بر روی هر نوعی که ما بخواهیم اعمال شود. ما باید یک کالکشنی از موجودیتها و یک رشته مرتب سازی را در این متد لحاظ کنیم.

حال بیاید تا پیاده سازی واقعی را ببینیم:

public class SortHelper<T> : ISortHelper<T>
{
    public IQueryable<T> ApplySort(IQueryable<T> entities, string orderByQueryString)
    {
        if (!entities.Any())
            return entities;

        if (string.IsNullOrWhiteSpace(orderByQueryString))
        {
            return entities;
        }

        var orderParams = orderByQueryString.Trim().Split(',');
        var propertyInfos = typeof(T).GetProperties(BindingFlags.Public | BindingFlags.Instance);
        var orderQueryBuilder = new StringBuilder();

        foreach (var param in orderParams)
        {
            if (string.IsNullOrWhiteSpace(param))
                continue;

            var propertyFromQueryName = param.Split(" ")[0];
            var objectProperty = propertyInfos.FirstOrDefault(pi => pi.Name.Equals(propertyFromQueryName, StringComparison.InvariantCultureIgnoreCase));

            if (objectProperty == null)
                continue;

            var sortingOrder = param.EndsWith(" desc") ? "descending" : "ascending";

            orderQueryBuilder.Append($"{objectProperty.Name.ToString()} {sortingOrder}, ");
        }

        var orderQuery = orderQueryBuilder.ToString().TrimEnd(',', ' ');

        return entities.OrderBy(orderQuery);
    }
}

public class SortHelper<T> : ISortHelper<T>

{

public IQueryable<T> ApplySort(IQueryable<T> entities, string orderByQueryString)

{

if (!entities.Any())

return entities;

if (string.IsNullOrWhiteSpace(orderByQueryString))

{

return entities;

}

var orderParams = orderByQueryString.Trim().Split(',');

var propertyInfos = typeof(T).GetProperties(BindingFlags.Public | BindingFlags.Instance);

var orderQueryBuilder = new StringBuilder();

foreach (var param in orderParams)

{

if (string.IsNullOrWhiteSpace(param))

continue;

var propertyFromQueryName = param.Split(" ")[0];

var objectProperty = propertyInfos.FirstOrDefault(pi => pi.Name.Equals(propertyFromQueryName, StringComparison.InvariantCultureIgnoreCase));

if (objectProperty == null)

continue;

var sortingOrder = param.EndsWith(" desc") ? "descending" : "ascending";

orderQueryBuilder.Append($"{objectProperty.Name.ToString()} {sortingOrder}, ");

}

var orderQuery = orderQueryBuilder.ToString().TrimEnd(',', ' ');

return entities.OrderBy(orderQuery);

}

این پیاده سازی، قابلیت تزریق این کلاس را به درون repository هایمان و فراخوانی ApplySort هرزمان که به آن نیاز داشتیم را میدهد:

private ISortHelper<Owner> _sortHelper;

public OwnerRepository(RepositoryContext repositoryContext, ISortHelper<Owner> sortHelper)
    : base(repositoryContext)
{
    _sortHelper = sortHelper;
}

private ISortHelper<Owner> _sortHelper;

public OwnerRepository(RepositoryContext repositoryContext, ISortHelper<Owner> sortHelper)

: base(repositoryContext)

{

_sortHelper = sortHelper;

}

همچنین باید RepoWrapper مان را توسعه دهیم چرا که کلاسهای repository مان اینجا نمونه سازی شده اند:

public class RepositoryWrapper : IRepositoryWrapper
{
    private RepositoryContext _repoContext;
    private IOwnerRepository _owner;
    private IAccountRepository _account;
    private ISortHelper<Owner> _ownerSortHelper;
    private ISortHelper<Account> _accountSortHelper;

    public IOwnerRepository Owner
    {
        get
        {
            if (_owner == null)
            {
                _owner = new OwnerRepository(_repoContext, _ownerSortHelper);
            }

            return _owner;
        }
    }

    public IAccountRepository Account
    {
        get
        {
            if (_account == null)
            {
                _account = new AccountRepository(_repoContext, _accountSortHelper);
            }

            return _account;
        }
    }

    public RepositoryWrapper(RepositoryContext repositoryContext,
        ISortHelper<Owner> ownerSortHelper,
        ISortHelper<Account> accountSortHelper)
    {
        _repoContext = repositoryContext;
        _ownerSortHelper = ownerSortHelper;
        _accountSortHelper = accountSortHelper;
    }

    public void Save()
    {
        _repoContext.SaveChanges();
    }
}

public class RepositoryWrapper : IRepositoryWrapper

{

private RepositoryContext _repoContext;

private IOwnerRepository _owner;

private IAccountRepository _account;

private ISortHelper<Owner> _ownerSortHelper;

private ISortHelper<Account> _accountSortHelper;

public IOwnerRepository Owner

{

get

{

if (_owner == null)

{

_owner = new OwnerRepository(_repoContext, _ownerSortHelper);

}

return _owner;

}

public IAccountRepository Account

{

get

{

if (_account == null)

{

_account = new AccountRepository(_repoContext, _accountSortHelper);

}

return _account;

}

public RepositoryWrapper(RepositoryContext repositoryContext,

ISortHelper<Owner> ownerSortHelper,

ISortHelper<Account> accountSortHelper)

{

_repoContext = repositoryContext;

_ownerSortHelper = ownerSortHelper;

_accountSortHelper = accountSortHelper;

}

public void Save()

{

_repoContext.SaveChanges();

}

و حالا میتوانیم آن را در متد GetOwners مان فراخوانی کنیم:

public PagedList<Owner> GetOwners(OwnerParameters ownerParameters)
{
    var owners = FindByCondition(o => o.DateOfBirth.Year >= ownerParameters.MinYearOfBirth &&
                                o.DateOfBirth.Year <= ownerParameters.MaxYearOfBirth);

    SearchByName(ref owners, ownerParameters.Name);

    var sortedOwners = _sortHelper.ApplySort(owners, ownerParameters.OrderBy);

    return PagedList<Owner>.ToPagedList(sortedOwners,
        ownerParameters.PageNumber,
        ownerParameters.PageSize);
}

public PagedList<Owner> GetOwners(OwnerParameters ownerParameters)

{

var owners = FindByCondition(o => o.DateOfBirth.Year >= ownerParameters.MinYearOfBirth &&

o.DateOfBirth.Year <= ownerParameters.MaxYearOfBirth);

SearchByName(ref owners, ownerParameters.Name);

var sortedOwners = _sortHelper.ApplySort(owners, ownerParameters.OrderBy);

return PagedList<Owner>.ToPagedList(sortedOwners,

ownerParameters.PageNumber,

ownerParameters.PageSize);

}

همین کار را در AccountRepository نیز انجام دهید. اگر با پیاده سازی آن مشکل دارید، به پروژه نهایی که لینک آن را در ابتدای مقاله برای شما گذاشتم مراجعه کنید.

و چون ما از تزریق وابستگی برای تزریق SortHelper مان استفاده کرده ایم، نباید فراموش کنیم که آن را در کلاس ServiceExtensions ثبت کنیم:

public static void ConfigureRepositoryWrapper(this IServiceCollection services)
{
    services.AddScoped<ISortHelper<Owner>, SortHelper<Owner>>();
    services.AddScoped<ISortHelper<Account>, SortHelper<Account>>();

    services.AddScoped<IRepositoryWrapper, RepositoryWrapper>();
}

public static void ConfigureRepositoryWrapper(this IServiceCollection services)

{

services.AddScoped<ISortHelper<Owner>, SortHelper<Owner>>();

services.AddScoped<ISortHelper<Account>, SortHelper<Account>>();

services.AddScoped<IRepositoryWrapper, RepositoryWrapper>();

}

کار زیادی انجام دادیم، اما ارزش آن را داشت. حالا میتوانیم مرتب سازی را بر روی هر موجودیتی در پروژه مان اعمال کنیم، حتی اگر موردهای جدیدی را در آینده آضافه کنیم.

حال بیاید تا آن را تست کنیم.

تست پیاده سازی

حالا قسمت جالب ماجرا شروع می شود، بیایید نتیجه تمام تلاش خود را برای آزمایش ببینیم.

اول از همه، کوئری که به عنوان یک مثال استفاده کرده بودیم را امتحان میکنیم:

https://localhost:5001/api/owner?orderBy=name,dateOfBirth desc

1	https://localhost:5001/api/owner?orderBy=name,dateOfBirth desc

پاسخی که میگیریم باید به این صورت باشد:

[
    {
        "id": "261e1685-cf26-494c-b17c-3546e65f5620",
        "name": "Anna Bosh",
        "dateOfBirth": "1974-11-14T00:00:00",
        "address": "27 Colored Row"
    },
    {
        "id": "9c362f85-5581-4182-ac96-b7b88a74dda7",
        "name": "Anna Bosh",
        "dateOfBirth": "1964-11-14T00:00:00",
        "address": "24 Crescent Street"
    },
    {
        "id": "24fd81f8-d58a-4bcc-9f35-dc6cd5641906",
        "name": "John Keen",
        "dateOfBirth": "1980-12-05T00:00:00",
        "address": "61 Wellfield Road"
    },
    {
        "id": "f98e4d74-0f68-4aac-89fd-047f1aaca6b6",
        "name": "Martin Miller",
        "dateOfBirth": "1983-05-21T00:00:00",
        "address": "3 Edgar Buildings"
    },
    {
        "id": "66774006-2371-4d5b-8518-2177bcf3f73e",
        "name": "Nick Somion",
        "dateOfBirth": "1998-12-15T00:00:00",
        "address": "North sunny address 102"
    },
    {
        "id": "a3c1880c-674c-4d18-8f91-5d3608a2c937",
        "name": "Sam Query",
        "dateOfBirth": "1990-04-22T00:00:00",
        "address": "91 Western Roads"
    }
]

[

{

"id": "261e1685-cf26-494c-b17c-3546e65f5620",

"name": "Anna Bosh",

"dateOfBirth": "1974-11-14T00:00:00",

"address": "27 Colored Row"

{

"id": "9c362f85-5581-4182-ac96-b7b88a74dda7",

"name": "Anna Bosh",

"dateOfBirth": "1964-11-14T00:00:00",

"address": "24 Crescent Street"

{

"id": "24fd81f8-d58a-4bcc-9f35-dc6cd5641906",

"name": "John Keen",

"dateOfBirth": "1980-12-05T00:00:00",

"address": "61 Wellfield Road"

{

"id": "f98e4d74-0f68-4aac-89fd-047f1aaca6b6",

"name": "Martin Miller",

"dateOfBirth": "1983-05-21T00:00:00",

"address": "3 Edgar Buildings"

{

"id": "66774006-2371-4d5b-8518-2177bcf3f73e",

"name": "Nick Somion",

"dateOfBirth": "1998-12-15T00:00:00",

"address": "North sunny address 102"

{

"id": "a3c1880c-674c-4d18-8f91-5d3608a2c937",

"name": "Sam Query",

"dateOfBirth": "1990-04-22T00:00:00",

"address": "91 Western Roads"

}

]

همانطور که میبینید، لیست به ترتیب صعودی توسط نام، مرتب شده است و چون دو Anna داریم، از این رو، آنها توسط تاریخ تولد به صورت نزولی مرتب شده اند.

حالا همین مرتب سازی را به صورت معکوس انجام میدهیم:

https://localhost:5001/api/owner?orderBy=name desc,dateOfBirth

1	https://localhost:5001/api/owner?orderBy=name desc,dateOfBirth

نتیجه باید به این صورت باشد:

[
    {
        "id": "a3c1880c-674c-4d18-8f91-5d3608a2c937",
        "name": "Sam Query",
        "dateOfBirth": "1990-04-22T00:00:00",
        "address": "91 Western Roads"
    },
    {
        "id": "66774006-2371-4d5b-8518-2177bcf3f73e",
        "name": "Nick Somion",
        "dateOfBirth": "1998-12-15T00:00:00",
        "address": "North sunny address 102"
    },
    {
        "id": "f98e4d74-0f68-4aac-89fd-047f1aaca6b6",
        "name": "Martin Miller",
        "dateOfBirth": "1983-05-21T00:00:00",
        "address": "3 Edgar Buildings"
    },
    {
        "id": "24fd81f8-d58a-4bcc-9f35-dc6cd5641906",
        "name": "John Keen",
        "dateOfBirth": "1980-12-05T00:00:00",
        "address": "61 Wellfield Road"
    },
    {
        "id": "9c362f85-5581-4182-ac96-b7b88a74dda7",
        "name": "Anna Bosh",
        "dateOfBirth": "1964-11-14T00:00:00",
        "address": "24 Crescent Street"
    },
    {
        "id": "261e1685-cf26-494c-b17c-3546e65f5620",
        "name": "Anna Bosh",
        "dateOfBirth": "1974-11-14T00:00:00",
        "address": "27 Colored Row"
    }
]

[

{

"id": "a3c1880c-674c-4d18-8f91-5d3608a2c937",

"name": "Sam Query",

"dateOfBirth": "1990-04-22T00:00:00",

"address": "91 Western Roads"

{

"id": "66774006-2371-4d5b-8518-2177bcf3f73e",

"name": "Nick Somion",

"dateOfBirth": "1998-12-15T00:00:00",

"address": "North sunny address 102"

{

"id": "f98e4d74-0f68-4aac-89fd-047f1aaca6b6",

"name": "Martin Miller",

"dateOfBirth": "1983-05-21T00:00:00",

"address": "3 Edgar Buildings"

{

"id": "24fd81f8-d58a-4bcc-9f35-dc6cd5641906",

"name": "John Keen",

"dateOfBirth": "1980-12-05T00:00:00",

"address": "61 Wellfield Road"

{

"id": "9c362f85-5581-4182-ac96-b7b88a74dda7",

"name": "Anna Bosh",

"dateOfBirth": "1964-11-14T00:00:00",

"address": "24 Crescent Street"

{

"id": "261e1685-cf26-494c-b17c-3546e65f5620",

"name": "Anna Bosh",

"dateOfBirth": "1974-11-14T00:00:00",

"address": "27 Colored Row"

}

]

میبینیم که همه چیز خیلی عالی کار میکند.

حال میتوانید انواع درخواستهای نامعتبر را مانند درخواستهای نیز امتحان کنید:

https://localhost:5001/api/owner?orderBy=age
https://localhost:5001/api/owner?orderBy= 
https://localhost:5001/api/owner?orderBy=name desc&dateOfBirth

https://localhost:5001/api/owner?orderBy=age

https://localhost:5001/api/owner?orderBy=

https://localhost:5001/api/owner?orderBy=name desc&dateOfBirth

و نتایج را خودتان ببینید.

مورد دیگری را که نیز باید امتحان کنیم این است که آیا solution زمانیکه با صفحه بندی، فیلترینگ و جستجو ترکیب میشود کار میکند یا خیر.

https://localhost:5001/api/owner?pageNumber=1&pageSize=5&orderBy=dateOfBirth asc&minYearOfBirth=1960&maxYearOfBirth=1980&name=Anna

1	https://localhost:5001/api/owner?pageNumber=1&pageSize=5&orderBy=dateOfBirth asc&minYearOfBirth=1960&maxYearOfBirth=1980&name=Anna

آیا میتوانید حدس بزنید که نتیجه این کوئری چیست؟ اگر حدس زدید در قسمت نظرات آن را با ما در میان بگذارید.

تمام. اجازه دهید مبحثمان را خلاصه کنیم.

نتیجه گیری

همانطور که مشاهده کردید، پیش پا افتاده ترین نوع مرتب سازی مانند این، به اندازه معینی از business logic، اندکی validation ،reflection و حتی کمی ساخت کوئری به صورت داینامیک نیاز دارد. اما زمانیکه آن را پیاده سازی میکنید، API شما واقعا همه کاره و انعطاف پذیر میشود.

این پیاده سازی به همان سادگی است که انجام می شود، اما کارهای خاصی وجود دارد که می توانیم برای بهبود آن انجام دهیم. ما میتوانیم یک لایه service پیاده سازی کنیم (این لایه را برای اصل سادگی نداریم)، میتوانیم کدمان را generic کنیم، نه اینکه فقط مختص owner باشد و ما البته میتوانیم یک extension method به نام ApplySort برای IQueryable بسازیم که باعث میشود این solution انعطاف پذیری بیشتری داشته باشد.

در این مقاله، ما موارد زیر را پوشش داده ایم:

تعریف مرتب سازی و نحوه کارکرد آن
یک شیوه پیاده سازی مرتب سازی در ASP.NET Core Web API
تست solution مان برای کوئریهای معتبر و نامعتبر
تست اینکه آیا solution ما به همراه صفحه بندی، فیلترینگ و جستجو کار میکند یا خیر.

کل مبحث مرتب سازی همین بود. اگر سوال و یا نظری دارید ما در قسمت نظرات در خدمت شما هستیم.

در مقاله بعدی، ما موضوع بسیار خوبی درباره data shaping را بیان خواهیم کرد.

لغو پاسخ

ممنون پاينده باشيد

سلام احتمالا جايي در كدتان اشتباه عمل كرديد. اين خطا معمولا به دليل استفاده از كلاس IdentityUser به جاي استفاده…

عالی بود

با سلام من یه پروژه دات نت کور داریم می نویسم و به این خطا برمی خوردم زمانیکه درون ادرس…

سلام ودرود طبق تحقيقي كه در رابطه با elanat انجام دادم، اين يك cms است كه بر اساس asp.net core…

مرتب سازی چیست؟

نحوه پیاده سازی مرتب سازی در ASP.NET Core Web API

پیاده سازی – مرحله به مرحله

فراخوانی متد

بهبود Solution

تست پیاده سازی

نتیجه گیری

نویسنده

لغو پاسخ