C# Language
Strukturelle Entwurfsmuster

Einführung

Adapter Design Pattern

„Adapter“ ist, wie der Name schon sagt, das Objekt, mit dem zwei miteinander inkompatible Schnittstellen miteinander kommunizieren können.

Zum Beispiel: Wenn Sie ein Iphone 8 (oder ein anderes Produkt von Apple) kaufen, benötigen Sie viele Adapter. Weil die Standardschnittstelle kein Audio oder USB unterstützt. Mit diesen Adaptern können Sie Kopfhörer mit Kabel oder ein normales Ethernet-Kabel verwenden. "Zwei miteinander inkompatible Schnittstellen kommunizieren also miteinander" .

In technischer Hinsicht bedeutet dies: Konvertieren Sie die Schnittstelle einer Klasse in eine andere Schnittstelle, die ein Client erwartet. Adapter lassen Klassen zusammenarbeiten, die sonst wegen inkompatibler Schnittstellen nicht möglich wären. Die Klassen und Objekte, die an diesem Muster teilnehmen, sind:

Das Adaptermuster verlässt 4 Elemente

1. ITarget: Dies ist die Schnittstelle, über die der Client die Funktionalität erreicht.
2. Anpassung: Dies ist die Funktionalität, die der Client wünscht, seine Schnittstelle ist jedoch nicht mit dem Client kompatibel.
3. Client: Dies ist die Klasse, die mit dem Code des Adaptees einige Funktionalität erreichen möchte.
4. Adapter: Dies ist die Klasse, die ITarget implementiert und den Adaptee-Code aufrufen würde, den der Client aufrufen möchte.

UML

Erstes Code-Beispiel (Theoretisches Beispiel) .

public interface ITarget
{
    void MethodA();
}

public class Adaptee
{
    public void MethodB()
    {
        Console.WriteLine("MethodB() is called");
    }
}

public class Client
{
    private ITarget target;

    public Client(ITarget target)
    {
        this.target = target;
    }

    public void MakeRequest()
    {
        target.MethodA();
    }
}  

public class Adapter : Adaptee, ITarget
{
    public void MethodA()
    {
        MethodB();
    }
}

Zweites Codebeispiel (Realimitation)

/// <summary>
///  Interface: This is the interface which is used by the client to achieve functionality.
/// </summary>
public interface ITarget
{
    List<string> GetEmployeeList();
}

/// <summary>
/// Adaptee: This is the functionality which the client desires but its interface is not compatible with the client.
/// </summary>
public class CompanyEmplyees
{
    public string[][] GetEmployees()
    {
        string[][] employees = new string[4][];

        employees[0] = new string[] { "100", "Deepak", "Team Leader" };
        employees[1] = new string[] { "101", "Rohit", "Developer" };
        employees[2] = new string[] { "102", "Gautam", "Developer" };
        employees[3] = new string[] { "103", "Dev", "Tester" };

        return employees;
    }
}

/// <summary>
/// Client: This is the class which wants to achieve some functionality by using the adaptee’s code (list of employees).
/// </summary>
public class ThirdPartyBillingSystem
{
    /* 
     * This class is from a thirt party and you do'n have any control over it. 
     * But it requires a Emplyee list to do its work
     */

    private ITarget employeeSource;

    public ThirdPartyBillingSystem(ITarget employeeSource)
    {
        this.employeeSource = employeeSource;
    }

    public void ShowEmployeeList()
    {
        // call the clietn list in the interface
        List<string> employee = employeeSource.GetEmployeeList();

        Console.WriteLine("######### Employee List ##########");
        foreach (var item in employee)
        {
            Console.Write(item);
        }

    }
}

/// <summary>
/// Adapter: This is the class which would implement ITarget and would call the Adaptee code which the client wants to call.
/// </summary>
public class EmployeeAdapter : CompanyEmplyees, ITarget
{
    public List<string> GetEmployeeList()
    {
        List<string> employeeList = new List<string>();
        string[][] employees = GetEmployees();
        foreach (string[] employee in employees)
        {
            employeeList.Add(employee[0]);
            employeeList.Add(",");
            employeeList.Add(employee[1]);
            employeeList.Add(",");
            employeeList.Add(employee[2]);
            employeeList.Add("\n");
        }

        return employeeList;
    }
}

/// 
/// Demo
/// 
class Programs
{
    static void Main(string[] args)
    {
        ITarget Itarget = new EmployeeAdapter();
        ThirdPartyBillingSystem client = new ThirdPartyBillingSystem(Itarget);
        client.ShowEmployeeList();
        Console.ReadKey();
    }
}

Wann verwenden?

• Zulassen, dass ein System Klassen eines anderen Systems verwendet, die nicht mit ihm kompatibel sind.
• Erlauben Sie die Kommunikation zwischen neuen und bereits bestehenden Systemen, die voneinander unabhängig sind
• Ado.Net SqlAdapter, OracleAdapter, MySqlAdapter sind das beste Beispiel für das Adaptermuster.