Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje