DevExpress_XAF_根据集合（Collection）计算属性值（例子：产品列表统计订单明细）

　　事先声明，本文大部分内容根据官方文件得到，有些翻译不准确的还望见谅。

　　什么叫基于集合计算属性值？根据下图我们可以知道。在订单关系中，订单数量（Orders Count）、订单金额总计（Orders Total）、订单最大值 (Maximum Order)，由下方列表（在业务类中用集合表示）经过统计获得。

初始化类的实现(没有统计功能时的源码)

　　订单（Order）和产品(Product)关系为多对多。

　　产品（Product）源码：

[DefaultClassOptions]
public class Product : BaseObject {
    public Product(Session session) : base(session) { }
    private string fName;
    public string Name {
        get { return fName; }
        set { SetPropertyValue("Name", ref fName, value); }
    }
    [Association("Product-Orders"), Aggregated]
    public XPCollection<Order> Orders {
        get { return GetCollection<Order>("Orders"); }
    }
}

 　　订单源码：

[DefaultClassOptions]
public class Order : BaseObject {
    public Order(Session session) : base(session) { }
    private string fDescription;
    public string Description {
         get { return fDescription; }
         set { SetPropertyValue("Description", ref fDescription, value); }
    }
    private decimal fTotal;
    public decimal Total {
        get { return fTotal; }
        set { SetPropertyValue("Total", ref fTotal, value); }
    }
    private Product fProduct;
    [Association("Product-Orders")]
    public Product Product {
        get { return fProduct; }
        set { SetPropertyValue("Product", ref fProduct, value); }
    }
}

计算属性

　　下面的代码片段演示了三个计算属性的实现——订单数量（Orders Count）、订单金额总计（Orders Total）、订单最大值 (Maximum Order)。

[DefaultClassOptions]
public class Product : BaseObject {
    // ... 
    private int? fOrdersCount = null;
    public int? OrdersCount {
        get {
            if(!IsLoading && !IsSaving && fOrdersCount == null)
                UpdateOrdersCount(false);
            return fOrdersCount;
        }
    }
    private decimal? fOrdersTotal = null;
    public decimal? OrdersTotal {
        get {
           if(!IsLoading && !IsSaving && fOrdersTotal == null)
                UpdateOrdersTotal(false);
            return fOrdersTotal;
        }
    }
    private decimal? fMaximumOrder = null;
    public decimal? MaximumOrder {
        get {
            if(!IsLoading && !IsSaving && fMaximumOrder == null)
                UpdateMaximumOrder(false);
            return fMaximumOrder;
        }
    }
}

 　　以下方法是三个计算属性值具体方法。

[DefaultClassOptions]
public class Product : BaseObject {
    // ... 
    public void UpdateOrdersCount(bool forceChangeEvents) {
        int? oldOrdersCount = fOrdersCount;
        fOrdersCount = Convert.ToInt32(Evaluate(CriteriaOperator.Parse("Orders.Count")));
        if (forceChangeEvents)
          OnChanged("OrdersCount", oldOrdersCount, fOrdersCount);
    }
    public void UpdateOrdersTotal(bool forceChangeEvents) {
        decimal? oldOrdersTotal = fOrdersTotal;
        decimal tempTotal = 0m;
        foreach (Order detail in Orders)
            tempTotal += detail.Total;
        fOrdersTotal = tempTotal;
        if (forceChangeEvents)
            OnChanged("OrdersTotal", oldOrdersTotal, fOrdersTotal);
    }
    public void UpdateMaximumOrder(bool forceChangeEvents) {
        decimal? oldMaximumOrder = fMaximumOrder;
        decimal tempMaximum = 0m;
        foreach (Order detail in Orders)
            if (detail.Total > tempMaximum)
                tempMaximum = detail.Total;
        fMaximumOrder = tempMaximum;
        if (forceChangeEvents)
            OnChanged("MaximumOrder", oldMaximumOrder, fMaximumOrder);
    }
}

 　　注意，fOrdersCount是在客户端使用UpdateOrdersCount方法中从内部XPO缓存加载的对象来计算的。可以使用下面的代码在服务器端计算fOrdersCount，这样就不会考虑未提交的对象。

fOrdersCount = Convert.ToInt32(Session.Evaluate<Product>(CriteriaOperator.Parse("Orders.Count"), 
    CriteriaOperator.Parse("Oid=?", Oid)));

　　在Order类的Total和Product属性设置器中，当Order对象的属性值发生变化且对象当前没有初始化时，UI将被更新:

[DefaultClassOptions]
public class Order : BaseObject {
    // ... 
    private decimal fTotal;
    public decimal Total {
        get { return fTotal; }
        set {
            bool modified = SetPropertyValue("Total", ref fTotal, value);
            if(!IsLoading && !IsSaving && Product != null && modified) {
                Product.UpdateOrdersTotal(true);
                Product.UpdateMaximumOrder(true);
            }
        }
    }
    private Product fProduct;
    [Association("Product-Orders")]
    public Product Product {
        get { return fProduct; }
        set {
            Product oldProduct = fProduct;
            bool modified = SetPropertyValue("Product", ref fProduct, value);
            if(!IsLoading && !IsSaving && oldProduct != fProduct && modified) {
                oldProduct = oldProduct ?? fProduct;
                oldProduct.UpdateOrdersCount(true);
                oldProduct.UpdateOrdersTotal(true);
                oldProduct.UpdateMaximumOrder(true);
            }
        }
    }
}

 　　在Product类中，OnLoaded方法被覆盖，因为在使用“延迟”计算时需要重置缓存的值。

[DefaultClassOptions]
public class Product : BaseObject {
    // ... 
    protected override void OnLoaded() {
        Reset();
        base.OnLoaded();
    }
    private void Reset() {
        fOrdersCount = null;
        fOrdersTotal = null;
        fMaximumOrder = null;
    }
    // ...

 将计算的值属性存储到数据库中

非持久性属性值时影响性能的。为了避免这个问题，可以将计算值存储到数据库中。可以使用PersistentAttribute将值保存到数据库中。

[DefaultClassOptions]
public class Product : BaseObject {
    // ... 
    [Persistent("OrdersCount")]
    private int? fOrdersCount = null;
    [PersistentAlias("fOrdersCount")]
    public int? OrdersCount {
        // ... 
    }
    [Persistent("OrdersTotal")]
    private decimal? fOrdersTotal = null;
    [PersistentAlias("fOrdersTotal")]
    public decimal? OrdersTotal {
        // ... 
    }
    [Persistent("MaximumOrder")]
    private decimal? fMaximumOrder = null;
    [PersistentAlias("fMaximumOrder")]
    public decimal? MaximumOrder {
        // ... 
    }
    // ...

 从主订单类中移除OnLoaded方法重载。

参考文献

　　[1] https://documentation.devexpress.com/eXpressAppFramework/113179/Task-Based-Help/Business-Model-Design/eXpress-Persistent-Objects-XPO/How-to-Calculate-a-Property-Value-Based-on-Values-from-a-Detail-Collection

　　[2]官网项目源码及示例网址：https://www.devexpress.com/Support/Center/Example/Details/E305/how-to-calculate-a-master-property-based-on-values-from-a-details-collection