C# Language
Wzory konstrukcyjne

Wprowadzenie

Wzorzec projektu adaptera

„Adapter”, jak sama nazwa wskazuje, jest obiektem, który pozwala na komunikację między sobą dwóch niekompatybilnych interfejsów.

Na przykład: jeśli kupisz Iphone 8 (lub inny produkt Apple), potrzebujesz wielu adapterów. Ponieważ domyślny interfejs nie obsługuje audio jac ani USB. Za pomocą tych adapterów można używać słuchawek z przewodami lub zwykłego kabla Ethernet. Tak więc „dwa wzajemnie niekompatybilne interfejsy komunikują się ze sobą” .

Z technicznego punktu widzenia oznacza to: Konwertuj interfejs klasy na inny interfejs, którego oczekują klienci. Adapter pozwala klasom współpracować ze sobą, co nie byłoby możliwe z powodu niekompatybilnych interfejsów. Klasy i obiekty uczestniczące w tym wzorze to:

Wzór adaptera wychodzi z 4 elementów

1. ITarget: jest to interfejs używany przez klienta do osiągnięcia funkcjonalności.
2. Adaptee: jest to funkcjonalność, której klient potrzebuje, ale jej interfejs nie jest zgodny z klientem.
3. Klient: jest to klasa, która chce osiągnąć pewną funkcjonalność za pomocą kodu adaptowanego.
4. Adapter: jest to klasa, która zaimplementuje ITarget i wywoła kod Adaptee, który klient chce wywołać.

UML

Przykład pierwszego kodu (przykład teoretyczny) .

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();
    }
}

Przykład drugiego kodu (rzeczywistość światowa)

/// <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();
    }
}

Kiedy użyć

• Zezwól systemowi na użycie klas innego systemu, który jest z nim niezgodny.
• Umożliwiają komunikację między nowym a już istniejącym systemem, które są od siebie niezależne
• Ado.Net SqlAdapter, OracleAdapter, MySqlAdapter są najlepszym przykładem Wzorca adaptera.