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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容