wenmo8 发布的文章

LoRA模型是小型的Stable Diffusion模型,它们对checkpoint模型进行微小的调整。它们的体积通常是检查点模型的10到100分之一。因为体积小,效果好,所以lora模型的使用程度比较高。

这是一篇面向从未使用过LoRA模型的初学者的教程。你将了解LoRA模型是什么,在哪里找到它们,以及如何在AUTOMATIC1111 GUI中使用它们。然后,你将在文章末尾找到一些LoRA模型的演示。

LoRA模型是什么?

LoRA(Low-Rank Adaptation)是一种微调Stable Diffusion模型的训练技术。

虽然我们已经有像Dreambooth和文本反转这样的训练技术。那么LoRA有什么用呢?

LoRA实际上可以看做是Dreambooth和文本反转embeddings的折中方案。Dreambooth功能虽然强大,但模型文件会比较大(2-7 GB)。文本反转非常小(约100 KB),但能做的事情比较少。

LoRA介于两者之间。它的文件大小更容易管理(2-200 MB),并且训练能力相当不错。

因为checkpoint比较大,所以硬盘空间存储会是一个问题。而LoRA是解决存储问题的优秀方案。

像文本反转一样,
你不能单独使用LoRA模型
。它必须与模型检查点文件一起使用。LoRA通过对配套的模型文件进行小的修改来改变风格。

LoRA是定制AI艺术模型的绝佳方式,而不会占用太多本地存储空间。

LoRA如何工作?

LoRA对Stable Diffusion模型中最关键的部分进行小的修改:
交叉注意力层
。研究人员发现,微调这部分模型就足以实现良好的训练。交叉注意力层是下面Stable Diffusion模型架构中的黄色部分。

交叉注意力层

交叉注意力层的权重以
矩阵
的形式排列。矩阵只是按列和行排列的一堆数字,就像Excel电子表格上一样。LoRA模型通过将自己的权重加到这些矩阵上来微调模型。

如果LoRA模型需要存储相同数量的权重,它们的文件怎么会更小呢?
LoRA的技巧是将矩阵分解成两个更小的(低秩)矩阵。
通过这样做,它可以存储更少的数字。让我们通过以下示例来说明。

假设模型有一个100行100列的矩阵。那是10000个数字(100x 100)需要存储在模型文件中。LoRA将矩阵分解成一个1000x2矩阵和一个2x100矩阵。那只有400个数字(100 x 2 + 2 x 100,如果矩阵够更大的话,LoRA模型会减少的更多。这就是为什么LoRA文件要小得多的原因。

image-20240703105705024

在这个例子中,矩阵的

是2。它比原始尺寸低得多,所以它们被称为
低秩矩阵
。秩可以低至1。

这种操作必定会带来数据上的缺失,但是在交叉注意力层来说,这些损失是无伤大雅的。所以Lora这种做法是可行的。

在哪里找到LoRA模型?

Civitai

image-20240703110017448

寻找LoRA的首选地点是Civitai。该网站托管了大量LoRA模型的集合。应用LORA过滤器以仅查看LoRA模型。不过里面的大多数模型都是:女性肖像,动漫,现实主义插图风格等。

Hugging Face

image-20240703110326192

Hugging Face是另一个LoRA库的好来源。你会发现更多种类的LoRA模型。但那里的LoRA模型可能没有C站多,并且也不太直观。因为没有图片预览。

如何使用LoRA?

这里,我将介绍如何在AUTOMATIC1111 Stable Diffusion GUI中使用LoRA模型。

AUTOMATIC1111原生支持LoRA。你不需要安装任何扩展。

第1步:安装LoRA模型

要在AUTOMATIC1111 webui中安装LoRA模型,请将模型文件放入以下文件夹。

stable-diffusion-webui/models/Lora

第2步:在提示中使用LoRA

要在AUTOMATIC1111 Stable Diffusion WebUI中添加带权重的LoRA,请在提示或否定提示中使用以下语法:

<lora: name: weight>

name
是LoRA模型的名称。它可以与文件名不同。
weight
是应用于LoRA模型的权重。默认值为1。将其设置为0将禁用模型。

那么怎么知道lora的名字是什么呢?

其实我们并不需要手动输入lora的名字,我们只需要点击下面的lora标签:

image-20240703111227834

你应该看到一个已安装的LoRA模型列表。单击你想要使用的模型。

LoRA短语将被插入到提示中。

就是这样!

使用LoRA的注意事项

你可以
调整乘数
以增强或调整效果。将乘数设置为0将禁用LoRA模型。你可以在0和1之间调整风格效果。

一些LoRA模型是使用Dreambooth训练的。你需要包括一个
触发关键词
才能使用LoRA模型。你可以在模型页面上找到触发关键词。

类似于嵌入,你可以同时使用
多个LoRA模型
。你也可以将它们与嵌入一起使用。

在AUTOMATIC1111中,LoRA短语不是提示的一部分。在应用LoRA模型后,它将被删除。这意味着你不能使用像[keyword1:keyword2: 0.8]这样的提示语法来使用他们。

实用的LoRA模型

这里介绍一些在实际应用中比较实用的Lora。

add_detail

image-20240703112744179

谁不想要AI图像中更多的细节?细节调整器允许你增加或减少图像中的细节。现在,你可以调整你想要的细节量。

使用正LoRA权重来增加细节,使用负权重来减少细节。

add_saturation

这个lora可以给图片添加一些饱和度,效果如下:

image-20240703113008727

add_brightness

这个lora可以用来控制图片的亮度:

image-20240703134833039

总结

LoRA模型是checkpoint模型的小型修改器。你可以通过在提示中包含一个短语轻松地在AUTOMATIC1111中使用它们。

我将在以后的文章中告诉你如何自己来训练一个LoRA模型。

点我查看更多精彩内容:www.flydean.com

80后用菜刀,90后用蚁剑,95后用冰蝎和哥斯拉,以phpshell连接为例,本文主要是对这四款经典的webshell管理工具进行流量分析和检测。

什么是一句话木马?

1、定义
顾名思义就是执行恶意指令的木马,通过技术手段上传到指定服务器并可以正常访问,将我们需要服务器执行的命令上传并执行
2、特点
短小精悍,功能强大,隐蔽性非常好
3、
举例
php一句话木马用php语言编写的,运行在php环境中的php文件,例:
<?php @eval($_POST['pass']);?>
4、原理
以最为常见的php一句话木马为例,"
<?php ?>
"为php固定规范写法,"
@
"在php中含义为后面如果执行错误不会报错,"
eval()
"函数表示括号里的语句全做代码执行,"
$_POST['pass']
"表示从页面中以
post方式
获取变量pass的值

三、冰蝎

1、Behinder v2.0

(1)实现原理

①首次连接webshell时,客户端首先向服务器端发起一个GET请求

②服务器端随机产生一个
16位
的密钥,把密钥回显给客户端,同时把密钥写进服务器侧的Session中

③客户端获取密钥后,对二进制payload先进行
AES加密
(本地openssl模块),再通过POST方式发送至服务器端

④服务器收到数据后,从Session中取出密钥,进行AES解密,解密之后得到二进制payload数据

⑤服务器解析二进制payload文件,执行任意代码,并将执行结果加密返回

客户端解密服务器端返回的结果

(2)代码分析

冰蝎的通信过程可以分为两个阶段:
密钥协商

加密传输
第一阶段-密钥协商


通过 GET 或者 POST 方法,请求服务器密钥


服务端使用随机数MD5的高16位作为密钥


并且存储到会话的$_SESSION变量中


返回密钥给攻击者

第二阶段-加密传输


客户端把待执行命令作为输入,利用 AES 算法进行加密,并发送至服务端


服务端接受密文后进行 AES 运算解密,执行相应的命令


执行结果通过AES加密后返回给攻击者

(3)数据包分析

第一阶段-密钥协商

冰蝎为了实现可以在webshell内添加任意内容 (比如gif89a子类的文件头或者其它标示字符) 冰蝎在初始化密钥时会对webshell进行两次访问,然后比较两次页面返回的差异,把两次请求都相同的字符记录一个位置,后续加密会用到这两个位置(beginIndex,endIndex)

第二阶段-加密传输

使用密钥进行AES解密信息如下:

(4)流量特征

1、Accept字段

冰蝎默认 Accept 字段的值很特殊,这个特征存在于冰蝎的任何一个通讯阶段

2、UserAgent字段

冰蝎内置了17种 UserAgent ,每次连接 shell 会随机选择一个进行使用

3、长连接和Content-Length

冰蝎通讯默认使用长连接,避免了频繁的握手造成的资源开销。默认情况下,请求头和响应头里会带有
Connection: Keep-Alive
Content-Length: 16
##

16就是冰蝎2连接的特征

四、
密钥传递时URL参数


密钥传递时,URI只有一个
key-value
型参数

Key是黑客给shell设置的密码,一般为10位以下字母和数字

Value一般是2至3位随机纯数字

webshell的扩展名一般为可执行脚本

五、
传递的密钥


加密所用密钥是长度为16的随机字符串,小写字母+数字组成

密钥传递阶段,密钥存在于Response Body中

2、Behinder v3.0

(1)代码分析


相比于冰蝎2,冰蝎3取消了动态密钥获取

密钥使用的是连接密码的MD5值的前16位,并存储于Session中

(2)数据包分析

Request请求包

Response响应包

(3)流量特征

1、
Accept字段

头部特征:application/xhtml+xml,application/xml,application/signed-exchange

2、
UserAgent字段

最新版本冰蝎内置了14种 UserAgent ,每次连接 shell 会随机选择一个进行使用

(4)检测规则

alert:记录所有匹配的规则并记录与匹配规则相关的数据包,生成一个警告

msg:规则名称,规则中的第一个字段,ids告警上显示的信息

flow: 特定时间内具有相同数据的数据包(5元组信息)同属于一个流

content:检测数据包中是否存在此内容

pcre:正则表达式

flowbits:可以确保例如两个不同的数据包同时匹配时会生成警报

classtype类别:根据规则检测到的活动类型为规则分类

sid特征标示符:用于唯一性规则标识,sid不能重复

alert http any any -> any any(msg:"MALWARE-BACKDOOR Behinder webshell online detected"; flow:established,to_client; pcre: "/\r\n\r\n[A-Za-z0-9]{16}$/"; content:"200 OK"; content: "Content-Length: 16"; fast_pattern;nocase; flowbits: set, bx_first_get_resp; noalert; classtype:web-attack;sid:3000021; rev:1; metadata:created_at 2019_11_20, updated_at 2019_11_20;)
alert http any any
-> any any(msg:"MALWARE-BACKDOOR Behinder webshell online detected"; flow:established,to_server; content:"GET"; http_method; pcre:"/\.(php|jsp|asp|jspx|aspx)\?\w{1,8}=\d{1,10} HTTP/1\.1/";flowbits:isset, bx_first_get_resp; flowbits:set, bx_second_get_req; noalert;classtype:web-attack; sid:3000022; rev:1; metadata:created_at 2019_11_20,updated_at 2019_11_20;)
alert http any any
-> any any(msg:"MALWARE-BACKDOOR Behinder webshell online detected"; flow:established,to_client; pcre: "/\r\n\r\n[A-Za-z0-9]{16}$/"; content:"Content-Length: 16"; fast_pattern; nocase; flowbits: isset,bx_second_get_req; flowbits:set, bx_second_get_resp; noalert;classtype:web-attack; sid:3000023; rev:1; metadata:created_at 2019_11_20,updated_at 2019_11_20;)
alert http any any
-> any any(msg:"MALWARE-BACKDOOR Behinder webshell online detected"; flow:established,to_server; content:"POST"; http_method; pcre:"/\.(php|jsp|asp|jspx|aspx) HTTP/1\.1/"; flowbits:isset, bx_second_get_resp;flowbits:set, bx_first_post_req; noalert; classtype:web-attack; sid:3000024;rev:1; metadata:created_at 2019_11_20, updated_at 2019_11_20;)
alert http any any
-> any any(msg:"MALWARE-BACKDOOR Behinder webshell online detected"; flow:established,to_client; pcre: "/[^\w\s><=\-'"\:\;\,\!\(\)\{\}][\w]{2}[^\w\s><=\-'"\.\:\;\,\!\(\)\{\}][a-zA-Z\d]{2}/";content: "200 OK"; content: "Content-Type: text/html";flowbits: isset, bx_first_post_req; classtype:web-attack; sid:3000025; rev:1;metadata:created_at 2019_11_20, updated_at 2019_11_20;) alert http any any -> any any(msg:"MALWARE-BACKDOOR Behinder webshell-jspx online"; flow:established,to_server; pcre:"/\r\n\r\n[a-zA-Z\d\+\/]{10,}\/[a-zA-Z\d\/]{50}/"; content:"Content-Type: application/octet-stream"; fast_pattern; flowbits:isset, bx_second_get_resp; flowbits: set, bx_req_jspx; noalert;classtype:web-attack; sid:3000026; rev:1; metadata:created_at 2019_11_20,updated_at 2019_11_20;)
alert http any any
-> any any(msg:"MALWARE-BACKDOOR Behinder webshell-jspx online"; flow:established,to_client; pcre:"/[^\w\s><=\-'"\:\;\,\!\(\)\{\}][\w]{2}[^\w\s><=\-'"\.\:\;\,\!\(\)\{\}][a-zA-Z\d]{2}/";content: "200 OK"; content: "Content-Type: text/xml";fast_pattern; flowbits: isset, bx_req_jspx; classtype:web-attack; sid:3000027;rev:1; metadata:created_at 2019_11_20, updated_at 2019_11_20;)

TA是什么?
ICMAN液位检测是基于双通道比较电容式液位检测原理,来判断容器中是否有液体或者液体是否达到一定高度。

有什么用?
ICMAN液位检测可以实现非接触式检测,起到高低、不同液位提醒、缺水提醒、溢水提醒等作用,让我们的生产生活更加安全、便捷、高效、绿色、经济。

应用优势?
ICMAN液位检测方案一致性好、测量精确、易于实施。主要体现在:
按照工业级设计,有超强稳定性和抗干扰能力,可以适应复杂多变的环境,可靠性高;
检测精度高达±1mm,可以隔着任何非导电介质检测到容器中的水位和液体的变化,容器里有杂质、污垢、沉淀物等,不会影响检测结果;
结构设计简洁,安装方便,易实现集成化、智能化液位检测功能,可以有效地降低制造成本中的硬件成本;
同时,公司具有21年的触摸和液位检测芯片设计、应用经验,解决问题能力强,技术服务优秀。

经典案例?
应用于工业控制和家用电器领域,尤其是环保清洁电器家电设备,例如洗地机、扫地机器人、净水器等。

相关型号?
ICMAN液位检测芯片和模组型号推荐:
SC01、SC01B和WS003B

ICMAN液位检测芯片应用:

以上推荐仅供参考,具体可以根据产品实际需求,联系我们定制专属解决方案。
【END】

概述

租约机制指在租约期限内,拥有租约的节点有权利操作一些预设好的对象,具体如下

  1. 租约是由授权者授予的一段时间内的承诺
  2. 授权者一旦发出租约,则无论接受方是否收到,也无论后续接收方处于何种状态,只要租约不过期,授权者就得遵守承诺,按承诺的时间和内容执行。
  3. 接收方在有效期内可以使用授权者的租约,如果租约过期,那么授权者将不再对租约的承诺负责。如果要继续使用租约,则需要重新申请。
  4. 可以通过版本号、时间周期或者某个固定的时间点判断租约是否有效

可以把租约机制和公司的权利下放做类比来帮助理解。公司有董事会、CEO、CTO 和 CFO,董事会把公司不同的管理权限在一定时间内分别授权 CEO、CTO、CFO,在固定的时间段内如果有相关事宜,则直接找 CEO、CTO、CFO 处理,不必所有事情都要经过董事会,因为董事会已经授权了 CEO、CTO、CFO 在部分时间段内拥有相关事宜的执行权限,而在该时间段内董事会不能违约,因此 CEO、CTO、CFO 可以按照线定执行相关权利,在约定的时间到期后,CEO、CTO、CFO 需要考虑是续约还是解约


租约机制解决的问题

1. 分布式系统节点的状态变化

目前,大部分分布式系统都是采用主备的方式来实现的,一般主节点负责集群的管理工作,同时负责数据的写操作并将数据同步到各个备节点。备节点接收用户的读操作,当当主节点发生宕机时,从备节点中选举出一个主节点,继续为系统服务

那么集群中的各个节点是如何确定其他节点状态的呢?答案是通过心跳机制。假设有三个节点,分别为 Server-1、Server-2、Server-3,它们之间互为副本,其中 Server-1 为主节点,Server-2、Server-3 为备节点。另一个节点 Server-Electer 负责判断节点状态,在发现主节点异常后,会从备节点重新选出一个主节点继续为集群服务。

Server-Electer 通过心跳机制定时与其他节点通信,如果超过一段时间收不到某个节点的心跳,则认为该节点异常。这种机制在集群中各个节点之间网络正常的情况下运行良好,但是在发生网络分区(集群中各个节点网络通信异常)时会出现问题。比如 Server-Electer 节点收不到主节点的心跳,除了可能是因为主节点本身发生异常,还有可能是因为 Server-Electer 和主节点之间的网络通信发生异常。这时,如果 Server-Electer 和 Server-2、Server-3 之间的通信正常,则 Server-Electer 会从两个备节点中选出一个主节点,这里假定选举 Server-2 为主节点,则集群出现两个主节点,我们称之为双主问题。如果集群出现双主问题,则在 Server-1 的网络恢复后,备节点 Server-3 收到 Server-1 和 Server-2 两个主节点的数据同步请求,Server-3 的数据就会出现不一致的情况

出现双主问题时该如何处理呢?租约机制给了我们很好的解决方案。在租约机制的实现中,由选举节点向其他节点发送租约,如果该节点持有有效的租约,则认为该节点可以正常提供服务。例如三个工作节点 Server-1、Server-2、Server-3 仍然通过心跳机制向选举节点 Server-Electer 汇报自己的状态,选举节点在收到心跳后发送一个租约给三个工作节点,表示确认节点的状态,并允许在有效期内使用该租约的权力并对外提供服务

这时可以让选举节点 Server-Electer 给主节点 Server-1 一个特殊的租约,表示该节点为主节点,一旦发生网络分区或者其他问题,选举节点需要切换主节点,则只需等待之前主节点的租约到期,再重新给新选举出的主节点颁发新的租约即可。即使之前的主节点网络恢复,其他节点发现其租约已经到期,也不会将其认定为主节点

2. 分布式缓存

在分布式系统中,为了加快用户读取数据的速度,我们常常将经常被访问的数据缓存在客户端,这样在用户读取数据时,会先从本地缓存读取,如果在缓存中没有则从服务端获取最新的数据并更新本地缓存

但是这种方案存在缓存一致性问题,针对该问题有两种常见的解决方案,一种方案是轮询,即客户端在每次读取数据时,都先询问服务端缓存中的数据是不是最新的,如果不是,就从服务端获取最新的数据。采用这种方案时,每次读取数据都要与服务端通信,会增加服务端的压力,降低缓存的效果

另一种方案就是无效化,服务端对数据做修改时,会首先通知这些客户端数据已经失效,让客户端重新加载。这种做法的问题在于服务端需要维护所有客户端的状态,并且每次进行数据更新通知所有客户端。这增加了服务端的复杂度和运行的负担,如果联系不上客户端、则修改操作将无法顺利通知到客户端,使得客户端出现数据不一致的情况

那我们如何利用租约机制来解决缓存一致性问题呢?我们可以让服务器给缓存客户端发一个租约,在租约有效期内,客户从客户端读取数据,如果服务器要更改数据,则首先征求这块数据租约的客户端的同意,之后才可以修改数据。客户端在从服务器中取数据时获取租约,在租约有效期内,如果没有收到服务器的修改请求,就可以保证当前缓存中的内容是最新的。如果在租约时限内收到了数据修改请求,并且同意了,就需要清空缓存并重新加载缓存。在租约过期以后,客户端如果还要从缓存中读取数据,就必须获取新的租约,我们称这个过程为续约。

这样在租约期限内,客户端可以保证其缓存中的数据是最新的。同时,租约可以容忍网络分割问题,如果发生客户端崩溃或者网络中断,则服务器只需等待其租约过期就可以进行修改操作。如果服务器出错,丢失了所有客户端的信息,则它只需知道租约的最长期限,就可以在这个期限之后安全地修改数据。与无效化的方式相比,服务器只需记住还有租约的客户端即可。

3. 缓解主节点压力

在分布式系统中,元数据的信息都在主节点上维护,用户在访问数据时,首先需要在主节点上访问元数据的信息,来定位数据所在的数据节点,然后到数据节点上访问数据,这样所有客户端的请求都要先从主节点上获取源数据的信息,导致主节点压力过大

为了解决这个问题,我们可以将元数据的信息缓存在客户端,并通过租约机制保证租约有效期内主节点的数据和客户端一致。客户端在访问数据时,会先从本地缓仔中查找。如果本地援存没有,则再到主节点上查找,并更新缓存和租约信息,降低主节点的压力


租约机制的时钟同步问题

1. 颁发者的时钟比接收者的时钟快

如果颁发者的时钟比接收者的时钟快,那么在颁发者认为租约已经过期时,接收者却依旧认为租约有效,导致承诺失效,影响系统的正确性。通常做法是将颁发者的有效期限设置得比接收者的略大,只要大过时钟误差,就可以避免对租约有效性产生影响

2. 颁发者的时钟比接收者的时钟慢

如果颁发者的时钟比接收者的时钟慢,则当接收者认为租约已经过期时,颁发者依旧认为租约有效。接收者可以在租约到期前,以再次申请租约的方式解决这个问题


租约机制的应用

1. HDFS 中的租约机制

在 HDFS 中,当客户端用户向某个文件中写数据时,为了保障数据的一致性,其他客户端是不允许向此文件写数据的。那么 HDFS 是如何实现这一点的呢?答案是租约机制,当客户要写某一个 HDFS 文件时,首先从 HDFS 服务获取一个写该文件的租约,只有持有该租约的客户端才允许对该文件进行写操作,否则客户端对该文件的写请求将被驳回,客户端在对文件写操作完成时释放租约

2. Eureka 中的租约机制

Eureka 实现了服务注册和服务发现的功能。Eureka 的角色分为服务端(EurekaServer)和客户瑞,客户端指注册到注册中心(EurekaServer)的服务实例,又分为服务提供者和服务消费者,服务消费者从计册中心获取服务提供者的服务地址,并调用该服务。服务提供者在启动时,首先会将自己的信息注册到 EurekaServer,并维护一个续约请求,持续发送信息给 EurekaServer 表示其正常运行。如果 EurekaServer 长时间收不到续约请求,会将该服务实例从服务列表中剔除


租约机制的特性

  1. 在租约机制的颁发过程中只要求网络可以单向通信,同一个租约颁发者可以重复向接受方发送租约,颁发者即使偶尔发送租约失败,也可以简单地通过重发租约来解决向题
  2. 机器宕机对租约机制的影响不大,如果颁发者发生宕机,则宕机的颁发者通常无法改变之前的承诺,不会影响租约的正确性。在颁发者宕机恢复后,如果颁发者恢复了之前的租约信息,则颁发者可以继续遵守租约的承诺。如果颁发者无法恢复租约信息,则只需等待一个最大的租约超时时间即可
  3. 租约机制依赖于有效期,这就要求颁发者和接收者的时钟同步
  4. 在实际实现中,我们还需要考虑租约失效后颁发者或主节点资源释放的问题

肉夹馍(
https://github.com/inversionhourglass/Rougamo
),一款编译时AOP组件,无需在应用启动时进行初始化,也无需繁琐的配置;支持所有种类方法(同步和异步、静态和实例、构造方法/属性/普通方法);提供了简单易上手的Attribute应用方式,同时还提供了类AspectJ表达式的批量应用规则。

4.0.1 更新内容


4.0版本发布的文章评论
中,有朋友反馈了一个调试时无法查看方法内部变量值的问题。本次更新就是修复这个问题的,4.0.1不包含其他修改,对调试时禁用肉夹馍的朋友没有任何影响,可以酌情升级。

肉夹馍IoC/DI扩展

4.0.1本来是不准备发博客的,内容一句话就结束了,不过又想到前段时间还发布了IoC扩展,索性就合在一起写一篇博客吧。

各位在使用肉夹馍时,最常遇到的问题可能就是如何与IoC交互了。现在主流的动态代理本身就需要IoC才能完成,所以动态代理在IoC交互方面具有天然的优势,而肉夹馍编译时完成不依赖IoC,所以与IoC的交互也不是很方便。但不方便并不是不能。此前已经有朋友在自己的项目中实现了IoC的访问,比如
Rougamo.OpenTelemetry
,
FreeSql
。考虑到IoC的使用在现在已经非常普遍,所以新增了几个常用IoC的扩展包。

目前只对最常用的两个IoC组件提供了支持,一个是微软官方的
Microsoft.Extensions.DependencyInjection
,另一个是
Autofac
,主要包含四个NuGet:

  • Rougamo.Extensions.DependencyInjection.AspNetCore
  • Rougamo.Extensions.DependencyInjection.GenericHost
  • Rougamo.Extensions.DependencyInjection.Autofac.AspNetCore
  • Rougamo.Extensions.DependencyInjection.Autofac

其中
AspNetCore
结尾的两个NuGet专用于AspNetCore(废话了哦),另外两个NuGet用于
通用主机
(Generic Host)和Framework等场景。

版本号说明

在引用这些NuGet包时,你会发现他们都包含很多个版本,这并不是版本迭代更新快或者版本号设置错了导致的,版本号有相应的规则,它们的主版本号跟随对应IoC组件的NuGet主版本号。微软官方的两个扩展包的主版本号跟随
Microsoft.Extensions.*
的主版本号(也是.NET SDK的版本),
Autofac
的两个扩展包的主版本号跟随
Autofac
的主版本号。

快速开始

下面直接用代码快速展示如何使用对应的扩展包。

Rougamo.Extensions.DependencyInjection.AspNetCore

// 注册Rougamo(注:如果你不使用IoC/DI功能,Rougamo默认是不需要注册操作的)
public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);
    // ...省略其他步骤
    builder.Services.AddRougamoAspNetCore();
    // ...省略其他步骤
}

// 在切面类型中获取IServiceProvider实例并使用
public class TestAttribute : MoAttribute
{
    public override void OnEntry(MethodContext context)
    {
        // 使用扩展方法GetServiceProvider获取IServiceProvider实例
        var services = context.GetServiceProvider();

        // 使用IServiceProvider
        var xxx = services.GetService<IXxx>();
    }
}

Rougamo.Extensions.DependencyInjection.GenericHost

// 注册Rougamo(注:如果你不使用IoC/DI功能,Rougamo默认是不需要注册操作的)
public static void Main(string[] args)
{
    var builder = Host.CreateDefaultBuilder();
    // ...省略其他步骤
    builder.ConfigureServices(services => services.AddRougamoGenericHost());
    // ...省略其他步骤
}

// 在切面类型中获取IServiceProvider实例并使用
public class TestAttribute : MoAttribute
{
    public override void OnEntry(MethodContext context)
    {
        // 使用扩展方法GetServiceProvider获取IServiceProvider实例
        var services = context.GetServiceProvider();

        // 使用IServiceProvider
        var xxx = services.GetService<IXxx>();
    }
}

Rougamo.Extensions.DependencyInjection.Autofac.AspNetCore

// 注册Rougamo(注:如果你不使用IoC/DI功能,Rougamo默认是不需要注册操作的)
public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);
    builder.Host
            .UseServiceProviderFactory(new AutofacServiceProviderFactory())
            .ConfigureContainer<ContainerBuilder>(builder =>
            {
                builder.RegisterRougamoAspNetCore();
            });
    
    // 注册IHttpContextAccessor也是必须的
    builder.Services.AddHttpContextAccessor();
}

// 在切面类型中获取ILifetimeScope实例并使用
public class TestAttribute : MoAttribute
{
    public override void OnEntry(MethodContext context)
    {
        // 使用扩展方法GetAutofacCurrentScope获取ILifetimeScope实例
        var scope = context.GetAutofacCurrentScope();

        // 使用ILifetimeScope
        var xxx = scope.Resolve<IXxx>();
    }
}

Rougamo.Extensions.DependencyInjection.Autofac

// 注册Rougamo(注:如果你不使用IoC/DI功能,Rougamo默认是不需要注册操作的)
public static void Main(string[] args)
{
    var builder = Host.CreateDefaultBuilder();
    
    builder
        .UseServiceProviderFactory(new AutofacServiceProviderFactory())
        .ConfigureContainer<ContainerBuilder>(builder =>
        {
            builder.RegisterRougamo();
        });
}

// 在切面类型中获取IServiceProvider实例并使用
public class TestAttribute : MoAttribute
{
    public override void OnEntry(MethodContext context)
    {
        // 使用扩展方法GetAutofacCurrentScope获取ILifetimeScope实例
        var scope = context.GetAutofacCurrentScope();

        // 使用ILifetimeScope
        var xxx = scope.Resolve<IXxx>();
    }
}

比较早的Framework项目以及WinForm、WPF等项目可能并没有使用通用主机(Generic Host),此时使用
Rougamo.Extensions.DependencyInjection.Autofac
将更加直接,初始化时创建
ContainerBuilder
后直接调用
RegisterRougamo
扩展方法即可。

var builder = new ContainerBuilder();
builder.RegisterRougamo();

更多

肉夹馍IoC/DI扩展更多的信息请访问 Rougamo.DI (
https://github.com/inversionhourglass/Rougamo.DI
),欢迎反馈建议和提交PR.