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

Question

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

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

让我尝试举一个例子。

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

我还为每个具体 DAO 提供了一个适配器。例如：EvenbriteAdapter

我将在某个地方有一些业务逻辑，所以我需要一个事件实体类。要将适配器的数据传递给实体，我需要一个 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);

Answer 1

我不知道在哪里放置其他 CRUD 逻辑，如 updateEvent、deleteEvent、getAll 等。我应该直接在控制器中调用它们还是创建存储库（存储库模式）？我对此很困惑。

您可以使用网关模式来封装与第三方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 个类/接口。

事实上，您使用适配器模式将一种表示（原始表示）转换为另一种表示（对象表示）。但适配器模式用于将一个程序接口转换为兼容的程序接口。使用映射器模式来转换表示。您可以实现简单的映射器，例如：

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 集合。