了解 Orchard 连接和数据关系

Question

在 Orchard 中，模块开发人员如何能够了解“连接”的工作原理，特别是在连接到核心部分和记录时？我见过的更好的帮助之一是 Orchard 文档，但这些例子都没有展示如何与现有或核心部分建立关系。作为我正在寻找的示例，这里是取自工作示例的模块服务代码片段：

_contentManager
    .Query<TaxonomyPart>()
    .Join<RoutePartRecord>()
    .Where(r => r.Title == name)
    .List()

在本例中，自定义 TaxonomyPart 正在与核心 RoutePartRecord 连接代码>.我研究了代码，但看不出 TaxononmyPart 如何“连接”到 RoutePartRecord。同样，从工作代码中，这里是另一个片段驱动程序代码，它将自定义 TagsPart 与核心 CommonPartRecord 相关联：

List<string> tags = new List<string> { "hello", "there" };
IContentQuery<TagsPart, TagsPartRecord> query = _cms.Query<TagsPart, TagsPartRecord>();
query.Where(tpr => tpr.Tags.Any(t => tags.Contains(t.TagRecord.TagName)));
IEnumerable<TagsPart> parts =
    query.Join<CommonPartRecord>()
    .Where(cpr => cpr.Id != currentItemId)
    .OrderByDescending(cpr => cpr.PublishedUtc)
    .Slice(part.MaxItems);

我认为我可以从前面的任何一个示例中学习如何形成我自己的查询。我这样做了：

List<string> tags = new List<string> { "hello", "there" };
IContentQuery<TagsPart, TagsPartRecord> query = _cms.Query<TagsPart, TagsPartRecord>();
query.Where(tpr => tpr.Tags.Any(t => tags.Contains(t.TagRecord.TagName)));
var stuff =
    query.Join<ContainerPartRecord>()
    .Where(ctrPartRecord => ctrPartRecord.ContentItemRecord.ContentType.Name == "Primary")
    .List();

我的代码的目的是将找到的内容项限制为仅特定容器（或博客）的内容项。当代码运行时，它在我的连接查询上引发异常，提示 {"could not parse property: ContentType of: Orchard.Core.Containers.Models.ContainerPartRecord"}。这会导致各种问题：

1. 为什么在第二个示例的驱动程序的 Display() 方法中填充的是 CommonPartRecord，而不是 ContainerPartRecord？一般来说，我如何知道填充了哪些部分记录以及何时填充？
2. 在工作代码片段中，由于没有指定连接键/条件（并且没有明显的隐式连接键），连接到底如何工作？例如，我检查了数据迁移文件和models类，发现TagsPart和CommonPartRecord之间没有内在联系。因此，除了查看示例代码之外，人们如何首先知道这样的连接是合法的或可能的？
3. 我尝试使用 TagsPart 和 ContainerPartRecord 进行的连接在任何情况下都合法吗？哪个？
4. 这些示例的查询语法主要是 Orchard、NHibernate 或 LINQ to NHibernate 的反映吗？如果它主要是 NHibernate 的反映，那么推荐阅读哪本 NHibernate 书籍或文章，以便我可以更深入地了解 Orchard？

文档中似乎存在关于此类想法和问题的漏洞，这使得编写模块变得困难。无论这个主题能找到什么答案，我都很乐意将其编译成一篇文章或社区 Orchard 文档。

Answer 1

1. 连接只是为了启用它后面的位置。这并不意味着正在连接的部分实际上将从数据库中删除。无论最新的 1.x 源代码如何，都会发生这种情况，并且在 1.3 版本中会延迟发生。
2. 您不需要条件，因为您只能通过这种方式连接零件。连接条件是隐式的：部件通过项目 ID 连接。
3. 是的。不合法的是，where 中的条件使用的数据无法从连接的零件记录中获得。
4. 这些示例都是 Orchard Content Manager 查询，因此它们受到相当大的限制，但只要您不超出其边界，它们也相当容易构建，因为可以假设很多事情并且会隐式发生。如果您需要更多控制，可以使用最新 1.x 版本中添加的新 HQL 功能。

至于文档中的漏洞，好吧，但是当然。我们今天拥有的文档仅涵盖了该平台的一小部分。今天最好的参考是源代码。我们和社区其他成员都会高度赞赏您为此做出的任何贡献。如果您需要这方面的帮助，请告诉我。