原则 2 中的代理人是什么？

Question

我刚刚读完所有 Doctrine 2 文档，我开始了自己的沙箱，我理解了大部分原理，但仍然有一个问题，我在文档中找不到任何完整的解释。

1. 什么是 Proxy 类？
2. 我什么时候应该在实体上使用它们？

据我了解，代理类添加了一个层，让您可以向实体添加一些其他功能，但为什么要使用代理而不是在实体类中实现方法本身呢？

Answer 1

更新

此答案包含有关代理对象和部分对象之间差异的错误信息。有关更多详细信息，请参阅@Kontrollfreak的答案：https://stackoverflow.com/a/17787070/252591

---

每当使用代理对象时您的查询不会返回创建实体所需的所有数据。想象一下以下场景：

@Entity
class User {
     @Column protected $id;
     @Column protected $username;
     @Column protected $firstname;
     @Column protected $lastname;

     // bunch of setters/getters here
}

DQL query:

SELECT u.id, u.username FROM Entity\User u WHERE u.id = :id

如您所见，此查询不会返回 firstname 和 lastname 属性，因此您无法创建 User 对象。创建不完整的实体可能会导致意外错误。

这就是为什么 Doctrine 将创建支持延迟加载的 UserProxy 对象。当您尝试访问 firstname 属性（未加载）时，它将首先从数据库加载该值。

---

我的意思是为什么我应该使用代理？

您应该始终像根本不使用代理对象一样编写代码。它们可以被视为 Doctrine 使用的内部对象。

为什么实体本身不能实现延迟加载？

从技术上讲，它可能是，但看看一些随机代理对象的类。它充满了肮脏的代码，呃。在您的实体中拥有干净的代码是件好事。

你能给我一个用例吗？

您正在显示最新 25 篇文章的列表，并且想要显示第一篇文章的详细信息。每个数据都包含大量文本，因此获取所有数据会浪费内存。这就是为什么你不获取不必要的数据。

SELECT a.title, a.createdAt
FROM Entity\Article a
ORDER BY a.createdAt DESC
LIMIT 25

$isFirst = true;
foreach ($articles as $article) {
    echo $article->getTitle();
    echo $article->getCreatedAt();

    if ($isFirst) {
        echo $article->getContent(); // Article::content is not loaded so it is transparently loaded 
                                     // for this single article.

        $isFirst = false;
    }
}

Answer 2

代理

Doctrine 代理只是一个扩展实体类以为其提供延迟加载的包装器。

默认情况下，当您向实体管理器请求与另一个实体关联的实体时，关联的实体不会从数据库加载，而是包装到代理对象中。然后，当您的应用程序请求该代理实体的属性或调用该代理实体的方法时，Doctrine 将从数据库加载该实体（除非您请求 ID，代理始终知道该 ID）。

由于代理扩展了您的实体类，因此这种情况对您的应用程序来说是完全透明的。

如果您没有在查询中JOIN或将获取模式设置为EAGER，Doctrine默认会将关联关联作为延迟加载代理。

---

现在我必须添加这一点，因为我没有足够的声誉来到处发表评论：

不幸的是，克罗津的答案包含错误信息。

如果您执行 DQL 查询，

SELECT u.id, u.username FROM Entity\User u WHERE u.id = :id

您将不会获得（代理的）实体对象，而是获得关联数组。因此不可能延迟加载任何附加属性。

考虑到这一点，我们得出的结论是用例示例也不起作用。
必须将 DQL 更改为类似以下内容才能将 $article 作为对象进行访问：

SELECT a FROM Entity\Article a ORDER BY a.createdAt DESC LIMIT 25

并且 getContent() 返回的属性必须是关联才能访问不加载所有 25 个实体的内容属性。

---

部分对象

如果你想部分加载不是关联的实体属性，你必须明确地告诉这个 Doctrine：

SELECT partial u.{id, username} FROM Entity\User u WHERE u.id = :id

这给你一个部分加载的实体对象。

但请注意，部分对象不是代理！延迟加载不适用于它们。因此，使用部分对象通常是危险的，应该避免。了解更多：部分对象 — Doctrine 2 ORM 2 文档