using System;
using System.Collections.Generic;
using System.Linq;
using System.Reflection;
using StardewModdingAPI.Events;
using StardewModdingAPI.Internal;
namespace StardewModdingAPI.Framework.Events
{
/// An event wrapper which intercepts and logs errors in handler code.
/// The event arguments type.
internal class ManagedEvent : IManagedEvent
{
/*********
** Fields
*********/
/// The mod registry with which to identify mods.
protected readonly ModRegistry ModRegistry;
/// The underlying event handlers.
private readonly List> Handlers = new();
/// A cached snapshot of , or null to rebuild it next raise.
private ManagedEventHandler[]? CachedHandlers = Array.Empty>();
/// The total number of event handlers registered for this events, regardless of whether they're still registered.
private int RegistrationIndex;
/// Whether new handlers were added since the last raise.
private bool HasNewHandlers;
/*********
** Accessors
*********/
///
public string EventName { get; }
///
public bool IsPerformanceCritical { get; }
/*********
** Public methods
*********/
/// Construct an instance.
/// A human-readable name for the event.
/// The mod registry with which to identify mods.
/// Whether the event is typically called at least once per second.
public ManagedEvent(string eventName, ModRegistry modRegistry, bool isPerformanceCritical = false)
{
this.EventName = eventName;
this.ModRegistry = modRegistry;
this.IsPerformanceCritical = isPerformanceCritical;
}
/// Get whether anything is listening to the event.
public bool HasListeners()
{
return this.Handlers.Count > 0;
}
/// Add an event handler.
/// The event handler.
/// The mod which added the event handler.
public void Add(EventHandler handler, IModMetadata mod)
{
lock (this.Handlers)
{
EventPriority priority = handler.Method.GetCustomAttribute()?.Priority ?? EventPriority.Normal;
var managedHandler = new ManagedEventHandler(handler, this.RegistrationIndex++, priority, mod);
this.Handlers.Add(managedHandler);
this.CachedHandlers = null;
this.HasNewHandlers = true;
}
}
/// Remove an event handler.
/// The event handler.
public void Remove(EventHandler handler)
{
lock (this.Handlers)
{
// match C# events: if a handler is listed multiple times, remove the last one added
for (int i = this.Handlers.Count - 1; i >= 0; i--)
{
if (this.Handlers[i].Handler != handler)
continue;
this.Handlers.RemoveAt(i);
this.CachedHandlers = null;
break;
}
}
}
/// Raise the event and notify all handlers.
/// The event arguments to pass.
/// A lambda which returns true if the event should be raised for the given mod.
public void Raise(TEventArgs args, Func? match = null)
{
this.Raise((_, invoke) => invoke(args), match);
}
/// Raise the event and notify all handlers.
/// Invoke an event handler. This receives the mod which registered the handler, and should invoke the callback with the event arguments to pass it.
/// A lambda which returns true if the event should be raised for the given mod.
public void Raise(Action> invoke, Func? match = null)
{
// skip if no handlers
if (this.Handlers.Count == 0)
return;
// update cached data
// (This is debounced here to avoid repeatedly sorting when handlers are added/removed,
// and keeping a separate cached list allows changes during enumeration.)
var handlers = this.CachedHandlers; // iterate local copy in case a mod adds/removes a handler while handling the event, which will set this field to null
if (handlers == null)
{
lock (this.Handlers)
{
if (this.HasNewHandlers && this.Handlers.Any(p => p.Priority != EventPriority.Normal))
this.Handlers.Sort();
this.CachedHandlers = handlers = this.Handlers.ToArray();
this.HasNewHandlers = false;
}
}
// raise event
foreach (ManagedEventHandler handler in handlers)
{
if (match != null && !match(handler.SourceMod))
continue;
try
{
invoke(handler.SourceMod, args => handler.Handler.Invoke(null, args));
}
catch (Exception ex)
{
this.LogError(handler, ex);
}
}
}
/*********
** Private methods
*********/
/// Log an exception from an event handler.
/// The event handler instance.
/// The exception that was raised.
protected void LogError(ManagedEventHandler handler, Exception ex)
{
handler.SourceMod.LogAsMod($"This mod failed in the {this.EventName} event. Technical details: \n{ex.GetLogSummary()}", LogLevel.Error);
}
}
}