Title here
Summary here
מערך שיעור: Controllers
משך: 2.75 שעות אקדמיות (125 דקות).
מטרת השיעור: הסטודנטים יבנו Controller מלא עם CRUD, וישלטו ב-IActionResult לשליטה על תגובות.
בסוף השיעור הסטודנטים צריכים: לכתוב Controller עם [Route]/[HttpGet]/[HttpPost] נכונים, להחזיר IActionResult מתאים לכל תרחיש, ולהסביר [FromBody].
דגש קריטי: זהו שיעור-הליבה של API אמיתי — הקדישו זמן מספק לתרגול מודרך, לא רק הדגמה.
מהלך השיעור
| חלק בשיעור | משך | הערות ודגשים |
|---|---|---|
| פתיחה וחיבור | 5 דקות | הראו Program.cs עם endpoints של כמה משאבים מעורבבים — “מה קורה עם 50 כאלה?” |
| החיבור בין הקבצים | 12 דקות | מבנה תיקיות (Program.cs / Models/ / Controllers/); AddControllers() + MapControllers() ב-Program.cs; “מי קורא ל-Controller” — סריקה בהפעלה → טבלת routing → הפעלת Action. הדגישו: זו אותה זרימה של app.MapGet, רק מגולה מה-attributes |
| שלב 1: שלד Controller ריק | 10 דקות | [ApiController], [Route("api/[controller]")], ControllerBase — בלי Actions עדיין; הקובץ החדש Controllers/StudentsController.cs |
| שלב 2: Action ראשון — GetAll | 15 דקות | [HttpGet], Ok() — קשרו ל-200 מיחידת ה-HTTP |
| שלב 3: Action שני — GetById | 15 דקות | [HttpGet("{id}")], NotFound() — Route Parameter בהקשר Controller |
| שלב 4: Action שלישי — Create | 20 דקות | [HttpPost], [FromBody], CreatedAtAction — חיבור ל-JSON ול-201/Location |
| שלב 5: Action רביעי — Delete | 15 דקות | [HttpDelete("{id}")], NoContent() |
| תרגול מודרך | 33 דקות | תרגיל 1+2 + התחלת פרויקט מסכם |
דגשים להעברת השיעור
- הקדישו זמן אמיתי לחלק “החיבור בין הקבצים” לפני קוד ה-Controller — הטעות הנפוצה של הסטודנטים היא לחשוב שה-Controller “רץ” כמו תוכנית. הבהירו: הוא ארגז פונקציות שה-Framework מגלה בהפעלה ומפעיל בתגובה לבקשה. הראו בפועל מה קורה כשמוחקים את
MapControllers()— כל בקשה חוזרת404למרות שהקוד מתקמפל. - זהו שיעור שדורש הרבה תרגול מעשי בפועל (Postman/curl/Swagger) — לא להסתפק בקוד על שקופית, הריצו endpoints אמיתיים מול Postman/דפדפן.
- הראו את ה-URL שנוצר אוטומטית מ-
[controller]בפועל — סטודנטים צריכים לראות בעיניים ש-StudentsController→api/students. - קשרו CreatedAtAction בבירור ל-Status Code
201+Locationheader מיחידת ה-HTTP הקודמת — לא “עוד syntax”, אלא יישום מדויק של המוסכמה שכבר נלמדה.
מושגים
Controller — מחלקה שמאגדת endpoints קשורים, בקובץ נפרד תחת Controllers/.
AddControllers() / MapControllers() — שתי השורות ב-Program.cs שמפעילות את סריקת ה-Controllers ומחברות אותם ל-Pipeline; בלעדיהן — 404 על הכל.
[Route] — קובע URL בסיס.
[HttpGet]/[HttpPost]/וכו’ — מתייגים Method לכל Action.
IActionResult — שולט על Status Code + Body יחד.
תרגיל חשיבה
שאלת פתיחה: “אם Program.cs שלכם מכיל 50 app.MapGet/MapPost בודדים לניהול תלמידים, מוצרים והזמנות ביחד — מה קשה במציאת קוד ספציפי?”
מהלך: הובילו לתובנה: בלי ארגון, כל הלוגיקה יושבת “שטוחה” באותו קובץ בלי חלוקה הגיונית — בדיוק אותה בעיה כמו מחלקה עם אחריות מעורבבת (SRP) שכבר תרגלתם, רק ברמת ה-API כולו.
מה המרצה מראה בסוף: הראו את אותו API — פעם עם app.MapGet בודדים ב-Program.cs, ופעם עם StudentsController/ProductsController נפרדים — ההבדל בקריאות ובניווט בקוד ברור מיד. הריצו את שניהם בפועל ב-Postman והראו שההתנהגות זהה — ההבדל הוא רק ארגון, לא פונקציונליות.