系列導航及源代碼
- 使用.NET 6開發TodoList應用文章索引
需求
在查詢的場景中，還有一類需求不是很常見，就是在前端請求中指定回傳的欄位，所以關于搜索的最后一個主題我們就來演示一下關于資料塑形（Data Shaping），
目標
實作資料塑形搜索請求，
原理與思路
對于資料塑形來說，我們需要定義一些介面和泛型類實作來完成通用的功能，然后修改對應的查詢請求，實作具體的功能，
實作
定義通用介面和泛型類實作
IDataShaper.cs
using System.Dynamic;
namespace TodoList.Application.Common.Interfaces;
public interface IDataShaper<T>
{
IEnumerable<ExpandoObject> ShapeData(IEnumerable<T> entities, string fieldString);
ExpandoObject ShapeData(T entity, string fieldString);
}
并實作通用的功能：
DataShaper.cs
using System.Dynamic;
using System.Reflection;
using TodoList.Application.Common.Interfaces;
namespace TodoList.Application.Common;
public class DataShaper<T> : IDataShaper<T> where T : class
{
public PropertyInfo[] Properties { get; set; }
public DataShaper()
{
Properties = typeof(T).GetProperties(BindingFlags.Public | BindingFlags.Instance);
}
public IEnumerable<ExpandoObject> ShapeData(IEnumerable<T> entities, string? fieldString)
{
var requiredProperties = GetRequiredProperties(fieldString);
return GetData(entities, requiredProperties);
}
public ExpandoObject ShapeData(T entity, string? fieldString)
{
var requiredProperties = GetRequiredProperties(fieldString);
return GetDataForEntity(entity, requiredProperties);
}
private IEnumerable<PropertyInfo> GetRequiredProperties(string? fieldString)
{
var requiredProperties = new List<PropertyInfo>();
if (!string.IsNullOrEmpty(fieldString))
{
var fields = fieldString.Split(',', StringSplitOptions.RemoveEmptyEntries);
foreach (var field in fields)
{
var property = Properties.FirstOrDefault(pi => pi.Name.Equals(field.Trim(), StringComparison.InvariantCultureIgnoreCase));
if (property == null)
{
continue;
}
requiredProperties.Add(property);
}
}
else
{
requiredProperties = Properties.ToList();
}
return requiredProperties;
}
private IEnumerable<ExpandoObject> GetData(IEnumerable<T> entities, IEnumerable<PropertyInfo> requiredProperties)
{
return entities.Select(entity => GetDataForEntity(entity, requiredProperties)).ToList();
}
private ExpandoObject GetDataForEntity(T entity, IEnumerable<PropertyInfo> requiredProperties)
{
var shapedObject = new ExpandoObject();
foreach (var property in requiredProperties)
{
var objectPropertyValue = https://www.cnblogs.com/code4nothing/archive/2022/01/04/property.GetValue(entity);
shapedObject.TryAdd(property.Name, objectPropertyValue);
}
return shapedObject;
}
}
定義擴展方法
為了使我們的Handle方法呼叫鏈能夠直接應用，我們在Application/Extensions中新增一個DataShaperExtensions：
DataShaperExtensions.cs
using System.Dynamic;
using TodoList.Application.Common.Interfaces;
namespace TodoList.Application.Common.Extensions;
public static class DataShaperExtensions
{
public static IEnumerable<ExpandoObject> ShapeData<T>(this IEnumerable<T> entities, IDataShaper<T> shaper, string? fieldString)
{
return shaper.ShapeData(entities, fieldString);
}
}
然后再對我們之前寫的MappingExtensions靜態類中添加一個方法：
MappingExtensions.cs
// 省略其他...
public static PaginatedList<TDestination> PaginatedListFromEnumerable<TDestination>(this IEnumerable<TDestination> entities, int pageNumber, int pageSize)
{
return PaginatedList<TDestination>.Create(entities, pageNumber, pageSize);
}
添加依賴注入
在Application的DependencyInjection.cs中添加依賴注入：
DependencyInjection.cs
// 省略其他
services.AddScoped(typeof(IDataShaper<>), typeof(DataShaper<>));
修改查詢請求和Controller介面
我們在上一篇文章實作排序的基礎上增加一個欄位用于指明資料塑形欄位并對應修改Handle方法：
GetTodoItemsWithConditionQuery.cs
using System.Dynamic;
using AutoMapper;
using AutoMapper.QueryableExtensions;
using MediatR;
using TodoList.Application.Common.Extensions;
using TodoList.Application.Common.Interfaces;
using TodoList.Application.Common.Mappings;
using TodoList.Application.Common.Models;
using TodoList.Application.TodoItems.Specs;
using TodoList.Domain.Entities;
using TodoList.Domain.Enums;
namespace TodoList.Application.TodoItems.Queries.GetTodoItems;
public class GetTodoItemsWithConditionQuery : IRequest<PaginatedList<ExpandoObject>>
{
public Guid ListId { get; set; }
public bool? Done { get; set; }
public string? Title { get; set; }
// 前端指明需要回傳的欄位
public string? Fields { get; set; }
public PriorityLevel? PriorityLevel { get; set; }
public string? SortOrder { get; set; } = "title_asc";
public int PageNumber { get; set; } = 1;
public int PageSize { get; set; } = 10;
}
public class GetTodoItemsWithConditionQueryHandler : IRequestHandler<GetTodoItemsWithConditionQuery, PaginatedList<ExpandoObject>>
{
private readonly IRepository<TodoItem> _repository;
private readonly IMapper _mapper;
private readonly IDataShaper<TodoItemDto> _shaper;
public GetTodoItemsWithConditionQueryHandler(IRepository<TodoItem> repository, IMapper mapper, IDataShaper<TodoItemDto> shaper)
{
_repository = repository;
_mapper = mapper;
_shaper = shaper;
}
public Task<PaginatedList<ExpandoObject>> Handle(GetTodoItemsWithConditionQuery request, CancellationToken cancellationToken)
{
var spec = new TodoItemSpec(request);
return Task.FromResult(
_repository
.GetAsQueryable(spec)
.ProjectTo<TodoItemDto>(_mapper.ConfigurationProvider)
.AsEnumerable()
// 進行資料塑形和分頁回傳
.ShapeData(_shaper, request.Fields)
.PaginatedListFromEnumerable(request.PageNumber, request.PageSize)
);
}
}
對應修改Controller：
TodoItemController.cs
[HttpGet]
public async Task<ApiResponse<PaginatedList<ExpandoObject>>> GetTodoItemsWithCondition([FromQuery] GetTodoItemsWithConditionQuery query)
{
return ApiResponse<PaginatedList<ExpandoObject>>.Success(await _mediator.Send(query));
}
驗證
啟動Api專案，執行查詢TodoItem的請求：
-
請求
-
回應
我們再把之前講到的過濾和搜索添加到請求里來：
-
請求
-
回應
總結
對于資料塑形的請求，關鍵步驟就是使用反射獲取待回傳物件的所有配置的可以回傳的屬性，再通過前端傳入的屬性名稱進行過濾和值的重組進行回傳，實作起來是比較簡單的，但是在實際的使用程序中我不推薦這樣用，除了某些非常適用的特殊場景，個人更偏向于向前端提供明確的介面定義，
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/403486.html
標籤：.NET技术