PATCH是REST API支持的请求之一。
REST API的请求常见的是GET和POST,其中PUT、DELETE和PATCH也很重要。
PATCH表示部分更新,用POST当然可以代替,PATCH语义更好更准确。
-
JSON Patch是一种实现PATCH的方案
-
ODATA也支持Patch
ODATA包含Delta功能,比JSON Patch简洁
但是Delta只能用于ODataController
-
MyDeltas.net是本人参考ODATA的Delta功能实现的一个小工具
-
MyDeltas和JSON Patch对比
|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
| |
|
以上是使用NodeBook实现的对比,大家可以从本项目源码中下载用vscode打开执行测试
gitbub地址: https://github.com/donetsoftwork/MyDelta.net/tree/master/Notes
或gitee地址: https://gitee.com/donetsoftwork/MyDelta.net/tree/master/Notes
以上很明显MyDeltas生成的json比JSON Patch的简洁。
以前很多项目对同一个实体有很多修改方法,改头像、改昵称、改生日、改性别等等,太多了。
用Patch都可以合并,这样就简洁明了。
JSON Patch更适合复杂对象,它支持Add、Remove、Replace等,MyDeltas相当于JSON Patch的Replace
如果我们做微服务的API,实体类简单直接用MyDeltas就好了
这里说的实体类简单并不是说包含的字段少,而是尽量不要一个实体类又包含多个其他实体类的对象
比如Post和Comment,如果Post含Comment列表,用JSON Patch才好处理
如果把Post和Comment拆分两个API,JSON Patch的Add、Remove能用上的机会就不多了
5. MyDeltas功能
5.1 通过nuget安装MyDeltas
dotnet add package MyDeltas --version 0.3.0-alpha
5.2 MyDelta通过IMyDeltaFactory工具来构造
IMyDeltaFactory factory = new MyDeltaFactory();
MyDelta<TodoItem> delta = factory.Create<TodoItem>();
5.3 MyDelta支持System.Text.Json序列化和反序列化
IMyDeltaFactory factory = new MyDeltaFactory();
MyDelta<TodoItem> delta = factory.Create<TodoItem>();
delta.TrySetValue("Name", "Test");
string json = JsonSerializer.Serialize(delta);
//{"Name":"Test"}
var json = "{\"Name\":\"Test\"}";
MyDelta<TodoItem>? delta = JsonSerializer.Deserialize<MyDelta<TodoItem>>(json);
其中反序列化也是调用IMyDeltaFactory来构造MyDelta**
5.4 Patch和Put功能都是把MyDelta数据应用到实例对象上**
Patch只应用变更的部分,并返回是否变更成功
Put是把变化部分和没变化部分都复制过去
/// <summary>
/// 增量修改
/// </summary>
/// <param name="original"></param>
/// <returns>是否变化</returns>
public bool Patch(TStructuralType original)
{
bool changed = false;
foreach (var item in _data)
{
if (_members.TryGetValue(item.Key, out var member))
changed = member.TrySetValue(original, item.Value);
}
return changed;
}
/// <summary>
/// 覆盖
/// </summary>
/// <param name="original"></param>
/// <returns></returns>
public void Put(TStructuralType original)
{
foreach (var item in _members)
{
if (_data.TryGetValue(item.Key, out var value))
item.Value.SetValue(original, value);
else
item.Value.Copy(_instance, original);
}
}
6. MyDeltas性能问题
**MyDelta通过IMyDeltaFactory来操作实体类的属性或字段,默认实现MyDeltaFactory是基于反射的PropertyInfo和FieldInfo
虽然.net9的反射性能已经提高很多了,但与手写代码还是有点差距,为此MyDeltas提供了扩展方案**
6.1 DelegateBuilder手写代码扩展
DelegateBuilder可以直接构造MyDelta也可以扩展IMyDeltaFactory****
var builder = new DelegateBuilder<TodoItem>()
.Add(nameof(TodoItem.Id), obj => obj.Id, (obj, value) => obj.Id = value)
.Add(nameof(TodoItem.Name), obj => obj.Name, (obj, value) => obj.Name = value)
.Add(nameof(TodoItem.IsComplete), obj => obj.IsComplete, (obj, value) => obj.IsComplete = value)
.Add(nameof(TodoItem.Remark), obj => obj.Remark, (obj, value) => obj.Remark = value);
TodoItem todo = new() { Id = 1, Name = "Test1" };
var myDelta = _builder.Create(todo);
myDelta.TrySetValue(nameof(TodoItem.Name), "todo1");
DelegateBuilder没定义的IMyDeltaFactory会补足
var builder = new DelegateBuilder<TodoItem>()
.Add(nameof(TodoItem.Id), obj => obj.Id, (obj, value) => obj.Id = value)
.Add(nameof(TodoItem.Name), obj => obj.Name, (obj, value) => obj.Name = value);
MyDeltaFactory factory = new MyDeltaFactory()
.Use(builder.Members);
MyDelta<TodoItem> delta = factory.Create<TodoItem>();
7. 如果嫌弃手写代码太繁琐可以使用MyDeltas.Emit
7.1 通过nuget安装MyDeltas.Emit
dotnet add package MyDeltas.Emit --version 0.3.0-alpha
7.2 使用EmitDeltaFactory代替MyDeltaFactory
IMyDeltaFactory emitFactory = new EmitDeltaFactory();
7.3 配置Json序列化
string json = JsonSerializer.Serialize(delta, new JsonSerializerOptions
{
Converters =
{
new MyDeltaConverterFactory(new MyDeltaFactory())
}
});
IMyDeltaFactory deltaFactory = new EmitDeltaFactory(emitFactory);
services.AddSingleton(deltaFactory)
.AddControllers()
.AddJsonOptions(options =>
{
options.JsonSerializerOptions.Converters.Add(new MyDeltaConverterFactory(deltaFactory));
});
源码托管地址: https://github.com/donetsoftwork/MyDeltas.net ,也欢迎大家直接查看源码。
gitee同步更新:https://gitee.com/donetsoftwork/MyDeltas.net
文档地址: https://donetsoftwork.github.io/MyDelta.net/index.html
如果大家喜欢请动动您发财的小手手帮忙点一下Star。