WPF-Control核心架构思想

WPF-Control 项目架构详解一、核心架构思想这个项目的架构可以用一句话概括控件负责显示服务负责能力模块负责组合主题负责外观ApplicationBase 负责生命周期IOC 负责连接所有对象。这是一种典型的分层模块化架构各个组件职责清晰松耦合易于扩展和维护。二、分层关系详解2.1 分层架构图┌─────────────────────────────────────────────────────────────┐ │ App / Tests │ ← 应用入口/测试层 ├─────────────────────────────────────────────────────────────┤ │ ApplicationBase │ ← 生命周期管理 ├─────────────────────────────────────────────────────────────┤ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ IOC │ │ Services │ │ Modules │ │ ← 核心服务层 │ └──────────┘ └──────────┘ └──────────┘ │ ├─────────────────────────────────────────────────────────────┤ │ Themes / Styles / Controls / Presenters │ ← UI展示层 └─────────────────────────────────────────────────────────────┘2.2 各层职责说明层级职责典型文件/组件App应用入口继承ApplicationBaseApp.xaml.csApplicationBase生命周期管理、异常处理、启动流程ApplicationBase.csIOC依赖注入容器连接所有对象Ioc.cs,IocExtension.csServices提供各种业务能力数据库、日志、消息等ILogService,IMessageServiceModules功能模块组合封装业务单元HomeBox,ProjectModuleThemes/Styles外观样式管理Generic.xaml,Share.xamlControls/PresentersUI控件和视图逻辑TagBox,HomeViewPresenter三、运行流程剖析3.1 完整启动流程启动 App │ ├─→ 创建 ServiceCollection (DI容器构建) │ ├─→ ConfigureServices 注册模块和服务 │ ├─→ Ioc.Build 构建容器 │ ├─→ 加载多语言 (ILoadGlobalizationOptionsService) │ ├─→ Configure 应用配置 │ ├─→ 加载主题 (ILoadThemeOptionsService) │ ├─→ 显示启动页 (SplashScreen) │ ├─→ 执行登录 (ILoginViewPresenter) │ ├─→ 创建并显示主窗口 │ └─→ 用户操作控件 → Command / Presenter / Service 响应3.2 核心流程代码解析第一步应用启动入口publicpartialclassApp:ApplicationBase{protectedoverridevoidConfigureServices(IServiceCollectionservices){// 注册应用服务services.AddApplicationServices();// 注册项目服务services.AddProjectAIDIProjectService(xx.UseOpenCurrentOnLoadfalse);// 注册模块services.AddHomeProjectThumbnialHomeViewPresenter();// 注册标签服务services.AddTagProjectTagService(x{x.Tags.Add(newTag(){Name训练数据,BackgroundBrushes.Green});x.Tags.Add(newTag(){Name测试数据,BackgroundBrushes.Gray});});// 注册数据库services.AddDbContextBySettingAIDIDataContext();services.AddSingletonIStringRepositoryfm_dd_image,DbContextRepositoryAIDIDataContext,fm_dd_image();}protectedoverrideWindowCreateMainWindow(StartupEventArgse){returnnewMainWindow();}}关键要点ConfigureServices方法用于注册所有服务和模块使用扩展方法链式调用代码清晰优雅支持配置回调可在注册时进行初始化配置第二步ApplicationBase 初始化publicabstractpartialclassApplicationBase:Application{publicApplicationBase(){this.ShutdownModeShutdownMode.OnMainWindowClose;AppPaths.Register(this.CreateAppPathServce());this.InitExcetion();// 初始化异常处理this.InitServiceCollection();// 初始化服务容器}protectedvoidInitServiceCollection(){ServiceCollectionscnewServiceCollection();this.ConfigureServices(sc);// 调用子类的配置Ioc.Build(sc);// 构建IOC容器// 在显示页面前加载多语言Ioc.GetServiceILoadGlobalizationOptionsService(false)?.Load(outstringmessage);}}关键要点构造函数执行顺序异常处理 → 服务注册 → 多语言加载Ioc.Build(sc)是核心将所有服务注册到容器第三步OnStartup 启动流程protectedoverridevoidOnStartup(StartupEventArgse){this.Configure();// 应用配置this.OnSingleton(e);// 单例检查base.OnStartup(e);Windowwindowthis.CreateMainWindow(e);// 主窗口加载完成后执行window.Loaded(s,e){varloadsIoc.GetAssignableFromServicesIMainWindowLoadedLoadable().Distinct();foreach(variteminloads)item.Load(outstringmessage);};this.OnSplashScreen(e);// 显示启动页this.OnLogin();// 执行登录IocIMainWindowSavableService.Instance?.Load(window);this.MainWindow.Show();}关键要点启动流程配置 → 单例检查 → 启动页 → 登录 → 主窗口通过Ioc.GetAssignableFromServicesT()实现批量服务调用四、核心组件详解4.1 IOC 容器IOC控制反转是整个架构的核心连接器负责管理所有对象的创建和依赖注入。publicstaticclassIoc{privatestaticIServiceProvider_servicesnull;publicstaticIServiceProviderServices_services;publicstaticvoidBuild(IServiceCollectionserviceCollection){_servicesserviceCollection.BuildServiceProvider();}publicstaticTGetServiceT(boolthrowIfNonetrue){if(_servicesnull)returnthrowIfNone?thrownewArgumentNullException(...):default;returnGetServiceT(typeof(T),throwIfNone);}// 通过类型获取服务publicstaticTGetServiceT(Typetype,boolthrowIfNonetrue){Tr(T)_services.GetService(type);if(rnullthrowIfNone)thrownewArgumentNullException(...);returnr;}// 获取所有实现了某个接口的服务publicstaticIEnumerableTGetAssignableFromServicesT(FuncT,boolpredicatenull){foreach(ServiceDescriptoritemin_serviceCollection){if(typeof(T).IsAssignableFrom(item.ServiceType)){// 遍历所有符合条件的服务实例...}}}}IOC 使用场景场景代码示例获取单例服务Ioc.GetServiceILogService()安全获取不抛异常Ioc.GetServiceIMyService(false)获取多个服务Ioc.GetAssignableFromServicesISplashLoadable()XAML 绑定IocExtension Type{x:Type local:MyService} /4.2 ApplicationBase 生命周期ApplicationBase封装了 WPF 应用的完整生命周期构造函数 │ ├─→ InitExcetion() // 注册异常处理 │ ├─→ DispatcherUnhandledException │ ├─→ AppDomain.UnhandledException │ └─→ TaskScheduler.UnobservedTaskException │ └─→ InitServiceCollection() ├─→ 创建 ServiceCollection ├─→ ConfigureServices() └─→ Ioc.Build() OnStartup │ ├─→ Configure() // 应用配置 ├─→ OnSingleton() // 单例检查 ├─→ OnSplashScreen() // 启动页 ├─→ OnLogin() // 登录 └─→ Show MainWindow OnExit │ ├─→ 停止定时任务 ├─→ 记录退出日志 └─→ 保存操作记录4.3 模块系统模块是功能的封装单元通过扩展方法注册publicstaticclassExtension{publicstaticIServiceCollectionAddHomeT(thisIServiceCollectionservices,ActionIHomeOptionssetupActionnull)whereT:class,IHomeViewPresenter{services.AddOptions();services.TryAdd(ServiceDescriptor.SingletonIHomeViewPresenter,T());if(setupAction!null)services.Configure(newActionHomeOptions(setupAction));returnservices;}}模块注册模式定义接口如IHomeViewPresenter实现具体类如ProjectThumbnialHomeViewPresenter通过扩展方法注册到 IOC在需要的地方通过接口获取实例五、项目结构实践5.1 推荐的项目目录结构Source/ ├── App/ # 应用程序 │ └── H.App.AIDI/ # 具体应用 │ ├── App.xaml.cs # 入口 │ ├── MainWindow.xaml # 主窗口 │ └── ViewModel/ # 视图模型 ├── Base/ # 基础组件 │ ├── H.Attach/ # 附加属性 │ └── H.Mvvm/ # MVVM框架 ├── Controls/ # 自定义控件 │ ├── H.Controls.TagBox/ # 标签控件 │ └── H.Controls.Form/ # 表单控件 ├── Modules/ # 功能模块 │ └── H.Modules.Home/ # 首页模块 ├── Providers/ # 服务提供者 │ └── H.Iocable/ # IOC容器 ├── Services/ # 服务层 │ └── H.Services.Common/ # 公共服务 └── Styles/ # 样式主题 └── H.Style/ # 全局样式5.2 创建新模块的步骤假设我们要创建一个设置模块步骤1定义接口publicinterfaceISettingViewPresenter:IViewPresenter{voidShow();}步骤2实现 PresenterpublicclassSettingViewPresenter:ISettingViewPresenter{publicvoidShow(){// 显示设置窗口逻辑}}步骤3创建扩展方法publicstaticclassSettingExtension{publicstaticIServiceCollectionAddSetting(thisIServiceCollectionservices){services.TryAddSingletonISettingViewPresenter,SettingViewPresenter();returnservices;}}步骤4在 App 中注册protectedoverridevoidConfigureServices(IServiceCollectionservices){services.AddSetting();}步骤5使用模块Ioc.GetServiceISettingViewPresenter().Show();六、最佳实践总结6.1 设计原则单一职责每个类只做一件事控件只负责显示服务只提供能力依赖倒置依赖抽象而非具体实现接口隔离使用细粒度接口避免胖接口开闭原则对扩展开放对修改关闭6.2 代码规范// ✅ 推荐依赖接口publicclassMyPresenter{privatereadonlyILogService_logService;publicMyPresenter(ILogServicelogService){_logServicelogService;}}// ❌ 不推荐依赖具体类publicclassMyPresenter{privatereadonlyLogService_logServicenewLogService();}6.3 服务注册规范生命周期使用场景注册方式Singleton全局共享服务日志、配置AddSingletonScoped每个请求/窗口独立AddScopedTransient每次获取新实例AddTransient七、总结WPF-Control 的架构设计体现了以下核心价值高内聚低耦合各层职责清晰模块独立可扩展性强通过 IOC 和接口实现松耦合扩展易于测试依赖注入使单元测试更简单统一生命周期ApplicationBase 统一管理应用生命周期通过理解这个架构模式您可以快速上手项目开发按照规范创建新模块高效定位和解决问题参与项目贡献