DataRabbit 轻量的数据访问框架（04） －－ IEntityRelationLoader

（完全限定类名：DataRabbit.ORM.IEntityRelationLoader）

在DataRabbit框架提供的ORM功能之中，除了IOrmAccesser接口展现的核心ORM功能外，IEntityRelationLoader接口也提供了一些有意义的功能。正如其名，IEntityRelationLoader是通过数据表的主外键关系来加载当前Entity的Parent和Children。

现在对我们前面示例经常用到的Student数据表做个扩充，假设，Student表的MentorID字段作为外键，指向Mentor表；而且，Book表中的StudentID字段也是外键，指向Student表。这种主外键关系的含义是：“一个学生有一个导师，并且拥有多本书”。这三个表的关系图如下所示：



通过对Student扩充后，我们可以为Student Entity Class 加上如下两个属性，来反映这种关系：

#region Mentor
[NonSerialized]
private Mentor m_Mentor = null ;
public Mentor Mentor
{
get
{
return this.m_Mentor ;
}
set
{
this.m_Mentor = value ;
}
}
#endregion

#region BookList
[NonSerialized]
private IList<Book> m_BookList = null ;
public IList<Book> BookList
{
get
{
return this.m_BookList ;
}
set
{
this.m_BookList = value ;
}
}
#endregion

我将这种通过主外键关系得到的属性称为“FamilyRelation”属性，如果使用EntityCreator工具生成Entity Class，这些属性都会根据数据表关系而自动生成。

现在，我们来调用如下语句：

Student student = stuOrmAccesser.GetOne(new Filter(Student._ID, 30));
结果会发现，返回的student对象的Mentor属性和BookList属性不会被填充。如果不使用IEntityRelationLoader接口，而是直接通过IOrmAccesser来获取这个student的“Family”，我们需要这样做：

Student student = stuOrmAccesser.GetOne(new Filter(Student._ID, 30));
student.Mentor = stuOrmAccesser.GetParent<Mentor>(student);
student.BookList = stuOrmAccesser.GetChildList<Book>(student);
像这样子可以达到目的，但是未免繁琐了一点，如果Student表有多个外键，则我们就要调用多次GetParent（）方法来分别获取各个Parent；对于多个Children，也是如此。IEntityRelationLoader接口使得这种基于关系的加载变得非常简单，如上述功能使用下面的代码即可实现：

entityRelationLoader.LoadFamily(student);
LoadFamily方法一次调用可以加载当前student对象的所有“Family”成员（注意，这里的加载“Family”只包括加载自己Parent和Children，而不包括更上的grandfather或更下的grandson等）。

我们可以从DataRabbit的入口点IDataAccesser接口获取IEntityRelationLoader引用：

IEntityRelationLoader entityRelationLoader = dataAccesser.GetEntityRelationLoader(null);

通过上面的示例，我们对IEntityRelationLoader的功能已经有了一些了解。下面我们来看看这个接口的全貌：

public interface IEntityRelationLoader :[u]ITransactionAccesser
[/u] {
/// <summary>
/// LoadChildren 加载自己的children到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadChildren(object entity);

/// <summary>
/// LoadParents 加载自己的parents到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadParents(object entity);

/// <summary>
/// LoadFamily 加载自己的parents和children到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadFamily(object entity);

/// <summary>
/// LoadOffspring 以当前entity为根，加载所有后代。注意，自己以及后代的所有Parent属性都不会被赋值。
/// </summary>
void LoadOffspring(object entity);
}

转到：DataRabbit 轻量的数据访问框架 －－ 序