.NET Core使用Autofac容器的DI依赖注入,IOC控制反转及AOP切面编程

2024-07-29 13:51:17

Autofac 容器

Autofac 是一款.NET IoC 容器 . 它管理类之间的依赖关系, 从而使 应用在规模及复杂性增长的情况下依然可以轻易地修改 . 它的实现方式是将常规的.net类当做组件处理.

安装 NuGet 程序包： Autofac 6.0.0
创建一个 ContainerBuiler
注册接口和实现关系
通过 ContainerBuiler 的 Build 方法，得到 IContainer 容器
通过 IContainer 容器获取实例
使用服务

ITestServiceA 和 TestServiceA

	public interface ITestServiceA
    {
        void Show();
    }

    public class TestServiceA : ITestServiceA
    {
        public TestServiceA()
        {
            Console.WriteLine($"{this.GetType().Name} 被构造了...");
        }

        public void Show()
        {
            Console.WriteLine($"This is a {this.GetType().Name} Instance...");
        }
    }

Program 中的 Main 方法

 var builder = new ContainerBuilder();
 builder.RegisterType<TestServiceA>().As<ITestServiceA>();
 var container = builder.Build();

 // 获取服务实例
 var testService = container.Resolve<ITestServiceA>();
 testService.Show();

Autofac 多种注入方式

ITestServiceB 和 TestServiceB

    public interface ITestServiceB
    {
        void Show();
    }

    public class TestServiceB : ITestServiceB
    {
        private ITestServiceA _testServiceA;

        public void SetService(ITestServiceA testServiceA)
        {
            _testServiceA = testServiceA;
        }

        public TestServiceB()
        {
            Console.WriteLine($"{this.GetType().Name} 被构造了...");
        }

        public void Show()
        {
            // _testServiceA.Show();
            Console.WriteLine($"This is a {this.GetType().Name} Instance...");
        }
    }

ITestServiceC 和 TestServiceC

    public interface ITestServiceC
    {
        void Show();
    }

    public class TestServiceC : ITestServiceC
    {
        public TestServiceC()
        {
            Console.WriteLine($"{this.GetType().Name} 被构造了...");
        }

        public void Show()
        {
            Console.WriteLine($"This is a {this.GetType().Name} Instance...");
        }
    }

ITestServiceD 和 TestServiceD

    public interface ITestServiceD
    {
        void Show();
    }

    public class TestServiceD : ITestServiceD
    {
        public ITestServiceA TestServiceA { get; set; }
        public ITestServiceB TestServiceB { get; set; }
        public ITestServiceC TestServiceC { get; set; }

        public TestServiceD()
        {
            Console.WriteLine($"{this.GetType().Name} 被构造了...");
        }

        public void Show()
        {
            // TestServiceA.Show();
            // TestServiceB.Show();
            // TestServiceC.Show();
            Console.WriteLine($"This is a {this.GetType().Name} Instance...");
        }
    }

构造函数注入

 var builder = new ContainerBuilder();
 builder.RegisterType<TestServiceA>().As<ITestServiceA>();
 builder.RegisterType<TestServiceB>().As<ITestServiceB>();
 builder.RegisterType<TestServiceC>().As<ITestServiceC>();
 builder.RegisterType<TestServiceD>().As<ITestServiceD>();
 var container = builder.Build();

 // 获取服务实例
 var testService = container.Resolve<ITestServiceA>();
 testService.Show();

属性注入

 var builder = new ContainerBuilder();
 builder.RegisterType<TestServiceA>().As<ITestServiceA>();
 builder.RegisterType<TestServiceB>().As<ITestServiceB>();
 builder.RegisterType<TestServiceC>().As<ITestServiceC>();
 builder.RegisterType<TestServiceD>().As<ITestServiceD>().PropertiesAutowired();
 var container = builder.Build();

 // 获取服务实例
 var testService = container.Resolve<ITestServiceD>();
 testService.Show();

方法注入

 var builder = new ContainerBuilder();
 builder.RegisterType<TestServiceA>().As<ITestServiceA>();
 builder.RegisterType<TestServiceB>().OnActivated(e =>
          e.Instance.SetService(e.Context.Resolve<ITestServiceA>())
 ).As<ITestServiceB>();
 builder.RegisterType<TestServiceC>().As<ITestServiceC>();
 builder.RegisterType<TestServiceD>().As<ITestServiceD>();
 var container = builder.Build();

 // 获取服务实例
 var testService = container.Resolve<ITestServiceB>();
 testService.Show();

Autofac 生命周期

InstancePerDependency ：默认模式，每次调用，都会重新实例化对象；每次请求都创建一个新的对象；

var builder = new ContainerBuilder();
builder.RegisterType<TestServiceA>().As<ITestServiceA>().InstancePerDependency();
var container = builder.Build();
var testServiceA = container.Resolve<ITestServiceA>();
var testServiceA1 = container.Resolve<ITestServiceA>();
Console.WriteLine(object.ReferenceEquals(testServiceA,testServiceA1));

SingleInstance ：单例模式，每次调用，都会使用同一个实例化的对象；每次都用同一个对象；

var builder = new ContainerBuilder();
builder.RegisterType<TestServiceA>().As<ITestServiceA>().SingleInstance();
var container = builder.Build();
var testServiceA = container.Resolve<ITestServiceA>();
var testServiceA1 = container.Resolve<ITestServiceA>();
Console.WriteLine(object.ReferenceEquals(testServiceA,testServiceA1));

InstancePerLifetimeScope ：同一个生命周期域中，每次调用，都会使用同一个实例化的对象；每次都用同一个对象；且每个不同的生命周期域中的实例是唯一的，不共享的。

var builder = new ContainerBuilder();
builder.RegisterType<TestServiceA>().As<ITestServiceA>().InstancePerLifetimeScope();
var container = builder.Build();
ITestServiceA testServiceA15;
ITestServiceA testServiceA16;
using (var scope1 = container.BeginLifetimeScope())
{
    var testServiceA11 = scope1.Resolve<ITestServiceA>();
    var testServiceA12 = scope1.Resolve<ITestServiceA>();
    Console.WriteLine(object.ReferenceEquals(testServiceA11,testServiceA12));
    testServiceA15 = testServiceA12;
}
using (var scope1 = container.BeginLifetimeScope())
{
    var testServiceA13 = scope1.Resolve<ITestServiceA>();
    var testServiceA14 = scope1.Resolve<ITestServiceA>();
    Console.WriteLine(object.ReferenceEquals(testServiceA13,testServiceA14));
    testServiceA16 = testServiceA14;
}
Console.WriteLine(object.ReferenceEquals(testServiceA15,testServiceA16));

InstancePerMatchingLifetimeScope ：同一个匹配的生命周期域中，每次调用，都会使用同一个实例化的对象；每次都用同一个对象；且每个不匹配的生命周期域中的实例是唯一的，不共享的。

var builder = new ContainerBuilder();
builder.RegisterType<TestServiceA>().As<ITestServiceA>()
    .InstancePerMatchingLifetimeScope("Run2948");
var container = builder.Build();
ITestServiceA testServiceA15;
ITestServiceA testServiceA16;
using (var scope1 = container.BeginLifetimeScope("Run2948"))
{
    var testServiceA11 = scope1.Resolve<ITestServiceA>();
    using (var scope2 = container.BeginLifetimeScope())
    {
        var testServiceA12 = scope2.Resolve<ITestServiceA>();
        Console.WriteLine(object.ReferenceEquals(testServiceA11,testServiceA12));
    }
    testServiceA15 = testServiceA11;
}
using (var scope1 = container.BeginLifetimeScope("Run2948"))
{
    var testServiceA13 = scope1.Resolve<ITestServiceA>();
    using (var scope2 = container.BeginLifetimeScope())
    {
        var testServiceA14 = scope2.Resolve<ITestServiceA>();
        Console.WriteLine(object.ReferenceEquals(testServiceA13,testServiceA14));
    }
    testServiceA16 = testServiceA13;
}
Console.WriteLine(object.ReferenceEquals(testServiceA15,testServiceA16));

InstancePerOwned ：在一个所拥有的实例创建的生命周期中，每次调用，都会使用同一个实例化的对象；每次都用同一个对象；（较少使用）
InstancePerHttpRequest ：同一次Http请求上下文中，每次调用，都会使用同一个实例化的对象；每次都用同一个对象；仅适用于 ASP.NET (CORE) MVC 或 WebForm 应用程序

Autofac 支持配置文件

安装 NuGet 程序包： Autofac.Extensions.DependencyInjection 7.1.0 、Autofac.Configuration 6.0.0
新建配置文件（指定接口和实现的对应关系） autofac.json:

{
 	"components":[
        {
            "type: "One.Services.TestServiceA,One",
            "services": [
            	{
            		"type": "One.Services.ITestServiceA,One"
        		}
            ],
    		"instanceScope": "single-instance",
    		"injectProperties": true
        },
        {
            "type: "One.Services.TestServiceB,One",
            "services": [
            	{
            		"type": "One.Services.ITestServiceB,One"
        		}
            ],
    		"instanceScope": "single-instance",
    		"injectProperties": true
        },
        {
            "type: "One.Services.TestServiceC,One",
            "services": [
            	{
            		"type": "One.Services.ITestServiceC,One"
        		}
            ],
    		"instanceScope": "single-instance",
    		"injectProperties": true
        },
        {
            "type: "One.Services.TestServiceD,One",
            "services": [
            	{
            		"type": "One.Services.ITestServiceD,One"
        		}
            ],
    		"instanceScope": "single-instance",
    		"injectProperties": true
        }
    ]
}

读取配置文件，完成服务对应关系的注册

var builder = new ContainerBuilder();
var config = new ConfigurationBuilder();
var configSource = new JsonConfigurationSource()
{
    Path = "Config/autofac.json",
    Optional = false,
    ReloadOnChange = true
};
config.Add(configSource);
var configModule = new ConfigurationModule(config.Build());
builder.RegisterModule(configModule);
var container = builder.Build();

 // 获取服务实例
 var testServiceA = container.Resolve<ITestServiceA>();
 var testServiceD = container.Resolve<ITestServiceD>();
 testServiceD.Show();

新建 ITestServiceA 的新版实现类 TestServiceUpdate

public class TestServiceUpdate : ITestServiceA
{
    public TestServiceUpdate()
    {
        Console.WriteLine($"{this.GetType().Name} 被构造了...");
    }

    public void Show()
    {
        Console.WriteLine($"This is a {this.GetType().Name} Instance...");
    }
}

通过修改配置文件 autofac.json 来实现快速实现 ITestServiceA 的实现的重新定义：

{
 	"components":[
        {
            "type: "One.Services.TestServiceUpdate,One",
            "services": [
            	{
            		"type": "One.Services.ITestServiceA,One"
        		}
            ],
    		"instanceScope": "single-instance",
    		"injectProperties": true
        },
		// ...

Autofac 整合 .NET 5 MVC

安装 NuGet 程序包： Autofac.Extensions.DependencyInjection 7.1.0
Program文件中指定 Autofac 工厂替换默认工厂：

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
              webBuilder.UseStartup<Startup>();
            }).UseServiceProviderFactory(new AutofacServiceProviderFactory());

在 Startup 类中增加 ConfigureContainer 方法：

	public void ConfigureContainer(ContainerBuilder builder)
    {
        builder.RegisterType<TestServiceA>().As<ITestServiceA>();
    }

通过控制器构造函数注入，获取实例

    [Route("api/[controller]")]
    [ApiController]
    public class ValuesController : ControllerBase
    {
        private readonly ITestServiceA _serviceA;

        public ValuesController(ITestServiceA serviceA
        {
            _serviceA = serviceA;
        }

        [HttpGet]
        public IActionResult Get()
        {
            _serviceA.Show();
            return Ok();
        }
    }

使用 IServiceCollection 注册的服务，将来也会交给 Autofac 管理

    public void ConfigureServices(IServiceCollection services)
    {
      #region IServiceCollection 注册的服务，将来也会交给 Autofac 处理

      services.AddTransient<ITestServiceA, TestServiceA>();
      services.AddTransient<ITestServiceB, TestServiceB>();
      services.AddTransient<ITestServiceC, TestServiceC>();

      #endregion
    }

    public void ConfigureContainer(ContainerBuilder builder)
    {
        // builder.RegisterType<TestServiceA>().As<ITestServiceA>();
        // builder.RegisterType<TestServiceB>().As<ITestServiceB>();
        // builder.RegisterType<TestServiceC>().As<ITestServiceC>();
        builder.RegisterType<TestServiceD>().As<ITestServiceD>();
    }

Autofac 支持控制器属性注入

控制器本身是一个类，它的实例其实是有 IControllerActivator 来创建的。

指定控制器的实例由容器来创建

    public void ConfigureServices(IServiceCollection services)
    {
        // ...

      #region 指定控制器的实例由容器来创建

      services.Replace(ServiceDescriptor.Transient<IControllerActivator, ServiceBasedControllerActivator>());

      #endregion
    }

注册控制器的抽象和具体的关系

 	public void ConfigureContainer(ContainerBuilder builder)
    {
        builder.RegisterType<TestServiceA>().As<ITestServiceA>().PropertiesAutowired();
        builder.RegisterType<TestServiceB>().As<ITestServiceB>();

        #region 注册所有控制器的关系及控制器实例化所需要的组件

        var controllersTypesInAssembly = typeof(Startup).Assembly.GetExportedTypes()
            .Where(type => typeof(ControllerBase).IsAssignableFrom(type)).ToArray();

        builder.RegisterTypes(controllersTypesInAssembly)
            .PropertiesAutowired();

        #endregion
    }

在控制器内定义属性

    [Route("api/[controller]")]
    [ApiController]
    public class ValuesController : ControllerBase
    {
        public ITestServiceA TestServiceA { get; set; }
        public ITestServiceB TestServiceB { get; set; }

        [HttpGet]
        public IActionResult Get()
        {
            TestServiceA.Show();
            TestServiceB.Show();
            return Ok();
        }
    }

扩展：自己控制哪些属性需要做依赖注入(默认是让控制器中的属性都依赖注入)

    [AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
    public class AutowaredAttribute : Attribute { }

    public class PropertySelector : IPropertySelector
    {
        public bool InjectProperty(PropertyInfo propertyInfo, object instance)
        {
            return propertyInfo.CustomAttributes.Any(ca => ca.AttributeType == typeof(AutowaredAttribute));
        }
    }

    public void ConfigureContainer(ContainerBuilder builder)
    {
        builder.RegisterType<TestServiceA>().As<ITestServiceA>();
        builder.RegisterType<TestServiceB>().As<ITestServiceB>();

        #region 注册所有控制器的关系及控制器实例化所需要的组件

        var controllersTypesInAssembly = typeof(Startup).Assembly.GetExportedTypes()
            .Where(type => typeof(ControllerBase).IsAssignableFrom(type)).ToArray();

        builder.RegisterTypes(controllersTypesInAssembly)
            .PropertiesAutowired(new PropertySelector());

        #endregion
    }

	[Route("api/[controller]")]
    [ApiController]
    public class ValuesController : ControllerBase
    {
        [Autowared]
        public ITestServiceA TestServiceA { get; set; }

        public ITestServiceB TestServiceB { get; set; }

        [HttpGet]
        public IActionResult Get()
        {
            TestServiceA.Show();
            TestServiceB.Show();
            return Ok();
        }
    }

Autofac 单实例多实现

 	public void ConfigureContainer(ContainerBuilder builder)
    {
        builder.RegisterType<TestServiceA>().As<ITestServiceA>();
        builder.RegisterType<TestServiceUpdate>().As<ITestServiceA>();
    }

如果多个实现同时注册，则后注册的实现就会覆盖先注册的实现，最后将返回最后一个注册的实现。
如果多个实现同时注册，可以通过一个 IEnumerable<实例> 来获取到所有的实现。

        private readonly IEnumerable<ITestServiceA> _testServiceAs;

        public ValuesController(IEnumerable<ITestServiceA> testServiceAs)
        {
            _testServiceAs = testServiceAs;
        }

当多个实现同时注册后，可以通过以下方式继续注册实例的所有实现。从而可以在控制器中直接使用具体实现类作为实现。

 	public void ConfigureContainer(ContainerBuilder builder)
    {
        builder.RegisterType<TestServiceA>().As<ITestServiceA>();
        builder.RegisterType<TestServiceUpdate>().As<ITestServiceA>();
        builder.RegisterSource(new AnyConcreteTypeNotAlreadyRegisteredSource(type => type.IsAssignableTo<ITestServiceA>()));
    }

        private readonly TestServiceA _testServiceA;
        private readonly TestServiceUpdate _testServiceUpdate;

        public ValuesController(TestServiceA testServiceA,TestServiceUpdate testServiceUpdate)
        {
            _testServiceA = testServiceA;
            _testServiceUpdate = testServiceUpdate;
        }

扩展：Autofac 的注册逻辑可以通过 Module 来拆分管理。

    public class AutofacModule : Autofac.Module
    {
        protected override void Load(ContainerBuilder builder)
        {
            // base.Load(builder);
            builder.RegisterType<TestServiceA>().As<ITestServiceA>();
            builder.RegisterType<TestServiceUpdate>().As<ITestServiceA>();
            builder.RegisterSource(new AnyConcreteTypeNotAlreadyRegisteredSource(type => type.IsAssignableTo<ITestServiceA>()));
        }
    }

 	public void ConfigureContainer(ContainerBuilder builder)
    {
 		// builder.RegisterModule(new AutofacModule());
        builder.RegisterModule<AutofacModule>();
    }

Autofac 支持 AOP

AOP 面向切面编程，通过预编译方式和运行期动态代理实现程序功能的统一维护的一种技术。Autofac 的AOP是通过 Castle（也是一个容器）项目的名为 Autofac.Extras.DynamicProxy 核心部分实现的，顾名思义其实现方式为动态代理。

安装 NuGet 程序包： Castle.Core 4.4.1 、Autofac.Extras.DynamicProxy 6.0.0
新建自定义 AOP 拦截器

 	public class CustomAutofacAop : IInterceptor
    {
        public void Intercept(IInvocation invocation)
        {
            {
                Console.WriteLine("方法执行前...");
            }

            invocation.Proceed();

            {
                Console.WriteLine("方法执行后...");
            }
        }
    }

在接口上标记需要使用的拦截器

[Intercept(typeof(CustomAutofacAop))]
public interface ITestServiceA
{
    void Show();
}

注册自定义拦截器，并允许实例接口使用拦截器

    public void ConfigureContainer(ContainerBuilder builder)
    {
		//builder.RegisterType<CustomAutofacAop>();
        builder.RegisterType(typeof(CustomAutofacAop));
        builder.RegisterType<TestServiceA>().As<ITestServiceA>();
        builder.RegisterType<TestServiceUpdate>().As<ITestServiceA>().EnableInterfaceInterceptors();
    }

在控制器中调用实例，即可成功执行 AOP 拦截器

	[Route("api/[controller]")]
    [ApiController]
    public class ValuesController : ControllerBase
    {
		private readonly TestServiceA _testServiceA;
        private readonly TestServiceUpdate _testServiceUpdate;

        public ValuesController(TestServiceA testServiceA,TestServiceUpdate testServiceUpdate)
        {
            _testServiceA = testServiceA;
            _testServiceUpdate = testServiceUpdate;
        }

        public IActionResult Get()
        {
            _testServiceA.Show();
            _testServiceUpdate.Show();
            return Ok();
        }
    }

到此这篇关于.NET Core使用Autofac容器的DI依赖注入,IOC控制反转及AOP切面编程的文章就介绍到这了。希望对大家的学习有所帮助，也希望大家多多支持我们。

.NET中IoC框架Autofac用法讲解

1 前置阅读在阅读本文章之前,你可以先阅读: 什么是依赖注入 2 简介 Autofac与C#语言的结合非常紧密,并学习它非常的简单,也是.NET领域最为流行的IoC框架之一. 3 使用首先,将Autofac的NuGet软件包安装到您的应用程序中. Autofac 然后,我们通过创建ContainerBuilder来注册组件. var builder = new ContainerBuilder(); builder.RegisterType<Knife>(); builder.Regist
.net6引入autofac框架

引入NuGet 注册Autofac 在Program的var app = builder.Build():前加上这段代码 builder.Host.UseServiceProviderFactory(new AutofacServiceProviderFactory()); builder.Host.ConfigureContainer<ContainerBuilder>(builder => { builder.RegisterType<LogRecordsService>
C# 利用Autofac批量接口注入依赖的问题小结

背景: 本人在一位大佬的Colder框架中看到了这个接口注入,然后呢就想学习一下ioc思想与di设计模式.此写法给我的感觉就是非常的优雅 ,优雅永不过时.关于接口注入具体是什么可以最后推荐的地址.话不多说,开撸. 安装: 打开nuget管理工具,将我下面标红色的包都进行安装(注:千万别安装错了,按照名字不差的安装) 使用: 我们新建一个DI的文件夹,在文件夹中增加一个接口:IDependency.cs namespace Coldairarrow { /// <summary> /// 注
C# 使用 Castle 实现 AOP及如何用 Autofac 集成 Castle

Castle 是 2003 年诞生于 Apache Avalon 项目,目的是为了创建一个IOC 框架.发展到现在已经有四个组件: ORM组件:ActiveRecord IOC组件:Windsor 动态代理组件:DynamicProxy Web MVC组件:MonoRail 本文主要介绍动态代理组件 Castle.DynamicProxy 基本用法 Castle.DynamicProxy 是通过 Emit 反射动态生成代理类来实现的,效率相对静态植入要慢一点,但比普通的反射又高一些.动态代理只
谈一谈autofac组件的实例范围

实例范围决定如何在请求之间共享服务. 原文地址:http://docs.autofac.org/en/latest/lifetime/instance-scope.html 每个依赖一个实例使用这个选项,每次请求服务都会返回一个新实例.使用 InstancePerDependency() 指定.这是默认选项.下面的代码,第2行和第3行是等价的. var builder = new ContainerBuilder(); builder.RegisterType<Worker>(); buil
NET Core 3.0 AutoFac内置DI替换的新姿势分享

.NET Core 3.0 和以往版本不同,替换AutoFac服务的方式有了一定的变化,在尝试着升级项目的时候出现了一些问题. 原来在NET Core 2.1时候,AutoFac返回一个 IServiceProvider 参数注入到ConfigureServices .NET Core 服务中,基本大痣是这样做的. 首先我们需要一个重写 Autofac.Module 的方法,这将用于将我们 Register [数据访问层] 以及 Services [逻辑层] 的注册. public class
.Net Core中使用Autofac替换自带的DI容器的示例

目录项目创建方案演示 .Net Core自带DI 不同的特性批量注入属性注入存储并提取容器实例为什么叫浅谈呢?就是字面上的意思,讲得比较浅,又不是不能用(这样是不对的)!!! Aufofac大家都不陌生了,说是.Net生态下最优秀的IOC框架那是一点都过分.用的人多了,使用教程也十分丰富,官网教程也比较详细(如果英文功底还不错的话). 那我为什么还要写这样一篇博客呢,一是用作学习笔记,二就是闲的. 废话不多说,开始正文项目创建云创建一个.Net Core Api项目,然后再添加一
浅析依赖注入框架Autofac的使用

下面通过代码给大家分享下依赖注入框架Autofac的使用,具体如下所示: Autofac是一款IOC框架,比较于其他的IOC框架,如Spring.NET,Unity,Castle等等所包含的,它很轻量级性能上也是很高的. 1)解压它的压缩包,主要看到Autofac.dll,Autofac.Configuration.dll,这也是本篇文章重点使用的Autofac的类库. 2)创建一个控制台工程,并且引用以上的DLL文件.创建一个数据库操作接口IDatabase.cs: /// <summary
ASP.Net Core基于EF6、Unitwork、Autofac实现Repository模式

一.实现的思路和结构图 Repository的共同性有一些公共的方法(增删改查), 这些方法无关于Repository操作的是哪个实体类,可以把这些方法定义成接口IRepository,然后有个基类BaseRepository实现该接口的方法.常见的方法,比如Find, Filter, Delete, Create等 Repository的差异性每个Repository类又会有一些差异性,应当允许它们能够继承BaseRepository之外,还能够再扩展自己的一些方法.所以每个类都可以再定义
.Net Core 之AutoFac的使用

目录 Autofac介绍组件的三种注册方式生命周期 AutoFac 在asp .net core中的使用本文不介绍IoC和DI的概念,如果你对Ioc之前没有了解的话,建议先去搜索一下相关的资料这篇文章将简单介绍一下AutoFac的基本使用以及在asp .net core中的应用 Autofac介绍组件的三种注册方式 1.反射 2.现成的实例(new) 3.lambda表达式 (一个执行实例化对象的匿名方法) 下面是一些简短的示例,我尽可能多的列出来一些常用的注册方式,同时在注释中解释下