对接多个物流公司下单接口和获取物流支持目的地接口,用ThinkPHP框架使用工厂模式写了一个示例,包括如何创建目录及文件命名方式。
首先,我们需要定义一个物流公司的接口(Interface):
// application/Interfaces/LogisticsCompany.php
namespace app\Interfaces;interface LogisticsCompany
{public function placeOrder($orderInfo);public function getSupportedDestinations();
}
然后,为每个具体的物流公司实现这个接口:
// application/Service/Logistics/CompanyA.php
namespace app\Service\Logistics;use app\Interfaces\LogisticsCompany;class CompanyA implements LogisticsCompany
{// 实现下单方法public function placeOrder($orderInfo){// 具体的下单逻辑...}// 实现获取支持目的地方法public function getSupportedDestinations(){// 具体的获取目的地逻辑...}
}// 同样方式为其他物流公司创建类,例如:CompanyB, CompanyC 等
接下来,创建物流服务工厂:
// application/Service/LogisticsFactory.php
namespace app\Service;class LogisticsFactory
{private static $companies = ['company_a' => '\\app\\Service\\Logistics\\CompanyA','company_b' => '\\app\\Service\\Logistics\\CompanyB',// 更多物流公司...];public static function create(string $name): LogisticsCompany{if (!isset(self::$companies[$name])) {throw new \InvalidArgumentException("Invalid logistics company: {$name}");}return new self::$companies[$name]();}
}
最后,在控制器或其他需要调用的地方使用工厂:
// application/controller/YourController.php
namespace app\controller;use app\Interfaces\LogisticsCompany;
use app\Service\LogisticsFactory;class YourController
{public function placeOrderAction(){$logisticsCompany = LogisticsFactory::create('company_a');$orderInfo = []; // 假设这是订单信息$logisticsCompany->placeOrder($orderInfo);// 获取支持的目的地$destinations = $logisticsCompany->getSupportedDestinations();}
}
关于目录及文件命名方式,以上代码已经体现出来了:
- 应用的核心接口存放于 application/Interfaces 目录下。
- 物流公司服务的具体实现位于 application/Service/Logistics 目录下,每个物流公司对应一个类文件,如 CompanyA.php、CompanyB.php 等。
- 工厂类 LogisticsFactory.php 放置于 application/Service 目录下。
为什么interface LogisticsCompany要分开目录?
将 LogisticsCompany 接口放在单独的目录(例如 application/Interfaces)中是为了更好地遵循单一职责原则(SRP)和高内聚低耦合的设计原则。这样做的好处包括:
- 代码组织清晰:
接口通常是定义公共契约的地方,它们代表了一组必须实现的方法,但并不涉及具体实现细节。将其与服务的具体实现分开放置,有助于提高代码的可读性和可维护性。 - 更好的模块化:
通过将接口单独抽离,可以方便地在不同的模块、层或包之间共享和复用这些接口,而无需关心具体的实现类。这对于大型项目尤其重要,可以减少不同组件之间的直接依赖。 - 易于扩展和替换:
当有新的物流公司加入时,只需创建一个新类去实现 LogisticsCompany 接口,并在工厂类中添加相应的映射即可。这使得系统更易于扩展,并且更容易进行单元测试。
当然,在实际项目中,根据项目的规模、团队规范和个人喜好,您完全可以选择将接口放在 Service 目录下,或者使用其他符合团队约定的结构组织代码。关键在于保持代码结构清晰,易读易维护。如果项目较小,接口数量不多,也可以考虑将接口文件置于同一目录,如 application/Service/Interfaces 下。