这一期咱们直接进入正题,做WPF客户端。之前几期把项目背景、服务端接口、数据库设计都捋了一遍,这一期开始写界面、调逻辑、对接硬件。标题里写的是“客户端”,那我们就把客户端从零搭起来,包括MVVM架构、界面布局、DataGrid操作、MQTT协议对接车牌识别相机、Redis缓存读取、图表可视化这些核心模块。我尽量把每一段代码、每一个踩过的坑都写清楚,方便你照着做。
先说清楚这一期适合谁看。如果你已经会用WPF的基础控件,能写简单的绑定和事件,但遇到真实的项目还是不知道从哪下手——比如DataGrid怎么实现选中一行再删除、下拉框为什么总会多一行空白、相机回调的数据怎么在界面上实时刷出来——那就对了,这篇就是给你准备的。如果你还没接触过WPF,建议先花两天时间把绑定和依赖属性搞明白,否则看后面的内容会有点吃力。项目本身是一个物联网类的管理平台客户端,服务端已经提供了接口,我这边的任务就是把它做成一个能真正干活、不用天天返工的桌面程序。
1. 客户端整体架构与设计思路
1.1 为什么选MVVM而不是直接写事件
很多新手做WPF项目,上来就在Button的Click事件里写业务逻辑,窗体里堆一大坨代码。前期确实快,界面一多就崩了——一个窗体上千行代码,改个需求牵一发动全身,尤其是数据校验、异步操作、多界面联动,逻辑一复杂完全没法维护。
这个项目我选的是MVVM加Prism框架。MVVM的核心就是让界面(View)、数据(Model)和业务逻辑(ViewModel)分开,界面只负责展示和收集输入,ViewModel处理业务规则,Model管数据来源。这样带来的直接好处是:界面换皮肤、换布局,ViewModel一行不用改;单元测试可以直接测ViewModel,不用启动界面;多个视图也可以共用一个ViewModel,像同一份数据用列表和图表两种方式展示,绑到同一个属性即可。
Prism在MVVM之上又加了解耦能力。最明显的就是模块化——这个客户端有登录、监控大屏、车辆管理、报表统计、系统设置好几个功能区,按Prism的模块化思路,每个功能区独立编译、独立维护,以后增加功能不需要动原有代码。还有一个很实用的点是导航系统,通过INavigationAware接口管理界面跳转,ViewModel之间传递参数比手动拼构造函数优雅得多。
1.2 客户端的功能模块划分
这个客户端不是单机工具,它面对的是一个停车场管理平台的运营人员。所以我把它分成了五个子模块:
- 登录与权限:对接服务端的认证接口,拿到令牌之后缓存到本地,后续所有请求都带上令牌。
- 实时监控看板:通过MQTT订阅相机推送的车牌识别结果,在界面上实时弹出车辆入场/出场记录,同时联动大屏显示。
- 车辆管理:DataGrid显示所有车辆记录,支持按车牌号搜索、选中行删除、导出报表。
- 统计报表:用LiveCharts2展示车流量、收入趋势等图表数据,支持按时间段筛选。
- 系统设置:相机接入配置、MQTT连接参数、Redis连接串等,用Properties.Settings把配置保存到本地。
每个模块都是独立的Prism视图和视图模型,模块之间通过事件聚合器解耦。比如相机识别到了车牌,这个事件挂在EventAggregator上,监控看板和车辆管理页面各自决定要不要订阅、怎么响应,互不干扰。
1.3 分层依赖与目录结构
我建项目的习惯是solution下面分四个目录:View放界面,ViewModel放业务逻辑,Models放实体类,Services放服务。Services目录下再分HttpService、MqttService、RedisService、CameraService,各司其职。
code复制src
├─ App.xaml
├─ Views
│ ├─ LoginView.xaml
│ ├─ MonitorView.xaml
│ ├─ VehicleManageView.xaml
│ ├─ StatisticsView.xaml
│ └─ SettingsView.xaml
├─ ViewModels
│ ├─ LoginViewModel.cs
│ ├─ MonitorViewModel.cs
│ ├─ VehicleManageViewModel.cs
│ ├─ StatisticsViewModel.cs
│ └─ SettingsViewModel.cs
├─ Models
│ ├─ VehicleRecord.cs
│ ├─ CameraDevice.cs
│ ├─ MqttMessage.cs
│ └─ LoginResult.cs
├─ Services
│ ├─ HttpService.cs
│ ├─ MqttService.cs
│ ├─ RedisService.cs
│ └─ CameraService.cs
└─ Commons
├─ EventMessages.cs
└─ RelayCommand.cs
这套结构不复杂,每个文件夹的作用看一眼就懂。最关键的约定是:ViewModel绝对不能直接new View,界面跳转统一用Prism的导航请求。这样解耦之后,每个文件都能单独测试、单独替换,这是客户端项目能持续迭代的基础。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 界面布局与控件实战
2.1 主窗体框架设计
WPF客户端的主窗体不建议用那种乱七八糟的布局,所有控件直接堆在Grid里,后期加功能会非常痛苦。我的做法是整体分成三栏:左侧导航栏固定宽度200像素,中间为主内容区,右侧为实时消息栏。左侧用ListBox或者RadioButton做导航菜单,中间放一个ContentControl作为Prism的导航宿主,右侧放实时滚动日志。
主窗体的XAML骨架大致这样:
xml复制<Grid>
<Grid.ColumnDefinitions>
<ColumnDefinition Width="200"/>
<ColumnDefinition Width="*"/>
<ColumnDefinition Width="300"/>
</Grid.ColumnDefinitions>
<!-- 左侧导航菜单 -->
<Border Grid.Column="0" Background="#2D3A4B">
<StackPanel>
<RadioButton Content="实时监控" GroupName="nav"
Command="{x:Static infra:PrismCommands.NavigateCommand}"
CommandParameter="MonitorView"/>
<RadioButton Content="车辆管理" GroupName="nav"
Command="{x:Static infra:PrismCommands.NavigateCommand}"
CommandParameter="VehicleManageView"/>
<RadioButton Content="统计报表" GroupName="nav"
Command="{x:Static infra:PrismCommands.NavigateCommand}"
CommandParameter="StatisticsView"/>
<RadioButton Content="系统设置" GroupName="nav"
Command="{x:Static infra:PrismCommands.NavigateCommand}"
CommandParameter="SettingsView"/>
</StackPanel>
</Border>
<!-- 主内容区 -->
<ContentControl Grid.Column="1" prism:RegionManager.RegionName="MainContentRegion"/>
<!-- 右侧实时消息栏 -->
<ListBox Grid.Column="2" ItemsSource="{Binding RealtimeLogs}"/>
</Grid>
导航这里有个细节要提醒:RadioButton的GroupName要一致,不然后期会出现在两个菜单同时选中的怪现象。另外CommandParameter里传的是视图名称字符串,Prism会根据它解析到对应的注册视图,所以Views目录下的类名要和这里完全一致。
2.2 样式资源统一管理
客户端界面最容易出的问题是控件样式五花八门,同一个Button在不同页面长得不一样。做项目的第一天就要把全局样式建好,放到App.xaml的Resources里,后续所有界面都引用统一的样式,改主题只改一处。
我这里定义了几个基础样式:
xml复制<Style x:Key="BaseButtonStyle" TargetType="Button">
<Setter Property="Background" Value="#4A90D9"/>
<Setter Property="Foreground" Value="White"/>
<Setter Property="BorderThickness" Value="0"/>
<Setter Property="Height" Value="32"/>
<Setter Property="Width" Value="90"/>
<Setter Property="Cursor" Value="Hand"/>
<Setter Property="Template">
<Setter.Value>
<ControlTemplate TargetType="Button">
<Border x:Name="border" Background="{TemplateBinding Background}" CornerRadius="4">
