src/OneScript.StandardLibrary/TypeDescriptions/TypeDescription.cs - develop - EvilBeaver/OneScript

src/OneScript.StandardLibrary/TypeDescriptions/TypeDescription.cs
342 строки12 KB
Mr-Rm
оптимизация ОписанияТипов
17 дек 2025, 23:55
17 дек 2025, 23:55daf1263
/*----------------------------------------------------------
This Source Code Form is subject to the terms of the 
Mozilla Public License, v.2.0. If a copy of the MPL 
was not distributed with this file, You can obtain one 
at http://mozilla.org/MPL/2.0/.
----------------------------------------------------------*/

using System.Collections.Generic;
using OneScript.Contexts;
using OneScript.Exceptions;
using OneScript.StandardLibrary.Collections;
using OneScript.Types;
using OneScript.Values;
using ScriptEngine.Machine;
using ScriptEngine.Machine.Contexts;

namespace OneScript.StandardLibrary.TypeDescriptions
{
	[ContextClass("ОписаниеТипов", "TypeDescription")]
	public class TypeDescription : AutoContext<TypeDescription>
	{
		private readonly List<BslTypeValue> _types = new List<BslTypeValue>();

		public TypeDescription(IEnumerable<BslTypeValue> types = null)
		{
			if (types != null)
			{
				_types.AddRange(types);
			}
			
			NumberQualifiers = new NumberQualifiers();
			StringQualifiers = new StringQualifiers();
			DateQualifiers = new DateQualifiers();
			BinaryDataQualifiers = new BinaryDataQualifiers();
		}

		internal TypeDescription(IEnumerable<BslTypeValue> types,
		                           NumberQualifiers numberQualifiers,
		                           StringQualifiers stringQualifiers,
		                           DateQualifiers   dateQualifiers,
		                           BinaryDataQualifiers binaryDataQualifiers)
		{
			if (types != null)
			{
				_types.AddRange(types);
			}

			NumberQualifiers = numberQualifiers;
			StringQualifiers = stringQualifiers;
			DateQualifiers = dateQualifiers;
			BinaryDataQualifiers = binaryDataQualifiers;
		}

		[ContextProperty("КвалификаторыЧисла", "NumberQualifiers")]
		public NumberQualifiers NumberQualifiers { get; }

		[ContextProperty("КвалификаторыСтроки", "StringQualifiers")]
		public StringQualifiers StringQualifiers { get; }

		[ContextProperty("КвалификаторыДаты", "DateQualifiers")]
		public DateQualifiers DateQualifiers { get; }

		[ContextProperty("КвалификаторыДвоичныхДанных", "BinaryDataQualifiers")]
		public BinaryDataQualifiers BinaryDataQualifiers { get; }

		[ContextMethod("Типы", "Types")]
		public ArrayImpl Types()
		{
			var result = ArrayImpl.Constructor();

			foreach (var type in _types)
			{
				result.Add(type);
			}

			return result;
		}

        internal IEnumerable<BslTypeValue> TypesInternal()
        {
	        return _types;
        }

		[ContextMethod("СодержитТип", "ContainsType")]
		public bool ContainsType(IValue type)
		{
			if (type is BslTypeValue typeVal)
			{
				if (typeVal.TypeValue.Equals(BasicTypes.Undefined))
				{
					// тип "Неопределено" содержится в любом явно определенном составном типе
					// и не содержится в типе Произвольный (когда явно не указан состав типов)
					//   или когда указан один конкретный тип
					return (_types.Count > 1);
				}
				return _types.Contains(typeVal);
			}

			throw RuntimeException.InvalidArgumentType(nameof(type));
		}

		private IValueAdjuster GetAdjusterForType(BslTypeValue type)
		{
			var value = type.TypeValue;
			
			if (value.Equals(BasicTypes.Number))
				return NumberQualifiers;

			if (value.Equals(BasicTypes.String))
				return StringQualifiers;

			if (value.Equals(BasicTypes.Date))
				return DateQualifiers;
			
			if (value.Equals(BasicTypes.Boolean))
				return new BooleanTypeAdjuster();

			if (value.Equals(BasicTypes.Undefined))
				return new UndefinedTypeAdjuster(); 

			return null;
		}

		[ContextMethod("ПривестиЗначение", "AdjustValue")]
		public IValue AdjustValue(IValue value = null)
		{
			if (_types.Count == 0)
			{
				return value ?? ValueFactory.Create();
			}

			if (value != null)
			{
				var valueType = new BslTypeValue(value.SystemType);
				if (ContainsType(valueType))
				{
					// Если такой тип у нас есть
					var adjuster = GetAdjusterForType(valueType);
					var adjustedValue = adjuster?.Adjust(value) ?? value;
					return adjustedValue;
				}
			}

			foreach (var type in _types)
			{
				var adjuster = GetAdjusterForType(type);
				var adjustedValue = adjuster?.Adjust(value);
				if (adjustedValue != null)
					return adjustedValue;
			}

			return ValueFactory.Create();
		}

		public static TypeDescription StringType(int length = 0,
			AllowedLengthEnum allowedLength = AllowedLengthEnum.Variable)
		{
            return new TypeDescription(new[] { new BslTypeValue(BasicTypes.String) },
				new NumberQualifiers(),
                new StringQualifiers(length, allowedLength),
				new DateQualifiers(),
				new BinaryDataQualifiers());
		}

		public static TypeDescription IntegerType(int length = 10,
			AllowedSignEnum allowedSign = AllowedSignEnum.Any)
		{
            return new TypeDescription(new[] { new BslTypeValue(BasicTypes.Number) },
                 new NumberQualifiers(length, 0, allowedSign),
                 new StringQualifiers(),
                 new DateQualifiers(),
                 new BinaryDataQualifiers());
		}

		public static TypeDescription BooleanType()
		{
            return new TypeDescription(new[] { new BslTypeValue(BasicTypes.Boolean) },
                  new NumberQualifiers(),
                  new StringQualifiers(),
                  new DateQualifiers(),
                  new BinaryDataQualifiers());
        }

        [ScriptConstructor]
		public static TypeDescription Constructor(
			TypeActivationContext context,
			BslValue source = null,
			BslValue p2 = null,
			BslValue p3 = null,
			BslValue p4 = null,
			BslValue p5 = null,
			BslValue p6 = null,
			BslValue p7 = null)
		{
			var builder = new TypeDescriptionBuilder();
			
			// параметры, которые заведомо не квалификаторы, заменяем на null, но оставляем,
			// чтобы указать номер параметра при выводе ошибки несоответствия типа
			var qualifiers = new[] { null, p2, p3, p4, p5, p6, p7 };
			
			if (source != null && source.SystemType != BasicTypes.Undefined)
			{
				if (source is TypeDescription typeDesc)
				{
					// Если 1 парарметр - ОписаниеТипов, то 2 - добавляемые типы, 3 - убираемые типы,
					builder.SourceDescription(typeDesc);

					var typesToAdd = CheckAndParseTypeList(context.TypeManager, p2, 2);
					var typesToRemove = CheckAndParseTypeList(context.TypeManager, p3, 3);

					builder.RemoveTypes(typesToRemove);
					builder.AddTypes(typesToAdd);

					qualifiers[1] = null; // эти параметры не квалификаторы
					qualifiers[2] = null; // эти параметры не квалификаторы
				}
				else if (source.SystemType == BasicTypes.String || source is ArrayImpl)
				{
					// Если 1 парарметр - Массив или строка, то это набор конкретных типов
					// остальные параметры (2 и далее) - клвалификаторы в произвольном порядке
					var typesList = CheckAndParseTypeList(context.TypeManager, source, 1);
					builder.AddTypes(typesList);
				}
				else
					throw RuntimeException.InvalidArgumentValue();
			} /* else 
				пустой первый параметр - нет объекта-основания
				добавляемые/вычитаемые типы не допускаются, квалификаторы игнорируются
				квалификакторы передаются только для контроля типов
			*/
			CheckAndAddQualifiers(builder, qualifiers);
			return builder.Build();
		}

		/// <summary>
		/// Преобразует входящий параметр в список типов.
		/// </summary>
		/// <param name="types">В качестве типов могут быть переданы Строка или Массив Типов</param>
		/// <param name="nParam">Номер параметра, который будет указан в исключении, если параметр typeList задан неверно</param>
		/// <exception cref="RuntimeException">Если typeList не может быть разобран как набор типов</exception>
		/// <returns>Список переданных типов, приведенный к конкретным TypeTypeValue</returns>
		private static List<BslTypeValue> CheckAndParseTypeList(ITypeManager typeManager, IValue types, int nParam)
		{
			if (types == null || types.SystemType == BasicTypes.Undefined)
				return new List<BslTypeValue>();
			
			if (types.SystemType == BasicTypes.String)
			{
				return FromTypeNames(typeManager, types.ToString());
			}
			if (types is ArrayImpl arrayOfTypes)
			{
				return FromArrayOfTypes(arrayOfTypes);
			}

			throw RuntimeException.InvalidNthArgumentType(nParam);
		}

		private static List<BslTypeValue> FromTypeNames(ITypeManager typeManager, string types)
		{
			var typeNames = types.Split(',');
			var typesList = new List<BslTypeValue>();
			foreach (var typeName in typeNames)
			{
				if (string.IsNullOrWhiteSpace(typeName))
					continue;

				var typeValue = new BslTypeValue(typeManager.GetTypeByName(typeName.Trim()));
				if (!typesList.Contains(typeValue))
					typesList.Add(typeValue);
			}

			return typesList;
		}

		private static List<BslTypeValue> FromArrayOfTypes(ArrayImpl arrayOfTypes)
		{
			var typesList = new List<BslTypeValue>();
			foreach (var type in arrayOfTypes)
			{
				if (type is BslTypeValue rawType)
				{
					typesList.Add(rawType);
				}
			}
			return typesList;
		}

		private static void CheckAndAddQualifiers(TypeDescriptionBuilder builder, BslValue[] parameters)
		{
			for (var i = 0; i < parameters.Length; i++)
			{
				var rawQualifier = parameters[i];
				if (rawQualifier != null && !rawQualifier.Equals(ValueFactory.Create()))
				{
					CheckAndAddOneQualifier(builder, rawQualifier, i + 1);
				}
			}
		}

		/// <summary>
		/// Проверяет, что переданный параметр является квалификатором типа.
		/// Если тип параметра не является квалификатором, бросает исключение с указанием номера параметра.
		/// </summary>
		/// <param name="builder">Построитель описания типов, которому будет присвоен квалификатор</param>
		/// <param name="qualifier">Проверяемый входящий параметр</param>
		/// <param name="nParam">Порядковый номер параметра для выброса исключения</param>
		/// <exception cref="RuntimeException">Если qualifier не является квалификатором типа</exception>
		private static void CheckAndAddOneQualifier(TypeDescriptionBuilder builder, IValue qualifier, int nParam)
		{
			switch (qualifier)
			{
				case NumberQualifiers nq:
					builder.SetNumberQualifiers(nq);
					break;

				case StringQualifiers sq:
					builder.SetStringQualifiers(sq);
					break;

				case DateQualifiers dq:
					builder.SetDateQualifiers(dq);
					break;

				case BinaryDataQualifiers bdq:
					builder.SetBinaryDataQualifiers(bdq);
					break;

				default:
					throw RuntimeException.InvalidNthArgumentType(nParam);
			}
		}
	}
	
	internal class UndefinedTypeAdjuster : IValueAdjuster
	{
		public IValue Adjust(IValue value)
		{
			return ValueFactory.Create();
		}
	}
}