企业管理软件开发架构之三 系统分层组织结构
我给MIS类型的软件分四个实现层次，三层架构。
BusinessLogic 业务实体 由LLBL Gen 生成业务实体，代码生成器生成
Interface 数据访问接口 根据实体产生的数据访问接口，由Code Smith生成
Manager 接口实现 根据实体产生的数据访问接口的实现代码，由Code Smith生成
UI 界面层 拖拉控件，绑定数据到界面中
Business Logic 业务实体层
以ORM作为数据访问基础技术，业务实体中包含数据之间的关系逻辑，而不再是用于填充数据的实体。
以上结构由LLBL Gen自动生成，它已经为我们生成了实体，实体验证类型，数据访问接口和相关的辅助类型。
公司注册中的公司实体，它的定义如下代码所示
[Serializable] public partial class CompanyEntity : CommonEntityBase // __LLBLGENPRO_USER_CODE_REGION_START AdditionalInterfaces // __LLBLGENPRO_USER_CODE_REGION_END
{
#region Class Member Declarations
private EntityCollection<ModuleEntity> _modules;
// __LLBLGENPRO_USER_CODE_REGION_START PrivateMembers
// __LLBLGENPRO_USER_CODE_REGION_END
#endregion
#region Statics
private static Dictionary<string, string> _customProperties;
private static Dictionary<string, Dictionary<string, string>> _fieldsCustomProperties;
/// <summary>All names of fields mapped onto a relation. Usable for in-memory filtering</summary>
public static partial class MemberNames
{
/// <summary>Member name Modules</summary>
public static readonly string Modules = "Modules";
}
#endregion
/// <summary> Static CTor for setting up custom property hashtables. Is executed before the first instance of this entity class or derived classes is constructed. </summary>
static CompanyEntity()
{
SetupCustomPropertyHashtables();
}
/// <summary> CTor</summary>
public CompanyEntity():base("CompanyEntity")
{
InitClassEmpty(null, null);
}
.....
}
LLBL Gen设计器生成的实体代码有几个特点
- 生成有多个用途的构造方法(ctor)。我们经常用到的是不带参数的构造方法，和带有主键值参数的方法。
[EditorBrowsable(EditorBrowsableState.Never)] protected CompanyEntity(SerializationInfo info, StreamingContext context) : base(info, context) { if(SerializationHelper.Optimization != SerializationOptimization.Fast) { _modules = (EntityCollection<ModuleEntity>)info.GetValue("_modules", typeof(EntityCollection<ModuleEntity>)); this.FixupDeserialization(FieldInfoProviderSingleton.GetInstance()); } // __LLBLGENPRO_USER_CODE_REGION_START DeserializationConstructor // __LLBLGENPRO_USER_CODE_REGION_END }
这个构造方法用在序列化对象时发生，比如.net Remoting远程返回对象时。
- 生成包含自定义属性的字段 自定义属性常用用属性的特殊设置。比如CompanyEntity.CompanyCode，实际中为了不区分CompanyCode的大小写，统一要求为大写，我们可以在此添加自定义属性RequiredCap,再到程序运行时读取此属性，并设置控件的字母大小写特性。
private static Dictionary<string, string> _customProperties; private static Dictionary<string, Dictionary<string, string>> _fieldsCustomProperties; private static void SetupCustomPropertyHashtables() { _customProperties = new Dictionary<string, string>(); _fieldsCustomProperties = new Dictionary<string, Dictionary<string, string>>(); Dictionary<string, string> fieldHashtable; fieldHashtable = new Dictionary<string, string>(); _fieldsCustomProperties.Add("CompanyCode", fieldHashtable); ...... Dictionary<string, string> fieldCustomProperties = CompanyEntity.FieldsCustomProperties["CompanyCode"]; string requiredCap = fieldCustomProperties["RequiredCap"];
读取自定义属性RequiredCap的值为true时，设置控件的CharachterCasing属性。
界面和逻辑分离
再来看业务实体的业务计算如何发生。示例代码如下所示
protected override void OnFieldValueChanged(object originalValue, IEntityField2 field) { base.OnFieldValueChanged(originalValue, field); switch ((CompanyFieldIndex)field.FieldIndex) { case CompanyFieldIndex.DriverAssembly: OnChangeDriverAssembly((string)originalValue); break; } } private void OnChangeDriverAssembly(string originalValue) { if (this.DriverAssembly == originalValue || String.IsNullOrEmpty(DriverAssembly)) return; this.DriverType = BaseCommon.GetProjectName(ModuleType.BusinessLogic, DriverAssembly); }
当我在界面中改变当前界面插件程序集时，它会为我自动读取这个程序集的类型信息，项目命名信息。要理解这种方式，需要先理解.NET开发中的数据绑定技术。数据源控件相当于一个桥梁，连接数据实体和界面控件，当给数据源控件赋值时，控件会读取数据实体的值，当界面中的控件值发生改变时，借助于数据源控件，自动把更改后的数据回写到数据实体中。所以，当数据实体中值发生改变后，我们可以注册相应的改变事件，作出业务逻辑处理，数据源控件会读取改变之后的数据实体值，呈现在界面上。几乎所有的业务逻辑是依照此方式编程，也实现了界面和逻辑分离。
界面和逻辑分离后，界面中的作用就是将控件绑定到数据源控件，再以Code Smith来生成数据读写接口：
public override EntityBase2 LoadEntity(string refNo) { IItemManager manager = ClientProxyFactory.CreateProxyInstance<IItemManager>(); ItemEntity customer = manager.GetItem(refNo); return customer; } public override void DeleteEntity(EntityBase2 entity) { ItemEntity user = (ItemEntity)entity; IItemManager manager = ClientProxyFactory.CreateProxyInstance<IItemManager>(); manager.DeleteItem(user); } public override void SaveEntity(EntityBase2 entity) { ItemEntity user = (ItemEntity)entity; IItemManager manager = ClientProxyFactory.CreateProxyInstance<IItemManager>(); manager.SaveItem(user); }
系统中所有与数据库读写相关的界面代码均是以此方式实现。
Interface/Implementation 接口层和接口实现层
接口与它的实体均以Code Smith模板生成，效率高。如下所示的供应商接口
public interface IVendorManager { VendorEntity GetVendor(System.String VendorNo); VendorEntity GetVendor(System.String VendorNo, IPrefetchPath2 prefetchPath); VendorEntity GetVendor(System.String VendorNo, IPrefetchPath2 prefetchPath, ExcludeIncludeFieldsList fieldList); EntityCollection GetVendorCollection(IRelationPredicateBucket filterBucket); EntityCollection GetVendorCollection(IRelationPredicateBucket filterBucket, ISortExpression sortExpression); EntityCollection GetVendorCollection(IRelationPredicateBucket filterBucket, ISortExpression sortExpression, IPrefetchPath2 prefetchPath); EntityCollection GetVendorCollection(IRelationPredicateBucket filterBucket, ISortExpression sortExpression, IPrefetchPath2 prefetchPath, ExcludeIncludeFieldsList fieldList); VendorEntity SaveVendor(VendorEntity vendor); VendorEntity SaveVendor(VendorEntity vendor, EntityCollection entitiesToDelete); VendorEntity SaveVendor(VendorEntity vendor, EntityCollection entitiesToDelete, string seriesCode); void SaveCollection(EntityCollection vendors); void DeleteVendor(VendorEntity vendor); bool IsVendorExist(System.String VendorNo); bool IsVendorExist(IRelationPredicateBucket filterBucket); int GetVendorCount(IRelationPredicateBucket filterBucket); VendorEntity CloneVendor(System.String VendorNo); void PostVendor(System.String VendorNo); void PostVendor(VendorEntity vendor); void ApprovalItem(EntityCollection vendors); }
实现接口的Manager类型代码例子如下
public class VendorManager : Foundation.Common.ManagerBase, IVendorManager { public VendorEntity GetVendor(System.String VendorNo) { return GetVendor(VendorNo, null); } public VendorEntity GetVendor(System.String VendorNo, IPrefetchPath2 prefetchPath) { return GetVendor(VendorNo, prefetchPath, null); } public VendorEntity GetVendor(System.String VendorNo, IPrefetchPath2 prefetchPath, ExcludeIncludeFieldsList fieldList) { VendorEntity _Vendor = new VendorEntity(VendorNo); using (DataAccessAdapterBase adapter = GetCompanyDataAccessAdapter()) { bool found = adapter.FetchEntity(_Vendor, prefetchPath, null, fieldList); if (!found) throw new Foundation.Common.RecordNotFoundException("Invalid Vendor"); } return _Vendor; }
界面层中或是实体层，使用下面的接口来访问接口：
ICompanyManager _companyManager = ClientProxyFactory.CreateProxyInstance<ICompanyManager>(); CompanyEntity _company = _companyManager.GetCompany(“Kingston”)
如果没有采用分布式技术(.net Remoting,WCF)，CreateProxyInstance方法直接返回ICompanyManager接口的实体类型的实例，供接口调用。如果有应用.net Remoting技术，则先以下面的方法产生服务器对象：客户端产生的实体对象会是一个远程代理，指向远程对象：
RemotingConfiguration.RegisterActivatedServiceType(type);
接口与实现分离的好处在这里体现的很明显，简单的切换部署模式(单机，分布式)不需要改变代码。
