MasterAbpVnextFramwork官方原版书籍

2022/04/23 DotNetCore 共 3430 字,约 10 分钟

ABP作者出版了一本书,叫做《Mater Abp Vnext Framwork》,感觉还比较全面。通过一个月的时间看完了英文版本,看的过程中做一些记录。官方文档里面一些比较重点的内容都在这本书里面有更加详细介绍,特别是uow仓储的使用这块,工作单元提交efcore事务这块,手动控制事务的提交。这个在实际开发中经常用到的。

AbpVnextDemo文件的初始化

abp vnext很多demo源码项目,建立了DbMigrator项目的,直接设置DbMigrator为启动项目运行即可。 如果使用控制台进行初始化一般会失败,并提示:

Invalid object name 'AbpSettings'.

devenv_OXjUCbUB2j

VsDebugConsole_LCsSRC4hPd

AbpVnext最简单的单层mvc项目初始化

项目背景:这里我需要使用abp框架来创建一个简单的mvc页面用来接收第三方程序通过http接口发送过来的文本消息,然后实时显示更新在页面中。就是这么一个简单的需求,并且是托管在本地iis里面。主要是用来实时显示OCR之后的英文视频字幕用来制作单词卡使用。这个网页程序等于是一个开机运行的托管网页端,用来实时接收另外一个程序发送过来的英文字幕。就是这么简单的一个需求。

技术方案:database采用sqlite3,采用mvc模式,并且配合SignalR来从后台接口中接收第三方发送方发出的文本信息并且实时更新到网页中。

项目用的是sqlite3,因为这个项目只是在本地运行用来测试使用。sqllite3直接去官方下载静态文件,exe放到c盘下面创建文件夹sqlite,然后把这个路径配置到全局环境即可。配置全局环境,在win10系统点击工具条放大镜,输入‘Environment’ 就可以修改win10系统环境变量。点击Path再点击Edit enviroment variable,增加变量C:\sqlite即可。然后cmd控制台命令创建数据库。

H9KXlMwzsX

C:\sqlite>sqlite3 LiveCaptureReceiver.db
SQLite version 3.39.2 2022-07-21 15:24:47
Enter ".help" for usage hints.

数据库文件放入项目路径中并配置好数据库链接地址。visual studio切换到Package Manager Console初始化db.

PM> Add-Migration "InitialDb"
Build started...
Build succeeded.
To undo this action, use Remove-Migration.
PM> Update-Database
Build started...
Build succeeded.
Done.
PM> 

启动项目,这个时候abp会报错:是因为还没有给mvc项目前端做初始化操作。

Could not find the bundle file '/libs/abp/core/abp.css' for the bundle 'Basic.Global'!

进入到项目文件cspro文件夹里面,cmd运行abp install-libs ,通过abp的cli自动初始化前端mvc依赖。参考官方说明:https://docs.abp.io/en/abp/latest/CLI#install-libs

oa9nGCWHnS

然后是往mvc中添加signalR支持:参考:https://community.abp.io/posts/realtime-notifications-via-signalr-in-abp-project-tsp2uqd3

1.首先,在项目中新建文件夹SignalR,里面创建3个类:

  1. INotificationClient.cs
  2. UiNotificationClient.cs
  3. UiNotificationHub.cs

执行下面命令行,安装SignalR依赖:

3lkmNZMXuV

abp add-package Volo.Abp.AspNetCore.SignalR

往项目模块中添加:

context.Services.AddSignalR();

MVC页面中使用SigNaR,需要在页面中添加SignalR JS库的引用:

@section scripts {
    <abp-script type="typeof(SignalRBrowserScriptContributor)" />
}

创建一个SignalRHub类:

[HubRoute("/english-hub")]
    public class MessagingHub:AbpHub
    {
        public async Task BroadcastMessage(string message)
        {
            await Clients.All.SendAsync("ReceiveMessage", message);
        }

        public override async Task OnConnectedAsync()
        {
            await base.OnConnectedAsync();
        }

        public override async Task OnDisconnectedAsync(Exception? exception)
        {
            await base.OnDisconnectedAsync(exception);
        }

        
    }

abp模块的初始化方法OnApplicationInitialization中增加:

 app.UseEndpoints(endpoints => { endpoints.MapHub<MessagingHub>("/english-hub"); });

mvc页面中添加js代码,调用SignalR:

var hubName = "english-hub";

var connection = new signalR.HubConnectionBuilder()
    .withUrl("/" + hubName)
    .withAutomaticReconnect()
    .configureLogging(signalR.LogLevel.Information)
    .build();

var myNotificationManager = $.extend({}, myNotificationManager, {
    messageListeners: {
        notificationProcessMessages: []
    }
});

connection.on("receiveNotificationMessage", function (message) {
    if (!myNotificationManager.messageListeners.notificationProcessMessages) {
        return;
    }

    myNotificationManager.messageListeners.notificationProcessMessages.forEach(function (fn) {
        fn({
            message: message
        });
    });
});

connection.start().then(function () {
    abp.log.info(hubName + " connected.");
}).catch(function (err) {
    abp.log.error(err.toString());
});

这样子前端就建立和后端的链接,当后端接收到数据的时候,就可以通过websocket的方式实时更新web页面。

Abp Vext中聊天功能支持百万计并发

在官方的Demo源码中,曾今看到过一个例子,就是通过redis或者rabbitmq横向扩展出来一个聊天App,内部使用的是SinalR,并且网站注册会员之间可以直接发送传递消息。

当时比较好奇,Abp Vnext是如何把websocket的消息发送到指定Id用户的?因为webscocket本身在链接的时候只有clientId作为标识,它是没有Userid的,那么两个userId不同的人相互发送消息,这个消息是怎么被精确传递到对应的userId的呢,那么这个websocket的ClientId和系统里面注册用户的userid之间已经是有一个httpContext上下文的交互的过程。

提及到这个HttpContext上下文。在Abp Vnext的这个demo源码这里有分析过一次,还有一个场景,就是线下超市门店的支持场景,中间开发商需要对接上下游支付接口的,进行支付数据转发的时候,也是利用的httpContext切换上下文进行传值。

文档信息

Search

    Table of Contents