Patrón Adapter

Parte de la sección Programación Orientada a Objetos del Journey de GO de Coddy — lección 92 de 107.

El patrón Adapter permite que interfaces incompatibles trabajen juntas envolviendo un tipo existente con una nueva interfaz. Mientras que Command encapsula acciones, Adapter traduce una interfaz en otra que los clientes esperan.

Imagina que tienes una impresora antigua que utiliza una firma de método diferente a la que espera tu aplicación:

// Interfaz objetivo que utiliza tu aplicación
type Printer interface {
    Print(text string) string
}

// Impresora antigua con interfaz incompatible
type OldPrinter struct{}

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

El adaptador envuelve el tipo heredado e implementa la interfaz esperada:

type OldPrinterAdapter struct {
    oldPrinter OldPrinter
}

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

Ahora la impresora heredada funciona a la perfección con el código que espera la interfaz Printer:

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

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

El patrón Adapter es inestimable al integrar librerías de terceros, trabajar con código heredado o cuando necesitas usar clases existentes que no coinciden con los requisitos de tu interfaz. Actúa como un puente sin modificar el código original.

Desafío

Fácil

¡Vamos a construir un sistema de reproductor de medios utilizando el patrón Adapter! Tienes un reproductor de audio moderno que espera una interfaz unificada, pero necesitas integrar equipos de audio antiguos que utilizan firmas de métodos completamente diferentes. Tu adaptador cerrará esta brecha, permitiendo que el hardware antiguo funcione sin problemas con el nuevo sistema.

Organizarás tu código en tres archivos:

player.go: Define tu interfaz objetivo y un dispositivo de audio antiguo.
Crea una interfaz AudioPlayer que tu sistema moderno espera, con un método Play(track string) string que recibe el nombre de una pista y devuelve un mensaje de reproducción.

También define un dispositivo antiguo que no coincide con esta interfaz:
- Estructura VinylPlayer con un campo SpeedRPM (int) — tiene un método DropNeedle(record string, side string) string que devuelve Playing [record] ([side] side) at [speed]rpm
La interfaz del VinylPlayer es incompatible con AudioPlayer—requiere dos parámetros y utiliza un nombre de método completamente diferente.
adapter.go: Crea tu adaptador que hace que el dispositivo antiguo sea compatible.
Construye una estructura VinylAdapter que envuelva un VinylPlayer e implemente la interfaz AudioPlayer. Cuando se llame a Play, el adaptador debe llamar al método DropNeedle del reproductor de vinilo, usando "A" por defecto para el parámetro side.

También crea un reproductor moderno para comparar:
- Estructura DigitalPlayer — su método Play devuelve Streaming: [track]
main.go: Demuestra ambos reproductores funcionando a través de la misma interfaz.
Crea una función PlayMusic(player AudioPlayer, track string) string que utilice la interfaz para reproducir música—esta función no debería saber ni importarle si está usando un reproductor digital o un reproductor de vinilo adaptado.

Lee un tipo de reproductor ("digital" o "vinyl"), y si es vinyl, lee también la velocidad RPM. Luego lee el nombre de la pista. Crea el reproductor apropiado (usando el adaptador para vinyl), reproduce la pista a través de tu función PlayMusic e imprime el resultado.

Se proporcionarán las siguientes entradas:

Línea 1: Tipo de reproductor ("digital" o "vinyl")
Línea 2: Velocidad RPM (solo si es vinyl)
Última línea: Nombre de la pista a reproducir

Por ejemplo, dado:

digital
Bohemian Rhapsody

Tu salida debería ser:

Streaming: Bohemian Rhapsody

Y dado:

vinyl
33
Abbey Road

Tu salida debería ser:

Playing Abbey Road (A side) at 33rpm

Y dado:

vinyl
45
Blue Monday

Tu salida debería ser:

Playing Blue Monday (A side) at 45rpm

Observa cómo la función PlayMusic funciona de manera idéntica con ambos reproductores—no tiene idea de que el reproductor de vinilo en realidad está siendo adaptado desde una interfaz completamente diferente. ¡El adaptador traduce las llamadas de la interfaz moderna al formato antiguo tras bambalinas!

Hoja de referencia

El patrón Adapter permite que interfaces incompatibles trabajen juntas envolviendo un tipo existente con una nueva interfaz.

Define una interfaz de destino que tu aplicación espera:

type Printer interface {
    Print(text string) string
}

Un tipo heredado (legacy) con una interfaz incompatible:

type OldPrinter struct{}

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

Crea un adaptador que envuelva el tipo heredado e implemente la interfaz de destino:

type OldPrinterAdapter struct {
    oldPrinter OldPrinter
}

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

Usa el adaptador para hacer que el tipo heredado funcione con el código que espera la interfaz de destino:

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

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

El patrón Adapter es útil para integrar librerías de terceros, trabajar con código heredado o adaptar clases existentes para que coincidan con las interfaces requeridas sin modificar el código original.

Pruébalo tú mismo

package main

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

// PlayMusic utiliza la interfaz AudioPlayer para reproducir música
// Esta función funciona con cualquier implementación de AudioPlayer
// TODO: Implementa esta función para llamar a player.Play(track) y devolver el resultado
func PlayMusic(player AudioPlayer, track string) string {
	// TODO: Implementa esta función
	return ""
}

func main() {
	reader := bufio.NewReader(os.Stdin)
	
	// Lee el tipo de reproductor
	playerType, _ := reader.ReadString('\n')
	playerType = strings.TrimSpace(playerType)
	
	var player AudioPlayer
	var track string
	
	if playerType == "vinyl" {
		// Lee la velocidad RPM para el vinilo
		rpmStr, _ := reader.ReadString('\n')
		rpmStr = strings.TrimSpace(rpmStr)
		rpm, _ := strconv.Atoi(rpmStr)
		
		// Lee el nombre de la pista
		track, _ = reader.ReadString('\n')
		track = strings.TrimSpace(track)
		
		// TODO: Crea un VinylPlayer con las RPM dadas
		// TODO: Envuélvelo en un VinylAdapter
		// TODO: Asígnalo a la variable player
		_ = rpm // Elimina esta línea cuando uses rpm
	} else {
		// Lee el nombre de la pista
		track, _ = reader.ReadString('\n')
		track = strings.TrimSpace(track)
		
		// TODO: Crea un DigitalPlayer
		// TODO: Asígnalo a la variable player
	}
	
	// TODO: Llama a PlayMusic e imprime el resultado
	_ = player // Elimina esta línea cuando uses player
	_ = track  // Elimina esta línea cuando uses track
}