Utilitas generik yang dapat digunakan ulang
Bangun helper kecil yang dapat digunakan ulang: pemeriksaan Guard, pembanding kesetaraan berbasis kunci, memoization untuk fungsi murni, dan Result sederhana.
Utilitas generik yang dapat digunakan ulang adalah pelajaran C# Academy gratis di CoddyKit. Ini adalah pelajaran 3 dari 3. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar C# Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus C# Academy mencakup 3 pelajaran total.
Rencana perangkat bantu
Tujuan: Kumpulkan pembantu kecil yang dapat digunakan kembali di berbagai proyek.
- Pemeriksaan Guard untuk argumen
- Pembanding berbasis kunci untuk kesamaan
- Memoisasi fungsi murni
- Result<T> untuk alur keberhasilan/kegagalan
Pemeriksaan Guard
Pusatkan validasi argumen dalam kelas Guard kecil; panggil kelas tersebut di awal metode.
using System;
public static class Guard
{
public static T NotNull<T>(T value, string name) where T : class
{
if (value == null) throw new ArgumentNullException(name);
return value;
}
public static string NotNullOrEmpty(string value, string name)
{
if (string.IsNullOrEmpty(value)) throw new ArgumentException("must not be null or empty", name);
return value;
}
}
public class Program
{
public static void Main(string[] args)
{
// OK
string name = Guard.NotNullOrEmpty("Ada", "name");
Console.WriteLine("Hello, " + name);
// Uncomment to see guard throw:
// Guard.NotNull<string>(null, "input");
}
}
Pembanding berbasis kunci
Bandingkan objek kompleks berdasarkan kunci, misalnya pengenal, tanpa mengubah Equals/GetHashCode milik model.
using System;
using System.Collections.Generic;
public sealed class KeyEqualityComparer<T, TKey> : IEqualityComparer<T>
{
private readonly Func<T, TKey> _keySelector;
private readonly IEqualityComparer<TKey> _keyComparer;
public KeyEqualityComparer(Func<T, TKey> keySelector)
: this(keySelector, EqualityComparer<TKey>.Default) {}
public KeyEqualityComparer(Func<T, TKey> keySelector, IEqualityComparer<TKey> keyComparer)
{
if (keySelector == null) throw new ArgumentNullException("keySelector");
if (keyComparer == null) throw new ArgumentNullException("keyComparer");
_keySelector = keySelector;
_keyComparer = keyComparer;
}
public bool Equals(T x, T y)
{
if (object.ReferenceEquals(x, y)) return true;
if ((object)x == null || (object)y == null) return false;
return _keyComparer.Equals(_keySelector(x), _keySelector(y));
}
public int GetHashCode(T obj)
{
if ((object)obj == null) return 0;
TKey key = _keySelector(obj);
return key == null ? 0 : _keyComparer.GetHashCode(key);
}
}
public sealed class User
{
public int Id;
public string Name;
}
public class Program
{
public static void Main(string[] args)
{
List<User> list = new List<User>();
list.Add(new User { Id = 1, Name = "Ada" });
list.Add(new User { Id = 1, Name = "Ada Lovelace" }); // same Id -> considered equal
list.Add(new User { Id = 2, Name = "Alan" });
// Deduplicate by Id using a HashSet with our comparer
HashSet<User> set = new HashSet<User>(new KeyEqualityComparer<User,int>(delegate(User u) { return u.Id; }));
foreach (User u in list) set.Add(u);
Console.WriteLine("Unique by Id = " + set.Count); // 2
}
}
Pembantu memoisasi
Memoisasi menyimpan hasil fungsi murni dalam tembolok. Gunakan untuk pemanggilan berulang dengan input yang sama.
using System;
using System.Collections.Generic;
public static class Memo
{
// Wrap a pure function f: K -> V with a simple cache
public static Func<TKey, TValue> Memoize<TKey, TValue>(Func<TKey, TValue> f)
{
if (f == null) throw new ArgumentNullException("f");
Dictionary<TKey, TValue> cache = new Dictionary<TKey, TValue>();
return delegate(TKey key)
{
TValue v;
if (cache.TryGetValue(key, out v)) return v;
v = f(key);
cache[key] = v;
return v;
};
}
}
public class Program
{
static int SlowSquare(int x)
{
// Simulate work
System.Threading.Thread.Sleep(100);
return x * x;
}
public static void Main(string[] args)
{
Func<int,int> fast = Memo.Memoize<int,int>(SlowSquare);
var t1 = DateTime.UtcNow; Console.WriteLine(fast(12));
var t2 = DateTime.UtcNow; Console.WriteLine(fast(12)); // from cache
var dt1 = (t2 - t1).TotalMilliseconds;
var t3 = DateTime.UtcNow; Console.WriteLine(fast(12)); // from cache again
var t4 = DateTime.UtcNow; var dt2 = (t4 - t3).TotalMilliseconds;
Console.WriteLine("First vs cached ms: " + dt1 + " / " + dt2);
}
}
Pembungkus Result<T>
Tipe Result<T> yang minimal membuat keberhasilan/kegagalan menjadi eksplisit dan mudah dicetak atau diuji.
using System;
public enum ResultKind { Ok, Error }
public sealed class Result<T>
{
public ResultKind Kind;
public T Value; // valid when Ok
public string Error; // valid when Error
private Result() {}
public static Result<T> Ok(T value)
{
Result<T> r = new Result<T>();
r.Kind = ResultKind.Ok;
r.Value = value;
r.Error = null;
return r;
}
public static Result<T> Fail(string error)
{
if (string.IsNullOrEmpty(error)) throw new ArgumentException("error");
Result<T> r = new Result<T>();
r.Kind = ResultKind.Error;
r.Error = error;
r.Value = default(T);
return r;
}
public override string ToString()
{
return Kind == ResultKind.Ok ? "OK: " + (Value == null ? "null" : Value.ToString())
: "ERROR: " + Error;
}
}
public class Program
{
static Result<int> ParsePositiveInt(string s)
{
int n;
if (!Int32.TryParse(s, out n)) return Result<int>.Fail("not a number");
if (n <= 0) return Result<int>.Fail("must be > 0");
return Result<int>.Ok(n);
}
public static void Main(string[] args)
{
Console.WriteLine(ParsePositiveInt("12"));
Console.WriteLine(ParsePositiveInt("-1"));
Console.WriteLine(ParsePositiveInt("x"));
}
}
Kiat praktis
Kiat:
- Jaga agar pembantu tetap kecil dan terfokus.
- Beri nama dengan jelas: Guard, KeyEqualityComparer, Memo.
- Dokumentasikan batasan dan kapan pembantu digunakan (fungsi murni untuk Memo).
- Tulis satu pengujian unit singkat untuk setiap pembantu.
Manfaat pembanding berbasis kunci
Ringkasan
Ringkasan: Gunakan kembali alat-alat kecil—Guard untuk input, KeyEqualityComparer untuk kesamaan, Memo untuk fungsi murni, dan Result<T> untuk hasil yang eksplisit.
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Utilitas generik yang dapat digunakan ulang” gratis?
Ya — teks lengkap “Utilitas generik yang dapat digunakan ulang” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus C# Academy, upgrade ke CoddyKit PRO. Kursus C# Academy mencakup 3 pelajaran total.
Apa yang akan aku pelajari di “Utilitas generik yang dapat digunakan ulang”?
Bangun helper kecil yang dapat digunakan ulang: pemeriksaan Guard, pembanding kesetaraan berbasis kunci, memoization untuk fungsi murni, dan Result sederhana. Kamu berlatih C# Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.
Apakah aku perlu pengalaman untuk memulai C# Academy?
Tidak diperlukan pengalaman sebelumnya. C# Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 3.
Berapa lama pelajaran “Utilitas generik yang dapat digunakan ulang” memakan waktu?
Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.
Bisakah aku menulis dan menjalankan kode dalam pelajaran C# Academy ini?
Ya. Setiap pelajaran C# Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.
Semua pelajaran dalam kursus ini
- unmanaged, notnull, new() (emulasi C# 6)
- Matematika generik (ikhtisar), atribut generik (bila relevan)
- Utilitas generik yang dapat digunakan ulang