User: johnsimons
Date: 2010/01/09 01:23 AM
Added:
/Core/trunk/src/Castle.Core/Smtp/
DefaultSmtpSender.cs, IEmailSender.cs
Modified:
/Core/trunk/src/
Changes.txt
/Core/trunk/src/Castle.Core/
Castle.Core-vs2008.csproj
Log:
Moving EmailSender into Core
File Changes:
Directory: /Core/trunk/src/Castle.Core/
=======================================
File [modified]: Castle.Core-vs2008.csproj
Delta lines: +243 -0
===================================================================
--- Core/trunk/src/Castle.Core/Smtp/DefaultSmtpSender.cs
(rev 0)
+++ Core/trunk/src/Castle.Core/Smtp/DefaultSmtpSender.cs 2010-01-09
08:23:37 UTC (rev 6602)
@@ -0,0 +1,244 @@
+// Copyright 2004-2009 Castle Project - http://www.castleproject.org/
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+namespace Castle.Core.Smtp
+{
+ #if !SILVERLIGHT
+
+ using System;
+ using System.Collections.Generic;
+ using System.ComponentModel;
+ using System.Net;
+ using System.Net.Mail;
+ using System.Security;
+ using System.Security.Permissions;
+
+ /// <summary>
+ /// Default <see cref="IEmailSender"/> implementation.
+ /// </summary>
+ public class DefaultSmtpSender : IEmailSender
+ {
+ private bool asyncSend;
+ private readonly string hostname;
+ private int port = 25;
+ private int? timeout;
+ private bool useSsl;
+ private readonly NetworkCredential credentials = new
NetworkCredential();
+
+ /// <summary>
+ /// This service implementation
+ /// requires a host name in order to work
+ /// </summary>
+ /// <param name="hostname">The smtp server name</param>
+ public DefaultSmtpSender(string hostname)
+ {
+ this.hostname = hostname;
+ }
+
+ /// <summary>
+ /// Gets or sets the port used to
+ /// access the SMTP server
+ /// </summary>
+ public int Port
+ {
+ get { return port; }
+ set { port = value; }
+ }
+
+ /// <summary>
+ /// Gets the hostname.
+ /// </summary>
+ /// <value>The hostname.</value>
+ public string Hostname
+ {
+ get { return hostname; }
+ }
+
+ /// <summary>
+ /// Gets or sets a value which is used to
+ /// configure if emails are going to be sent asyncrhonously or
not.
+ /// </summary>
+ public bool AsyncSend
+ {
+ get { return asyncSend; }
+ set { asyncSend = value; }
+ }
+
+ /// <summary>
+ /// Gets or sets a value that specifies
+ /// the amount of time after which a synchronous Send call
times out.
+ /// </summary>
+ public int Timeout
+ {
+ get { return timeout.HasValue ? timeout.Value : 0; }
+ set { timeout = value; }
+ }
+
+ /// <summary>
+ /// Gets or sets a value indicating whether the email should be
sent using
+ /// a secure communication channel.
+ /// </summary>
+ /// <value><c>true</c> if should use SSL; otherwise,
<c>false</c>.</value>
+ public bool UseSsl
+ {
+ get { return useSsl; }
+ set { useSsl = value; }
+ }
+
+ /// <summary>
+ /// Sends a message.
+ /// </summary>
+ /// <exception cref="ArgumentNullException">If any of the
parameters is null</exception>
+ /// <param name="from">From field</param>
+ /// <param name="to">To field</param>
+ /// <param name="subject">e-mail's subject</param>
+ /// <param name="messageText">message's body</param>
+ public void Send(String from, String to, String subject, String
messageText)
+ {
+ if (from == null) throw new
ArgumentNullException("from");
+ if (to == null) throw new ArgumentNullException("to");
+ if (subject == null) throw new
ArgumentNullException("subject");
+ if (messageText == null) throw new
ArgumentNullException("messageText");
+
+ Send(new MailMessage(from, to, subject, messageText));
+ }
+
+ /// <summary>
+ /// Sends a message.
+ /// </summary>
+ /// <exception cref="ArgumentNullException">If the message is
null</exception>
+ /// <param name="message">Message instance</param>
+ public void Send(MailMessage message)
+ {
+ if (message == null) throw new
ArgumentNullException("message");
+
+ if (asyncSend)
+ {
+ // The MailMessage must be diposed after
sending the email.
+ // The code creates a delegate for deleting the
mail and adds
+ // it to the smtpClient.
+ // After the mail is sent, the message is
disposed and the
+ // eventHandler removed from the smtpClient.
+ SmtpClient smtpClient = new
SmtpClient(hostname, port);
+ Configure(smtpClient);
+
+ Guid msgGuid = new Guid();
+ SendCompletedEventHandler sceh = null;
+ sceh = delegate(object sender,
AsyncCompletedEventArgs e)
+ {
+ if (msgGuid == (Guid)e.UserState)
+ message.Dispose();
+ // The handler itself, cannot be null,
test omitted
+ smtpClient.SendCompleted -= sceh;
+ };
+ smtpClient.SendCompleted += sceh;
+ smtpClient.SendAsync(message, msgGuid);
+ }
+ else
+ {
+ using (message)
+ {
+ SmtpClient smtpClient = new
SmtpClient(hostname, port);
+ Configure(smtpClient);
+
+ smtpClient.Send(message);
+ }
+ }
+ }
+
+ public void Send(IEnumerable<MailMessage> messages)
+ {
+ foreach (MailMessage message in messages)
+ {
+ Send(message);
+ }
+ }
+
+ /// <summary>
+ /// Gets or sets the domain.
+ /// </summary>
+ /// <value>The domain.</value>
+ public String Domain
+ {
+ get { return credentials.Domain; }
+ set { credentials.Domain = value; }
+ }
+
+ /// <summary>
+ /// Gets or sets the name of the user.
+ /// </summary>
+ /// <value>The name of the user.</value>
+ public String UserName
+ {
+ get { return credentials.UserName; }
+ set { credentials.UserName = value; }
+ }
+
+ /// <summary>
+ /// Gets or sets the password.
+ /// </summary>
+ /// <value>The password.</value>
+ public String Password
+ {
+ get { return credentials.Password; }
+ set { credentials.Password = value; }
+ }
+
+ /// <summary>
+ /// Configures the sender
+ /// with port information and eventual credential
+ /// informed
+ /// </summary>
+ /// <param name="smtpClient">Message instance</param>
+ protected virtual void Configure(SmtpClient smtpClient)
+ {
+ smtpClient.Credentials = null;
+
+ if (CanAccessCredentials && HasCredentials)
+ {
+ smtpClient.Credentials = credentials;
+ }
+
+ if (timeout.HasValue)
+ {
+ smtpClient.Timeout = timeout.Value;
+ }
+
+ if (useSsl)
+ {
+ smtpClient.EnableSsl = useSsl;
+ }
+ }
+
+ /// <summary>
+ /// Gets a value indicating whether credentials were informed.
+ /// </summary>
+ /// <value>
+ /// <see langword="true"/> if this instance has credentials;
otherwise, <see langword="false"/>.
+ /// </value>
+ private bool HasCredentials
+ {
+ get { return
!string.IsNullOrEmpty(credentials.UserName); }
+ }
+
+ private static bool CanAccessCredentials
+ {
+ get
+ {
+ return SecurityManager.IsGranted(new
SecurityPermission(SecurityPermissionFlag.UnmanagedCode));
+ }
+ }
+ }
+ #endif
Directory: /Core/trunk/src/Castle.Core/Smtp/
============================================
File [added]: DefaultSmtpSender.cs
Delta lines: +49 -0
===================================================================
--- Core/trunk/src/Castle.Core/Smtp/IEmailSender.cs
(rev 0)
+++ Core/trunk/src/Castle.Core/Smtp/IEmailSender.cs 2010-01-09 08:23:37 UTC
(rev 6602)
@@ -0,0 +1,49 @@
+// Copyright 2004-2009 Castle Project - http://www.castleproject.org/
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+namespace Castle.Core.Smtp
+{
+ #if !SILVERLIGHT
+
+ using System.Collections.Generic;
+ using System.Net.Mail;
+
+ /// <summary>
+ /// Email sender abstraction.
+ /// </summary>
+ public interface IEmailSender
+ {
+ /// <summary>
+ /// Sends a mail message.
+ /// </summary>
+ /// <param name="from">From field</param>
+ /// <param name="to">To field</param>
+ /// <param name="subject">E-mail's subject</param>
+ /// <param name="messageText">message's body</param>
+ void Send(string from, string to, string subject, string
messageText);
+
+ /// <summary>
+ /// Sends a <see cref="MailMessage">message</see>.
+ /// </summary>
+ /// <param name="message"><see cref="MailMessage">Message</see>
instance</param>
+ void Send(MailMessage message);
+
+ /// <summary>
+ /// Sends multiple <see cref="MailMessage">messages</see>.
+ /// </summary>
+ /// <param name="messages">List of <see
cref="MailMessage">messages</see></param>
+ void Send(IEnumerable<MailMessage> messages);
+ }
+ #endif
+}
File [added]: IEmailSender.cs
Delta lines: +1 -1
===================================================================
--- Core/trunk/src/Changes.txt 2010-01-08 20:50:35 UTC (rev 6601)
+++ Core/trunk/src/Changes.txt 2010-01-09 08:23:37 UTC (rev 6602)
@@ -1,7 +1,7 @@
Unreleased Changes
==================
-- none
+- Added IEmailSender interface and its default implementation
1.2.0 beta (2009-12-04)
Directory: /Core/trunk/src/
===========================
File [modified]: Changes.txt
Delta lines: +0 -0
===================================================================
--
You received this message because you are subscribed to the Google Groups
"Castle Project Commits" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/castle-project-commits?hl=en.
