PHP设计模式之数据映射模式（Data Mapper）代码实例大全（13）

淩亂°似流年 2022-12-07 12:21 69阅读 0赞

## 目标 ##

数据映射器是一种数据访问层，用于将数据在持久性数据存储（通常是一个关系数据库）和内存中的数据表示（领域层）之间进行双向传输。该模式的目标是为了将数据的内存表示、持久存储、数据访问进行分离。 该层由一个或多个映射器（或数据访问对象）组成，并且进行数据的转换。映射器实现的范围有所不同。 通用映射器将处理许多不同的域实体类型，专用映射器将处理一个或几个。

## 例子 ##

数据库对象关系映射器（ ORM ）：Doctrine2 使用的 DAO，名字叫做 “EntityRepository”。

## UML 图 ##

![20200915204703277.png][]

[★官方PHP高级学习交流社群「点击」管理整理了一些资料，BAT等一线大厂进阶知识体系备好（相关学习资料以及笔面试题）以及不限于：分布式架构、高可扩展、高性能、高并发、服务器性能调优、TP6，laravel，YII2，Redis，Swoole、Swoft、Kafka、Mysql优化、shell脚本、Docker、微服务、Nginx等多个知识点高级进阶干货][PHP_BAT_TP6_laravel_YII2_Redis_Swoole_Swoft_Kafka_Mysql_shell_Docker_Nginx]

## 代码 ##

*  User.php

<?php
    
    namespace DesignPatterns\Structural\DataMapper;
    
    class User
    {
        /**
         * @var string
         */
        private $username;
    
        /**
         * @var string
         */
        private $email;
    
        public static function fromState(array $state): User
        {
            // 在你访问的时候验证状态
    
            return new self(
                $state['username'],
                $state['email']
            );
        }
    
        public function __construct(string $username, string $email)
        {
            // 先验证参数再设置他们
    
            $this->username = $username;
            $this->email = $email;
        }
    
        /**
         * @return string
         */
        public function getUsername()
        {
            return $this->username;
        }
    
        /**
         * @return string
         */
        public function getEmail()
        {
            return $this->email;
        }
    }

*  UserMapper.php

<?php
    
    namespace DesignPatterns\Structural\DataMapper;
    
    class UserMapper
    {
        /**
         * @var StorageAdapter
         */
        private $adapter;
    
        /**
         * @param StorageAdapter $storage
         */
        public function __construct(StorageAdapter $storage)
        {
            $this->adapter = $storage;
        }
    
        /**
         * 根据 id 从存储器中找到用户，并返回一个用户对象
         * 在内存中，通常这种逻辑将使用 Repository 模式来实现
         * 然而，重要的部分是在下面的 mapRowToUser() 中，它将从中创建一个业务对象
         * 从存储中获取的数据
         *
         * @param int $id
         *
         * @return User
         */
        public function findById(int $id): User
        {
            $result = $this->adapter->find($id);
    
            if ($result === null) {
                throw new \InvalidArgumentException("User #$id not found");
            }
    
            return $this->mapRowToUser($result);
        }
    
        private function mapRowToUser(array $row): User
        {
            return User::fromState($row);
        }
    }

*  StorageAdapter.php

<?php
    
    namespace DesignPatterns\Structural\DataMapper;
    
    class StorageAdapter
    {
        /**
         * @var array
         */
        private $data = [];
    
        public function __construct(array $data)
        {
            $this->data = $data;
        }
    
        /**
         * @param int $id
         *
         * @return array|null
         */
        public function find(int $id)
        {
            if (isset($this->data[$id])) {
                return $this->data[$id];
            }
    
            return null;
        }
    }

## 测试 ##

*  Tests/DataMapperTest.php

<?php
    
    namespace DesignPatterns\Structural\DataMapper\Tests;
    
    use DesignPatterns\Structural\DataMapper\StorageAdapter;
    use DesignPatterns\Structural\DataMapper\User;
    use DesignPatterns\Structural\DataMapper\UserMapper;
    use PHPUnit\Framework\TestCase;
    
    class DataMapperTest extends TestCase
    {
        public function testCanMapUserFromStorage()
        {
            $storage = new StorageAdapter([1 => ['username' => 'domnikl', 'email' => 'liebler.dominik@gmail.com']]);
            $mapper = new UserMapper($storage);
    
            $user = $mapper->findById(1);
    
            $this->assertInstanceOf(User::class, $user);
        }
    
        /**
         * @expectedException \InvalidArgumentException
         */
        public function testWillNotMapInvalidData()
        {
            $storage = new StorageAdapter([]);
            $mapper = new UserMapper($storage);
    
            $mapper->findById(1);
        }
    }

[PHP 互联网架构师成长之路\*「设计模式」终极指南][PHP]

[PHP 互联网架构师 50K 成长指南+行业问题解决总纲（持续更新）][PHP _ 50K]

[面试10家公司，收获9个offer，2020年PHP 面试问题][10_9_offer_2020_PHP]

★如果喜欢我的文章，想与更多资深开发者一起交流学习的话，获取更多大厂面试相关技术咨询和指导，欢迎加入我们的群啊，暗号：phpzh（群ID：856460874）。

[2020年最新PHP进阶教程，全系列！][2020_PHP]

> 内容不错的话希望大家支持鼓励下点个赞/喜欢，欢迎一起来交流；另外如果有什么问题 建议 想看的内容可以在评论提出

[20200915204703277.png]: /images/20221123/264cdfe0ba3f462ab1376e39238e2c7c.png
[PHP_BAT_TP6_laravel_YII2_Redis_Swoole_Swoft_Kafka_Mysql_shell_Docker_Nginx]: https://link.zhihu.com/?target=https%3A//jq.qq.com/%3F_wv%3D1027%26k%3D48yySdN5
[PHP]: https://zhuanlan.zhihu.com/p/189702435
[PHP _ 50K]: https://zhuanlan.zhihu.com/p/174655616
[10_9_offer_2020_PHP]: https://zhuanlan.zhihu.com/p/145553170
[2020_PHP]: https://www.zhihu.com/club/1288844274021441536/post/1288864908286148608