CKTIS / C#
System.Func<T> und Action<T>: Factory und Zurücksetzen im Objektpool
Verwende `Func<T>` als parameterlose Factory und `Action<T>`, um ein zurückgegebenes Objekt im eigenen Pool zurückzusetzen.
Version: 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 und .NET 8 gehören beide Delegattypen zum Namespace System. In Func<T> bezeichnet T den Ergebnistyp: factory() nimmt keine Argumente entgegen und gibt ein T zurück. In Action<T> bezeichnet T den Parametertyp: reset(item) übernimmt ein Argument als Wert und gibt void zurück. Bei einer Klasse wird die Referenz kopiert, sodass der Reset dasselbe Objekt verändern kann.
Verwechsle diese Typen nicht mit Func<T, TResult> (eine Eingabe und ein Ergebnis) oder dem nicht generischen Action (keine Eingabe, kein Ergebnis). Übergib eine kompatible benannte Methode oder ein Lambda an den Konstruktor, um sie später aufzurufen. Bei Referenztypen erlaubt out die Zuweisung von Func<Derived> an Func<Base> und in die Zuweisung von Action<Base> an Action<Derived>. Diese Angaben beschreiben Varianz, nicht die Argumentübergabe per Referenz.
Im eigenen ObjectPool<T> des Beispiels ruft Rent() die Factory nur auf, wenn kein Objekt verfügbar ist. Return(item) setzt das Objekt zurück, bevor es gegebenenfalls gespeichert wird, auch wenn der einzige Platz bereits belegt ist. Action<T> liefert keine Entscheidung über die Aufnahme. Löst der Reset eine Ausnahme aus, gelangt sie zum Aufrufer, und dieser Aufruf speichert das Objekt nicht.
Verwende ein zurückgegebenes Objekt nicht weiter und gib es nicht erneut zurück. Das Beispiel ist nicht threadsicher und kümmert sich nicht um die Ressourcenfreigabe per Dispose. Der eigene Typ ist nicht Microsoft.Extensions.ObjectPool.ObjectPool<T>; jene Bibliothek bietet PooledObjectPolicy<T> zur Anpassung der Erstellung und der Verarbeitung bei der Rückgabe.
Beispiele
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;
}
}Ergebnis
Same instance: True Item count: 0
Beim ersten Ausleihen erstellt die Factory eine Liste. Bei der Rückgabe entfernt `Clear()` den Eintrag. Beim zweiten Ausleihen erhältst du dieselbe, nun leere Liste.
Zugehörige Lektionen
- C# · Lektion 13 · Fortgeschritten · Version: 3