.NET 6 实现滑动验证码（四）、扩展类

为了能够通过配置文件（appsettings.json）或通过代码进行背景图片与模板进行配置、可自定义资源类型、自定义验证规则，本节创建一些扩展类，用来实现这些功能。
上一节内容：NET 6 实现滑动验证码（三）、接口

扩展类都放在了Extensions文件夹下

目录

• CaptchaBuilderExtensions.cs
  
• CaptchaServiceCollectionExtensions.cs
  
• ServiceCollectionExtensions.cs
  
• SlideCaptchaException.cs
  

CaptchaBuilderExtensions.cs

CaptchaBuilderExtensions.cs实现了自定义提供验证码背景图片资源或模板资源、自定义实现资源类型、替换默认验证规则、禁用默认凹槽模板

1. using SlideCaptcha;
2. using SlideCaptcha.Interface;
3. using SlideCaptcha.Resources.Provider;
4. using System.Linq;
6. namespace Microsoft.Extensions.DependencyInjection
7. {
8.     public static class CaptchaBuilderExtensions
9.     {
10.         /// <summary>
11.         /// 自定义提供验证码背景图片资源或模板资源
12.         /// </summary>
13.         /// <typeparam name="TProvider">自定义实现</typeparam>
14.         /// <param name="builder"></param>
15.         /// <returns></returns>
16.         public static CaptchaBuilder AddResourceProvider<TProvider>(this CaptchaBuilder builder) where TProvider : class, IResourceProvider
17.         {
18.             builder.Services.AddSingleton<IResourceProvider, TProvider>();
19.             return builder;
20.         }
21.         /// <summary>
22.         /// 自定义实现资源类型
23.         /// </summary>
24.         /// <typeparam name="THandler">自定义实现</typeparam>
25.         /// <param name="builder"></param>
26.         /// <returns></returns>
27.         public static CaptchaBuilder AddResourceHandler<THandler>(this CaptchaBuilder builder) where THandler : class, IResourceHandler
28.         {
29.             builder.Services.AddSingleton<IResourceHandler, THandler>();
30.             return builder;
31.         }
32.         /// <summary>
33.         /// 替换默认的验证规则
34.         /// </summary>
35.         /// <typeparam name="TValidator">自定义验证规则</typeparam>
36.         /// <param name="builder"></param>
37.         /// <returns></returns>
38.         public static CaptchaBuilder ReplaceValidator<TValidator>(this CaptchaBuilder builder) where TValidator : class, IValidator
39.         {
40.             builder.Services.Replace<IValidator, TValidator>();
41.             return builder;
42.         }
43.         /// <summary>
44.         /// 禁用默认凹槽模板
45.         /// </summary>
46.         /// <param name="builder"></param>
47.         /// <returns></returns>
48.         public static CaptchaBuilder DisableDefaultTemplates(this CaptchaBuilder builder)
49.         {
50.             var serviceDescriptor = builder.Services.FirstOrDefault(e => e.ImplementationType == typeof(EmbeddedResourceProvider));
51.             if (serviceDescriptor != null)
52.             {
53.                 builder.Services.Remove(serviceDescriptor);
54.             }
56.             return builder;
57.         }
58.     }
59. }

复制代码

CaptchaServiceCollectionExtensions.cs

CaptchaServiceCollectionExtensions.cs为自动注入必要的接口

1. using Microsoft.Extensions.Configuration;
2. using SlideCaptcha;
3. using SlideCaptcha.Constant;
4. using SlideCaptcha.Generator;
5. using SlideCaptcha.Interface;
6. using SlideCaptcha.Resources;
7. using SlideCaptcha.Resources.Handler;
8. using SlideCaptcha.Resources.Provider;
9. using SlideCaptcha.Storage;
10. using SlideCaptcha.Validator;
11. using System;
13. namespace Microsoft.Extensions.DependencyInjection
14. {
15.     public static class CaptchaServiceCollectionExtensions
16.     {
17.         /// <summary>
18.         /// 依赖注入必要的接口。
19.         /// </summary>
20.         /// <param name="services"></param>
21.         /// <param name="configuration"></param>
22.         /// <param name="optionsAction"></param>
23.         /// <returns></returns>
24.         public static CaptchaBuilder AddSlideCaptcha(this IServiceCollection services, IConfiguration configuration, Action<CaptchaOptions> optionsAction = default)
25.         {
26.             services.Configure<CaptchaOptions>(configuration?.GetSection("SlideCaptcha"));
27.             //对所需验证的参数进行检查，如果参数不合法就抛一个异常出来
28.             if (optionsAction != null) services.PostConfigure(optionsAction);
30.             var builder = new CaptchaBuilder(services);
31.             services.AddSingleton<IResourceProvider, OptionsResourceProvider>();
32.             services.AddSingleton<IResourceProvider, EmbeddedResourceProvider>();
33.             services.AddSingleton<IResourceHandlerManager, CachedResourceHandlerManager>();
34.             services.AddSingleton<IResourceManager, DefaultResourceManager>();
35.             services.AddSingleton<ISliderCaptchaImageGenerator, SliderCaptchaImageGenerator>();
36.             services.AddSingleton<IResourceHandler, FileResourceHandler>();
37.             services.AddSingleton<IResourceHandler, EmbeddedResourceHandler>();
38.             services.AddScoped<ICaptcha, ImageCaptcha>();
39.             services.AddScoped<IStorage, DefaultStorage>();
40.             services.AddScoped<IValidator, SimpleValidator>();
41.             return builder;
42.         }
43.     }
44. }

复制代码

ServiceCollectionExtensions.cs

ServiceCollectionExtensions.cs用于实现IServiceCollection的Replace方法

1. using System;
2. using System.Collections.Generic;
3. using System.Linq;
6. namespace Microsoft.Extensions.DependencyInjection
7. {
8.     public static class ServiceCollectionExtensions
9.     {
10.         public static IServiceCollection Replace<TService, TImplementation>(this IServiceCollection services)
11.                where TImplementation : TService
12.         {
13.             return services.Replace<TService>(typeof(TImplementation));
14.         }
16.         public static IServiceCollection Replace<TService>(this IServiceCollection services, Type implementationType)
17.         {
18.             return services.Replace(typeof(TService), implementationType);
19.         }
21.         public static IServiceCollection Replace(this IServiceCollection services, Type serviceType, Type implementationType)
22.         {
23.             if (services == null)
24.             {
25.                 throw new ArgumentNullException(nameof(services));
26.             }
28.             if (serviceType == null)
29.             {
30.                 throw new ArgumentNullException(nameof(serviceType));
31.             }
33.             if (implementationType == null)
34.             {
35.                 throw new ArgumentNullException(nameof(implementationType));
36.             }
38.             if (!services.TryGetDescriptors(serviceType, out var descriptors))
39.             {
40.                 throw new ArgumentException($"No services found for {serviceType.FullName}.", nameof(serviceType));
41.             }
43.             foreach (var descriptor in descriptors)
44.             {
45.                 var index = services.IndexOf(descriptor);
47.                 services.Insert(index, descriptor.WithImplementationType(implementationType));
49.                 services.Remove(descriptor);
50.             }
52.             return services;
53.         }
55.         private static bool TryGetDescriptors(this IServiceCollection services, Type serviceType, out ICollection<ServiceDescriptor> descriptors)
56.         {
57.             return (descriptors = services.Where(service => service.ServiceType == serviceType).ToArray()).Any();
58.         }
60.         private static ServiceDescriptor WithImplementationType(this ServiceDescriptor descriptor, Type implementationType)
61.         {
62.             return new ServiceDescriptor(descriptor.ServiceType, implementationType, descriptor.Lifetime);
63.         }
64.     }
65. }

复制代码

SlideCaptchaException.cs

SlideCaptchaException.cs 实现自定义异常信息。

1. using System;
3. namespace SlideCaptcha.Exceptions
4. {
5.     public class SlideCaptchaException : Exception
6.     {
7.         public SlideCaptchaException() : base()
8.         {
9.         }
11.         public SlideCaptchaException(string message) : base(message)
12.         {
13.         }
15.         public SlideCaptchaException(string message, Exception innerException) : base(message, innerException)
16.         {
17.         }
18.     }
19. }

复制代码

下载方式：
扫描公众号二维码，或搜索公众号fenxiang3389关注我，回复captcha下载，压缩包包含了验证码类库、服务端API、HTML+JQuery完整代码、vue3组件代码及演示代码！

欢迎大家关注我的微信公众号，一起进步，一起成长
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！