Auto 属性的 Fluent NHibernate PropertyNotFoundException

Question

我正在尝试让 Fluent NHibernate 为我映射一个集合。我的类定义如下：

public abstract class Team 
{
    public virtual Guid Id { get; set; }
    public virtual string Name { get; set; }
}

public class ClientTeam : Team
{
    public virtual IEnumerable<Client> Clients { get; set; }
}

public class Client
{
    public virtual Guid Id { get; set; }
    public virtual string Name { get; set; }
    public virtual string Identifiers { get; set; }
}

我的映射：

public class TeamMap : ClassMap<Team>
{
    public TeamMap()
    {
        Table("Team");
        Id(x => x.Id).GeneratedBy.Assigned();
        Map(t => t.TeamName);
    }
}

public class ClientTeamMap : SubclassMap<ClientTeam>
{
    public ClientTeamMap()
    {
        HasMany(t => t.Clients);
    }
}

public class ClientMap : ClassMap<Client>
{
    public ClientMap()
    {
        Table("Client");
        Id(c => c.Id);
        Map(c => c.Name);
        Map(c => c.Identifiers);
    }
}

我构建了一个单元测试，实例化一个团队，然后尝试保留它（测试库中有依赖项配置等）：

public class TeamMapTester : DataTestBase
{
    [Test]
    public void Should_persist_and_reload_team()
    {
        var team = new ClientTeamDetail
        {
            Id = Guid.NewGuid(),
            TeamName = "Team Rocket",
            Clients = new[] 
            {
                new ClientDetail {ClientName = "Client1", ClientIdentifiers = "1,2,3"}
            }
        };

        using (ISession session = GetSession())
        {
            session.SaveOrUpdate(team);
            session.Flush();
        }

        AssertObjectWasPersisted(team);
    }
}

当我运行测试时，我得到这个错误：

SetUp：FluentNHibernate.Cfg.FluentConfigurationException：创建 SessionFactory 时使用了无效或不完整的配置。检查 PotentialReasons 集合和 InnerException 了解更多详细信息。

• 未通过数据库方法配置数据库。

----> NHibernate.MappingException：无法编译映射文档：(XmlDocument)
----> NHibernate.PropertyNotFoundException：在“ClientTeam”类中找不到字段“_clients”`

我已经浏览了 NHibernate 文档并进行了一些谷歌搜索，但我找不到任何似乎可以解决此问题的内容。 Fluent NHibernate 的引用方法的文档明确使用自动属性，所以我确信这不是问题。

为什么 NHibernate 会认为 _clients 是在这种情况下应该映射的字段？

Answer 1

原因是：约定。

Fluent 映射被设置为尝试通过需要支持字段来强制执行只读集合属性。有问题的ICollectionConvention：

public class CollectionAccessConvention : ICollectionConvention
{
    public void Apply(ICollectionInstance instance)
    {
        instance.Fetch.Join();
        instance.Not.LazyLoad();
        instance.Access.CamelCaseField(CamelCasePrefix.Underscore);
    }
}

它要求集合支持字段采用驼峰式命名并以下划线开头。