using System; using System.Reflection; namespace StardewModdingAPI.Framework.Reflection { /// A field obtained through reflection. /// The field value type. internal class ReflectedField : IReflectedField { /********* ** Fields *********/ /// The type that has the field. private readonly Type ParentType; /// The object that has the instance field, or null for a static field. private readonly object? Parent; /// The display name shown in error messages. private string DisplayName => $"{this.ParentType.FullName}::{this.FieldInfo.Name}"; /********* ** Accessors *********/ /// public FieldInfo FieldInfo { get; } /********* ** Public methods *********/ /// Construct an instance. /// The type that has the field. /// The object that has the instance field, or null for a static field. /// The reflection metadata. /// Whether the field is static. /// The or is null. /// The is null for a non-static field, or not null for a static field. public ReflectedField(Type parentType, object? obj, FieldInfo field, bool isStatic) { // validate if (parentType == null) throw new ArgumentNullException(nameof(parentType)); if (field == null) throw new ArgumentNullException(nameof(field)); if (isStatic && obj != null) throw new ArgumentException("A static field cannot have an object instance."); if (!isStatic && obj == null) throw new ArgumentException("A non-static field must have an object instance."); // save this.ParentType = parentType; this.Parent = obj; this.FieldInfo = field; } /// public TValue GetValue() { try { return (TValue)this.FieldInfo.GetValue(this.Parent)!; } catch (InvalidCastException) { throw new InvalidCastException($"Can't convert the {this.DisplayName} field from {this.FieldInfo.FieldType.FullName} to {typeof(TValue).FullName}."); } catch (Exception ex) { throw new Exception($"Couldn't get the value of the {this.DisplayName} field", ex); } } /// public void SetValue(TValue value) { try { this.FieldInfo.SetValue(this.Parent, value); } catch (InvalidCastException) { throw new InvalidCastException($"Can't assign the {this.DisplayName} field a {typeof(TValue).FullName} value, must be compatible with {this.FieldInfo.FieldType.FullName}."); } catch (Exception ex) { throw new Exception($"Couldn't set the value of the {this.DisplayName} field", ex); } } } }