Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

System.Func<T> e Action<T>: criação e reposição num pool de objetos

Usa `Func<T>` como fábrica sem parâmetros e `Action<T>` para repor o estado de um objeto devolvido ao teu pool.

Versão: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxe

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

Em C# 12 e .NET 8, ambos os tipos de delegado pertencem ao espaço de nomes System. Em Func<T>, T é o tipo do resultado: factory() não recebe argumentos e devolve um T. Em Action<T>, T é o tipo do parâmetro: reset(item) recebe um argumento por valor e devolve void. Para uma classe, é copiada a referência, pelo que a reposição pode alterar o mesmo objeto.

Não confundas estes tipos com Func<T, TResult> (uma entrada e um resultado) nem com Action não genérico (sem entrada nem resultado). Passa ao construtor um método com nome compatível ou uma expressão lambda para invocação posterior. Para tipos de referência, out permite atribuir Func<Derived> a Func<Base> e in permite atribuir Action<Base> a Action<Derived>. Estas marcas descrevem variância, não a passagem de argumentos por referência.

No ObjectPool<T> personalizado do exemplo, Rent() chama a fábrica apenas quando não há um objeto disponível. Return(item) repõe o estado do objeto antes de o guardar, se houver espaço, mesmo que o único lugar já esteja ocupado. Action<T> não devolve uma decisão de aceitação. Se a reposição lançar uma exceção, esta propaga-se para quem chamou o método e essa chamada não guarda o objeto.

Depois de devolveres um objeto, não o uses nem o devolvas novamente. O exemplo não é seguro para utilização simultânea por várias threads e não gere a libertação de recursos através de Dispose. É um tipo próprio, não Microsoft.Extensions.ObjectPool.ObjectPool<T>; essa biblioteca disponibiliza PooledObjectPolicy<T> para personalizar a criação e o tratamento das devoluções.

Exemplos

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

Resultado

Same instance: True
Item count: 0

A fábrica cria uma lista no primeiro empréstimo. Na devolução, `Clear()` remove o elemento. O segundo empréstimo recupera a mesma lista, agora vazia.

Lições relacionadas

  • C# · Lição 13 · Avançado · Versão: 3

Fontes