在我的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);
答案 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集合。