First commit for LLBLGen Pro v2.6 version of HnD, pulled from svn

BL/AssemblyInfo.cs

@@ -0,0 +1,77 @@
+/*
+	This file is part of HnD.
+	HnD is (c) 2002-2007 Solutions Design.
+    http://www.llblgen.com
+	http://www.sd.nl
+
+	HnD is free software; you can redistribute it and/or modify
+	it under the terms of version 2 of the GNU General Public License as published by
+	the Free Software Foundation.
+
+	HnD is distributed in the hope that it will be useful,
+	but WITHOUT ANY WARRANTY; without even the implied warranty of
+	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+	GNU General Public License for more details.
+
+	You should have received a copy of the GNU General Public License
+	along with HnD, please see the LICENSE.txt file; if not, write to the Free Software
+	Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+using System.Reflection;
+using System.Runtime.CompilerServices;
+
+//
+// General Information about an assembly is controlled through the following 
+// set of attributes. Change these attribute values to modify the information
+// associated with an assembly.
+//
+[assembly: AssemblyTitle("SD.HnD.BL")]
+[assembly: AssemblyDescription("HnD's Business Logic Layer")]
+[assembly: AssemblyConfiguration("")]
+[assembly: AssemblyCompany("Solutions Design")]
+[assembly: AssemblyProduct("HnD, a .NET 2.0 Forum system using LLBLGen Pro")]
+[assembly: AssemblyCopyright("(c)2002-2006 Solutions Design")]
+[assembly: AssemblyTrademark("HnD, LLBLGen and LLBLGen Pro are trademarks of Solutions Design.")]
+[assembly: AssemblyCulture("")]		
+
+//
+// Version information for an assembly consists of the following four values:
+//
+//      Major Version
+//      Minor Version 
+//      Build Number
+//      Revision
+//
+// You can specify all the values or you can default the Revision and Build Numbers 
+// by using the '*' as shown below:
+
+[assembly: AssemblyVersion("2.0.0.0")]
+
+//
+// In order to sign your assembly you must specify a key to use. Refer to the 
+// Microsoft .NET Framework documentation for more information on assembly signing.
+//
+// Use the attributes below to control which key is used for signing. 
+//
+// Notes: 
+//   (*) If no key is specified, the assembly is not signed.
+//   (*) KeyName refers to a key that has been installed in the Crypto Service
+//       Provider (CSP) on your machine. KeyFile refers to a file which contains
+//       a key.
+//   (*) If the KeyFile and the KeyName values are both specified, the 
+//       following processing occurs:
+//       (1) If the KeyName can be found in the CSP, that key is used.
+//       (2) If the KeyName does not exist and the KeyFile does exist, the key 
+//           in the KeyFile is installed into the CSP and used.
+//   (*) In order to create a KeyFile, you can use the sn.exe (Strong Name) utility.
+//       When specifying the KeyFile, the location of the KeyFile should be
+//       relative to the project output directory which is
+//       %Project Directory%\obj\<configuration>. For example, if your KeyFile is
+//       located in the project directory, you would specify the AssemblyKeyFile 
+//       attribute as [assembly: AssemblyKeyFile("..\\..\\mykey.snk")]
+//   (*) Delay Signing is an advanced option - see the Microsoft .NET Framework
+//       documentation for more information on this.
+//
+[assembly: AssemblyDelaySign(false)]
+[assembly: AssemblyKeyFile("")]
+[assembly: AssemblyKeyName("")]

BL/ForumManager.cs

@@ -0,0 +1,247 @@
+/*
+	This file is part of HnD.
+	HnD is (c) 2002-2007 Solutions Design.
+    http://www.llblgen.com
+	http://www.sd.nl
+
+	HnD is free software; you can redistribute it and/or modify
+	it under the terms of version 2 of the GNU General Public License as published by
+	the Free Software Foundation.
+
+	HnD is distributed in the hope that it will be useful,
+	but WITHOUT ANY WARRANTY; without even the implied warranty of
+	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+	GNU General Public License for more details.
+
+	You should have received a copy of the GNU General Public License
+	along with HnD, please see the LICENSE.txt file; if not, write to the Free Software
+	Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+using System;
+using System.Data;
+using System.Text;
+using System.Collections;
+
+using SD.LLBLGen.Pro.ORMSupportClasses;
+using SD.HnD.DAL.EntityClasses;
+using SD.HnD.DAL;
+using SD.HnD.DAL.CollectionClasses;
+using SD.HnD.DAL.HelperClasses;
+using SD.HnD.DAL.FactoryClasses;
+
+namespace SD.HnD.BL
+{
+	/// <summary>
+	/// General forum management class. 
+	/// </summary>
+	public static class ForumManager
+	{
+		/// <summary>
+		/// Creates a new forum in the system, and locates this forum in the section iSectionID.
+		/// </summary>
+		/// <param name="sectionID">The section ID.</param>
+		/// <param name="forumName">Name of the forum.</param>
+		/// <param name="forumDescription">The forum description.</param>
+		/// <param name="hasRSSFeed">True if the forum has an RSS feed.</param>
+		/// <param name="defaultSupportQueueID">The ID of the default support queue for this forum. Can be null.</param>
+		/// <param name="defaultThreadListInterval">The default thread list interval.</param>
+		/// <param name="orderNo">The order no for the section. Sections are sorted ascending on orderno.</param>
+		/// <param name="maxAttachmentSize">Max. size of an attachment.</param>
+		/// <param name="maxNoOfAttachmentsPerMessage">The max no of attachments per message.</param>
+		/// <param name="newThreadWelcomeText">The new thread welcome text, as shown when a new thread is created. Can be null.</param>
+		/// <param name="newThreadWelcomeTextAsHTML">The new thread welcome text as HTML, is null when newThreadWelcomeText is null or empty.</param>
+		/// <returns>
+		/// ForumID of new forum or 0 if something went wrong.
+		/// </returns>
+		public static int CreateNewForum(int sectionID, string forumName, string forumDescription, bool hasRSSFeed, int? defaultSupportQueueID, 
+				int defaultThreadListInterval, short orderNo, int maxAttachmentSize, short maxNoOfAttachmentsPerMessage, 
+				string newThreadWelcomeText, string newThreadWelcomeTextAsHTML)
+		{
+			ForumEntity newForum = new ForumEntity();
+			newForum.SectionID = sectionID;
+			newForum.ForumDescription = forumDescription;
+			newForum.ForumName = forumName;
+			newForum.HasRSSFeed = hasRSSFeed;
+			newForum.DefaultSupportQueueID = defaultSupportQueueID;
+			newForum.DefaultThreadListInterval = Convert.ToByte(defaultThreadListInterval);
+			newForum.OrderNo = orderNo;
+			newForum.MaxAttachmentSize = maxAttachmentSize;
+			newForum.MaxNoOfAttachmentsPerMessage = maxNoOfAttachmentsPerMessage;
+			newForum.NewThreadWelcomeText = newThreadWelcomeText;
+			newForum.NewThreadWelcomeTextAsHTML = newThreadWelcomeTextAsHTML;
+			bool result = newForum.Save();
+			if(result)
+			{
+				// succeeded
+				return newForum.ForumID;
+			}
+			else
+			{
+				return 0;
+			}
+		}
+
+
+		/// <summary>
+		/// Modifies the given forum with the information given
+		/// </summary>
+		/// <param name="forumID">ID of forum to modify</param>
+		/// <param name="sectionID">ID of section to locate this forum in</param>
+		/// <param name="forumName">Name of the forum</param>
+		/// <param name="forumDescription">Short description of the forum.</param>
+		/// <param name="hasRSSFeed">True if the forum has an RSS feed.</param>
+		/// <param name="defaultSupportQueueID">The ID of the default support queue for this forum. Can be null.</param>
+		/// <param name="defaultThreadListInterval">The default thread list interval.</param>
+		/// <param name="orderNo">The order no for the section. Sections are sorted ascending on orderno.</param>
+		/// <param name="maxAttachmentSize">Max. size of an attachment.</param>
+		/// <param name="maxNoOfAttachmentsPerMessage">The max no of attachments per message.</param>
+		/// <param name="newThreadWelcomeText">The new thread welcome text, as shown when a new thread is created. Can be null.</param>
+		/// <param name="newThreadWelcomeTextAsHTML">The new thread welcome text as HTML, is null when newThreadWelcomeText is null or empty.</param>
+		/// <returns>True if succeeded, false otherwise</returns>
+		public static bool ModifyForum(int forumID, int sectionID, string forumName, string forumDescription, bool hasRSSFeed, int? defaultSupportQueueID,
+				int defaultThreadListInterval, short orderNo, int maxAttachmentSize, short maxNoOfAttachmentsPerMessage,
+				string newThreadWelcomeText, string newThreadWelcomeTextAsHTML)
+		{
+			ForumEntity forum = ForumGuiHelper.GetForum(forumID);
+			if(forum==null)
+			{
+				// not found
+				return false;	// doesn't exist
+			}
+			forum.SectionID = sectionID;
+			forum.ForumDescription = forumDescription;
+			forum.ForumName = forumName;
+			forum.HasRSSFeed = hasRSSFeed;
+			forum.DefaultSupportQueueID = defaultSupportQueueID;
+			forum.DefaultThreadListInterval = Convert.ToByte(defaultThreadListInterval);
+			forum.OrderNo = orderNo;
+			forum.MaxAttachmentSize = maxAttachmentSize;
+			forum.MaxNoOfAttachmentsPerMessage = maxNoOfAttachmentsPerMessage;
+			forum.NewThreadWelcomeText = newThreadWelcomeText;
+			forum.NewThreadWelcomeTextAsHTML = newThreadWelcomeTextAsHTML;
+			return forum.Save();
+		}
+
+
+		/// <summary>
+		/// Deletes the given forum from the system, including <b>all</b> threads in this forum and messages in those threads.
+		/// </summary>
+		/// <param name="forumID">Forum ID.</param>
+		/// <returns>True if succeeded, false otherwise</returns>
+		public static bool DeleteForum(int forumID)
+		{
+			// first all threads in this forum have to be removed, then this forum should be removed. Do this in one transaction.
+			Transaction trans = new Transaction(IsolationLevel.ReadCommitted, "DeleteForum");
+			try
+			{
+				PredicateExpression forumFilter = new PredicateExpression();
+				forumFilter.Add((ForumFields.ForumID == forumID));
+
+				// remove all threads in this forum
+                ThreadManager.DeleteAllThreadsInForum(forumID, trans);
+
+				// remove all ForumRoleForumActionRight entities for this forum
+				ForumRoleForumActionRightCollection forumRoleActionRights = new ForumRoleForumActionRightCollection();
+				trans.Add(forumRoleActionRights);
+				forumRoleActionRights.DeleteMulti(ForumRoleForumActionRightFields.ForumID == forumID);
+
+				// remove the forum entity. do this by executing a direct delete statement on the database
+				ForumCollection forums = new ForumCollection();
+				trans.Add(forums);
+				forums.DeleteMulti(forumFilter);
+				trans.Commit();
+				return true;
+			}
+			catch
+			{
+				// exception occured, rollback
+				trans.Rollback();
+				throw;
+			}
+			finally
+			{
+				trans.Dispose();
+			}
+		}
+
+
+		/// <summary>
+		/// Creates a new thread in the given forum and places the passed in message as the first message in the thread.
+		/// Caller should validate input parameters.
+		/// </summary>
+		/// <param name="forumID">Forum wherein the new thread will be placed</param>
+		/// <param name="userID">User who started this thread</param>
+		/// <param name="subject">Subject of the thread</param>
+		/// <param name="messageText">First message of the thread</param>
+		/// <param name="messageAsHTML">Message text as HTML</param>
+		/// <param name="isSticky">Flag if the thread is sticky / pinned (true) or not (false)</param>
+		/// <param name="userIDIPAddress">IP address of user calling this method</param>
+		/// <param name="defaultSupportQueueID">The ID of the default support queue for this forum. If not null, the thread created will be
+		/// added to the support queue with the ID specified.</param>
+		/// <param name="messageID">The message ID of the new message, which is the start message in the thread.</param>
+		/// <returns>ThreadID if succeeded, 0 if not.</returns>
+		public static int CreateNewThreadInForum(int forumID, int userID, string subject, string messageText, string messageAsHTML, bool isSticky, 
+				string userIDIPAddress, int? defaultSupportQueueID, bool subscribeToThread, out int messageID)
+		{
+			Transaction trans = new Transaction(IsolationLevel.ReadCommitted, "NewThread");
+			try
+			{
+				DateTime postDate = DateTime.Now;
+
+				ThreadEntity newThread = new ThreadEntity();
+				newThread.ForumID = forumID;
+				newThread.IsClosed = false;
+				newThread.IsSticky = isSticky;
+				newThread.StartedByUserID = userID;
+				newThread.Subject = subject;
+				newThread.ThreadLastPostingDate = postDate;
+
+				if(defaultSupportQueueID.HasValue)
+				{
+					// a support queue has been specified as the default support queue for this forum. Add the new thread to this support queue.
+					SupportQueueThreadEntity supportQueueThread = new SupportQueueThreadEntity();
+					supportQueueThread.QueueID = defaultSupportQueueID.Value;
+					supportQueueThread.PlacedInQueueByUserID = userID;
+					supportQueueThread.PlacedInQueueOn = DateTime.Now;
+					// assign the Thread property to the newly created thread entity, so this supportqueuethreadentity will be part of the graph
+					// of objects which will be saved.
+					supportQueueThread.Thread = newThread;
+				}
+
+				DateTime postingDate = DateTime.Now;
+				MessageEntity newMessage = new MessageEntity();
+				newMessage.MessageText = messageText;
+				newMessage.MessageTextAsHTML = messageAsHTML;
+				newMessage.PostedByUserID = userID;
+				newMessage.PostingDate = postingDate;
+				newMessage.PostedFromIP = userIDIPAddress;
+				newMessage.Thread = newThread;
+
+				// add the newMessage entity to the transaction object. All entities saved recursively will be added automatically
+				trans.Add(newMessage);
+
+				// save the complete graph
+				newMessage.Save(true);
+
+				messageID = newMessage.MessageID;
+				int threadID = newMessage.ThreadID;
+
+				// update thread statistics, this is the task for the message manager, and we pass the transaction object so the actions will run in
+				// the same transaction.
+				MessageManager.UpdateStatisticsAfterMessageInsert(threadID, userID, trans, postingDate, false, subscribeToThread);
+
+				trans.Commit();
+				return newThread.ThreadID;
+			}
+			catch(Exception)
+			{
+				trans.Rollback();
+				throw;
+			}
+			finally
+			{
+				trans.Dispose();
+			}
+		}
+	}
+}