在使用第三方API并在Laravel中创建域时使用适配器模式

时间:2019-04-26 13:18:11

标签: laravel design-patterns architecture repository adapter

在我的Laravel REST API项目中,我主要使用第三方API。为此,我有一个按API(住宿,计划,折扣等)分组的“ 服务”文件夹,用于向API发送正确的参数并获取原始数据。

我觉得我需要在这里使用适配器模式,因为这第三方的输出需要格式化。

让我尝试举一个例子。

我有一个EventDao接口(数据访问对象)和一个或多个具体的EventDao类,例如EventbriteDao。

我对每个具体的DAO都有一个适配器。例如:EvenbriteAdapter

我将在某处有一些业务逻辑,因此我需要有一个Event entity 类。要将适配器的数据传递给实体,我需要一个EventDTO类(数据传输对象

最后,我可以调用eventDao(感谢Laravel的服务提供商,通过界面)

我将其原始输出传递给适配器,然后将适配器的输出传递给实体。然后,我可以调用实体类的方法之一。 (在那之后,我需要将其转换为正确的json数据,但这是简单的部分。)

我没有放置其他CRUD逻辑的地方,例如 updateEvent,deleteEvent,getAll 等。我应该直接在控制器中调用它们还是创建存储库(存储库模式 )?我对此感到困惑。

这是一种好方法还是过度设计?因为除了控制器以外,我还有5-6个类/接口。

另一个问题是直接在控制器中调用EventbriteAdapter。我应该有一个接口吗?在这种情况下,我将需要将服务和适配器接口都绑定到其在AppServiceProvider中的实现。

我的另一个担心是拥有实体块的集合。如果我调用getAll()方法,则可以遍历数据并创建对象数组,但是我对此并不满意。 Laravel的集合将很有用,但我想将应用程序层与域分开。有什么好的解决方案?

以下是我提到的某些文件的示例代码:

interface EventAdapter
{
    public function getId();
    public function getName();
    public function getStartDate();
    public function getLocationName();
}



class EventbriteAdapter implements EventInterface
{
    private $raw;

    public function __construct(array $raw)
    {
        $this->raw = $raw;
    }

    public function getName()
    {
        return $this->raw['name'];
    }

    public function getStartDate()
    {
        return $this->raw['start'];
    }

    public function getLocation()
    {
        return $this->raw['venue']['name'].' '.$this->raw['venue']['address'];
    }
}


// Fetch event from Eventbrite (or other third-party)
$result = fetchEventFromEventbrite();

// Wrap event in adapter
$adapter = new EventbriteAdapter($result);

1 个答案:

答案 0 :(得分:2)

  

我不知道将其他CRUD逻辑(例如updateEvent)放在哪里,   deleteEvent,getAll等。我应该直接在控制器中调用它们还是   创建存储库(存储库模式)?我对此感到困惑。

您可以使用the Gateway pattern来封装与第三方API交互的所有逻辑。网关可以包含获取数据和保存数据的方法。例如:

interface EventGatewayInterface
{
    /**
     * Get an event by id
     * 
     * @param mixed $id unique identifier of an event
     * @return Event the event
     */
    public function getById($id);

    /**
     * Get all events
     *
     * @return Event[] list of events
     */
    public function getAll();

    /** 
     * Add an event
     *
     * @param Event $event the event which will be added
     */
    public function add(Event $event);

    /**
     * Update an event
     *
     * @param Event $event the event which will be updated  
     */
    public function update(Event $event);

    /**
     * Delete an event
     *
     * @param Event $event the event which will be removed
     */
    public function delete();
}
  

这是一个好方法还是过度设计?因为我有5-6   控制器以外的其他类/接口。

实际上,您使用the Adapter pattern将一种表示形式(原始表示形式)转换为另一种表示形式(对象表示形式)。但是适配器模式用于将一个程序接口转换为兼容的程序接口。要转换表示,请使用the Mapper pattern。您可以实现简单的映射器,例如:

class RawEventMapper
{
    /**
     * Map raw data to an event object
     * 
     * @param array $data raw data
     * @return Event the event object
     */
    public function map(array $data)
    {
        $event = new Event();
        $event->name = $data['name'];
        $event->startDate = $data['start'];
        $event->location = $data['venue']['name'].' '.$data['venue']['address'];
        return $event;
    }
}

并在Gateway中使用它将原始数据转换为对象。

class ConcreteEventGateway implement EventGatewayInterface
{
    /** @var RawEventMapper data mapper */
    protected $mapper;

    /**
     * Constructor
     *
     * @param RawEventMapper $mapper data mapper
     */ 
    public function __construct(RawEventMapper $mapper)
    {
        $this->mapper = $mapper;
    }

    /** @inheritdoc */
    public function getById($id)
    {
        // get raw data from 3rd party API
        return $this->mapper->map($raw);
    }
}
  

Laravel的收藏很有用,但我想分开   域中的应用层。有什么好的解决方案?

如果您打算创建独立于框架的域层,则不应使用Laravel集合。