当唯一的区别是一个变量的类型时重构重复的代码？

Question

我必须能够连接到两个不同版本的 API（1.4 和 1.5），我们将其称为 Foo API。我连接到 API 并处理结果的代码基本上是重复的 - 唯一的区别是从两个 API 返回的数据类型。我如何重构它以消除重复？

在 Foo14Connector.cs （我自己的调用 1.4 API 的类）

public class Foo14Connector
{
    public void GetAllCustomers() 
    {
        var _foo = new Foo14WebReference.FooService();
        Foo14WebReference.customerEntity[] customers = _foo.getCustomerList;
        foreach (Foo14WebReference.customerEntity customer in customers)
        {
            GetSingleCustomer(customer);
        }
    }
    public void GetSingleCustomer(Foo14WebReference.customerEntity customer)
    {
        var id = customer.foo_id;
        // etc 
    }
}

和几乎完全相同的重复类 Foo15Connector.cs （我自己的调用 1.5 API 的类）中，

public class Foo15Connector
{
    public void GetAllCustomers() 
    {
        var _foo = new Foo15WebReference.FooService();
        Foo15WebReference.customerEntity[] customers = _foo.getCustomerList;
        foreach (Foo15WebReference.customerEntity customer in customers)
        {
            GetSingleCustomer(customer);
        }
    }
    public void GetSingleCustomer(Foo15WebReference.customerEntity customer)
    {
        var id = customer.foo_id;
        // etc 
    }
}

请注意，我必须有两个不同的连接器，因为一个方法调用（out数百）API 上在 1.5 中有一个新参数。

Foo14WebReference.customerEntity 和 Foo15WebReference.customerEntity 两个类具有相同的属性。

Answer 1

如果连接器位于不同的项目中，则这是一个很容易解决的情况：

添加一个新的类文件，将其命名为 ConnectorCommon 并复制所有公共代码，但删除命名空间。使此类成为分部类，并将该类（而不是文件）重命名为类似 Connector 的名称。

您需要为每个项目添加一个链接。

接下来，从当前连接器类中删除所有代码，将类（不一定是文件）重命名为与分部类相同的名称，并添加引用命名空间的 using 语句。

这应该得到你正在寻找的东西。

因此，完成后您将拥有：

File ConnectorCommon:

public partial class Connector
{
    public void GetAllCustomers() 
    {
        var _foo = new FooService();
        customerEntity[] customers = _foo.getCustomerList;
        foreach (customerEntity customer in customers)
        {
            GetSingleCustomer(customer);
        }
    }
    public void GetSingleCustomer(customerEntity customer)
    {
        var id = customer.foo_id;
        // etc 
    }
}

File Magento15Connector

using Foo15WebReference;

partial class Connector
{
}

File Magento14Connector

using Foo14WebReference;

partial class Connector
{
}

更新

这个过程一开始可能会有点混乱。

澄清一下，您正在两个项目之间的公共文件中共享源代码。

实际的类是每个项目中具有名称空间的特定类。您可以使用partial 关键字使公共文件与每个项目中的实际项目文件（即Magneto14）相结合，以便在编译时在该项目中创建完整的类。

最棘手的部分是将公共文件添加到两个项目中。

为此，请在第二个项目中选择“添加现有项目...”菜单，导航到公共文件，然后单击“添加”按钮旁边的右箭头。

从下拉菜单中，选择添加为链接。这会将文件的引用添加到第二个项目。源代码将包含在两个项目中，并且对公共文件的任何更改都将自动在两个项目中可用。

更新 2

我有时会忘记 VB 使这样的任务是多么容易，因为那是我普通的编程环境。

为了在 C# 中实现此功能，还必须使用一个技巧：条件编译符号。它使通用代码的开头比我想要的更冗长，但它仍然确保您可以使用一组通用代码。

要使用此技巧，请向每个项目添加一个条件编译符号（确保为所有配置设置它）。例如，在 Magento14 项目中添加 Ver14，在 Magento15 项目中添加 Ver15。

然后在公共文件中，将命名空间替换为类似于以下的结构：

#if Ver14
using Magneto14;
namespace Magento14Project

#elif Ver15
using Magneto15;
namespace Magento15Project

#endif

这将确保根据公共代码编译到的项目包含正确的命名空间和用法。

请注意，所有常见的 using 语句都应保留在公共文件中（即足以使其编译）。

Answer 2

如果 FooConnectors 未密封并且您可以控制创建新实例，那么您可以派生自己的连接器并同时实现接口。在 C# 中，您可以通过简单地从基类继承成员来实现成员！

public IFooConnector {
    void GetAllCustomers();
}

public MyFoo14Connector : Foo14Connector, IFooConnector
{
    // No need to put any code in here!
}

进而

IFooConnector connector = new MyFoo14Connector();
connector.GetAllCustomers();

Answer 3

您应该引入两个实现通用的接口。如果项目是用相同的语言编写的并且位于不同的项目中，则可以引入两个项目引用的公共项目。然后，您将朝着仅依赖于接口的方向发展，这应该允许您使用控制反转（谷歌、依赖注入或服务定位器或工厂模式）在幕后的某个地方交换不同的实现。

您面临的困难可能是：

1）实现中的公共静态方法无法通过接口静态公开
2) 一个实现类（即 Foo14Connector 或 Foo15Connector）中可能存在将代码放入通用接口中没有意义的代码