在很多情况下,我们利用IOC控制反转可以很方便实现一些接口的适配处理,可以在需要的时候切换不同的接口实现,使用这种方式在调用的时候,只需要知道相应的接口接口,具体调用哪个实现类,可以在配置文件中动态指定,本篇主要介绍AutoFac的IOC组件的使用,用来实现微信接口处理的控制反转功能。
我们知道,实现IOC的方式有很多,如Unity、AutoFac、Ninject、Castle Windsor、Spring.NET等等,每种IOC组件均有自己的一些特点,我在之前的实体框架随笔系列介绍过Unity的使用《Entity Framework 实体框架的形成之旅--利用Unity对象依赖注入优化实体框架(2)》,本来也想用这个来实现微信的接口调用处理,不过由于其版本以及一些其他问题,总是没有那么方便,最后决定使用也比较流行,应用较多的的AutoFac组件来实现。
1、微信接口的处理需求
我们在使用微信公众号实现一些业务处理的时候,往往需要根据不同的条件进行不同的接口调用。
如通过二维码扫码的结果处理,然后呈现给微信用户的相关信息,有下面两种方式。
根据用户的扫码结果,我们可以自定义自己的业务处理,然后呈现给用户,那么这里使用IOC来实现具体的业务是比较好的,我们在具体的业务实现里面,可以根据不同的条件实现所需要的复杂处理。
当然我们还可以扩展到很多的业务接口里面,如百度的地理位置解析接口、电影院信息查询、天气信息查询、交通信息查询、旅游信息查询等,还有短信、邮件发送等常规接口,都可以使用这种方式进行处理。
接口的效果展示如下所示。
这些给其他项目模块使用的时候,我们可以在配置文件里面指定具体的接口实现信息,这种可以具体指定所需的实现。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="autofac" type="Autofac.Configuration.SectionHandler, Autofac.Configuration"/>
</configSections>
<autofac defaultAssembly="WHC.Common.Handler">
<components>
<component type="WHC.Common.Handler.TestHandler, WHC.Common.Handler" service="WHC.Common.Handler.ITestHandler" />
<component type="WHC.Common.Handler.QRCodeHandler, WHC.Common.Handler" service="WHC.Common.Handler.IQRCodeHandler" />
<!--邮件短信-->
<component type="WHC.Common.Handler.SmsSendHandler, WHC.Common.Handler" service="WHC.Common.Handler.ISmsHandler" />
<component type="WHC.Common.Handler.MailSendHandler, WHC.Common.Handler" service="WHC.Common.Handler.IMailHandler" />
</components>
</autofac>
</configuration>
直接使用AutoFac的操作应该是比较方便,使用接口获取方式获取具体实现就可以了。
2、使用Autofac实现
为了方便使用Autofac,我们可以先在项目上的Nuget包管理,引用相关的DLL,其中包括核心的Autofac类库,以及读取配置文件的Autofac Configuration,后者为方便读取XML配置信息所必须。
引入这两个DLL就可以使用Autofac的功能了。
一般通过配置文件,初始化的Autofac组件的代码如下所示
instance = new AutoFactory();
//初始化相关的注册接口
var builder = new ContainerBuilder();
//从配置文件注册相关的接口处理
builder.RegisterModule(new ConfigurationSettingsReader("autofac", configurationFile));
container = builder.Build();
而我们使用Autofac的接口也是很容易的,常规的使用代码如下所示。
var handler = container.Resolve<ITestHandler>();
handler.Test("测试");
当然,为了方便,我们可以使用一个辅助类来简化这个接口的调用:在辅助类初始化的时候,我们从配置文件加载对应的组件接口实现,当我们需要解析具体接口的时候,就可以直接从Container容器里面胡获取了,辅助类代码如下所示。
/// <summary>
/// 使用AutoFac的工厂类,通过配置
/// </summary>
public class AutoFactory
{
//普通局部变量
private static object syncRoot = new Object();
//工厂类的单例
private static AutoFactory instance = null;
//配置文件
private const string configurationFile = "autofac.config";
/// <summary>
/// IOC的容器,可调用来获取对应接口实例。
/// </summary>
public IContainer Container { get; set; }
/// <summary>
/// IOC容器工厂类的单例
/// </summary>
public static AutoFactory Instatnce
{
get
{
if (instance == null)
{
lock (syncRoot)
{
if (instance == null)
{
instance = new AutoFactory();
//初始化相关的注册接口
var builder = new ContainerBuilder();
//从配置文件注册相关的接口处理
builder.RegisterModule(new ConfigurationSettingsReader("autofac", configurationFile));
instance.Container = builder.Build();
}
}
}
return instance;
}
}
/// <summary>
/// 测试的接口
/// </summary>
public void Test()
{
var handler = AutoFactory.Instatnce.Container.Resolve<ITestHandler>();
handler.Test("测试");
}
}
3、外部接口实现及调用
这样我们所有的接口都定义好,并给每个定义的接口相应个实现就可以使用这个Autofac组件进行调用了。
/// <summary>
/// 短信发送接口
/// </summary>
public interface ISmsHandler
{
/// <summary>
/// 发送短信
/// </summary>
/// <param name="content">短信内容</param>
/// <param name="mobiles">手机号码(多个号码用”,”分隔)</param>
/// <param name="sendTime">预约发送时间</param>
/// <returns></returns>
CommonResult Send(string content, string mobiles, DateTime? sendTime = null);
/// <summary>
/// 查询剩余条数
/// </summary>
/// <returns></returns>
CommonResult GetLeftCount();
}
/// <summary>
/// 邮件发送接口
/// </summary>
public interface IMailHandler
{
/// <summary>
/// 发送外部邮件(自定义邮件配置,如个人邮件)
/// </summary>
/// <param name="mailInfo">发送邮件信息</param>
/// <param name="settingInfo">SMTP协议设置信息</param>
/// <returns></returns>
CommonResult Send(MailInfo mailInfo, SmtpSettingInfo settingInfo);
/// <summary>
/// 发送外部邮件(系统配置,系统邮件)
/// </summary>
/// <param name="mailInfo">发送邮件信息</param>
/// <returns></returns>
CommonResult Send(MailInfo mailInfo);
}
例如,测试发送短信和邮件的IOC调用代码如下所示
//使用IOC模块发送
var sms = AutoFactory.Instatnce.Container.Resolve<ISmsHandler>();
var smsTemplate = string.Format("验证码:{0}。尊敬的会员,您好,您正在注册会员,验证码2分钟内有效,感谢您的支持。", new Random().Next(100000));
var result = sms.Send(smsTemplate, "18620292076");
Console.WriteLine(result.Success ? "发送短信成功" : "发送短信失败:" + result.ErrorMessage);
MailInfo info = new MailInfo();
info.ToEmail = "wuhuacong@163.com";
info.FromEmail = "wuhuacong@163.com";
info.Subject = "这是一份来自我自己的测试邮件";
info.Body = info.Subject + ",这是内容部分。<a href='http://www.iqidi.com'>点击这里返回主页</a>";
var mail = AutoFactory.Instatnce.Container.Resolve<IMailHandler>();
var mailResult = mail.Send(info);
Console.WriteLine(mailResult.Success ? "发送邮件成功" : "发送邮件失败:" + mailResult.ErrorMessage);
测试后得到的结果如下:
邮件结果一样可以收到。
我们回到上面介绍的二维码扫描的业务实现效果,上面提到了,一个二维码事件可以派生出不同的接口实现,从而给不同的响应信息。
/// <summary>
/// 扫码进行的处理
/// </summary>
public interface IQRCodeHandler
{
/// <summary>
/// 处理ScancodePush的事件
/// </summary>
/// <param name="info">扫描信息</param>
/// <param name="accountInfo">账号信息</param>
/// <returns></returns>
string HandleScancodePush(RequestEventScancodePush info, AccountInfo accountInfo);
/// <summary>
/// 处理ScancodeWaitmsg的事件
/// </summary>
/// <param name="info">扫描信息</param>
/// <param name="accountInfo">账号信息</param>
/// <returns></returns>
string HandleScancodeWaitmsg(RequestEventScancodeWaitmsg info, AccountInfo accountInfo);
}
我们可以定义两个简单的接口处理,用来承接微信二维码扫描接口的处理操作。
这样我们在处理二维码扫描事件的时候,我们就可以把它分配到接口里面进行处理即可。
/// <summary>
/// 扫码推事件的事件推送处理
/// </summary>
/// <param name="info">扫描信息</param>
/// <returns></returns>
public string HandleEventScancodePush(RequestEventScancodePush info, AccountInfo accountInfo)
{
string result = "";
var handler = AutoFactory.Instatnce.Container.Resolve<IQRCodeHandler>();
if(handler != null)
{
result = handler.HandleScancodePush(info, accountInfo);
}
return result;
}
/// <summary>
/// 扫码推事件且弹出“消息接收中”提示框的事件推送的处理
/// </summary>
/// <param name="info">扫描信息</param>
/// <returns></returns>
public string HandleEventScancodeWaitmsg(RequestEventScancodeWaitmsg info, AccountInfo accountInfo)
{
string result = "";
try
{
var handler = AutoFactory.Instatnce.Container.Resolve<IQRCodeHandler>();
if (handler != null)
{
result = handler.HandleScancodeWaitmsg(info, accountInfo);
}
}
catch(Exception ex)
{
LogHelper.Error(ex);
}
return result;
}
对于其中之一的接口处理,我们都可以把它分拆,根据扫描的事件键值Key进行不同的信息相应。
/// <summary>
/// 扫描后,会等待事件处理结果返回给用户
/// </summary>
public string HandleScancodeWaitmsg(RequestEventScancodeWaitmsg info, AccountInfo accountInfo)
{
ResponseText response = new ResponseText(info);
response.Content = string.Format("您的信息为:{0},可以结合后台进行数据查询。", info.ScanCodeInfo.ScanResult);
var result = response.ToXml();
string devicecode = GetParam(info.ScanCodeInfo, "devicecode");//参数名为小写
if (!string.IsNullOrEmpty(devicecode))
{
switch(info.EventKey.ToLower())
{
case "device_view"://设备查看
{
var deviceinfo = BLLFactory<Device>.Instance.FindByCode(devicecode);
response.Content = ConvertDeviceInfo(deviceinfo);
result = response.ToXml();
}
break;
case "measure"://设备计量
{
var deviceinfo = BLLFactory<Device>.Instance.FindByCode(devicecode);
response.Content = ConvertMeasure(deviceinfo);
result = response.ToXml();
}
break;
case "repair"://设备报修,返回报修单号
{
var content = ConvertRepaire(info, accountInfo, devicecode);
response.Content = content;
result = response.ToXml();
}
break;
case "inventory"://设备盘点,转到盘点界面
{
var content = ConvertInventory(info, accountInfo, devicecode);
response.Content = content;
result = response.ToXml();
}
break;
case "maintain":
break;
case "check":
break;
case "device_add":
break;
}
}
return result;
}
以上就是关于使用Autofac实现一些常规接口处理的实现,这种控制反转的方式,可以便于我们项目的开发效率,可以根据需要指定一些特定的实现处理即可,而且通过配置文件的方式加载,可以很方便的进行配置。