Adapter

Definição (GoF): “Converter a interface de uma classe em outra interface esperada pelos clientes. Adapter permite a comunicação entre classes que não poderiam trabalhar juntas devido à incompatibilidade de suas interfaces.”

Problema

• O cliente espera uma interface-alvo (Target), mas a implementação disponível expõe uma interface incompatível (Adaptee).

  classDiagram
  direction TD
  class Cliente {
    - Alvo alvo
    +Cliente(Alvo a)
    +executar()
  }
  Cliente --> Alvo : usa 
  class Alvo {
    <<interface>>
    +metodo()
  } 
  class CodigoExistente {
    +metodoUtil()
  }

Código Fonte

Cliente.javaAlvo.javaCodigoExistente.java

public class Cliente {
    private final Alvo alvo;

    public Cliente(Alvo a) {
        this.alvo = a;
    }

    public void executar() {
        // o cliente só conhece a INTERFACE Alvo
        alvo.metodo();
    }
}

public interface Alvo {
    void metodo();
}

public class CodigoExistente {
    public void metodoUtil() {
        System.out.println("[CodigoExistente] fazendo o trabalho útil...");
    }
}

• Como reusar o código existente (legado/terceiros) sem alterar seu contrato, nem quebrar o cliente?

Solução (visões GoF)

• Class Adapter (herança): o adaptador implementa Target e herda de Adaptee (em Java, viável quando Target é interface).

• Object Adapter (composição): o adaptador implementa Target e compõe um Adaptee, delegando chamadas (opção mais flexível/testável).

Class Adapter

  classDiagram
  direction TD
  class Cliente {
    -alvo : Alvo
    +Cliente(Alvo a)
    +executar()
  }
  Cliente --> Alvo : usa 
  class Alvo {
    <<interface>>
    +metodo()
  } 
  class CodigoExistente {
    +metodoUtil()
  }
  class ClasseAdapter {
    +metodo()
  }
  note for ClasseAdapter "metodo(){ this.metodoUtil()}"
  ClasseAdapter ..|> Alvo : implementa
  CodigoExistente <|--  ClasseAdapter : herda

Código Fonte

AdaptadorClasse.java

// Implementa Alvo (Target) e HERDA CodigoExistente (Adaptee)
public class AdaptadorClasse extends CodigoExistente implements Alvo {
    @Override
    public void metodo() {
        // traduz a chamada esperada pelo cliente → para o método do adaptee
        super.metodoUtil();
    }
}

Object Adapter

  classDiagram
  direction TD
  class Cliente {
    -alvo : Alvo
    +Cliente(Alvo a)
    +executar()
  }
  Cliente --> Alvo : usa 
  class Alvo {
    <<interface>>
    +metodo()
  } 
  class CodigoExistente {
    +metodoUtil()
  }
  class ObjectAdapter {
    -codigoExistente : CodigoExistente
    +metodo()
  }
  note for ObjectAdapter "metodo(){ this.codigoExistente.metodoUtil()}"
  ObjectAdapter ..|> Alvo : implementa
  CodigoExistente --*  ObjectAdapter : tem

Código Fonte

AdaptadorObjeto.java

// Implementa Alvo (Target) e COMPÕE CodigoExistente (Adaptee)
public class AdaptadorObjeto implements Alvo {
    private final CodigoExistente adaptee;

    public AdaptadorObjeto(CodigoExistente adaptee) {
        this.adaptee = adaptee;
    }

    @Override
    public void metodo() {
        // delega/traduz para o adaptee
        adaptee.metodoUtil();
    }
}

Código Fonte

Demo.java

public class Demo {
    public static void main(String[] args) {

        // Usando o CLASS ADAPTER (herança)
        Alvo a1 = new AdaptadorClasse();
        Cliente cliente1 = new Cliente(a1);
        cliente1.executar();

        // Usando o OBJECT ADAPTER (composição)
        Alvo a2 = new AdaptadorObjeto(new CodigoExistente());
        Cliente cliente2 = new Cliente(a2);
        cliente2.executar();
    }
}

---

Exemplo 1: Adapter Problema

  classDiagram
  direction TD

  namespace myApp{
  class CadastroController {
    -servicoCep : ServicoCep
    +Cliente(ServicoCep servicoCep)
  }

  class ServicoCep {
    <<interface>>
    +obterEndereco(String cep): Endereco
  } 
  class Endereco {
    <<interface>>
  } 
  }

  CadastroController --> ServicoCep : usa 
  CadastroController --> Endereco : usa 

  namespace ViaCep{
  class ViaCepService {
    +lookup(String cep): EnderecoViaCep
  }

  class EnderecoViaCep {
  }

  }
  ViaCepService --> EnderecoViaCep

Código Fonte

CepControler.javaServicoCep.javaEndereco.javaViaCepService.javaViaCepEndereco.java

public class CepControler {
    private final ServicoCep servico;
    public Cliente(ServicoCep servico) {
        this.servico = servico;
    }
    public Endereco executar() {
        // o cliente só conhece a INTERFACE Alvo
        return servico.obterEndereco(41740090);
    }
}

public interface ServicoCep {
    Endereco obterEndereco(String cep);
}

public interface Endereco {
    public String getLogradouro();
}

public class ViaCepService {
    public ViaCepEndereco lookup(String cep) {
        System.out.println("codigo para Obter Cep");
    }
}

public class ViaCepEndereco {
    //dados de Endereco
    public String getRua(){
    }
}

Solução

  classDiagram
  direction LR

  namespace myApp{
  class CadastroController {
    -servicoCep : ServicoCep
    +Cliente(ServicoCep servicoCep)
  }

  class ServicoCep {
    <<interface>>
    +obterEndereco(String cep): Endereco
  } 
  class Endereco {
    <<interface>>
  } 

 class CepServiceAdapter {
    -viaCepService : ViaCepService
    +obterEndereco(String cep) Endereco
  }
  class EnderecoAdapter{
    -enderecoViaCep : EnderecoViaCep
  }
}

  note for CepServiceAdapter "obterEndereco(cep){ this.lookup(cep)()}"
  CepServiceAdapter ..|> ServicoCep : implementa
  ViaCepService  <| -- CepServiceAdapter : herda
  CepServiceAdapter --> Endereco

  EnderecoAdapter ..|> Endereco : implementa
  EnderecoViaCep  --* EnderecoAdapter : tem


  CadastroController --> ServicoCep : usa 
  CadastroController --> Endereco : usa 

  namespace ViaCep{
  class ViaCepService {
    +lookup(String cep): EnderecoViaCep
  }

  class EnderecoViaCep


  }
  ViaCepService --> EnderecoViaCep

Código Fonte

ViaCepAdapter.javaEnderecoAdapter.java

public class ViaCepAdapter extends ViaCepService implements ServicoCep {
    @Override
    public Endereco obterEndereco(String cep) { 
        return new EnderecoAdapter(lookup(cep));
    }
}

public class EnderecoAdapter implements Endereco {
    private EnderecoViaCep enderecoViaCep;
    public EnderecoAdapter(EnderecoViaCep enderecoViaCep) {
        this.enderecoViaCep = enderecoViaCep;
    }
    public String getLogradouro() {
        return enderecoViaCep.getLogradouro();
    }
}