写在前面
Microsoft.Extensions.ObjectPool 是 ASP.NET Core 基础结构的一部分,当对象的初始化成本较高,并且可能被频繁使用时,才适合采用对象池技术;被ObjectPool管理的对象不会进入垃圾回收,使用时通过由实例对象实现的Get()方法,从对象池中借出对象,用完之后调用Return(T obj)方法,将对象还回去。也可以在Return(T obj)方法中设置判断条件,仅允许特定的对象进入对象池。
通过NuGet 获取 Microsoft.Extensions.ObjectPool 类库
代码实现
using Microsoft.Extensions.DependencyInjection.Extensions;
using Microsoft.Extensions.ObjectPool;
using System.Security.Cryptography;
using System.Text;
var builder = WebApplication.CreateBuilder(args);
// DefaultPooledObjectPolicy: 默认的策略,继承抽象类PooledObjectPolicy
builder.Services.TryAddSingleton<ObjectPoolProvider, DefaultObjectPoolProvider>();
builder.Services.TryAddSingleton<ObjectPool<ReusableBuffer>>(serviceProvider =>
{
var provider = serviceProvider.GetRequiredService<ObjectPoolProvider>();
var policy = new DefaultPooledObjectPolicy<ReusableBuffer>();
return provider.Create(policy);
});
builder.Services.TryAddSingleton<ObjectPool<Person>>(serviceProvider => {
var provider = serviceProvider.GetRequiredService<ObjectPoolProvider>();
var policy = new PersonPoolPolicy();
return provider.Create(policy);
});
builder.Services.TryAddSingleton<ObjectPool<StringBuilder>>(serviceProvider =>
{
var provider = serviceProvider.GetRequiredService<ObjectPoolProvider>();
var policy = new StringBuilderPooledObjectPolicy();
return provider.Create(policy);
});
var app = builder.Build();
// config middleware
app.UseMiddleware<BirthdayMiddleware>();
app.MapGet("/", () => "Hello rjcql!");
// return the SHA256 hash of a word
http://localhost:5128/hash/xxxx
app.MapGet("/hash/{word}", (string word, ObjectPool<ReusableBuffer> bufferPool) =>
{
var buffer = bufferPool.Get();
try
{
// Set the buffer data to the ASCII values of a word
for (var i = 0; i < word.Length; i++)
{
buffer.Data[i] = (byte)word[i];
}
Span<byte> hash = stackalloc byte[32];
SHA256.HashData(buffer.Data.AsSpan(0, word.Length), hash);
return "Hash: " + Convert.ToHexString(hash);
}
finally
{
// Data is automatically reset because this type implemented IResettable
bufferPool.Return(buffer);
}
});
app.MapGet("/create/{name}", (string name, ObjectPool<Person> personPool) =>
{
var person = personPool.Get();
try
{
person.Id = Guid.NewGuid().ToString("N");
var lastName = person.Name; // 这个是上一个对象的值
person.Name = name;
return $"{person.Id}:{person.Name}, {lastName}";
}
finally
{
// 根据条件回收
personPool.Return(person);
}
});
app.Run();
public class ReusableBuffer : IResettable
{
public byte[] Data { get; } = new byte[1024 * 1024]; // 1 MB
public bool TryReset()
{
Array.Clear(Data);
return true;
}
}
public class Person
{
public string Id { get; set; }
public string Name { get; set; }
}
public class PersonPoolPolicy : PooledObjectPolicy<Person>
{
public override Person Create()
{
return new Person { Id = "", Name = "rjcql" };
}
public override bool Return(Person p)
{
if (p.Name != "rjcql")
{
// 不允许其他名称的对象放入对象池
return false;
}
return true;
}
}
/// <summary>
/// 创建中间件
/// </summary>
public class BirthdayMiddleware
{
private readonly RequestDelegate _next;
public BirthdayMiddleware(RequestDelegate next)
{
_next = next;
}
public async Task InvokeAsync(HttpContext context, ObjectPool<StringBuilder> builderPool)
{
var stringBuilder = builderPool.Get();
try
{
stringBuilder.Append("Hi");
// 在中间干点啥别的
// await context.Response.WriteAsync(stringBuilder.ToString());
await _next.Invoke(context);
}
finally // 即使出错也要保证归还对象
{
builderPool.Return(stringBuilder);
}
}
}
调用示例
因为设置了回收条件,所以只有名字为rjcql的对象才会被回收,所以每次调用都先把rjcql对象取出。