Akademi C# · Pelajaran

Tingkah Laku Saluran Pemprosesan

Tambahkan logik merentas aspek dengan tingkah laku.

Pelajaran 3 daripada 413 langkah

Tingkah Laku Saluran Pemprosesan ialah pelajaran Akademi C# percuma di CoddyKit. Ini ialah pelajaran 3 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Akademi C#, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.

Keprihatinan Merentas Komponen

Pengelogan, pengesahan, pemasaan dan transaksi digunakan oleh banyak handler. Menyalin kod tersebut ke dalam setiap handler adalah berulang dan mudah menyebabkan ralat.

Tingkah laku saluran paip MediatR membolehkan anda membalut setiap permintaan dengan logik dikongsi.

// One behavior runs around all handlers

IPipelineBehavior

Tingkah laku melaksanakan IPipelineBehavior<TRequest, TResponse>. Kaedah Handle menerima permintaan dan delegat next yang memanggil bahagian saluran paip yang seterusnya.

public class LoggingBehavior<TRequest, TResponse>
    : IPipelineBehavior<TRequest, TResponse>
    where TRequest : notnull
{
    public async Task<TResponse> Handle(
        TRequest request,
        RequestHandlerDelegate<TResponse> next,
        CancellationToken ct)
    {
        // before
        var response = await next();
        // after
        return response;
    }
}

Delegat Seterusnya

next() memanggil tingkah laku seterusnya, atau handler sebenar jika ini ialah tingkah laku terakhir. Kod sebelum panggilan berjalan semasa masuk; kod selepas panggilan berjalan semasa keluar.

// [Behavior A in] -> [Behavior B in] -> [Handler]
//               <- [Behavior B out] <- [A out]

Tingkah Laku Pengelogan

Tingkah laku pengelogan khusus merekodkan nama permintaan semasa masuk dan masa yang berlalu semasa keluar.

public async Task<TResponse> Handle(
    TRequest request,
    RequestHandlerDelegate<TResponse> next,
    CancellationToken ct)
{
    var name = typeof(TRequest).Name;
    _logger.LogInformation("Handling {Name}", name);
    var sw = Stopwatch.StartNew();
    var response = await next();
    _logger.LogInformation("{Name} took {Ms}ms", name, sw.ElapsedMilliseconds);
    return response;
}

Mendaftarkan Tingkah Laku

Daftarkan tingkah laku generik terbuka dalam DI. MediatR menggunakannya pada setiap permintaan.

builder.Services.AddTransient(
    typeof(IPipelineBehavior<,>),
    typeof(LoggingBehavior<,>));

Tingkah Laku Pengesahan

Salah satu kegunaan yang popular ialah pengesahan permintaan dengan FluentValidation. Tingkah laku ini menjalankan semua pengesah sebelum handler dilaksanakan dan mencetuskan pengecualian jika ada yang gagal.

public async Task<TResponse> Handle(
    TRequest request,
    RequestHandlerDelegate<TResponse> next,
    CancellationToken ct)
{
    var context = new ValidationContext<TRequest>(request);
    var failures = _validators
        .Select(v => v.Validate(context))
        .SelectMany(r => r.Errors)
        .Where(f => f is not null)
        .ToList();
    if (failures.Count != 0)
        throw new ValidationException(failures);
    return await next();
}

Pintas Awal

Tingkah laku boleh melangkau handler sepenuhnya dengan mengembalikan hasil tanpa memanggil next() - berguna untuk mencache hasil pertanyaan atau menolak permintaan yang tidak sah.

if (_cache.TryGet(key, out TResponse cached))
    return cached;          // handler never runs
var response = await next();
_cache.Set(key, response);
return response;

Susunan Tingkah Laku

Tingkah laku dilaksanakan mengikut susunan pendaftarannya. Letakkan pengelogan paling luar, diikuti pengesahan dan kemudian transaksi, supaya setiap satu membalut yang seterusnya dengan betul.

services.AddTransient(typeof(IPipelineBehavior<,>), typeof(LoggingBehavior<,>));
services.AddTransient(typeof(IPipelineBehavior<,>), typeof(ValidationBehavior<,>));
services.AddTransient(typeof(IPipelineBehavior<,>), typeof(TransactionBehavior<,>));

Tingkah Laku Transaksi

Balut handler arahan dalam transaksi pangkalan data supaya keseluruhan operasi dilakukan atau dibatalkan secara atomik.

await using var tx = await _db.Database.BeginTransactionAsync(ct);
try
{
    var response = await next();
    await tx.CommitAsync(ct);
    return response;
}
catch
{
    await tx.RollbackAsync(ct);
    throw;
}

Menyasarkan Permintaan Tertentu

Gunakan antara muka penanda dan kekangan generik supaya tingkah laku hanya digunakan pada permintaan yang memilih untuk menggunakannya - contohnya, hanya arahan yang mendapat transaksi.

public interface ITransactional { }
public record CreateOrderCommand(...) : IRequest<int>, ITransactional;

// where TRequest : ITransactional

Mengapa Tingkah Laku Lebih Baik daripada Middleware

Tidak seperti middleware HTTP, tingkah laku berjalan bagi setiap mesej, mempunyai permintaan dan respons yang ditaip, serta berfungsi walaupun permintaan dihantar di luar HTTP (contohnya daripada tugas latar belakang).

// Strongly typed, transport-independent cross-cutting logic

Semakan Pantas

Pastikan anda memahami cara tingkah laku berfungsi.

Jawab dalam pelajaran interaktif

Ringkasan

Anda telah mempelajari tingkah laku saluran paip:

IPipelineBehavior<TRequest, TResponse> membalut setiap permintaan dengan logik dikongsi.
Delegat next meneruskan saluran paip; melangkaunya akan memintas handler.
Kegunaan biasa: pengelogan, pengesahan, transaksi dan pencachean.
Tingkah laku berjalan mengikut susunan pendaftaran dan ditaip dengan kuat.

Seterusnya: pemberitahuan dan peristiwa.

Percuma untuk bermula

Pelajari C# dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 93
Pelajaran: 346

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Tingkah Laku Saluran Pemprosesan” percuma?

Ya — teks penuh “Tingkah Laku Saluran Pemprosesan” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus Akademi C#, tingkat taraf kepada CoddyKit PRO. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Tingkah Laku Saluran Pemprosesan”?

Tambahkan logik merentas aspek dengan tingkah laku. Anda berlatih Akademi C# menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Akademi C#?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Akademi C# di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 3 daripada 4.

Berapa lamakah pelajaran “Tingkah Laku Saluran Pemprosesan” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Akademi C# ini?

Ya. Setiap pelajaran Akademi C# menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke Akademi C#