Common-VS2019/SacsStandardBase/Base/ItemDocs/SaItemDoc.cs

using Sarand.Net.Standard.Base.Bus;
using Sarand.Net.Standard.Base.Core;
using Sarand.Net.Standard.Base.Utils;
using System;
using System.Collections.Generic;
using System.Text;

namespace Sarand.Net.Standard.Base.ItemDocs
{
	//=======================================================================
	public class SaItemDoc : SacsHierarchyItem
	{
		//-------------------------------------------------------------------
		// Columns.
		public enum Column
		{
			Pos = 0,
			Id,
			// Item Id.
			ItemType,
			ItemType_Desc,
			ItemId,
			// Item Doc properties.
			Category,
			Category_Desc,
			DocType,
			DocType_Desc,
			DescBrief,
			Folder,
			Filename,
			MimeType,
			// Common properties.
			Notes,
			Status,
			Status_Desc,
			Status_Ind,
			CreateOn_Date,
			UpdateOn_Date,
		}

		//-------------------------------------------------------------------
		/// <summary>Properties other than common.</summary>
		public class DataProperties
		{
			public ItemId ItemId { get; set; } = new ItemId();
			public SaItemDocConsole.Category Category { get; set; }
			public String DocType { get; set; } = String.Empty;
			public String DescBrief { get; set; } = String.Empty;
			public String Folder { get; set; } = String.Empty;
			public String Filename { get; set; } = String.Empty;
			public String MimeType { get; set; } = String.Empty;
			public short ItemTypeAutoAssign { get; set; }
		}

		//-------------------------------------------------------------------
		// Data.
		public new class Data : SacsHierarchyItem.Data
		{
			// Data members.
			private readonly DataProperties data = new DataProperties();
			// Construction.
			public Data ()
			{
				Status = DefaultStatus;
			}
			// Properties.
			public ItemId ItemId
			{
				get { return data.ItemId; }
				set { CheckChanged(data.ItemId, value); data.ItemId = value; }
			}
			public SaItemDocConsole.Category Category
			{
				get { return data.Category; }
				set { CheckChanged((int)data.Category, (int)value); data.Category = value; }
			}
			public String DocType
			{
				get { return data.DocType; }
				set { CheckChanged(data.DocType, value); data.DocType = value; }
			}
			public String DescBrief
			{
				get { return data.DescBrief; }
				set { CheckChanged(data.DescBrief, value); data.DescBrief = value; }
			}
			public String Folder
			{
				get { return data.Folder; }
				set { CheckChanged(data.Folder, value); data.Folder = value; }
			}
			public String Filename
			{
				get { return data.Filename; }
				set { CheckChanged(data.Filename, value); data.Filename = value; }
			}
			public String MimeType
			{
				get { return data.MimeType; }
				set { CheckChanged(data.MimeType, value); data.MimeType = value; }
			}
			public short ItemTypeAutoAssign
			{
				get { return data.ItemTypeAutoAssign; }
				set { CheckChanged(data.ItemTypeAutoAssign, value); data.ItemTypeAutoAssign = value; }
			}
			// Population.
			internal void PopulateFrom (Data data)
			{
				ItemId = data.ItemId;
				Category = data.Category;
				DocType = data.DocType;
				DescBrief = data.DescBrief;
				Folder = data.Folder;
				Filename = data.Filename;
				MimeType = data.MimeType;
				ItemTypeAutoAssign = data.ItemTypeAutoAssign;
				base.PopulateFrom(data);
			}
			public Data Clone ()
			{
				Data data = new Data();
				data.PopulateFrom(this);
				return data;
			}
		}

		//-------------------------------------------------------------------
		// Error field - identify properties with validation error.
		public new class ErrField : SacsHierarchyItem.ErrField
		{
			// Identifies the field that has invalid data.
			public ValidValue ItemType { get; set; } = ValidValue.Valid;
			public ValidValue ItemId { get; set; } = ValidValue.Valid;
			public ValidValue Category { get; set; } = ValidValue.Valid;
			public ValidValue DocType { get; set; } = ValidValue.Valid;
			public ValidValue DescBrief { get; set; } = ValidValue.Valid;
			public ValidValue Folder { get; set; } = ValidValue.Valid;
			public ValidValue Filename { get; set; } = ValidValue.Valid;
			public ValidValue MimeType { get; set; } = ValidValue.Valid;
			public ValidValue ItemTypeAutoAssign { get; set; } = ValidValue.Valid;
		}

		//-------------------------------------------------------------------
		// Data members.
		private readonly Data data = new Data();
		// Flags.
		public static readonly Byte Flag_AutoAssigned = 0x01;

		//-------------------------------------------------------------------
		// Construction.
		public SaItemDoc (SysId id, ItemId itemId, SaItemDocConsole.Category category) :
			base(id)
		{
			base.SetData(data);
			ItemId = itemId;
			Category = category;
			Status = DefaultStatus;
		}

		//-------------------------------------------------------------------
		// Status.
		private List<SaStatus> validStatuses = new List<SaStatus>()
		{
			SaStatus.Current,
			SaStatus.Deleted,
		};
		public static SaStatus DefaultStatus { get { return StatusCurrent; } }
		public static SaStatus StatusCurrent { get { return SaStatus.Current; } }
		public static List<SaStatus> ValidStatuses { get { return new List<SaStatus>(ValidStatuses); } }
		public static DataValue.TriStateType GetStatusTriState (SaStatus status)
		{
			if (status == SaStatus.Current) return DataValue.TriStateType.Green;
			if (status == SaStatus.Deleted) return DataValue.TriStateType.Purple;
			return DataValue.TriStateType.Unknown;
		}

		//-------------------------------------------------------------------
		// Properties.
		public Data GetData () { return data.Clone(); }
		public void SetData (Data data)
		{
			// Properties that cannot be changed if previously specified.
			if (ItemId.Type >= 0 && ItemId.Type != data.ItemId.Type)
				throw new NotSupportedException($"{SysUtil.Fn} Item type cannot be changed");
			if (SysId.IsValid(ItemId.Id) && SysId.ToInt(ItemId.Id) != SysId.ToInt(data.ItemId.Id))
				throw new NotSupportedException($"{SysUtil.Fn} Item Id cannot be changed");
			// Category.
			if ((int)data.Category < 1)
				data.Category = Category;
			if ((int)Category != 0 && Category != data.Category)
				throw new NotSupportedException($"{SysUtil.Fn} Category cannot be changed");
			// Populate individual properties to ensure that 'Changed' indicator is kept up to date.
			this.data.PopulateFrom(data);
		}
		public ItemId ItemId
		{
			get { return data.ItemId; }
			protected set { data.ItemId = value; }
		}
		public SaItemDocConsole.Category Category
		{
			get { return data.Category; }
			protected set { data.Category = value; }
		}
		public String DocType
		{
			get { return data.DocType; }
			set { data.DocType = value; }
		}
		public String DescBrief
		{
			get { return data.DescBrief; }
			set { data.DescBrief = value; }
		}
		public String Folder
		{
			get { return data.Folder; }
			set { data.Folder = value; }
		}
		public String Filename
		{
			get { return data.Filename; }
			set { data.Filename = value; }
		}
		public String MimeType
		{
			get { return data.MimeType; }
			set { data.MimeType = value; }
		}
		public short ItemTypeAutoAssign
		{
			get { return data.ItemTypeAutoAssign; }
			set { data.ItemTypeAutoAssign = value; }
		}

		//-------------------------------------------------------------------
		// Flags.
		public bool AutoAssigned
		{
			get { return GetFlag(Flag_AutoAssigned); }
			set { SetFlag(Flag_AutoAssigned, value); }
		}

		//-------------------------------------------------------------------
		// Comparison.
		public bool Matches (ItemId itemId)
		{
			if (ItemId.Type != itemId.Type) return false;
			if (SysId.ToInt(ItemId.Id) != SysId.ToInt(itemId.Id)) return false;
			return true;
		}
		public bool Matches (ItemId itemId, SaItemDocConsole.Category category)
		{
			if (!Matches(itemId)) return false;
			if (Category != category) return false;
			return true;
		}
		public bool Matches (ItemId itemId, SaItemDocConsole.Category category, String docType)
		{
			if (!Matches(itemId, category)) return false;
			if (!DocType.EqualsCI(docType)) return false;
			return true;
		}

		//-------------------------------------------------------------------
		// List parameters.
		public enum StatusCat
		{
			Any,
			NotDeleted,
			CurrentOnly,
			DeletedOnly,
		}
		/// <summary>
		/// Item list parameters.
		/// </summary>
		public new class Params : SacsHierarchyItem.Params
		{
			public HashSet<SysId> IdsIncluded { get; } = new HashSet<SysId>();
			public HashSet<SysId> IdsExcluded { get; } = new HashSet<SysId>();
			public HashSet<ItemId> ItemIdsIncluded { get; } = new HashSet<ItemId>();
			public SaItemDocConsole.Category Category { get; set; }
			public String DocType { get; set; }
			public String DescBriefPartial { get; set; }
			public String MimeType { get; set; }
			public String FolderFull { get; set; }
			public String FolderPartial { get; set; }
			public String FilenameFull { get; set; }
			public short ItemTypeAutoAssign { get; set; }
			public StatusCat StatusCat { get; set; } = StatusCat.NotDeleted;
		}

		//-------------------------------------------------------------------
	}

	//=======================================================================
	/// <summary>List extension methods.</summary>
	public static class SaItemDocList
	{
		public static List<SaItemDoc> FindByItem (this List<SaItemDoc> values, ItemId itemId)
		{
			return values.FindAll(item => item.Matches(itemId));
		}
		public static List<SaItemDoc> FindByItemDocCategory (this List<SaItemDoc> values, ItemId itemId, SaItemDocConsole.Category category)
		{
			return values.FindAll(item => item.Matches(itemId, category));
		}
	}

	//=======================================================================
}