[ASP.NET Core] Replaced custom SendGrid implementation with NuGet package

Author: NikolayIT

ASP.NET Core/Services/AspNetCoreTemplate.Services.Messaging/AspNetCoreTemplate.Services.Messaging.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>netstandard2.0</TargetFramework>
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
 
@@ -13,9 +13,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="3.1.0" />
-    <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="3.1.0" />
-    <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
+    <PackageReference Include="Sendgrid" Version="9.12.0" />
     <PackageReference Include="StyleCop.Analyzers" Version="1.2.0-beta.113" PrivateAssets="all">
       <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
     </PackageReference>

ASP.NET Core/Services/AspNetCoreTemplate.Services.Messaging/EmailAttachment.cs

@@ -0,0 +1,11 @@
+namespace AspNetCoreTemplate.Services.Messaging
+{
+    public class EmailAttachment
+    {
+        public byte[] Content { get; set; }
+
+        public string FileName { get; set; }
+
+        public string MimeType { get; set; }
+    }
+}

ASP.NET Core/Services/AspNetCoreTemplate.Services.Messaging/IEmailSender.cs

@@ -0,0 +1,10 @@
+namespace AspNetCoreTemplate.Services.Messaging
+{
+    using System.Collections.Generic;
+    using System.Threading.Tasks;
+
+    public interface IEmailSender
+    {
+        Task SendEmailAsync(string to, string subject, string htmlContent, IEnumerable<EmailAttachment> attachments = null);
+    }
+}

ASP.NET Core/Services/AspNetCoreTemplate.Services.Messaging/ISmsSender.cs

@@ -1,23 +1,12 @@
 namespace AspNetCoreTemplate.Services.Messaging
 {
+    using System.Collections.Generic;
     using System.Threading.Tasks;
 
-    using Microsoft.AspNetCore.Identity.UI.Services;
-
-    // This class is used by the application to send Email and SMS
-    // when you turn on two-factor authentication in ASP.NET Identity.
-    // For more details see this link https://go.microsoft.com/fwlink/?LinkID=532713
-    public class NullMessageSender : IEmailSender, ISmsSender
+    public class NullMessageSender : IEmailSender
     {
-        public Task SendEmailAsync(string email, string subject, string message)
-        {
-            // Plug in your email service here to send an email.
-            return Task.CompletedTask;
-        }
-
-        public Task SendSmsAsync(string number, string message)
+        public Task SendEmailAsync(string to, string subject, string htmlContent, IEnumerable<EmailAttachment> attachments = null)
         {
-            // Plug in your SMS service here to send a text message.
             return Task.CompletedTask;
         }
     }

ASP.NET Core/Services/AspNetCoreTemplate.Services.Messaging/NullMessageSender.cs

@@ -1,101 +1,52 @@
 namespace AspNetCoreTemplate.Services.Messaging
 {
     using System;
-    using System.Net.Http;
-    using System.Net.Http.Headers;
-    using System.Text;
+    using System.Collections.Generic;
+    using System.Linq;
     using System.Threading.Tasks;
 
-    using AspNetCoreTemplate.Services.Messaging.SendGrid;
+    using SendGrid;
+    using SendGrid.Helpers.Mail;
 
-    using Microsoft.AspNetCore.Identity.UI.Services;
-    using Microsoft.Extensions.Logging;
-
-    using Newtonsoft.Json;
-
-    // Documentation: https://sendgrid.com/docs/API_Reference/Web_API_v3/Mail/index.html
     public class SendGridEmailSender : IEmailSender
     {
-        private const string AuthenticationScheme = "Bearer";
-        private const string BaseUrl = "https://api.sendgrid.com/v3/";
-        private const string SendEmailUrlPath = "mail/send";
+        private readonly SendGridClient client;
 
-        private readonly string fromAddress;
-        private readonly string fromName;
-        private readonly HttpClient httpClient;
-        private readonly ILogger logger;
+        private readonly EmailAddress from;
 
-        public SendGridEmailSender(ILoggerFactory loggerFactory, string apiKey, string fromAddress, string fromName)
+        public SendGridEmailSender(string apiKey, string fromAddress, string fromName)
         {
-            if (loggerFactory == null)
-            {
-                throw new ArgumentNullException(nameof(loggerFactory));
-            }
-
-            if (string.IsNullOrWhiteSpace(apiKey))
-            {
-                throw new ArgumentOutOfRangeException(nameof(apiKey));
-            }
-
-            if (string.IsNullOrWhiteSpace(fromAddress))
-            {
-                throw new ArgumentOutOfRangeException(nameof(fromAddress));
-            }
-
-            if (string.IsNullOrWhiteSpace(fromName))
-            {
-                throw new ArgumentOutOfRangeException(nameof(fromName));
-            }
-
-            this.logger = loggerFactory.CreateLogger<SendGridEmailSender>();
-            this.httpClient = new HttpClient();
-            this.httpClient.DefaultRequestHeaders.Authorization =
-                new AuthenticationHeaderValue(AuthenticationScheme, apiKey);
-            this.httpClient.BaseAddress = new Uri(BaseUrl);
-            this.fromAddress = fromAddress;
-            this.fromName = fromName;
+            this.client = new SendGridClient(apiKey);
+            this.from = new EmailAddress(fromAddress, fromName);
         }
 
-        public async Task SendEmailAsync(string email, string subject, string message)
+        public async Task SendEmailAsync(string to, string subject, string htmlContent, IEnumerable<EmailAttachment> attachments = null)
         {
-            if (string.IsNullOrWhiteSpace(this.fromAddress))
-            {
-                throw new ArgumentOutOfRangeException(nameof(this.fromAddress));
-            }
-
-            if (string.IsNullOrWhiteSpace(email))
+            if (string.IsNullOrWhiteSpace(subject) && string.IsNullOrWhiteSpace(htmlContent))
             {
-                throw new ArgumentOutOfRangeException(nameof(email));
+                throw new ArgumentException("Subject and message should be provided.");
             }
 
-            if (string.IsNullOrWhiteSpace(subject) && string.IsNullOrWhiteSpace(message))
+            var toAddress = new EmailAddress(to);
+            var message = MailHelper.CreateSingleEmail(this.from, toAddress, subject, null, htmlContent);
+            if (attachments?.Any() == true)
             {
-                throw new ArgumentException("Subject and/or message must be provided.");
+                foreach (var attachment in attachments)
+                {
+                    message.AddAttachment(attachment.FileName, Convert.ToBase64String(attachment.Content), attachment.MimeType);
+                }
             }
 
-            var msg = new SendGridMessage(
-                new SendGridEmail(email),
-                subject,
-                new SendGridEmail(this.fromAddress, this.fromName),
-                message);
             try
             {
-                var json = JsonConvert.SerializeObject(msg);
-                var response = await this.httpClient.PostAsync(
-                    SendEmailUrlPath,
-                    new StringContent(json, Encoding.UTF8, "application/json"));
-
-                if (!response.IsSuccessStatusCode)
-                {
-                    // See if we can read the response for more information, then log the error
-                    var errorJson = await response.Content.ReadAsStringAsync();
-                    throw new Exception(
-                        $"SendGrid indicated failure! Code: {response.StatusCode}, reason: {errorJson}");
-                }
+                var response = await this.client.SendEmailAsync(message);
+                Console.WriteLine(response.StatusCode);
+                Console.WriteLine(await response.Body.ReadAsStringAsync());
             }
-            catch (Exception ex)
+            catch (Exception e)
             {
-                this.logger.LogError($"Exception during sending email: {ex}");
+                Console.WriteLine(e);
+                throw;
             }
         }
     }