תבנית המתאם

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

תבנית המתאם מאפשרת לממשקים שאינם תואמים לעבוד יחד על ידי עטיפת טיפוס קיים בממשק חדש. בעוד ש-Command עוטפת פעולות, Adapter מתרגמת ממשק אחד לאחר שהלקוחות מצפים לו.

דמיין שיש לך מדפסת ישנה שמשתמשת בחתימת מתודה שונה מזו שהיישום שלך מצפה לה:

// ממשק היעד שבו היישום שלך משתמש
type Printer interface {
    Print(text string) string
}

// מדפסת ישנה עם ממשק לא תואם
type OldPrinter struct{}

func (o OldPrinter) PrintDocument(doc string, copies int) string {
    return fmt.Sprintf("Old printer: %s (x%d)", doc, copies)
}

המתאם עוטף את הטיפוס הישן ומממש את הממשק המצופה:

type OldPrinterAdapter struct {
    oldPrinter OldPrinter
}

func (a OldPrinterAdapter) Print(text string) string {
    return a.oldPrinter.PrintDocument(text, 1)
}

כעת המדפסת הישנה פועלת בצורה חלקה עם קוד שמצפה לממשק Printer:

func PrintMessage(p Printer, msg string) string {
    return p.Print(msg)
}

adapter := OldPrinterAdapter{oldPrinter: OldPrinter{}}
result := PrintMessage(adapter, "Hello")  // "Old printer: Hello (x1)"

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

אתגר

קל

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

תארגן את הקוד שלך בשלושה קבצים:

player.go: הגדר את ממשק היעד שלך ואת התקן השמע הישן.
צור ממשק AudioPlayer שהמערכת המודרנית שלך מצפה לו, עם מתודה Play(track string) string שמקבלת את שם הרצועה ומחזירה הודעה על הניגון.

הגדר גם התקן ישן שאינו תואם לממשק הזה:
- מבנה VinylPlayer עם שדה SpeedRPM מסוג int. יש לו מתודה DropNeedle(record string, side string) string שמחזירה Playing [record] ([side] side) at [speed]rpm
הממשק של VinylPlayer אינו תואם ל-AudioPlayer. הוא דורש שני פרמטרים ומשתמש בשם מתודה שונה לחלוטין.
adapter.go: צור את המתאם שלך, שהופך את ההתקן הישן לתואם.
בנה מבנה VinylAdapter שעוטף VinylPlayer ומממש את הממשק AudioPlayer. כשקוראים ל-Play, המתאם צריך לקרוא למתודה DropNeedle של נגן התקליטים, ולהשתמש כברירת מחדל ב-A עבור הפרמטר של הצד.

צור גם נגן מודרני לשם השוואה:
- מבנה DigitalPlayer: המתודה Play שלו מחזירה Streaming: [track]
main.go: הדגם איך שני הנגנים פועלים באמצעות אותו ממשק.
צור פונקציה PlayMusic(player AudioPlayer, track string) string שמשתמשת בממשק כדי לנגן מוזיקה. הפונקציה לא צריכה לדעת או להתעניין אם היא משתמשת בנגן דיגיטלי או בנגן תקליטים שהותאם באמצעות מתאם.

קרא את סוג הנגן (digital או vinyl), ואם הוא נגן תקליטים, קרא גם את מהירות ה-RPM. לאחר מכן קרא את שם הרצועה. צור את הנגן המתאים (באמצעות המתאם עבור נגן תקליטים), נגן את הרצועה באמצעות הפונקציה PlayMusic שלך והדפס את התוצאה.

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

שורה 1: סוג הנגן (digital או vinyl)
שורה 2: מהירות RPM (רק אם מדובר בנגן תקליטים)
השורה האחרונה: שם הרצועה לניגון

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

digital
Bohemian Rhapsody

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

Streaming: Bohemian Rhapsody

ועבור הקלט:

vinyl
33
Abbey Road

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

Playing Abbey Road (A side) at 33rpm

ועבור הקלט:

vinyl
45
Blue Monday

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

Playing Blue Monday (A side) at 45rpm

שים לב שפונקציית PlayMusic פועלת באופן זהה עם שני הנגנים. אין לה מושג שנגן התקליטים למעשה מותאם מממשק שונה לחלוטין. המתאם מתרגם מאחורי הקלעים את הקריאות לממשק המודרני לפורמט הישן!

נסו בעצמכם

package main

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

// PlayMusic משתמשת בממשק AudioPlayer כדי להשמיע מוזיקה
// פונקציה זו פועלת עם כל מימוש של AudioPlayer
// TODO: ממשו את הפונקציה כך שתקרא ל-player.Play(track) ותחזיר את התוצאה
func PlayMusic(player AudioPlayer, track string) string {
	// TODO: ממשו את הפונקציה הזו
	return ""
}

func main() {
	reader := bufio.NewReader(os.Stdin)
	
	// קראו את סוג הנגן
	playerType, _ := reader.ReadString('\n')
	playerType = strings.TrimSpace(playerType)
	
	var player AudioPlayer
	var track string
	
	if playerType == "vinyl" {
		// קראו את מהירות ה-RPM של תקליט הוויניל
		rpmStr, _ := reader.ReadString('\n')
		rpmStr = strings.TrimSpace(rpmStr)
		rpm, _ := strconv.Atoi(rpmStr)
		
		// קראו את שם הרצועה
		track, _ = reader.ReadString('\n')
		track = strings.TrimSpace(track)
		
		// TODO: צרו VinylPlayer עם ערך ה-RPM הנתון
		// TODO: עטפו אותו ב-VinylAdapter
		// TODO: הקצו אותו למשתנה player
		_ = rpm // הסירו שורה זו כשתשתמשו ב-rpm
	} else {
		// קראו את שם הרצועה
		track, _ = reader.ReadString('\n')
		track = strings.TrimSpace(track)
		
		// TODO: צרו DigitalPlayer
		// TODO: הקצו אותו למשתנה player
	}
	
	// TODO: קרא ל-PlayMusic והדפס את התוצאה
	_ = player // הסר את השורה הזו כשאתה משתמש ב-player
	_ = track  // הסר את השורה הזו כשאתה משתמש ב-track
}