Api对接之－适配器模式

最近需要对接第三方独立平台的推送订单，同步库存以及同步包裹信息。考虑不同平台数据接口的差异，以及我们自有系统的维护便利性，这里采用了适配器模式来处理。
何为适配器模式：其核心思想把对某些相似的类的操作转化为一个统一的“接口”(这里是比喻的说话)–适配器，或者比喻为一个“界面”，统一或屏蔽了那些类的细节。适配器模式还构造了一种“机制”，使“适配”的类可以很容易的增减，而不用修改与适配器交互的代码，符合“减少代码间耦合”的设计原则。
最常见的例子就是我们的电源转换插头，不同伏的电源，不同的类型电器(有些需要5伏，有些需要10伏)，但是只需要一个电源转换器，它们就可以适配使用。废话少说，上代码：
获取本地数据，封装成独立的对象放置在trait中：

trait GetBaseData
{
    public function getPayOrders($providerId, $startTime = 1489680000);
    public function getProductSku($providerId);
    public function getUnshipOrder($providerId);
}

由于PHP不像Java可以使用对象的引用，可以在运行时决定具体使用哪个子类的方法。但是由于它是弱类型，可以采用变相的方式来达到多态的效果。本例中使用一个通用类来处理真正的实现。

class ApiInterface
{
    public function syncOrder($obj, $data)
    {
        $orderInfo = $obj->packOrderData($data);
        $output = $obj->syncOrderInfo($orderInfo);
        $result = $obj->parseOrderResult($output);
        return $result;
    }
    public function pullGoods($obj, $data)
    {
        $goodsInfo = $obj->packGoodsData($data);
        $output = $obj->pullGoodsInfo($goodsInfo);
        $result = $obj->parseGoodsResult($output);
        return $result;
    }
    public function pullShip($obj, $data)
    {
        $goodsInfo = $obj->packShipData($data);
        $output = $obj->pullShipInfo($goodsInfo);
        $result = $obj->parseShipResult($output);
        return $result;
    }
}

通过通用接口，我们可以统一调用不需要改外层调用的地方。代码调用处可以将真正的执行对象传入，类似于这样操作。
$apiInterface = new ApiInterface();$retMsg = $apiInterface->syncOrder($obj, $item);
至于外层调用这个$obj如何获得，我们就可以使用工厂模式来获得，具体适配的代码也是工厂模式中来匹配到对应的执行类。下面给出其中一个适配类的实现。

class FuHeLe implements BaseInterface
{
    private $allianceCode = '';
    private $requestTime  = '';
    private $secretKey    = '';
    private $sign        = '';

    //静态变量保存全局实例
    private static $_instance = null;

    //私有构造函数，防止外界实例化对象
    private function __construct() 
    {
        *******
    }
    //私有克隆函数，防止外办克隆对象
    private function __clone() {}

    //静态方法，单例统一访问入口
    public static function getInstance() {
        if (is_null ( self::$_instance ) || isset ( self::$_instance )) {
            self::$_instance = new self ();
        }
        return self::$_instance;
    }

    public function packOrderData($item)
    {
        ********
    }
    public function packGoodsData($sku)
    {
        ********
    }
    public function packShipData($item)
    {
        ********
    }
    public function syncOrderInfo($orderInfo)
    {
        ********
    }
    public function pullGoodsInfo($sku)
    {
        *********
    }
    public function pullShipInfo($orderInfo)
    {
        ********
    }
    public function parseOrderResult($retXml)
    {
        ********
    }
    public function parseGoodsResult($retXml)
    {
        *********
    }
    public function parseShipResult($retXml)
    {
        **********
    }
}

这个适配类处理每个同步功能都处理成三个函数：封装数据(packOrderData), 请求第三方平台(syncOrderInfo)，以及解析数据(parseOrderResult)。这个类的代码就是以后对接其它平台需要着重处理的类，至于根据返回值来做自有系统的业务逻辑也是可以独立被封装成trait。

trait HandleResult
{
    use LogApiStatic;
    public function updSyncOrder($retMsg, $item);
    public function updSyncGoods($retMsg, $item, $barCodeArr);
    public function updSyncShip($retMsg, $item, $pStr);
}

采用这样适配器模式的好处在于，开发人员只需要着重编写适配类即可，而且维护方便。功能代码能够有更好的耦合性，数据隔离性做的更好。
大家喜欢可以访问我的个人网站：http://www.yingminxing.com
如有疑问，欢迎沟通交流：QQ:370399195, 微信:yingminxing1988