WMS—Wpf.MvvmLight.SelfHost

最新推荐文章于 2024-03-01 11:06:36 发布
最新推荐文章于 2024-03-01 11:06:36 发布
阅读量437 收藏 2
点赞数 1
分类专栏： WPF MvvmLight SelfHost 文章标签： wpf c# 自动化 sqlite 服务器
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/forrange/article/details/129463012
版权
WPF 同时被 3 个专栏收录
2 篇文章 0 订阅
订阅专栏
MvvmLight
2 篇文章 0 订阅
订阅专栏
SelfHost
2 篇文章 0 订阅
订阅专栏

WMS—Wpf.MvvmLight.SelfHost

介绍

其实本人之前一直主攻Web前后端的开发，但是由于业务需要，今年开始被分到了公司的自动化项目组搬砖，主要负责上位机的开发。看着项目组中参差不齐的开发模式，也没有具体的便于开发人员使用的项目开发框架，遂产生了设计一种通用开发框架的想法，最终在第一次自动化项目的开发工作中孕育出了WMS（Wpf.MvvmLight.SelfHost）。

项目需求

  • 宇宙最强IDE：Visual Studio 2019（推荐）/ Visual Studio 2022（偶尔遇到小Bug）
  • .NET版本：.NET Framework 4.6.1

下载

Github： https://github.com/ForeverRG/Wpf.MvvmLight.SelfHost.git

快速了解

项目简介

Wpf.MvvmLight.SelfHost（简称WMS）是一款基于MVVMLight+SelfHost的WPF自动化项目便捷开发框架。

主要特性

  • 自动生成代码功能（核心的四层项目类文件）
  • 项目层层分明，注重解耦合
  • 作为Web服务器，托管Web Api
  • 集成常用的第三方库，并对部分进行二次封装，易使用与维护
  • 附带自动化项目的业务处理模型
  • …

技术选型

1.系统环境

  • .NET Framework 4.6.1

2.核心

  • WPF
  • MVVMLight
  • SelfHost

3.日志

  • NLog
  • Log4Net
  • Seq

4.持久层

  • SqlSugar

5.视图层

  • MaterialDesign
  • MahApps

快速开始

  1. 下载该项目，项目下载完成后，双击Wpf.MvvmLight.SelfHost.sln打开解决方案。
  2. 首先生成整个解决方案，看是否有出错，无报错后直接F5运行项目即可（注意:设置Wpf.MvvmLight.SelfHost为启动项目）。
  3. 运行起来后是个WPF项目，内部使用了一个轻量级的MVVM框架——MVVMLight，此外内部还通过SelfHost托管了Web Api，所以该应用也算是个小服务器，默认监听端口为9000。
  4. 项目中使用的是Sqlite数据库，项目运行起来后会在根目录的DB文件夹自动生成数据库。
  5. 双击根目录下的批处理文件CreateYourProject.bat，根据提示输入自己想要的项目名称，之后在根目录下会有一个.YourProject文件，里面则是你的项目。
  6. 项目启动后，点击主界面的"启动"按钮，开始监听TCP Server端口2022，此时点击左侧菜单中的"运行调试"，切换到对应界面，点击相应的按钮，即可运行自带的Demo。

代码生成

在开发过程中，项目里其实有很多代码都是重复的，为了提高各位Coder的工作效率，让各位更专注于业务逻辑的开发，于是提供了代码自动生成功能。

CodeFirst

我在上述开始的步骤中有提到过，在项目运行后，根目录会自动生成了数据库文件，这里的自动生成其实就是CodeFirst模式。

  1. 更改数据库名称。打开Wpf.MvvmLight.SelfHost项目下的App.config文件，可以修改数据库名称，具体配置如下。
<connectionStrings>
	<add name="SQLiteConnStr" connectionString="URControl.db" /> 
</connectionStrings>
  1. 新增实体类。在Wpf.MvvmLight.SelfHost.Model项目下新增自己想要的实体类，可以参考已有的实体进行添加，更详细的特性配置，可以参考SqlSugar官方文档进行学习。
  2. 自动创建表。在Wpf.MvvmLight.SelfHost.Repository项目下的DBSeed文件中，打开SQLiteDbContext.cs进行实体装载，在InitDB方法中添加新增的实体类型参数，添加完毕后再次启动应用，此时打开数据库，你就会发现里面新增了一个表，而那个表就是根据你新增的实体自动生成的。
public void InitDatabaseAndTables()
{
    InitDB(false, 300,
    typeof(ControlCenter),
    typeof(PLC),
    typeof(Robot),
    typeof(TestBench),
    typeof(VisionModel),
    typeof(Jig),
    typeof(ModuleSettings),
    typeof(Tray),
    typeof(Config),
    typeof(Channel),
    typeof(ModuleType),
    typeof(GripperLoadInfo)
    );
}
DbFirst

如果你在下载完WMS并运行后，发现它可以满足你的需求，并打算在此基础上进行二次开发，那么你在通过CodeFirst模式新增完数据表后，就可以使用DbFirst模式来生成四层项目的代码文件了：Model+Service+Repository+Controller，当然你也可以手动新建出来这些代码文件。

WMS是通过开放Web Api来支持你进行自动生成四层项目的代码文件的，所以需要先将项目运行起来，此时应用的自宿主服务也就启动了，默认监听端口为9000，此时可以通过浏览器或者Postman等工具访问该接口了，成功后会自动生成四层项目文件，存放生成文件的目录为"C:\my-file"。

代码文件生成接口(GET请求):http://localhost:9000/api/DbFirst/allframefiles

项目详解

文件结构

├─Wpf.MvvmLight.SelfHost        // UI视图层
│  ├─Common        // 存放本项目中用到的通用类
│  │  ├─Enum        // 存放枚举类型
│  │  ├─Helpers        // 存放帮助类
│  │  ├─Model        // 存放实体类
│  │  ├─Services        // 存放对外提供服务的类
│  │  └─SocketCommand    // 存放SuperSocket服务端处理命令
│  ├─Config        // 存放工具相关的配置文件
│  ├─EventBus        // 封装了MVVMLight中带有的消息/订阅机制
│  ├─Model        // MVVM中的Model层：负责数据实体的结构处理，与ViewModel进行交互
│  │  └─ASChildModel    // 子Model（项目Demo）
│  ├─Properties        // 项目自动生成，可忽略
│  ├─Resources        // 存放系统静态资源
│  │  ├─img        // 存放图片资源
│  ├─View        // MVVM中的View层：负责前端展示，与ViewModel进行数据和命令的交互
│  │  ├─ASChildView        // 子View（项目Demo）
│  │  └─HomeChildView        // 子View（项目Demo）
│  ├─ViewModel        // MVVM中的ViewModel层：负责前端视图业务级别的逻辑结构组织，并将其反馈给前端
│  │  └─ASChildViewModel    // 子ViewModel（项目Demo）
│  ├─x64        // 存放项目在x64平台下的必需的dll
│  └─x86        // 存放项目在x86平台下的必需的dll
├─Wpf.MvvmLight.SelfHost.Api        // 对外开放的Api层
│  ├─Controllers        // 存放控制器
│  ├─Model        // 存放实体类
│  └─Properties        // 项目自动生成，可忽略
├─Wpf.MvvmLight.SelfHost.Common    // 通用工具层
│  ├─Config    // 存放工具相关的配置文件
│  ├─LogHelper    // 存放日志帮助类
│  │  └─NLog        // 二次封装NLog
│  ├─Properties        // 项目自动生成，可忽略
│  └─SocketHelper    // Socket帮助类，二次封装SuperSocket
├─Wpf.MvvmLight.SelfHost.Extensions    // 扩展层，存放项目相关的扩展插件，暂无内容
│  └─Properties        // 项目自动生成，可忽略
├─Wpf.MvvmLight.SelfHost.IRepository        // 仓储层抽象接口层
│  ├─Base        // 仓储父接口
│  └─Properties        // 项目自动生成，可忽略
├─Wpf.MvvmLight.SelfHost.IServices        // 业务逻辑层抽象接口层
│  └─Properties        // 项目自动生成，可忽略
├─Wpf.MvvmLight.SelfHost.Model        // 实体数据层
│  ├─Enum        // 存放枚举类型
│  ├─GlobalVariable        // 存放全局变量
│  └─Properties        // 项目自动生成，可忽略
├─Wpf.MvvmLight.SelfHost.Repository        // 仓储层，管理数据持久层
│  ├─Base    // 仓储父类
│  ├─DBSeed        // 存放种子数据生成类
│  └─Properties        // 项目自动生成，可忽略
├─Wpf.MvvmLight.SelfHost.Services        // 业务逻辑层，关注业务逻辑
│  └─Properties        // 项目自动生成，可忽略
└─Wpf.MvvmLight.SelfHost.Tasks        // 任务作业调度层（该层只提供了Quartz使用Demo，待完善）
    ├─Jobs        // 存放各种Job（使用了Quartz）
    └─Properties        // 项目自动生成，可忽略

配置文件

目前项目中的可配置项并不算多，后面会逐渐完善。这里主要提一下UI视图层和Common层中的配置文件。

视图层中的App.confg

  • 关于数据库的配置：
<!--sqlite数据库-->
<connectionStrings>
	<add name="SQLiteConnStr" connectionString="URControl.db" /> 
</connectionStrings>
  • 关于SocketServer的配置：如果是通过配置启动SocketServer的话，就需要进行相关的配置，详细的配置和使用说明请参考官方文档

Common层中的NLog.config

  • 关于NLog.config的配置，输出规则和格式等内容请参考官方文档，另外项目中集成了Seq日志服务，可以将日志输出到seq，使用者可以通过搭建seq服务，然后直接在系统中查看相关日志即可，具体配置项：
<!--seq日志服务-->
<targets async="true">
    <target name="seq" xsi:type="BufferingWrapper" bufferSize="1000" flushTimeout="2000">
	    <target xsi:type="Seq" serverUrl="http://localhost:5341" apiKey="yPEItxPvth4HnynZhg39">
		    <property name="ThreadId" value="${threadid}" as="number" />
		    <property name="MachineName" value="${machinename}" />
		    <property name="Environment" value="Development" />
		    <property name="Logger" value="${logger}" />
	    </target>
    </target>
</targets>

<rules>
	<logger name="*" minlevel="Info" writeTo="seq" />
</rules>

核心技术

WPF
  1. 介绍

使用 Windows Presentation Foundation (WPF)，你可以创建适用于 Windows 且具有非凡视觉效果的桌面客户端应用程序。

上面是摘自微软官方对WPF的介绍，其实任何一名工作多年的C# Coder，或多或少可能都会有所听说或了解，我这里也没什么好过多赘述的，给人留下的印象简单点描述可能就是：WPF做出来的界面好看！

相对Winform做出来的桌面应用来说，WPF也确实更容易做出好看的界面，但是对我来说，不仅仅是如此。WPF也让我第一次接触了MVVM，熟悉前端的同学肯定都知道现在流行的三大框架Vue.js、React.js、Angular.js，而它们无一不是用到了MVVM的设计思想。

WMS用到的.NET版本是 .NET Framework4.6.1，相对于 .NET 6.0(最新的LTS版本)来说，4.6.1版本确实有点陈旧了，而且目前 .NET Framework版本也已不再更新了，但是就我目前对工业物联网行业中用到的上位机的了解，它的侧重点是在自动化运行中保持稳定！甚至会考虑的更细，比如程序的执行效率、内存的占用情况等等，所以我在着手做第一个自动化项目之前，一度考虑到使用Winform去完成它，但由于种种原因，我最终还是使用了WPF，并且在和其他项目组成员的实际合作中，定下来使用 .NET Framework4.6.1。

这里我还是想多嘴一下，如果可以的话，建议大家去积极拥抱新技术，并且能在项目中使用它，我觉得这是任何一名Coder都应该有的专业素养（如果你确实喜欢，并且想在这一行业一直做下去的话）。

  1. 优点
  • 界面视觉效果好，用户交互友好。
  • MVVM的设计思想让UI和业务逻辑进一步解耦合。
  • 提供了更广泛的应用开发功能，包括应用模型、资源、控件、图形、布局、数据绑定、文档和安全性。
MVVMLight
  1. 介绍

既然这里说到了MVVMLight，那就简单提一下MVVM吧！MVVM是Model-View-ViewModel（模型-视图-视图模型）的简写。它是一种用于解耦 UI 代码和非 UI 代码的 UI 体系结构设计模式，主要目的是为了分离视图（View）和模型（Model）的耦合，由数据绑定来提供松散耦合，因此使用它可以减少不同类型的代码之间的硬性依赖关系。详细的这里也不再赘述了，有兴趣的可以网上找更多资料去了解它。

MVVMLight是个应用于WPF的轻量化的MVVM框架，它算是历史悠久了，作者也早早地停止了维护，是个较为小众的框架，但应用它的项目却不算少，有些甚至耳熟能详(比如虎牙客户端)，这里我不会去讲解它的使用方法，又兴趣的可以参考《利刃 MVVMLight》这篇博文进行学习，这里面说的真的很详细。

除了MVVMLight，另外推荐2个值得大家去学习了解的MVVM框架：MVVM Toolkit和Prism。MVVM Toolkit在一定程度上是对MVVMLight的优化、延申和扩展，而Prism则是一个重型的MVVM框架，提供的功能很强大。

  1. 优点
  • 轻量化的MVVM框架。
  • 自带简易的Ioc框架SimpleIoc，用于视图模型注入。
  • 提供了Messenger，一种消息发布/订阅模式，用于通信的解耦合。
SelfHost
  1. 介绍

由于项目需求，需要给第三方开放Web接口，而且不方便部署在IIS或其他Web服务器上，所以就产生了通过应用程序来托管Web API的想法。

因为之前并没有做过类似的托管服务，我查阅了很多相关资料，还是有很多的解决方案的。目前官方推荐使用的是OWIN来实现自承载Web Api框架，但我在按照官方资料实现的过程中，遇到了很多问题，前面都一个一个解决了，最终我倒在了"和MVVMLigh中自带的SimpleIoc产生冲突"这个问题上，当然，这其实也是有解决方法的，但是那种方法不利于我日后的开发工作，所以我也就暂时放弃了在项目中使用OWIN，转向用SelfHost去实现托管API。

SelfHost可以实现将一个Web API宿主到一个任意类型的应用程序，包括控制台、Winform、WPF、Windows Service等等，而不局限于IIS。具体的使用方法并不复杂，详细的可以参考项目中Api层中的代码。

  1. 优点
  • 让应用程序实现自宿主，托管Web Api，方便处理外部发送过来的请求。
  • 将 Web 应用程序与服务器分离，免去了部署Web Api的步骤。

项目进度

  • 使用仓储+服务+接口的形式封装框架
  • 使用ORM组件SqlSugar，封装数据库操作
  • 实现项目启动后，自动生成种子数据
  • 实现自动生成项目中的四层文件
  • 封装Wpf.MvvmLight.SelfHost.Template项目模板，一键新建项目
  • 支持多种数据库的使用和切换
  • Web Api集成身份认证于鉴权框架
  • Webp Api集成Swagger

写在最后

对于WMS框架基本使用的介绍算是告一段落了，并没有说的很细，因为我最初的主要目的只是想对自己做的东西有个记录而已，当然也是让使用者能对整个框架有个大概的了解，后面有机会的话我会对框架进行拆分讲解，也想对框架的整个开发过程有个详细的记录。

WMS框架缺陷和待优化完善的地方仍然有很多，欢迎各位大佬进行指教，我自己也会尽力维护下去！

forrange
关注
  • 1
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 5
    评论
专栏目录
ERP MES WPF MES 上位机产线执行系统 两套系统源代码 WPF AGV
tcqgkor的博客
08-23 177
WPF各种技术应用：WPF作为一个基于Windows操作系统的GUI框架，拥有众多强大的视觉效果和高级功能，WPF MES则充分运用了WPF的技术优势，让用户可以更加直观地进行操作。WPF下的OPC开发：OPC是一种广泛应用于工业自动化领域的数据通信规范，WPF工业组态使用WPF技术接入OPC，从而实现对OPC服务器的访问和数据获取等操作。各种典型WPF页面开发：WPF工业组态内部各个页面都采用了WPF技术进行开发，并且根据不同的需求进行了优化和定制，满足不同场景下的生产需要。
WPF自定义控件与样式(14)-轻量MVVM模式实践
LJianDong的博客
11-07 562
一．前言 　　申明：WPF自定义控件与样式是一个系列文章，前后是有些关联的，但大多是按照由简到繁的顺序逐步发布的，若有不明白的地方可以参考本系列前面的文章，文末附有部分文章链接。 　　MVVM是WPF中一个非常实用的编程模式，充分利用了WPF的绑定机制，体现了WPF数据驱动的优势。 图片来源：(WPF的MVVM) 　　关于MVVM网上很多介绍或者示例，本文不多做介绍了，本文的主要目的是提...
WPF mvvm WMS 仓库 登录 主界面
04-12
使用WPF Stylet框架部分, WPF MaterialDesign样式,WPF mvvm模式，mvvm登录展示 ,WPF 左侧下拉菜单样式 ,DataGrid 查询展示 ， 数据库SqlServer2008 使用SqlSugar框架
WPF仓库管理系统，WPF界面设计
11-19
仓库管理系统是具备有物资登记，出库，入库，盘存完整的流程。它包含到物资的快递单号，快递公司，物资类别。 物资入库时它能包含物资的供应商和仓库。在选择好已有的供应商和仓库后，选择已经登记的物资进行入库。假设：登记纸巾的数量为700，如果入库的数量为200，则会提示：“入库成功”那么在物资登记，纸巾的数量现在是900。 物资出库时 它包含客户和仓库。选择已经登记的物资，客户和仓库进行出库。假设：登记纸巾的数量现在为900，那么在出库时的数量则不能超过900，如果超过900，则会提示：“库存数量不足，入库失败”，如果出库的数量为400，则会提示：“出库成功”那么在物资登记，纸巾的数量现在是500。
【愚公系列】2023年02月 WMS智能仓储系统-011.数据库文档设计
时光隧道
02-17 9570
数据库设计文档是一项重要工作，它涉及到数据库设计的方方面面,是保证数据库能够正常工作，运行稳定，以满足用户需求的重要工具。其中包括数据库设计的方案，对不同类型的数据存储,数据存储结构，数据库调优功能，数据库安全方案，数据库实现方式，安装配置和其他内容。WMS智能仓储系统的数据库文档设计下面会介绍。
WPF真入门教程30--顺风物流单据管理系统
hqwest的专栏
03-01 1419
到现在为止，真入门系列教程已完成了29刺由浅入深地讲解，当然不可能讲到了WPF的所有技能点，但读者看到了wpf的内部各种功能及之间的联系，在此基础上，提供一个完整有效的综合项目，以此为实战，并作为本教程的结束。
学习MvvmLight工具
任玉腾的博客
03-09 781
最近学习了一下MvvmLight，觉得有些功能还是挺有特色的，所以记录一下首先新建也给WPF程序然后在Nuget里面安装MvvmLightLib 包，安装上面那个也可以，但是安装上面那个会自动在代码里面添加一些MvvmLight的demo ，安装MvvmLightLib比较纯净安装完成后，在App.cs 里面重写一下OnStartup方法，让程序启动的时候初始一下IOC容器和DispatcherHelper。（其实这两步也可以放在其他地方，比如放在构造函数里面或者其他地方也是可以的，没有特殊要求）
WPF+SelfHost+HttpClient 模拟web通信
05-28
在本文中，我们将深入探讨如何在WPF应用中利用SelfHost和HttpClient来模拟Web通信，同时结合Mvvmlight框架，实现一个简单的客户端-服务器通信示例。首先，让我们逐个解析这些关键技术点。 1. **WPF (Windows ...
Proton-WMS操作手册.pdf
05-03
Proton_WMS操作手册.pdf
Proton-WMS配置手册.pdf
最新发布
05-03
### Proton-WMS配置手册知识点概述 #### 一、WMS 使用前安装 在使用Proton WMS系统之前，需要进行一系列的安装准备工作。这部分主要包括软件环境的搭建、硬件设备的准备以及网络环境的配置等内容。 1. **软件环境...
OWIN来实现自承载Web Api框架
05-10
WPF自宿主作为Web服务器，托管Web Api，使用的是OWIN来实现自承载Web Api框架，集成了swagger接口文档，可以实现将一个Web API宿主到一个任意类型的应用程序，包括控制台、Winform、WPF、Windows Service等 优点 让应用程序实现自宿主，托管Web Api，方便处理外部发送过来的请求。 将 Web 应用程序与服务器分离，免去了部署Web Api的步骤。
使用WPF MVVM进行数据库访问
04-08
WPF MVVM实用程序访问简单旧版数据库的示例。
PWMS.zip_PWMS_PWMS.exe
07-14
系统介绍 根据企业对人事管理的要求，本...（2）实例执行文件位置：TM\07\PWMS\PWMS\bin\Debug\ PWMS.exe （3）程序可执行文件目录中，必须存在bar文件夹。否则，以默认路径对数据库进行备份时，将无法找到备份路径。
C#开发WPF自宿主web服务
幽冥夜魇
05-10 1569
使用微软自带OWIN来实现自承载Web Api框架，集成了swagger接口文档
关于如何用WPF实现WebApi自托管服务及交互
Hat_man_的博客
03-21 3133
WPF WebApi
C#学习笔记-WPF框架（MvvmLight）
云淡风气半浮生
11-07 1965
1.框架引用 1.1 MvvmLight 1.2 MvvmLight+PropertyChanged.Fody 在项目中，添加NuGet程序包，浏览处，查找MvvmLight程序包和PropertyChanged.Fody程序包，安装配置到项目中。添加完这些NuGet程序包之后，项目中会有一个ViewModel的文件夹，包含了ViewModelLocator、MainViewModel两个文件，以及在app.xmal文件中添加了一个资源引用。 ViewModelLocato...
.NET Core WPF中构建Web API
gaiyi09的博客
06-19 939
MiniAPI、WPF、.NET Core
wpf WpfMultiStyle 后台代码设置Style
Lhjuia的博客
12-13 1637
如题，如果不了解这个东西请参考这个作者写的[WPF]控件应用多个样式 后台代码设置 WpfMultiStyle.Apply.SetMultiStyle(this.laBt1, "FooterButtons SingleBt HomeBt");//控件名和style的key值，不同的key值用空格区分开 关于原作者的教程 原作者写的已经很好了，感谢，以及开发这个包的大佬，???? 下载 NuGet里面搜索 “ WpfMultiStyle ” 就可以下载，或者NuGet的控制台 Install-Package
WPF 结合 MVVM模式下SqlSugar ORM框架的使用
qq_35320456的博客
12-28 1772
一个详细的指导，介绍如何在 WPF MVVM 中使用 SQLSugar 访问 MySQL 数据库。
Consider defining a bean of type 'com.wms.wms.mapper.UserMapper' in your configuration.
12-03
在这种情况下，它无法找到类型为'com.wms.wms.mapper.UserMapper'的bean。解决此问题的方法是在Spring Boot应用程序的配置类中定义一个bean，该bean的类型为'com.wms.wms.mapper.UserMapper'。你可以使用@MapperScan...
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值