Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

System.Func<T> i Action<T>: fabryka i reset w puli obiektów

Użyj `Func<T>` jako bezargumentowej fabryki i `Action<T>` do resetowania zwracanego obiektu w swojej puli obiektów.

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

Składnia

// 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);

W C# 12 i .NET 8 oba typy delegatów należą do przestrzeni nazw System. W Func<T> parametr T oznacza typ wyniku: factory() nie przyjmuje argumentów i zwraca T. W Action<T> parametr T oznacza typ argumentu: reset(item) przyjmuje jeden argument przez wartość i zwraca void. Dla klasy kopiowana jest referencja, więc reset może zmienić stan tego samego obiektu.

Nie myl ich z Func<T, TResult> (jedno wejście i wynik) ani z niegenerycznym Action (brak wejścia i wyniku). Pasującą metodę lub lambdę można przekazać konstruktorowi i wywołać później. Dla typów referencyjnych out pozwala przypisać Func<Derived> do Func<Base>, a in pozwala przypisać Action<Base> do Action<Derived>; te oznaczenia dotyczą wariancji, a nie przekazywania argumentów wywołania przez referencję.

We własnej ObjectPool<T> z przykładu Rent() wywołuje fabrykę tylko wtedy, gdy nie ma wolnego obiektu. Return(item) wywołuje reset przed ewentualnym zachowaniem obiektu, nawet jeśli jedyne miejsce jest już zajęte. Action<T> nie zwraca decyzji o przyjęciu obiektu; jeśli reset zgłosi wyjątek, wyjątek trafia do wywołującego, a ta operacja nie zapisuje obiektu w puli.

Po zwrocie nie używaj obiektu i nie zwracaj go drugi raz. Przykład nie jest bezpieczny wątkowo i nie zarządza zwalnianiem zasobów przez Dispose. To własny typ, a nie Microsoft.Extensions.ObjectPool.ObjectPool<T>; w tamtej bibliotece PooledObjectPolicy<T> pozwala dostosować tworzenie i obsługę zwrotu.

Przykłady

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;
    }
}

Wynik

Same instance: True
Item count: 0

Fabryka tworzy listę przy pierwszym wypożyczeniu. `Clear()` usuwa element przy zwrocie, a drugie wypożyczenie daje tę samą, pustą listę.

Powiązane lekcje

  • C# · Lekcja 13 · Zaawansowany · Wersja: 3

Źródła