KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

System.Func<T> en Action<T>: aanmaken en resetten in een objectpool

Gebruik `Func<T>` als parameterloze factory en `Action<T>` om een teruggegeven object in je eigen pool te resetten.

Versie: 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);

In C# 12 en .NET 8 staan beide delegatetypen in de naamruimte System. In Func<T> is T het resultaattype: factory() krijgt geen argumenten en retourneert een T. In Action<T> is T het parametertype: reset(item) krijgt één argument op waarde en retourneert void. Bij een klasse wordt de referentie gekopieerd, zodat de reset hetzelfde object kan wijzigen.

Verwar deze typen niet met Func<T, TResult> (één invoer en een resultaat) of met de niet-generieke Action (geen invoer en geen resultaat). Geef een compatibele benoemde methode of lambda aan de constructor door om die later aan te roepen. Voor referentietypen maakt out toewijzing van Func<Derived> aan Func<Base> mogelijk, en in toewijzing van Action<Base> aan Action<Derived>. Deze aanduidingen gaan over variantie, niet over argumenten doorgeven per referentie.

In de eigen ObjectPool<T> uit het voorbeeld roept Rent() de factory alleen aan als er geen object beschikbaar is. Return(item) reset het object voordat het eventueel wordt bewaard, ook als de enige plek al bezet is. Action<T> retourneert geen besluit over het bewaren van het object. Als de reset een uitzondering opwerpt, gaat die naar de aanroeper en slaat deze aanroep het object niet op.

Gebruik een teruggegeven object niet meer en geef het niet nogmaals terug. Het voorbeeld is niet thread-safe en regelt het vrijgeven van resources via Dispose niet. Dit is een eigen type, niet Microsoft.Extensions.ObjectPool.ObjectPool<T>; die bibliotheek biedt PooledObjectPolicy<T> om het aanmaken en afhandelen van teruggaven aan te passen.

Voorbeelden

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

Resultaat

Same instance: True
Item count: 0

De factory maakt bij de eerste uitleenbeurt een lijst. Bij teruggave verwijdert `Clear()` het element. De tweede uitleenbeurt levert dezelfde lijst op, nu leeg.

Gerelateerde lessen

  • C# · Les 13 · Gevorderd · Versie: 3

Bronnen