جلسهی 30: پروژه: انبارِ همهچیز Project: The Everything Store
یک کلاس جنریک به اسم Store<T> میسازی: انباری که هر چیزی را که id دارد نگه میدارد، پیدا میکند و عوض میکند. بعد همان یک کلاس را برای کتابها و برای بازیکنها به کار میبری.
در این جلسه یاد میگیری
- در پایان این پروژه یک کلاس جنریکِ شرطدار ساختهای:
Store<T extends { id: number }>. - در پایان این پروژه میتوانی تابعی بنویسی که
T | undefinedبرمیگرداند و باifاز جوابش استفاده کنی. - در پایان این پروژه
Partial<T>را در یک کلاس واقعی به کار بردهای. - در پایان این پروژه دیدهای که یک کلاس، بدون کپی، برای دو شکل متفاوت کار میکند.
درس
یک انبار بزرگ را تصور کن با قفسههای شمارهدار. انباردار کاری ندارد که داخل بستهها چیست: کتاب، توپ یا کفش. فقط یک شرط دارد: هر بسته باید شماره داشته باشد، تا بشود پیدایش کرد. در این پروژه همین انبار را میسازی: کلاس Store<T>. T هر شکلی میتواند باشد، به شرطی که id عددی داشته باشد. این نقشهی کار است.
همهی تکهها را بلدی؛ فقط باید کنار هم بگذاری. کلاس جنریک را در جلسهی ۲۸ دیدی، شرطِ extends { id: number } را در جلسهی ۲۷ و Partial را در جلسهی ۲۹. این یک نمونهی کوچک است: انباری که فعلاً فقط add و count دارد، برای حیوانهای خانگی. انبار پروژه از این کاملتر است.
<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>
<pre id="out"></pre>
<script type="text/typescript">
interface Pet {
id: number;
name: string;
}
class Store<T extends { id: number }> {
private items: T[] = [];
add(item: T): void {
this.items.push(item);
}
get count(): number {
return this.items.length;
}
}
const pets = new Store<Pet>();
pets.add({ id: 1, name: "Pishi" });
show(pets.count);
</script>
پروژه چهار قدم دارد و هر قدم روی کدِ قدم قبل ساخته میشود. بعد از هر قدم اجرا کن. دو نکته: ۱) get شاید چیزی پیدا نکند، پس جوابش T | undefined است و قبل از استفاده باید با if نگاه کنی. ۲) در update این خط به کارت میآید: Object.assign(item, changes);. یعنی «فیلدهای changes را روی item بریز». فقط فیلدهایی که در changes هستند عوض میشوند.
وقتی تمام شد، به کلاس Store نگاه کن: حتی یک بار هم کلمهی Book یا Player در آن نیامده است. با این حال برای هر دو کار میکند و اشتباههای هر دو را میگیرد. این قدرت جنریک است. اگر دوست داشتی، یک انبار سوم برای چیزی که خودت دوست داری بساز، یا یک remove(id) به کلاس اضافه کن. در فاز بعد تایپاسکریپت را به دنیای واقعی میبری: صفحه، دکمهها و دادههایی که از بیرون میآیند.
مثالهای این جلسه
چالشها
- Step 1: The Store (آسان)
- Step 2: Find One (متوسط)
- Step 3: Change One (متوسط)
- Step 4: A Second Store (سخت)