База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

System.Func<T> и Action<T>: създаване и нулиране в пул от обекти

Използвай `Func<T>` като фабрика без параметри и `Action<T>`, за да нулираш състоянието на обект, върнат в твоя пул.

Версия: C# 12 and .NET 8; later runtimes may add compatible features

Синтаксис

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

В C# 12 и .NET 8 и двата делегатни типа са в пространството от имена System. В Func<T> T е типът на резултата: factory() не приема аргументи и връща T. В Action<T> T е типът на параметъра: reset(item) приема един аргумент по стойност и връща void. При клас се копира референцията, затова нулирането може да промени състоянието на същия обект.

Не ги бъркай с Func<T, TResult> (един вход и резултат) или с необобщения Action (без вход и резултат). Подай на конструктора съвместим именуван метод или ламбда израз за по-късно извикване. При референтни типове out позволява присвояване на Func<Derived> към Func<Base>, а in позволява присвояване на Action<Base> към Action<Derived>. Тези означения описват вариантност, а не предаване на аргументи по референция.

В собствения ObjectPool<T> от примера Rent() извиква фабриката само ако няма наличен обект. Return(item) нулира обекта преди евентуалното му запазване, дори ако единственото място вече е заето. Action<T> не връща решение дали обектът да бъде приет. Ако нулирането хвърли изключение, то се предава на извикващия код и това извикване не запазва обекта.

След като върнеш обекта, не го използвай и не го връщай отново. Примерът не е безопасен за едновременна употреба от няколко нишки и не управлява освобождаването на ресурси чрез Dispose. Това е собствен тип, а не Microsoft.Extensions.ObjectPool.ObjectPool<T>; тази библиотека предлага PooledObjectPolicy<T> за настройване на създаването и обработката на върнатите обекти.

Примери

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

Резултат

Same instance: True
Item count: 0

Фабриката създава списък при първото заемане. При връщане `Clear()` премахва елемента му. Второто заемане получава същия списък, вече празен.

Свързани уроци

  • C# · Урок 13 · Напреднало · Версия: 3

Източници