Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

System.Func<T> a Action<T>: vytváranie a reset vo fonde objektov

Použi `Func<T>` ako továreň bez parametrov a `Action<T>` na obnovenie stavu objektu vráteného do vlastného fondu.

Verzia: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

// 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 patria oba typy delegátov do priestoru názvov System. V Func<T> je T typ výsledku: factory() neprijíma žiadne argumenty a vracia T. V Action<T> je T typ parametra: reset(item) prijíma jeden argument hodnotou a vracia void. Pri triede sa kopíruje referencia, takže reset môže zmeniť stav toho istého objektu.

Nezamieňaj ich s Func<T, TResult> (jeden vstup a výsledok) ani s negenerickým Action (bez vstupu a výsledku). Odovzdaj konštruktoru kompatibilnú pomenovanú metódu alebo výraz lambda, aby ich mohol kód neskôr zavolať. Pri referenčných typoch out umožňuje priradiť Func<Derived> do Func<Base> a in umožňuje priradiť Action<Base> do Action<Derived>. Tieto označenia vyjadrujú varianciu, nie odovzdávanie argumentov odkazom.

Vo vlastnom ObjectPool<T> z príkladu Rent() zavolá továreň iba vtedy, keď nie je dostupný žiadny objekt. Return(item) resetuje objekt pred prípadným uložením, aj keď je jediné miesto už obsadené. Action<T> nevracia rozhodnutie o prijatí objektu. Ak reset vyvolá výnimku, tá sa prenesie k volajúcemu a toto volanie objekt neuloží.

Po vrátení objekt ďalej nepoužívaj ani ho nevracaj znova. Príklad nie je bezpečný pri súbežnom používaní z viacerých vlákien a nespravuje uvoľňovanie prostriedkov pomocou Dispose. Ide o vlastný typ, nie o Microsoft.Extensions.ObjectPool.ObjectPool<T>; táto knižnica poskytuje PooledObjectPolicy<T> na prispôsobenie vytvárania a spracovania vrátených objektov.

Prí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ýsledok

Same instance: True
Item count: 0

Továreň vytvorí zoznam pri prvom vypožičaní. Pri vrátení `Clear()` odstráni jeho položku. Druhé vypožičanie poskytne ten istý, teraz prázdny zoznam.

Súvisiace lekcie

  • C# · Lekcia 13 · Pokročilá · Verzia: 3

Zdroje