view API/Objects/Requirement/RequiresNoMoreThanNOfUnitTypeRequirement.cs @ 419:71fceea2725b

Code tidy-up - remove warnings * Add missing GetHashcode() implementations * Remove unused exception variables * Use unused event * Remove dead code * Properly override some methods
author IBBoard <dev@ibboard.co.uk>
date Sun, 25 Sep 2011 20:52:27 +0100
parents 0dd8dbe8afe9
children 3882b533d99d
line wrap: on
line source

// This file (RequiresNoMoreThanNOfUnitTypeRequirement.cs) is a part of the IBBoard.WarFoundry.API project and is copyright 2011 IBBoard
// 
// The file and the library/program it is in are licensed and distributed, without warranty, under the GNU Affero GPL license, either version 3 of the License or (at your option) any later version. Please see COPYING for more information and the full license.
using System;
using IBBoard.WarFoundry.API.Objects;
using System.Collections.Generic;
using System.Text;

namespace IBBoard.WarFoundry.API.Objects.Requirement
{
	/// <summary>
	/// A requirement where a WarFoundryObject cannot be taken in an army if more than N of a UnitType will be in the army.
	/// </summary>
	public class RequiresNoMoreThanNOfUnitTypeRequirement : AbstractRequirement
	{
		private List<UnitCountRequirementData> limitedTypes;

		public RequiresNoMoreThanNOfUnitTypeRequirement(params UnitType[] limitedUnitTypes)
		{
			FailureStringPrefix = "Army cannot contain more than: ";
			limitedTypes = new List<UnitCountRequirementData>();

			foreach (UnitType unitType in limitedUnitTypes)
			{
				AddUnitTypeRequirement(unitType);
			}
		}

		/// <summary>
		/// Checks whether the supplied WarFoundryObject can be added to the supplied army.
		/// </summary>
		/// <returns>
		/// A <code>Validation</code> enum to show the result of the validation
		/// </returns>
		/// <param name='wfObject'>
		/// The object that we want to add. This may be involved in the check, or it may not affect the evaluation of the requirement
		/// </param>
		/// <param name='toArmy'>
		/// The army to add the object to.
		/// </param>
		public override Validation AllowsAdding(WarFoundryObject wfObject, Army toArmy)
		{
			Validation canAdd = Validation.Passed;
			
			foreach (UnitCountRequirementData limit in limitedTypes)
			{
				if (GetUnitTypeCount(toArmy, limit.UnitType, wfObject) > limit.Count)
				{
					canAdd = Validation.Failed;
					break;
				}
			}
			
			return canAdd;
		}

		private int GetUnitTypeCount(Army toArmy, UnitType unitType, WarFoundryObject wfObject)
		{
			return toArmy.GetUnitTypeCount(unitType) + GetCountFromObject(wfObject, unitType);
		}

		private int GetCountFromObject(WarFoundryObject wfObject, UnitType limitedType)
		{
			return (limitedType.Equals(wfObject) || (wfObject is Unit && ((Unit)wfObject).UnitType.Equals(limitedType))) ? 1 : 0;
		}

		/// <summary>
		/// Adds a requirement for there to be no more than maxCount of a given UnitType
		/// </summary>
		/// <param name='unitType'>
		/// The unit type to limit.
		/// </param>
		/// <param name='minCount'>
		/// The maximum number of that type that must exist.
		/// </param>
		public void AddUnitTypeRequirement(UnitType unitType, int maxCount)
		{
			limitedTypes.Add(new UnitCountRequirementData(unitType, maxCount));
		}

		/// <summary>
		/// Adds a requirement for there to be none of a given UnitType
		/// </summary>
		/// <param name='unitType'>
		/// The unit type to limit.
		/// </param>
		public void AddUnitTypeRequirement(UnitType unitType)
		{
			AddUnitTypeRequirement(unitType, 0);
		}

		/// <summary>
		/// Checks whether the supplied army is currently valid according to this requirement.
		/// </summary>
		/// <returns>
		/// A <code>Validation</code> enum to show the result of the validation
		/// </returns>
		/// <param name='toValidate'>
		/// The army to validate
		/// </param>
		public override Validation ValidatesArmy(Army army)
		{
			Validation canAdd = Validation.Passed;
			
			foreach (UnitCountRequirementData limit in limitedTypes)
			{
				if (army.GetUnitTypeCount(limit.UnitType) > limit.Count)
				{
					canAdd = Validation.Failed;
					break;
				}
			}
			
			return canAdd;
		}

		protected override bool TypeEquals(object obj)
		{
			RequiresNoMoreThanNOfUnitTypeRequirement other = (RequiresNoMoreThanNOfUnitTypeRequirement)obj;
			return Collections.Collections.AreEqual(limitedTypes, other.limitedTypes);
		}

		public override int GetHashCode()
		{
			int hash = 0;

			foreach (UnitCountRequirementData limit in limitedTypes)
			{
				hash += limit.UnitType.GetHashCode();
			}

			return hash;
		}

		protected string FailureStringPrefix { get; set; }

		protected override string GetValidationFailedMessage (Army army)
		{
			StringBuilder sb = new StringBuilder();
			sb.Append(FailureStringPrefix);
			sb.Append(String.Join("; ", GetFailedRequirements(army).ToArray()));
			sb.Append(".");
			return sb.ToString();
		}

		private List<string> GetFailedRequirements(Army army)
		{
			List<string> failures = new List<string>();

			foreach (UnitCountRequirementData requirement in limitedTypes)
			{
				int unitCount = army.GetUnitTypeCount(requirement.UnitType);

				if (unitCount > requirement.Count)
				{
					failures.Add(requirement.Count + " × " + requirement.UnitType.Name + " (have " + unitCount + ")");
				}
			}

			return failures;
		}

		protected override string GetAllowsAddingFailedMessage(UnitType toAdd, Army toArmy)
		{
			StringBuilder sb = new StringBuilder();
			sb.Append(FailureStringPrefix);
			sb.Append(String.Join("; ", GetFailedAddingRequirements(toAdd, toArmy).ToArray()));
			sb.Append(".");
			return sb.ToString();
		}

		private List<string> GetFailedAddingRequirements(UnitType unitType, Army army)
		{
			List<string> failures = new List<string>();

			foreach (UnitCountRequirementData requirement in limitedTypes)
			{
				int unitCount = GetUnitTypeCount(army, requirement.UnitType, unitType);

				if (unitCount > requirement.Count)
				{
					failures.Add(requirement.Count + " × " + requirement.UnitType.Name + " (would have " + unitCount + ")");
				}
			}

			return failures;
		}
	}
}