mirror of https://github.com/abpframework/abp.git
1 changed files with 111 additions and 0 deletions
@ -0,0 +1,111 @@ |
|||
# 短信发送 |
|||
|
|||
Abp框架提供一个用于发送短信的抽象,有如下优点: |
|||
|
|||
- 在不改变应用程序代码的情况下,您可以**非常容易地切换**短信发送提供者(提供商)。 |
|||
- 如果您想创建可重用的应用程序模块,则不需要假设短信是如何发送的。 |
|||
|
|||
## 安装 |
|||
|
|||
建议您使用[ABP CLI](CLI.md)来安装这个包。 |
|||
|
|||
### 使用Abp CLI |
|||
|
|||
在项目所在目录(.csproj 文件所在目录)打开命令行工具,输入如下命令: |
|||
|
|||
```bash |
|||
abp add-package Volo.Abp.Sms |
|||
``` |
|||
|
|||
### 手动安装 |
|||
|
|||
如果您想要手动安装; |
|||
|
|||
1. 添加 [Volo.Abp.Sms](https://www.nuget.org/packages/Volo.Abp.Sms) NuGet 包到您的项目中: |
|||
|
|||
``` |
|||
Install-Package Volo.Abp.Sms |
|||
``` |
|||
|
|||
2. 在您的模块的依赖列表中添加对模块`AbpSmsModule`的依赖: |
|||
|
|||
```csharp |
|||
[DependsOn( |
|||
//...秋天依赖 |
|||
typeof(AbpSmsModule) //添加新模块的依赖 |
|||
)] |
|||
public class YourModule : AbpModule |
|||
{ |
|||
} |
|||
``` |
|||
|
|||
## 发送短信 |
|||
|
|||
[注入](Dependency-Injection.md) `ISmsSender`, 并使用`SendAsync`方法来发送短信。 |
|||
|
|||
**例子:** |
|||
|
|||
```csharp |
|||
using System.Threading.Tasks; |
|||
using Volo.Abp.DependencyInjection; |
|||
using Volo.Abp.Sms; |
|||
|
|||
namespace MyProject |
|||
{ |
|||
public class MyService : ITransientDependency |
|||
{ |
|||
private readonly ISmsSender _smsSender; |
|||
|
|||
public MyService(ISmsSender smsSender) |
|||
{ |
|||
_smsSender = smsSender; |
|||
} |
|||
|
|||
public async Task DoItAsync() |
|||
{ |
|||
await _smsSender.SendAsync( |
|||
"+012345678901", // 目标手机号 |
|||
"This is test sms..." // 消息内容 |
|||
); |
|||
} |
|||
} |
|||
} |
|||
``` |
|||
|
|||
示例中给定的`SendAsync`方法是一个扩展方法,用于发送带有基本参数的短信。此外,您也可以传入一个有如下属性的`SmsMessage`对象: |
|||
|
|||
- `PhoneNumber` (`string`):目标手机号 |
|||
- `Text` (`string`):短信消息内容 |
|||
- `Properties` (`Dictionary<string, string>`):用于传入自定义参数的键值对 |
|||
|
|||
## NullSmsSender |
|||
|
|||
`NullSmsSender`是`ISmsSender`的一个默认实现。它写入内容到[标准日志](Logging.md)中,而不是真正地发送短信。 |
|||
|
|||
开发时,您不想真正地发送短信时,这个类是非常有用的。**然而,若您想真实发送短信,您需要在您的应用程序代码中实现`ISmsSender`接口。** |
|||
|
|||
## 实现ISmsSender接口 |
|||
|
|||
通过创建一个实现`ISmsSender`接口的类,您可以很容易创建您自己的短信发送实现,如下所示: |
|||
|
|||
```csharp |
|||
using System.IO; |
|||
using System.Threading.Tasks; |
|||
using Volo.Abp.Sms; |
|||
using Volo.Abp.DependencyInjection; |
|||
|
|||
namespace AbpDemo |
|||
{ |
|||
public class MyCustomSmsSender : ISmsSender, ITransientDependency |
|||
{ |
|||
public async Task SendAsync(SmsMessage smsMessage) |
|||
{ |
|||
// 发送短信 |
|||
} |
|||
} |
|||
} |
|||
``` |
|||
|
|||
## More |
|||
|
|||
[ABP Commercial](https://commercial.abp.io/)提供Twilio的集成包,用于使用[Twilio service](https://docs.abp.io/en/commercial/latest/modules/twilio-sms)来发送短信。 |
|||
Loading…
Reference in new issue