
### 免费开源分布式系统日志收集框架 Exceptionless 

https://www.cnblogs.com/savorboard/p/exceptionless.html

### 肉夹馍AOP框架
https://github.com/inversionhourglass/Rougamo

https://www.cnblogs.com/nigture/p/16542420.html#


### .NetCore中使用分布式事务DTM的二阶段消息 

https://www.cnblogs.com/xwc1996/p/17252311.html

### .NET Core微服务之基于MassTransit实现数据最终一致性

https://www.cnblogs.com/edisonchou/p/dnc_microservice_masstransit_foundation_part1.html


### SAGA分布式事务

https://juejin.cn/post/7056552459937775647

### 适合于.NET Core的超轻量级工作流引擎：Workflow-Core

https://www.cnblogs.com/edisonchou/p/lightweight_workflow_engine_for_dotnetcore.html

### 蒋佬的管道流程处理

https://www.cnblogs.com/artech/p/17469614.html


### 大佬文章

https://www.cnblogs.com/edisonchou/category/364530.html

### RabbitMQ
https://www.cnblogs.com/Mamba8-24/p/16190097.html


### 玩具

https://www.kookapp.cn/tools/message-builder.html#/card

TODO 研究清单

### 主要几点

- Font 字体对象
```csharp
      using FileStream fs = File.OpenRead(字体所在目录);
      SKTypeface Font = SKTypeface.FromStream(fs);

```


- 常用的 SKPaint 对象
```csharp
SKPaint text_paint = new SKPaint
            {
                TextSize = 24F,
                Color = sKColors,
                Typeface = Font,
                TextScaleX = scale,
                FakeBoldText = bold,
                IsAntialias = true,//抗锯齿
                IsDither = true
            };
```

-  圆角矩形 

```csharp
  SKRoundRect roundRect = new SKRoundRect(new SKRect(0, 0, childSurface1Width, childSurface1Height), 11, 11);
  SKCanvas对象实例.ClipRoundRect(roundRect);   
```

- 绘制多行文本，并且使用省略号

```csharp
/// </summary>
        /// <param name="canvas">画布</param>
        /// <param name="text">多行文字</param>
        /// <param name="x">x坐标</param>
        /// <param name="y">y坐标</param>
        /// <param name="paint">画笔</param>
        /// <param name="maxWidth">单行文字最大宽度</param>
        /// <param name="maxLines">最大行数，如果超出，则使用...</param>
        public static void DrawMuiltLineText(SKCanvas canvas, string text, float x, float y, SKPaint paint, float maxWidth, int maxLines)
        {
            //已写出行数
            int lines = 0;
            //省略号宽度
            var ellipseWidth = paint.MeasureText("...");
            //如果文字没写完且已写行数小于最大行数，则继续写出
            while (!string.IsNullOrEmpty(text) && lines < maxLines)
            {
                //单行文字
                string lineStr;
                //单行文字长度
                long strLength;
                //非最后一行
                if (lines != maxLines - 1)
                {
                    //调用BreakText方法，可计算指定宽度能写出多少文字
                    strLength = paint.BreakText(text, maxWidth, out float ww, out lineStr);
                }
                //最后一行
                else
                {
                    //调用BreakText方法计算单行文字长度，这里需减去省略号宽度
                    strLength = paint.BreakText(text, maxWidth - ellipseWidth, out float ww, out lineStr);
                    //假如字还没写完，需加省略号
                    if (strLength < text.Length)
                    {
                        lineStr += "...";
                    }
                }
                //文字矩形
                var tRect = new SKRect();
                //计算文字矩形
                paint.MeasureText(lineStr, ref tRect);
                //计算坐标
                var tPoint = new SKPoint
                {
                    X = x - tRect.Left,
                    //这里注意Y坐标需要加上行高
                    Y = y + lines * paint.FontSpacing - tRect.Top
                };
                //写出一行文字
                canvas.DrawText(lineStr, tPoint, paint);
                //已写出行数加1
                lines++;

                //取剩余文字
                text = text.Substring((int)strLength);
            }
        }
```


### 代码实例


#### 活动海报
```c#
public class 海报生成
{
    /// <summary>
    /// 自定义字体
    /// </summary>
    static SKTypeface? Font;

    /// <summary>
    /// 生成员工活码图片
    /// </summary>
    /// <param name="bgPath">背景地址</param>
    /// <param name="qrPath">二维码地址</param>
    /// <param name="title">标题</param>
    /// <param name="text">子标题</param>
    public static Stream CreateActivityDiyQrCode(string bgPath, string qrPath, string coverPath, string title)
    {
        if (!File.Exists(bgPath))
            throw new Exception($"不存在文件：{bgPath}");
        if (Font == null)
        {
            var fontPath = $"AlibabaPuHuiTi-2-45-Light.ttf";
            using (FileStream fs = File.OpenRead(fontPath))
            {
                Font = SKTypeface.FromStream(fs);
            }
        }
        //字体设置
        var text_paint = new SKPaint
        {
            TextSize = 24F,
            Typeface = Font,
            FakeBoldText = true,
            IsAntialias = true,
            IsDither = true
        };
        // 创建一个主画布
        using var bgMap = SKBitmap.Decode(bgPath);
        var mapInfo = new SKImageInfo(495, 880);
        var map = SKBitmap.FromImage(SKImage.Create(mapInfo));
        // 创建一个主画布的画布上下文
        using var mainCanvas = new SKCanvas(map);
        var bsSize = new SKSizeI(495, 880);
        var bgImage = bgMap.Resize(bsSize, SKFilterQuality.High);
        mainCanvas.DrawColor(SKColors.White);
        mainCanvas.DrawBitmap(bgImage, 0, 0);
        //顶部
        var coverBitmap = SKBitmap.Decode(coverPath);
        mainCanvas.DrawBitmap(coverBitmap, 16, y: 24);
        mainCanvas.DrawText(title, 72, 53, text_paint);

        //二维码画布
        var childSurface1Height = mapInfo.Height - (630 + 20);
        var childSurface1Width = mapInfo.Width - (283 + 20);
        using var childSurface1 = new SKBitmap(childSurface1Width, childSurface1Height);
        using var childCanvas1 = new SKCanvas(childSurface1);
        childCanvas1.Clear(SKColors.Transparent);
        SKRoundRect roundRect = new SKRoundRect(new SKRect(0, 0, childSurface1Width, childSurface1Height), 11, 11);
        childCanvas1.ClipRoundRect(roundRect);       
        var qrHeight = 160;
        var qrWidth = 160;
        var qrMap = SKBitmap.Decode(qrPath);
        var qrSize = new SKSizeI(qrWidth, height: qrHeight);
        var qrImage = qrMap.Resize(qrSize, SKFilterQuality.High);
        childCanvas1.DrawColor(SKColors.White);
        childCanvas1.DrawBitmap(qrImage, 16, 12);
        var qrTextY = 200;
        var qrTextX = 35;
        childCanvas1.DrawText("扫码加好友", qrTextX, qrTextY, text_paint);

        // 把二维码画布画到主画布上
        mainCanvas.DrawBitmap(childSurface1, 283, 630);
        var stream = SKImage.FromBitmap(map).Encode(SKEncodedImageFormat.Png, 100).AsStream();
        return stream;
    }

}
```

#### 产品海报图

- 下载在线图片到本地示例 （使用flurl库）
```
string localPath = await "imgUrl".DownloadFileAsync(filePath, $"temp_prodImg_{nowTimeFileName}");
```

- 把byte[]图片数据保存到本地示例

```csharp
private async Task<string> SaveIgmToTemp(string fileName, byte[] byteArray)
        {
            using MemoryStream imgStream = new MemoryStream(byteArray);

            string tempPath = "temp/image/";

            string filePath = Path.Combine(tempPath, fileName).Replace("\\", "/");

            if (!Directory.Exists(tempPath)) Directory.CreateDirectory(tempPath);

            using var fileStream = File.Create(filePath);
            imgStream.CopyTo(fileStream);

            return filePath;
        }
```

- 核心代码
```csharp
public class ImageHelper
    {
        /// <summary>
        /// 生成产品二维码海报图
        /// </summary>
        /// <param name="prodPath">产品图地址（本地地址）</param>
        /// <param name="qrCodePath">二维码地址（本地地址）</param>
        /// <param name="regularPriceF">产品原价</param>
        /// <param name="salePriceF">产品售价</param>
        /// <param name="prodTitle">产品标题</param>
        /// <param name="marginX">整体的X边距</param>
        /// <param name="marginY">整体的Y边距</param>
        /// <param name="additionalH">额外增高</param>
        /// <param name="fontPath">字体路径（本地地址）</param>
        /// <returns></returns>
        public static Stream CreateProductQrImage(string prodPath, string qrCodePath, float regularPriceF, float salePriceF, string prodTitle, int marginX = 35, int marginY = 35, int additionalH = 200, string fontPath = "font.ttf")
        {
            int prodRadius = 11;

            //分别获取原价和售价的整数和小数
            string salePriceZero = "." + salePriceF.ToString("0.00").Split('.')[1];
            string salePriceInt = ((int)salePriceF).ToString();
            string regularPriceZero = "." + regularPriceF.ToString("0.00").Split('.')[1];
            string regularPriceInt = ((int)regularPriceF).ToString();

            SKBitmap prodBitmapSource = SKBitmap.Decode(prodPath);
            var bsSize = new SKSizeI(500, 550);
            SKBitmap prodBitmap = prodBitmapSource.Resize(bsSize, SKFilterQuality.High);

            //根据产品图片大小生成画布大小
            using SKBitmap mainBitmap = new SKBitmap(prodBitmap.Width + marginX * 2, prodBitmap.Height + additionalH + marginY * 2);

            using SKCanvas mainCanvas = new SKCanvas(mainBitmap);
            mainCanvas.Clear();
            mainCanvas.DrawColor(SKColors.White);

            var prodReBitmap = new SKBitmap(bsSize.Width, bsSize.Height);
            using SKCanvas prodCanvas = new SKCanvas(prodReBitmap);
            prodCanvas.Clear();
            SKRoundRect roundRect = new SKRoundRect(new SKRect(0, 0, bsSize.Width, bsSize.Height), prodRadius, prodRadius);
            prodCanvas.ClipRoundRect(roundRect);
            prodCanvas.DrawColor(SKColors.White);
            prodCanvas.DrawBitmap(prodBitmap, new SKPoint() { X = 0, Y = 0 });
            //画产品图
            mainCanvas.DrawBitmap(prodReBitmap, marginX, marginY);
            //画文字 MeasureText
            var line_1Paint = GetSKPaint(fontPath, SKColor.Parse("#af243d"));
            string row1_col1Text = "￥";
            SKRect row1_col1GapSkRect = new SKRect();
            SKRect row1_col2GapSkRect = new SKRect();
            SKRect row2_GapSkRect = new SKRect();
            SKRect row2_col1GapSkRect = new SKRect();
            line_1Paint.MeasureText(text: row1_col1Text, bounds: ref row1_col1GapSkRect);

            float row1Y = prodBitmap.Height + prodBitmap.Height / 7;
            mainCanvas.DrawText(row1_col1Text, marginX, row1Y, line_1Paint);

            float row1X = marginX + row1_col1GapSkRect.Width + row1_col1GapSkRect.Width / 2;
            line_1Paint.TextSize = 45F;
            mainCanvas.DrawText(salePriceInt, row1X, y: row1Y, line_1Paint);

            line_1Paint.MeasureText($"{salePriceInt}", ref row1_col2GapSkRect);
            line_1Paint.TextSize = 25F;
            row1X = marginX + row1_col2GapSkRect.Width + (row1_col2GapSkRect.Width / 2) + (row1_col2GapSkRect.Width / 7);
            mainCanvas.DrawText(salePriceZero, row1X, y: row1Y, line_1Paint);

            row1Y = row1Y + row1_col1GapSkRect.Height * 2 + 10;
            string line_2Col1Text = $"价格";
            SKPaint line_2Patin = GetSKPaint(fontPath, SKColors.Gray, 15F, false);


            //画第二行第一段文字
            mainCanvas.DrawText(line_2Col1Text, marginX, row1Y, line_2Patin);

            //第二行第一段文字（价格）的大小方位
            line_2Patin.MeasureText($"{line_2Col1Text}", ref row2_col1GapSkRect);

            //画第二行第二段文字
            string row2Col2Text = $"￥{regularPriceInt}{regularPriceZero}";
            float row2Col2TextStartPoint = marginX + row2_col1GapSkRect.Width + 5;
            mainCanvas.DrawText(row2Col2Text, row2Col2TextStartPoint, row1Y, line_2Patin);


            line_2Patin.MeasureText(row2Col2Text, ref row2_GapSkRect);

            //画线
            SKPaint linePaint = new SKPaint
            {
                Style = SKPaintStyle.Stroke,
                Color = SKColors.Gray,
                StrokeWidth = 2
            };
            float lineY = row1Y - row2_GapSkRect.Height * .4f;
            mainCanvas.DrawLine(row2Col2TextStartPoint, lineY, row2Col2TextStartPoint + row2_GapSkRect.Width+10, lineY, linePaint);

            DrawMuiltLineText(
                mainCanvas,
                prodTitle,
                marginX,
                row1Y + row2_GapSkRect.Height + 10,
                GetSKPaint(fontPath, SKColor.Parse("#292929"), 25F, bold: false, 1),
                prodBitmap.Width / 2 + 10,
                2);


            using SKBitmap qrCodeBimap = SKBitmap.Decode(qrCodePath);
            int wh = 150;
            int x = mainBitmap.Width - wh - wh / 5;
            int y = mainBitmap.Height - wh - wh / 4;
            //画二维码
            //using SKImage qrCodeSKImage = SKImage.FromEncodedData(SKData.Create(qrCodePath));

            //int x = mainBitmap.Width - 100; //- qrCodeSKImage.Width;
            //int y = mainBitmap.Height - 100;// - qrCodeSKImage.Height;


            SKRect qrCodeRect = SKRect.Create(x, y, wh, wh);
            mainCanvas.DrawBitmap(qrCodeBimap, qrCodeRect);

            Stream stream = SKImage.FromBitmap(mainBitmap).Encode(SKEncodedImageFormat.Png, 100).AsStream();
            return stream;
        }

        /// <summary>
        /// 获取画笔
        /// </summary>
        /// <param name="fontPath"></param>
        /// <param name="sKColors"></param>
        /// <param name="size"></param>
        /// <param name="bold"></param>
        /// <param name="scale"></param>
        /// <returns></returns>
        static SKPaint GetSKPaint(string fontPath, SKColor sKColors, float size = 24F, bool bold = true, float scale = 1f)
        {
            using FileStream fs = File.OpenRead(fontPath);
            SKTypeface Font = SKTypeface.FromStream(fs);

            //字体设置
            SKPaint text_paint = new SKPaint
            {
                TextSize = 24F,
                Color = sKColors,
                Typeface = Font,
                TextScaleX = scale,
                FakeBoldText = bold,
                IsAntialias = true,
                IsDither = true
            };

            return text_paint;
        }

        ///<summary>
        /// 画多行文本并省略
        /// </summary>
        /// <param name="canvas">画布</param>
        /// <param name="text">多行文字</param>
        /// <param name="x">x坐标</param>
        /// <param name="y">y坐标</param>
        /// <param name="paint">画笔</param>
        /// <param name="maxWidth">单行文字最大宽度</param>
        /// <param name="maxLines">最大行数，如果超出，则使用...</param>
        public static void DrawMuiltLineText(SKCanvas canvas, string text, float x, float y, SKPaint paint, float maxWidth, int maxLines)
        {
            //已写出行数
            int lines = 0;
            //省略号宽度
            var ellipseWidth = paint.MeasureText("...");
            //如果文字没写完且已写行数小于最大行数，则继续写出
            while (!string.IsNullOrEmpty(text) && lines < maxLines)
            {
                //单行文字
                string lineStr;
                //单行文字长度
                long strLength;
                //非最后一行
                if (lines != maxLines - 1)
                {
                    //调用BreakText方法，可计算指定宽度能写出多少文字
                    strLength = paint.BreakText(text, maxWidth, out float ww, out lineStr);
                }
                //最后一行
                else
                {
                    //调用BreakText方法计算单行文字长度，这里需减去省略号宽度
                    strLength = paint.BreakText(text, maxWidth - ellipseWidth, out float ww, out lineStr);
                    //假如字还没写完，需加省略号
                    if (strLength < text.Length)
                    {
                        lineStr += "...";
                    }
                }
                //文字矩形
                var tRect = new SKRect();
                //计算文字矩形
                paint.MeasureText(lineStr, ref tRect);
                //计算坐标
                var tPoint = new SKPoint
                {
                    X = x - tRect.Left,
                    //这里注意Y坐标需要加上行高
                    Y = y + lines * paint.FontSpacing - tRect.Top
                };
                //写出一行文字
                canvas.DrawText(lineStr, tPoint, paint);
                //已写出行数加1
                lines++;

                //取剩余文字
                text = text.Substring((int)strLength);
            }
        }
    }
```


.Net SkiaSharp 绘图

> 光速入门blazor达到“能用”标准，主要是用这套[框架](https://www.blazor.zone/)，文档没法直接模糊搜内容，只能一个个点开找，且某些个人常用场景实在很难找到咋实现的，所以记录下常用的，避免反复查找的同时也希望能节省一下后来者的时间，面向和我一样对blazor只有个大概概念，切迫切需要光速上手落地实际东西的萌新





**文档会时不时更新，欢迎分享小技巧或者使用知识点** 💛

### 相关应该有用的资料

- [Blazor基础之组件通信](https://www.cnblogs.com/zxyao/p/12671873.html)

- [BB框架浏览器全局事件](https://www.cnblogs.com/codecopier/p/17609206.html)


### Table的一些属性

- 常规Table模板，方便复制

```
<Table class="table-users" TItem="PlayerInfoEntity"
       @bind-SelectedRows="SelectedItems"
       Height="600"
       IsPagination="true"
       PageItemsSource="@PageItemsSource"
       OnSaveAsync="OnSaveAsync"
       RenderMode="TableRenderMode.Table"
       IsFixedHeader="true"
       IsStriped="true"
       IsBordered="true"
       ShowToolbar="true"
       ShowDefaultButtons="true"
       ShowDeleteButton="true"
       ShowPageInfo="true"
       ShowAddButton="true"
       ShowSearchButton="true"
       ShowExtendButtons="true"
       ShowExtendEditButton="true"
       ShowExtendDeleteButton="true"
       ShowLoadingInFirstRender="true"
       ShowSkeleton="true"
       AddModalTitle="🙄 添加"
       EditModalTitle="🤩 编辑"
       ShowEmpty="true"
       AllowDragColumn="true"
       IsMultipleSelect="true"
       OnQueryAsync="OnQueryAsync">
```

> **SelectedItems** 对象记得需要new, **PageItemsSource** 其实就是这个  ![image.png](/static/img/1db4c13965d6c0668c17ace58457b5c6.image.webp) 的效果，传int集合即可

#### EditTemplate · 表单


##### 反常规思维注意事项❗❗❗❗❗

###### AvatarUpload组件
- 在使用**AvatarUpload组件**时注意， ` @bind-Value="@context.Avatar"` 无法在save的时候直接获取到UploadFile的PrevUrl值，也就不能直接依靠`context.Avatar`  ，目前我的处理方式是再上传图片的时候存个变量save再次单独手动赋值一下 [示例代码点我查看,OnSaveAsync 方法代码](https://github.com/MineCosmos/Bot/blob/main/MineCosmos.Bot.BlazorApp/MineCosmos.Bot.BlazorApp.Shared/Pages/Users.razor.cs)


###### Slect组件
- 使用**Slect组件**下拉注意，`OnQueryAsync` 配合 `@bind-Value="@context.ServerId"` 绑定只会显示value值，不会显示text值，这就意味着需要一个再建一个input来显示text值，而`@bind-Value`只负责改变value值（虽然有点怪，不能直接通过value显示text，但好像设计是如此，详情看我提的 [ISS]
- **Select组件新思路** 
1. bind-value 绑定  SelectedItem
```
  private SelectedItem? ServerDropDownSelectItem { get; set; } = new();
```
2. 给Table 加 ` OnEditAsync="OnEditAsync" ` 事件（也就是点击编辑按钮时，界面还没渲染时的事件）

3. 在事件里手动赋值

```
        /// <summary>
        /// 点击编辑按钮时
        /// </summary>
        /// <param name="model"></param>
        /// <returns></returns>
        private async Task OnEditAsync(PlayerInfoEntity model)
        {
            //图片手动赋值
            if (!string.IsNullOrWhiteSpace(model.Avatar))
            {
                PreviewFileList = new() { new UploadFile { PrevUrl = model.Avatar } };
                CurrentImageUrl = model.Avatar;
            }

            //下拉框手动赋值
            if (model.ServerInfo is null) return;
            ServerDropDownSelectItem.Text = model.ServerInfo.ServerName;
            ServerDropDownSelectItem.Value = model.ServerId.ToString();
        }

```


- (https://github.com/dotnetcore/BootstrapBlazor/issues/2190)）



- 分享一下我的SaveToFile写法（改自示例）

```
private CancellationTokenSource? ReadToken { get; set; }

public async Task<bool> SaveToFile(UploadFile file)
        {
            var ret = false;
            string filePath = $"/upload/images/";
            string fileName = $"{DateTime.Now.ToString("yyyyMMddHHmmss")}_{file.GetFileName()}";
            string pathToWwwroot = HostEnvironment!.WebRootPath;
            string saveFilePath = $"{pathToWwwroot}{filePath}".Replace("\\", "/");           
            string saveFileFull = Path.Combine(saveFilePath, fileName);

            ReadToken ??= new CancellationTokenSource();
            ret = await file.SaveToFileAsync(saveFileFull, ImageMaxFileLength, ReadToken.Token);
            if (ret)
            {
            //读当前地址，例如本地就是：localhost:端口
                file.PrevUrl = $"{AppSettings.app(new string[] { "SiteOption", "Url" })}{filePath}{fileName}";
                CurrentImageUrl = file.PrevUrl;
            }
            else
            {
                var errorMessage = $"{"保存图片失败"} {file.OriginFileName}";
                file.Code = 1;
                file.Error = errorMessage;
                await ToastService.Error("上传图片", errorMessage);
            }
            return ret;
        }
```


#### 行属性
```
ShowExtendButtons 显示行操作按钮
ShowExtendEditButton 显示行编辑操作按钮
ShowExtendDeleteButton 显示行删除操作按钮
```
- **效果**

![image.png](/static/img/d8babb5299f318741db9230eb33cd760.image.webp)




- #### 回调方法属性

- OnQueryAsync
```c#
private async Task<QueryData<实体名称>> OnQueryAsync(QueryPageOptions options)
        {
            
            var queryPageInfo =  查询数据源;
            return new QueryData<实体名称>()
            {
                Items = queryPageInfo.数据源的集合
                TotalCount = queryPageInfo.数据源集合总数
                IsFiltered = false,
                IsSorted = false,
                IsSearch = false                  
            };
        }

```

- #### 数据绑定属性

- 选中的对象 @bind-SelectedRows="绑定的对象"

### 瞎捉摸的小技巧

- 最好定义一个公共基类，定义一些常用的方法，举例：

```
        /// <summary>
        /// 获取table查询数据
        /// </summary>
        /// <param name="pageDto"></param>
        /// <returns></returns>
        public QueryData<T> GetQueryData(ResPageDto<T> pageDto)
        {
            return new QueryData<T>()
            {
                Items = pageDto.Data,
                TotalCount = pageDto.Total,
                IsFiltered = false,
                IsSorted = false,
                IsSearch = false
            };
        }
```


> 我是直接类泛型，ResPageDto 是我的分页查询返回实体结构，这个主要作用就是转为BB框架分页所需的QueryData类型,💥💥记得.cs继承自己封装的父类后，razor页面也要加上 `@inherits BotComponentBase<PlayerInfoEntity>` ，主要是 **@inherits** 作用就继承


### 视觉类

- 更好的输入框体验，比普通input看起来更舒服

```示例代码
  <FloatingLabel DisplayText="玩家正版ID" @bind-Value="@context.Name" TValue="string" IsSelectAllTextOnFocus="true" />
```

Blazor快速过

MineCosmos项目梳理

本社畜常遇问题，个人向git手册整理




#### 设置git代理

```cmd
git config --global http.proxy http://127.0.0.1:7890
git config --global http.proxy https://127.0.0.1:7890
```


#### git rm -r --cached
> 有时候明明添加了遗忘设置，但是修改项目中依然会有这个文件夹的提交，此时仅需要执行以下命令
```
git rm -r --cached directory_or_file
```