Event.cs 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803
  1. using com.sun.jmx.mbeanserver;
  2. using Comal.Classes;
  3. using Expressive;
  4. using InABox.Core;
  5. using InABox.Database;
  6. using Newtonsoft.Json;
  7. using Newtonsoft.Json.Serialization;
  8. using System;
  9. using System.Collections;
  10. using System.Collections.Generic;
  11. using System.Diagnostics.CodeAnalysis;
  12. using System.Linq;
  13. using System.Reflection;
  14. using System.Text;
  15. using System.Threading.Tasks;
  16. namespace PRS.Shared.Events;
  17. public interface IEventData
  18. {
  19. IEvent Event { get; }
  20. IEnumerable<string> ReferencedVariables { get; }
  21. }
  22. public class EventData<T, TDataModel> : IEventData
  23. where T : IEvent<TDataModel>
  24. where TDataModel : IEventDataModel
  25. {
  26. public T Event { get; set; }
  27. /// <summary>
  28. /// A list of triggers for this event. If any of the triggers match, the event runs.
  29. /// </summary>
  30. public List<IEventTrigger<T, TDataModel>> Triggers { get; set; }
  31. public List<IEventAction<T>> Actions { get; set; }
  32. IEvent IEventData.Event => Event;
  33. public IEnumerable<string> ReferencedVariables =>
  34. Triggers.SelectMany(x => x.ReferencedVariables)
  35. .Concat(Actions.SelectMany(x => x.ReferencedVariables))
  36. .Distinct();
  37. public EventData(T eventData)
  38. {
  39. Event = eventData;
  40. Triggers = new List<IEventTrigger<T, TDataModel>>();
  41. Actions = new List<IEventAction<T>>();
  42. }
  43. public Notification GenerateNotification(TDataModel model) => Event.GenerateNotification(model);
  44. }
  45. public static class EventUtils
  46. {
  47. #region Serialisation
  48. private class WritablePropertiesOnlyResolver : DefaultContractResolver
  49. {
  50. protected override IList<JsonProperty> CreateProperties(Type type, MemberSerialization memberSerialization)
  51. {
  52. IList<JsonProperty> props = base.CreateProperties(type, memberSerialization);
  53. return props.Where(p => p.Writable).ToList();
  54. }
  55. }
  56. private static JsonSerializerSettings SerializationSettings()
  57. {
  58. var settings = Serialization.CreateSerializerSettings();
  59. settings.TypeNameHandling = TypeNameHandling.Auto;
  60. settings.ContractResolver = new WritablePropertiesOnlyResolver();
  61. return settings;
  62. }
  63. public static string Serialize(IEventData data)
  64. {
  65. return JsonConvert.SerializeObject(data, typeof(IEventData), SerializationSettings());
  66. }
  67. public static IEventData Deserialize(string json)
  68. {
  69. return JsonConvert.DeserializeObject<IEventData>(json, SerializationSettings())!;
  70. }
  71. #endregion
  72. #region Event Types
  73. private static Dictionary<Type, List<Type>>? _eventTriggerTypes;
  74. private static Dictionary<Type, List<Type>>? _eventActionTypes;
  75. private static List<Type>? _standardEventActionTypes;
  76. [MemberNotNullWhen(true, nameof(_eventTriggerTypes), nameof(_eventActionTypes), nameof(_standardEventActionTypes))]
  77. private static bool _loadedTypes { get; set; }
  78. [MemberNotNull(nameof(_eventTriggerTypes), nameof(_eventActionTypes), nameof(_standardEventActionTypes))]
  79. private static void LoadTypes()
  80. {
  81. if (_loadedTypes) return;
  82. _loadedTypes = true;
  83. _eventTriggerTypes = new();
  84. _eventActionTypes = new();
  85. _standardEventActionTypes = new();
  86. foreach(var type in CoreUtils.TypeList(x => true))
  87. {
  88. if (type.GetInterfaceDefinition(typeof(IEventTrigger<,>)) is Type eventTriggerInterface)
  89. {
  90. if (type.GetConstructor([]) is not null)
  91. {
  92. var eventType = eventTriggerInterface.GenericTypeArguments[0];
  93. eventType = eventType.IsGenericType ? eventType.GetGenericTypeDefinition() : eventType;
  94. _eventTriggerTypes.GetValueOrAdd(eventType).Add(type);
  95. }
  96. }
  97. else if(type.GetInterfaceDefinition(typeof(IStandardEventAction<>)) is Type standardEventAction)
  98. {
  99. if (type.GetConstructor([]) is not null)
  100. {
  101. _standardEventActionTypes.Add(type);
  102. }
  103. }
  104. else if (type.GetInterfaceDefinition(typeof(IEventAction<>)) is Type eventActionInterface)
  105. {
  106. if (type.GetConstructor([]) is not null)
  107. {
  108. var eventType = eventActionInterface.GenericTypeArguments[0];
  109. eventType = eventType.IsGenericType ? eventType.GetGenericTypeDefinition() : eventType;
  110. _eventActionTypes.GetValueOrAdd(eventType).Add(type);
  111. }
  112. }
  113. }
  114. }
  115. public static IEnumerable<Type> GetEventTriggerTypes(Type eventType)
  116. {
  117. LoadTypes();
  118. eventType = eventType.IsGenericType ? eventType.GetGenericTypeDefinition() : eventType;
  119. return _eventTriggerTypes.GetValueOrDefault(eventType) ?? Enumerable.Empty<Type>();
  120. }
  121. public static IEnumerable<Type> GetEventActionTypes(Type eventType)
  122. {
  123. LoadTypes();
  124. eventType = eventType.IsGenericType ? eventType.GetGenericTypeDefinition() : eventType;
  125. return _eventActionTypes.GetValueOrDefault(eventType) ?? Enumerable.Empty<Type>();
  126. }
  127. public static IEnumerable<Type> GetStandardEventActionTypes()
  128. {
  129. LoadTypes();
  130. return _standardEventActionTypes;
  131. }
  132. #endregion
  133. #region Execution
  134. private static bool Check<T, TDataModel>(EventData<T, TDataModel> ev, TDataModel dataModel)
  135. where T : IEvent<TDataModel>
  136. where TDataModel : IEventDataModel
  137. {
  138. return ev.Triggers.Any(x => x.Check(dataModel));
  139. }
  140. public static void Run<T, TDataModel>(IStore store, Event ev, EventData<T, TDataModel> evData, TDataModel dataModel)
  141. where T : IEvent<TDataModel>
  142. where TDataModel : IEventDataModel
  143. {
  144. if (!Check(evData, dataModel)) return;
  145. foreach(var action in evData.Actions)
  146. {
  147. IEvent.RunAction(evData.Event, dataModel, action);
  148. }
  149. NotifySubscribers(store, ev, evData, dataModel);
  150. }
  151. private static void NotifySubscribers<T, TDataModel>(IStore store, Event ev, EventData<T, TDataModel> evData, TDataModel dataModel)
  152. where T : IEvent<TDataModel>
  153. where TDataModel : IEventDataModel
  154. {
  155. string? description;
  156. if (ev.NotificationExpression.IsNullOrWhiteSpace())
  157. {
  158. description = null;
  159. }
  160. else
  161. {
  162. var descriptionExpr = new CoreExpression(ev.NotificationExpression, typeof(string));
  163. if(!descriptionExpr.TryEvaluate<string>(dataModel).Get(out description, out var error))
  164. {
  165. CoreUtils.LogException(store.UserID, error, extra: "Error notifying subscribers", store.Logger);
  166. return;
  167. }
  168. }
  169. var subscribers = store.Provider.Query(
  170. new Filter<EventSubscriber>(x => x.Event.ID).IsEqualTo(ev.ID),
  171. Columns.None<EventSubscriber>().Add(x => x.Employee.ID).Add(x => x.Employee.Email).Add(x => x.SubscriberType))
  172. .ToArray<EventSubscriber>();
  173. var notifications = new List<Notification>();
  174. foreach(var subscriber in subscribers)
  175. {
  176. var notification = evData.GenerateNotification(dataModel);
  177. notification.Employee.CopyFrom(subscriber.Employee);
  178. if(description is not null)
  179. {
  180. notification.Description = description;
  181. }
  182. if(subscriber.SubscriberType == EventSubscriberType.Notification)
  183. {
  184. notifications.Add(notification);
  185. }
  186. else
  187. {
  188. var mailer = DbFactory.Mailer;
  189. if(mailer is not null)
  190. {
  191. if (mailer.Connect())
  192. {
  193. var msg = mailer.CreateMessage();
  194. // msg.From = DbFactory.EmailAddress;
  195. msg.To = [subscriber.Employee.Email];
  196. msg.Subject = notification.Title;
  197. msg.Body = notification.Description;
  198. var bOK = mailer.SendMessage(msg);
  199. }
  200. }
  201. }
  202. }
  203. store.Provider.Save(notifications);
  204. }
  205. #endregion
  206. #region Event Cache
  207. private static bool _loadedCache = false;
  208. private static Dictionary<EventType, Dictionary<Type, List<(Event Event, IEventData EventData)>>> _entityEvents = new();
  209. private static Dictionary<Guid, (EventType, Type)> _entityEventMap = new();
  210. private static Dictionary<EventType, List<(Event Event, IEventData EventData)>> _genericEvents = new();
  211. private static Dictionary<Guid, EventType> _genericEventMap = new();
  212. public static Type GetEventType(EventType type)
  213. {
  214. switch (type)
  215. {
  216. case EventType.AfterSave:
  217. return typeof(SaveEvent<>);
  218. case EventType.Scheduled:
  219. return typeof(ScheduledEvent);
  220. default:
  221. throw new Exception($"Invalid event type {type}");
  222. }
  223. }
  224. public static void ReloadCache(IProvider provider)
  225. {
  226. _loadedCache = true;
  227. _entityEvents.Clear();
  228. _entityEventMap.Clear();
  229. _genericEvents.Clear();
  230. _genericEventMap.Clear();
  231. var events = provider.Query(
  232. new Filter<Event>(x => x.Enabled).IsEqualTo(true),
  233. Columns.None<Event>().Add(x => x.ID).Add(x => x.Code).Add(x => x.EventType).Add(x => x.Data).Add(x => x.NotificationExpression))
  234. .ToObjects<Event>();
  235. foreach(var ev in events)
  236. {
  237. AddEvent(provider, ev);
  238. }
  239. }
  240. private static void AddGenericEvent(Event ev)
  241. {
  242. if(ev.Data is not null && ev.Data.Length != 0)
  243. {
  244. var data = Deserialize(ev.Data);
  245. var list = _genericEvents.GetValueOrAdd(ev.EventType);
  246. list.RemoveAll(x => x.Event.ID == ev.ID);
  247. list.Add((ev, data));
  248. _genericEventMap[ev.ID] = ev.EventType;
  249. }
  250. }
  251. private static void RemoveGenericEvent(Event ev)
  252. {
  253. if(_genericEventMap.Remove(ev.ID, out var evType))
  254. {
  255. if(_genericEvents.TryGetValue(evType, out var eventTypeEvents))
  256. {
  257. eventTypeEvents.RemoveAll(x => x.Event.ID == ev.ID);
  258. if(eventTypeEvents.Count == 0)
  259. {
  260. _genericEvents.Remove(evType);
  261. }
  262. }
  263. }
  264. }
  265. private static void AddEntityEvent(Event ev)
  266. {
  267. if(ev.Data is not null && ev.Data.Length != 0)
  268. {
  269. var data = Deserialize(ev.Data);
  270. var entityType = data.Event.GetType().GenericTypeArguments[0];
  271. var list = _entityEvents.GetValueOrAdd(ev.EventType).GetValueOrAdd(entityType);
  272. list.RemoveAll(x => x.Event.ID == ev.ID);
  273. list.Add((ev, data));
  274. _entityEventMap[ev.ID] = (ev.EventType, entityType);
  275. }
  276. }
  277. private static void RemoveEntityEvent(Event ev)
  278. {
  279. if(_entityEventMap.TryGetValue(ev.ID, out var item))
  280. {
  281. if(_entityEvents.TryGetValue(item.Item1, out var eventTypeEvents))
  282. {
  283. if(eventTypeEvents.TryGetValue(item.Item2, out var entityEvents))
  284. {
  285. entityEvents.RemoveAll(x => x.Event.ID == ev.ID);
  286. if(entityEvents.Count == 0)
  287. {
  288. eventTypeEvents.Remove(item.Item2);
  289. }
  290. }
  291. if(eventTypeEvents.Count == 0)
  292. {
  293. _entityEvents.Remove(item.Item1);
  294. }
  295. }
  296. _entityEventMap.Remove(ev.ID);
  297. }
  298. }
  299. public static void AddEvent(IProvider provider, Event ev)
  300. {
  301. if (!_loadedCache) ReloadCache(provider);
  302. var type = GetEventType(ev.EventType);
  303. if (type.HasInterface(typeof(IEntityEvent<>)))
  304. {
  305. AddEntityEvent(ev);
  306. }
  307. else
  308. {
  309. AddGenericEvent(ev);
  310. }
  311. }
  312. public static void RemoveEvent(IProvider provider, Event ev)
  313. {
  314. if (!_loadedCache) ReloadCache(provider);
  315. var type = GetEventType(ev.EventType);
  316. if (type.HasInterface(typeof(IEntityEvent<>)))
  317. {
  318. RemoveEntityEvent(ev);
  319. }
  320. else
  321. {
  322. RemoveGenericEvent(ev);
  323. }
  324. }
  325. #endregion
  326. #region Public Event Running Interface
  327. public static void AfterSave<T>(IStore store, T entity)
  328. where T : Entity, new()
  329. {
  330. if (!_loadedCache) ReloadCache(store.Provider);
  331. var events = _entityEvents.GetValueOrDefault(EventType.AfterSave)
  332. ?.GetValueOrDefault(typeof(T));
  333. if (events is null) return;
  334. foreach(var ev in events)
  335. {
  336. var eventData = (ev.EventData as EventData<SaveEvent<T>, SaveEventDataModel<T>>)!;
  337. var model = new SaveEventDataModel<T>(entity, store);
  338. eventData.Event.Init(store, eventData, model);
  339. Run(store, ev.Event, eventData, model);
  340. }
  341. }
  342. private static bool CheckEventSchedule(ScheduledEvent ev)
  343. {
  344. var now = DateTime.Now;
  345. switch (ev.Properties.Period)
  346. {
  347. case SchedulePeriod.Minute:
  348. case SchedulePeriod.Hour:
  349. case SchedulePeriod.Day:
  350. var dayOfWeekSettings = ev.Properties.DayOfWeekSettings.FirstOrDefault(x => x.DayOfWeek == now.DayOfWeek);
  351. if(dayOfWeekSettings is null || !dayOfWeekSettings.Enabled)
  352. {
  353. return false;
  354. }
  355. var start = now - now.TimeOfDay + dayOfWeekSettings.StartTime;
  356. var end = now - now.TimeOfDay + dayOfWeekSettings.EndTime;
  357. if(ev.Properties.Period == SchedulePeriod.Day)
  358. {
  359. if(ev.Properties.LastExecution < start && now >= start && (now.Date - ev.Properties.LastExecution.Date).TotalDays >= ev.Properties.Frequency)
  360. {
  361. ev.Properties.LastExecution = start;
  362. return true;
  363. }
  364. else
  365. {
  366. return false;
  367. }
  368. }
  369. else if(ev.Properties.Period == SchedulePeriod.Hour)
  370. {
  371. if(start <= now && now <= end)
  372. {
  373. var nowIntervals = Math.Floor((now - start).TotalHours / ev.Properties.Frequency);
  374. var lastIntervals = Math.Floor((ev.Properties.LastExecution - start).TotalHours / ev.Properties.Frequency);
  375. if(nowIntervals > lastIntervals)
  376. {
  377. ev.Properties.LastExecution = start.AddHours(nowIntervals * ev.Properties.Frequency);
  378. }
  379. return true;
  380. }
  381. else
  382. {
  383. return false;
  384. }
  385. }
  386. else if(ev.Properties.Period == SchedulePeriod.Minute)
  387. {
  388. if (start <= now && now <= end)
  389. {
  390. var nowIntervals = Math.Floor((now - start).TotalMinutes / ev.Properties.Frequency);
  391. var lastIntervals = Math.Floor((ev.Properties.LastExecution - start).TotalMinutes / ev.Properties.Frequency);
  392. if (nowIntervals > lastIntervals)
  393. {
  394. ev.Properties.LastExecution = start.AddMinutes(nowIntervals * ev.Properties.Frequency);
  395. }
  396. return true;
  397. }
  398. else
  399. {
  400. return false;
  401. }
  402. }
  403. else
  404. {
  405. throw new Exception("Invalid state");
  406. }
  407. case SchedulePeriod.Week:
  408. if (now >= ev.Properties.NextSchedule)
  409. {
  410. while (now >= ev.Properties.NextSchedule)
  411. {
  412. ev.Properties.NextSchedule += TimeSpan.FromDays(7 * ev.Properties.Frequency);
  413. }
  414. return true;
  415. }
  416. else
  417. {
  418. return false;
  419. }
  420. case SchedulePeriod.Month:
  421. if(now >= ev.Properties.NextSchedule)
  422. {
  423. while(now >= ev.Properties.NextSchedule)
  424. {
  425. ev.Properties.NextSchedule = ev.Properties.NextSchedule.AddMonths(ev.Properties.Frequency);
  426. }
  427. return true;
  428. }
  429. else
  430. {
  431. return false;
  432. }
  433. case SchedulePeriod.Year:
  434. if(now >= ev.Properties.NextSchedule)
  435. {
  436. while(now >= ev.Properties.NextSchedule)
  437. {
  438. ev.Properties.NextSchedule = ev.Properties.NextSchedule.AddYears(ev.Properties.Frequency);
  439. }
  440. return true;
  441. }
  442. else
  443. {
  444. return false;
  445. }
  446. default:
  447. throw new Exception("Invalid state");
  448. }
  449. }
  450. public static void CheckScheduledEvents()
  451. {
  452. var store = DbFactory.FindStore<Event>(Guid.Empty, "", Platform.DatabaseEngine, CoreUtils.GetVersion(), Logger.New());
  453. if (!_loadedCache) ReloadCache(store.Provider);
  454. var events = _genericEvents.GetValueOrDefault(EventType.Scheduled);
  455. if (events is null) return;
  456. foreach(var ev in events)
  457. {
  458. var eventData = (ev.EventData as EventData<ScheduledEvent, ScheduledEventDataModel>)!;
  459. if (CheckEventSchedule(eventData.Event))
  460. {
  461. var model = new ScheduledEventDataModel(ev.Event);
  462. eventData.Event.Init(store, eventData, model);
  463. Run(store, ev.Event, eventData, model);
  464. ev.Event.Data = Serialize(eventData);
  465. store.Provider.Save(ev.Event);
  466. }
  467. }
  468. }
  469. #endregion
  470. }
  471. #region DataModel Definition
  472. public interface IEventVariable
  473. {
  474. string Name { get; set; }
  475. Type Type { get; set; }
  476. }
  477. public class StandardEventVariable : IEventVariable
  478. {
  479. public string Name { get; set; }
  480. public Type Type { get; set; }
  481. public StandardEventVariable(string name, Type type)
  482. {
  483. Name = name;
  484. Type = type;
  485. }
  486. }
  487. public class ListEventVariable : IEventVariable
  488. {
  489. public string Name { get; set; }
  490. public Type Type { get; set; }
  491. public ListEventVariable(string name, Type type)
  492. {
  493. Name = name;
  494. Type = type;
  495. }
  496. }
  497. public interface IEventDataModelDefinition
  498. {
  499. IEnumerable<IEventVariable> GetVariables();
  500. IEventVariable? GetVariable(string name);
  501. }
  502. #endregion
  503. #region DataModel
  504. public interface IEventDataModel : IVariableProvider
  505. {
  506. bool TryGetVariable(string name, out object? value);
  507. bool IVariableProvider.TryGetValue(string variableName, out object? value)
  508. {
  509. return TryGetVariable(variableName, out value);
  510. }
  511. T RootModel<T>()
  512. where T : IEventDataModel
  513. {
  514. if(this is IChildEventDataModel child)
  515. {
  516. return child.Parent.RootModel<T>();
  517. }
  518. else if(this is T root)
  519. {
  520. return root;
  521. }
  522. else
  523. {
  524. throw new Exception($"Root model of wrong type; expected {typeof(T).FullName}; got {GetType().FullName}");
  525. }
  526. }
  527. }
  528. public interface ITypedEventDataModel : IEventDataModel
  529. {
  530. public Type EntityType { get; }
  531. }
  532. public interface IChildEventDataModel : IEventDataModel
  533. {
  534. IEventDataModel Parent { get; }
  535. }
  536. public class ChildEventDataModel : IChildEventDataModel
  537. {
  538. public IEventDataModel Parent { get; set; }
  539. public Dictionary<string, object?> Values { get; set; } = new Dictionary<string, object?>();
  540. public ChildEventDataModel(IEventDataModel parent)
  541. {
  542. Parent = parent;
  543. }
  544. public bool TryGetVariable(string name, out object? value)
  545. {
  546. return Values.TryGetValue(name, out value)
  547. || Parent.TryGetVariable(name, out value);
  548. }
  549. public void Init(IEventData data)
  550. {
  551. }
  552. }
  553. #endregion
  554. public interface IEvent
  555. {
  556. IEventDataModelDefinition DataModelDefinition();
  557. public static void RunAction(IEvent ev, IEventDataModel model, IEventAction action)
  558. {
  559. var dataModelDef = ev.DataModelDefinition();
  560. var values = new List<(string name, object? value)[]>() { Array.Empty<(string, object?)>() };
  561. foreach(var variable in action.ReferencedVariables)
  562. {
  563. var varDef = dataModelDef.GetVariable(variable);
  564. if(varDef is ListEventVariable)
  565. {
  566. if (model.TryGetVariable(varDef.Name, out var list) && list is IEnumerable enumerable)
  567. {
  568. var oldValues = values;
  569. values = new List<(string name, object? value)[]>();
  570. foreach(var item in enumerable)
  571. {
  572. foreach(var valueList in oldValues)
  573. {
  574. values.Add(valueList.Concatenate(new (string name, object? value)[]
  575. {
  576. (varDef.Name, item)
  577. }));
  578. }
  579. }
  580. }
  581. else
  582. {
  583. values.Clear();
  584. break;
  585. }
  586. }
  587. }
  588. if(values.Count > 0 && (values.Count > 1 || values[0].Length > 0))
  589. {
  590. var subModel = new ChildEventDataModel(model);
  591. foreach(var valueSet in values)
  592. {
  593. subModel.Values.Clear();
  594. foreach(var (name, value) in valueSet)
  595. {
  596. subModel.Values[name] = value;
  597. }
  598. action.Execute(subModel);
  599. }
  600. }
  601. else
  602. {
  603. action.Execute(model);
  604. }
  605. }
  606. }
  607. /// <summary>
  608. /// Indicates that this event type has properties that can be edited; <typeparamref name="TProperties"/> is used to edit these properties
  609. /// with a dynamic editor.
  610. /// </summary>
  611. public interface IPropertiesEvent<TProperties>
  612. where TProperties : BaseObject, new()
  613. {
  614. /// <summary>
  615. /// Create the properties object for editing.
  616. /// </summary>
  617. TProperties GetProperties();
  618. /// <summary>
  619. /// Given an edited properties object, save them again.
  620. /// </summary>
  621. void SetProperties(TProperties properties);
  622. }
  623. /// <summary>
  624. /// Indicates that this event is generic for type <typeparamref name="T"/>; if this interface is implemented,
  625. /// the main type <b>must</b> be generic, with only one generic type argument.
  626. /// </summary>
  627. public interface IEntityEvent<T>
  628. where T : Entity
  629. {
  630. }
  631. public interface IEvent<TDataModel> : IEvent
  632. {
  633. void Init(IStore store, IEventData data, TDataModel model);
  634. Notification GenerateNotification(TDataModel model);
  635. }
  636. public interface IEventTrigger
  637. {
  638. IEnumerable<string> ReferencedVariables { get; }
  639. string Description { get; }
  640. }
  641. public interface IEventTrigger<TEvent, TDataModel> : IEventTrigger
  642. where TEvent : IEvent<TDataModel>
  643. where TDataModel : IEventDataModel
  644. {
  645. bool Check(TDataModel dataModel);
  646. }
  647. public interface IEventTriggerParent<TEvent, TDataModel> : IEventTrigger<TEvent, TDataModel>
  648. where TEvent : IEvent<TDataModel>
  649. where TDataModel : IEventDataModel
  650. {
  651. public List<IEventTrigger<TEvent, TDataModel>> ChildTriggers { get; }
  652. }
  653. public class AndTrigger<TEvent, TDataModel> : IEventTrigger<TEvent, TDataModel>, IEventTriggerParent<TEvent, TDataModel>
  654. where TEvent : IEvent<TDataModel>
  655. where TDataModel : IEventDataModel
  656. {
  657. public List<IEventTrigger<TEvent, TDataModel>> ChildTriggers { get; set; } = new();
  658. public IEnumerable<string> ReferencedVariables => ChildTriggers.SelectMany(x => x.ReferencedVariables);
  659. public string Description => "And";
  660. public bool Check(TDataModel dataModel)
  661. {
  662. return ChildTriggers.All(x => x.Check(dataModel));
  663. }
  664. }
  665. public class OrTrigger<TEvent, TDataModel> : IEventTrigger<TEvent, TDataModel>, IEventTriggerParent<TEvent, TDataModel>
  666. where TEvent : IEvent<TDataModel>
  667. where TDataModel : IEventDataModel
  668. {
  669. public List<IEventTrigger<TEvent, TDataModel>> ChildTriggers { get; set; } = new();
  670. public IEnumerable<string> ReferencedVariables => ChildTriggers.SelectMany(x => x.ReferencedVariables);
  671. public string Description => "Or";
  672. public bool Check(TDataModel dataModel)
  673. {
  674. return ChildTriggers.Any(x => x.Check(dataModel));
  675. }
  676. }
  677. public interface IEventAction
  678. {
  679. IEnumerable<string> ReferencedVariables { get; }
  680. object? Execute(IEventDataModel dataModel);
  681. string Description { get; }
  682. }
  683. public interface IEventAction<TEvent> : IEventAction
  684. where TEvent : IEvent
  685. {
  686. }
  687. /// <summary>
  688. /// Marks this event action as being applicable to any event type.
  689. /// </summary>
  690. public interface IStandardEventAction<TEvent> : IEventAction<TEvent>
  691. where TEvent : IEvent
  692. {
  693. }