Einführung in die Implementierungsmethode der Paging-Funktion in der ABP-Einführungsreihe

In diesem Abschnitt wird hauptsächlich die Verwendung von ABP für Hintergrund-Paging sowie die Implementierung der ABP-Hintergrund-Paging-Logik erläutert. Außerdem wird gezeigt, wie Sie X.PagedList für Front-End-Paging verwenden.

Nachdem wir das Hinzufügen, Löschen, Ändern und Überprüfen der Aufgabenliste abgeschlossen haben, sprechen wir über die wesentliche Paging-Funktion.

Zuallererst bin ich sehr froh, dass ABP uns dabei geholfen hat, die Paging-Implementierung zu kapseln, was wirklich rücksichtsvoll ist.

Komm schon, schauen wir uns in diesem Abschnitt an, wie man ABP für das Paging verwendet.

1. Paging-Request-DTO-Definition

DatenübertragungObjekt(Datenübertragung Objekts ) wird zur Datenübertragung auf der Anwendungsschicht und der Präsentationsschicht verwendet.

Die Präsentationsschicht übergibt ein Datenübertragungsobjekt (DTO), um eine Anwendungsdienstmethode aufzurufen. Anschließend führt der Anwendungsdienst eine bestimmte Geschäftslogik über das Domänenobjekt aus und gibt das DTO an die Präsentationsschicht zurück. Auf diese Weise werden die Präsentationsschicht und die Domänenschicht vollständig getrennt. In einer gut geschichteten Anwendung verwendet die Präsentationsschicht Domänenobjekte (Lager, Entitäten) nicht direkt.

Wenn wir eine Paging-Anfrage in der Präsentationsebene haben, müssen wir im Allgemeinen zwei Parameter angeben, einer wird zum Markieren der Seite verwendet und der andere ist die Anzahl der Zeilen pro Seite (normalerweise gibt es einen Konfigurationsdatei Konfiguration).

Da Paging eine sehr häufig verwendete Funktion ist, ist es am besten, wenn wir eine Paging-Anfrage in der Präsentationsschicht haben, über ein entsprechendes DTO zu verfügen, um diese beiden Parameter zu kapseln.

Für uns ist im ABP-Quellcode keine solche öffentliche Klasse gekapselt, aber im ABPZero-Projekt ist das entsprechende Paging-Dto definiert.

Das entsprechende Klassendiagramm lautet wie folgt:

Seitensortierung und Filterung des entsprechenden Dto-Klassendiagramms

Es ist ersichtlich, dass es Enthält hauptsächlich die folgenden vier gängigen DTO-Definitionen:

1. PagedInputDto: Paging-Anforderungs-Dto

2. PagedAndSortedInputDto: Paging-Sortierungs-Dto

3. PagedSortedAndFilteredInputDto:Seitensortierungsfilter Dto

4. PagedAndFilteredInputDto: Paging-Filter Dto

Ist es sehr praktisch? Unser Paging ist normalerweise gemischt mit Filterung und Sortierung.

Die folgenden Hauptattribute sind hauptsächlich definiert:

• MaxResultCount: Die Anzahl der Zeilen pro Seite, die aus der definierten Konfiguration abgelesen werden kann .

• SkipCount: Die Anzahl der Sprünge. Die allgemeine Berechnungsformel lautet SkipCount=Page*MaxResultCount (Anzahl der Seiten*Anzahl der Zeilen).

• Filter: Filter String

• Sortierung: Sortieren nach

Ich werde nicht näher auf die konkrete Implementierung eingehen. Ich glaube, dass Sie sie selbst implementieren können, wenn Sie sich das Klassendiagramm genau ansehen. AbpZero definiert diese öffentlichen Dtos im Dto-Ordner der Anwendungsdienstschicht. Die spezifischen Pfade lauten wie folgt.

2. So verwenden Sie Paging-DTO

Nehmen Sie unsere Aufgabenliste als Beispiel, wir ändern sie es und erstellen Sie GetTaskInputDto, lassen Sie von PagedSortedAndFilteredInputDto erben, sodass GetTaskInputDto über die Attribute verfügt, die für die Seitensortierung und -filterung erforderlich sind.

public class GetTasksInput : PagedSortedAndFilteredInputDto
{
 public TaskState? State { get; set; }
 public int? AssignedPersonId { get; set; }
}

3. Paginierte Ergebnisse DTO zurückgeben

PagedResultDto<TaskDto> GetPagedTasks(GetTasksInput input);

public PagedResultDto<TaskDto> GetPagedTasks(GetTasksInput input)
{
 //初步过滤
 var query = _taskRepository.GetAll().Include(t => t.AssignedPerson)
  .WhereIf(input.State.HasValue, t => t.State == input.State.Value)
  .WhereIf(!input.Filter.IsNullOrEmpty(), t => t.Title.Contains(input.Filter))
  .WhereIf(input.AssignedPersonId.HasValue, t => t.AssignedPersonId == input.AssignedPersonId.Value);
 //排序
 query = !string.IsNullOrEmpty(input.Sorting) ? query.OrderBy(input.Sorting) : query.OrderByDescending(t => t.CreationTime);
 //获取总数
 var tasksCount = query.Count();
 //默认的分页方式
 //var taskList = query.Skip(input.SkipCount).Take(input.MaxResultCount).ToList();
 //ABP提供了扩展方法PageBy分页方式
 var taskList = query.PageBy(input).ToList();
 return new PagedResultDto<TaskDto>(tasksCount,taskList.MapTo<List<TaskDto>>());
}

 public ActionResult PagedList(int? page)
 {
  //每页行数
  var pageSize = 5;
  var pageNumber = page ?? 1;//第几页
  var filter = new GetTasksInput
  {
   SkipCount = (pageNumber - 1) * pageSize,//忽略个数
   MaxResultCount = pageSize
  };
  var result = _taskAppService.GetPagedTasks(filter);
  //已经在应用服务层手动完成了分页逻辑，所以需手动构造分页结果
  var onePageOfTasks = new StaticPagedList<TaskDto>(result.Items, pageNumber, pageSize, result.TotalCount);
  //将分页结果放入ViewBag供View使用
  ViewBag.OnePageOfTasks = onePageOfTasks;
  return View();
}

@using X.PagedList.Mvc;
@using Abp.Web.Mvc.Extensions
@using X.PagedList; 
<link href="~/Content/PagedList.css" rel="external nofollow" rel="stylesheet" />
<ul class="list-group">
 @foreach (var task in ViewBag.OnePageOfTasks)
 {
  <li class="list-group-item">
   <p class="btn-group pull-right">
    <button type="button" class="btn btn-info">Edit</button>
    <button type="button" class="btn btn-success">Delete</button>
   </p>
   <p class="media">
    <a class="media-left" href="#" rel="external nofollow" >
     @*<i class="fa @Model.GetTaskLable(task) fa-3x"></i>*@
    </a>
    <p class="media-body">
     <h4 class="media-heading">@task.Title</h4>
     <span class="text-muted">@task.CreationTime.ToString("yyyy-MM-dd HH:mm:ss")</span>
    </p>
   </p>
  </li>
 }
</ul>
@Html.PagedListPager((IPagedList)ViewBag.OnePageOfTasks, page => Url.Action("PagedList", new { page }))