CKTIS / C#
System.Func<T> a Action<T>: vytváření a reset ve fondu objektů
Použijte `Func<T>` jako továrnu bez parametrů a `Action<T>` k obnovení stavu objektu vráceného do vlastního fondu.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
// System delegate declarations (.NET 8)
public delegate TResult Func<out TResult>();
public delegate void Action<in T>(T obj);
// In a custom ObjectPool<T> where T : class, with using System;
// Constructor signature: public ObjectPool(Func<T> factory, Action<T> reset)
T item = factory();
reset(item);V C# 12 a .NET 8 patří oba typy delegátů do jmenného prostoru System. V Func<T> je T typ výsledku: factory() nepřijímá žádné argumenty a vrací T. V Action<T> je T typ parametru: reset(item) přijímá jeden argument předaný hodnotou a vrací void. U třídy se kopíruje reference, takže reset může změnit stav téhož objektu.
Nezaměňujte je za Func<T, TResult> (jeden vstup a výsledek) ani za negenerický Action (bez vstupu i výsledku). Předejte konstruktoru kompatibilní pojmenovanou metodu nebo lambda výraz, aby je mohl kód později zavolat. Pro referenční typy umožňuje out přiřadit Func<Derived> do Func<Base> a in umožňuje přiřadit Action<Base> do Action<Derived>. Tato označení popisují varianci, nikoli předávání argumentů odkazem.
Ve vlastní ObjectPool<T> z příkladu volá Rent() továrnu jen tehdy, když není žádný objekt k dispozici. Return(item) resetuje objekt před případným uložením, i když je jediné místo už obsazené. Action<T> nevrací rozhodnutí o přijetí objektu. Pokud reset vyvolá výjimku, výjimka se předá volajícímu a toto volání objekt neuloží.
Po vrácení objekt už nepoužívejte ani ho nevracejte podruhé. Příklad není bezpečný při souběžném použití z více vláken a nespravuje uvolňování prostředků pomocí Dispose. Jde o vlastní typ, nikoli o Microsoft.Extensions.ObjectPool.ObjectPool<T>; tato knihovna nabízí PooledObjectPolicy<T> k přizpůsobení vytváření a zpracování vracených objektů.
Příklady
using System;
using System.Collections.Generic;
var pool = new ObjectPool<List<string>>(
static () => new List<string>(),
static list => list.Clear());
var first = pool.Rent();
first.Add("temporary");
pool.Return(first);
var second = pool.Rent();
Console.WriteLine($"Same instance: {object.ReferenceEquals(first, second)}");
Console.WriteLine($"Item count: {second.Count}");
pool.Return(second);
sealed class ObjectPool<T> where T : class
{
private readonly Func<T> _factory;
private readonly Action<T> _reset;
private T? _available;
public ObjectPool(Func<T> factory, Action<T> reset)
{
_factory = factory ?? throw new ArgumentNullException(nameof(factory));
_reset = reset ?? throw new ArgumentNullException(nameof(reset));
}
public T Rent()
{
if (_available is T item)
{
_available = null;
return item;
}
return _factory() ?? throw new InvalidOperationException("The factory returned null.");
}
public void Return(T item)
{
ArgumentNullException.ThrowIfNull(item);
_reset(item);
_available ??= item;
}
}Výsledek
Same instance: True Item count: 0
Továrna vytvoří seznam při prvním vypůjčení. Při vrácení `Clear()` odstraní jeho položku. Druhé vypůjčení vrátí tentýž, nyní prázdný seznam.
Související lekce
- C# · Lekce 13 · Pokročilá · Verze: 3