שרשור מתודות

חלק מהיחידה תכנות מונחה עצמים במסלול ה-GO של Coddy. שיעור 81 מתוך 107.

שרשור מתודות הוא טכניקה שבה מתודות מחזירות את האובייקט שעליו הן נקראות, וכך מאפשרות לקשר יחד כמה קריאות למתודות במשפט אחד. כבר ראית את זה בתבנית Builder, אבל זהו מושג עצמאי ושימושי בהקשרים רבים.

המפתח הוא להחזיר מצביע למבנה מכל מתודה:

type Query struct {
    table   string
    columns []string
    where   string
    limit   int
}

func (q *Query) Select(cols ...string) *Query {
    q.columns = cols
    return q
}

func (q *Query) From(table string) *Query {
    q.table = table
    return q
}

func (q *Query) Where(condition string) *Query {
    q.where = condition
    return q
}

func (q *Query) Limit(n int) *Query {
    q.limit = n
    return q
}

עכשיו אפשר לשרשר את הקריאות האלה בצורה שוטפת:

query := &Query{}
query.Select("name", "email").From("users").Where("active = true").Limit(10)

זה נקרא כמעט כמו שפה טבעית בהשוואה למשפטים נפרדים. שרשור מתודות עובד בצורה הטובה ביותר כאשר הפעולות מגדירות או משנות אובייקט בלי צורך להחזיר ערכים אחרים. משתמשים בו לעיתים קרובות בבוני שאילתות, בממשקי API להגדרות ובספריות לבדיקת טענות.

זכור שכל מתודה חייבת להשתמש במקבל מצביע ולהחזיר *StructType כדי שהשרשור יפעל כראוי.

אתגר

קל

בואו נבנה בונה של רכיבי HTML בשימוש בשירשור מתודות, כדי ליצור תגי HTML עם מאפיינים ותוכן! זהו יישום מעשי של שירשור מתודות: תיצרו API שכמעט נקרא כמו שפה טבעית בעת בניית רכיבי HTML.

תארגנו את הקוד בשני קבצים:

element.go: הגדירו את בונה רכיבי ה-HTML שלכם עם מתודות שניתן לשרשר.
צרו מבנה Element ששומר את שם התג, מפה של מאפיינים (ממחרוזת למחרוזת) ואת התוכן הפנימי. בנו את המתודות הבאות שניתן לשרשר, וכל אחת מהן מחזירה *Element:
- NewElement(tag string) - בנאי שיוצר Element חדש עם שם התג הנתון ומפה מאותחלת (ריקה) של מאפיינים
- Attr(key, value string) - מוסיפה מאפיין לרכיב
- ID(id string) - מתודת נוחות שמגדירה את המאפיין "id"
- Class(class string) - מתודת נוחות שמגדירה את המאפיין "class"
- Content(text string) - מגדירה את התוכן הפנימי של הרכיב
הוסיפו מתודת Render() שמחזירה מחרוזת HTML. המאפיינים צריכים להופיע בסדר אלפביתי לפי המפתח. הפורמט הוא:
```
<tag attr1="value1" attr2="value2">content</tag>
```
אם אין מאפיינים, הציגו פשוט את <tag>content</tag>. אם אין תוכן, הציגו <tag attr="value"></tag>.
main.go: בנו רכיבי HTML באמצעות שירשור מתודות.
קראו את שם התג, ואז קראו את מספר הפעולות שיש לבצע. כל פעולה היא אחת מהבאות:
- id ואחריו ערך ה-ID
- class ואחריו ערך ה-class
- attr ואחריו שם המאפיין והערך שלו (בשתי שורות)
- content ואחריו טקסט התוכן
שרשרו את כל הפעולות זו לזו בצורה קולחת, ואז הדפיסו את ה-HTML שנוצר.

הקלטים הבאים יסופקו:

שורה 1: שם התג
שורה 2: מספר הפעולות
השורות הבאות: סוג הפעולה והערכים שלה

לדוגמה, עבור הקלט:

div
3
id
container
class
main-content
content
Hello World

הפלט שלכם צריך להיות:

<div class="main-content" id="container">Hello World</div>

ועבור הקלט:

a
3
attr
href
https://example.com
attr
target
_blank
content
Click here

הפלט שלכם צריך להיות:

<a href="https://example.com" target="_blank">Click here</a>

ועבור הקלט:

input
2
attr
type
text
attr
placeholder
Enter name

הפלט שלכם צריך להיות:

<input placeholder="Enter name" type="text"></input>

ועבור הקלט:

p
1
content
Simple paragraph

הפלט שלכם צריך להיות:

<p>Simple paragraph</p>

שימו לב איך שירשור מתודות מאפשר לכם לבנות רכיבים צעד אחר צעד בדרך קריאה. כל מתודה משנה את הרכיב ומחזירה אותו, כך שאפשר לשרשר ישירות את הקריאה למתודה הבאה.

נסו בעצמכם

package main

import (
	"bufio"
	"fmt"
	"os"
	"strconv"
)

func main() {
	scanner := bufio.NewScanner(os.Stdin)

	// קרא את שם התגית
	scanner.Scan()
	tagName := scanner.Text()

	// קרא את מספר הפעולות
	scanner.Scan()
	numOps, _ := strconv.Atoi(scanner.Text())

	// צור את האלמנט
	element := NewElement(tagName)

	// עבד כל פעולה
	for i := 0; i < numOps; i++ {
		scanner.Scan()
		operation := scanner.Text()

		// TODO: בהתאם לסוג הפעולה, שרשר את המתודה המתאימה
		// הפעולות האפשריות הן: "id", "class", "attr" או "content"
		// - עבור "id": קרא את השורה הבאה כערך ה-ID
		// - עבור "class": קרא את השורה הבאה כערך המחלקה
		// - עבור "attr": קרא את TWO השורות הבאות (שם המאפיין, ואז הערך)
		// - עבור "content": קרא את השורה הבאה כטקסט התוכן
		// השתמש בשרשור מתודות כדי לבנות את האלמנט באופן שוטף

		_ = operation // הסר את השורה הזו בעת המימוש
	}

	// הדפס את ה-HTML שעבר רינדור
	fmt.Println(element.Render())
}