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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容