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

采用这样适配器模式的好处在于,开发人员只需要着重编写适配类即可,而且维护方便。功能代码能够有更好的耦合性,数据隔离性做的更好。

如有疑问,欢迎沟通交流:QQ:370399195, 微信:yingminxing1988

发表评论

电子邮件地址不会被公开。 必填项已用*标注