up

Libraries/Esiur/Resource/IResource.cs

@@ -35,7 +35,8 @@ public delegate bool QueryFilter<T>(T value);
 
 public interface IResource : IDestructible
 {
-    AsyncReply<bool> Trigger(ResourceTrigger trigger);
+    AsyncReply<bool> Handle(ResourceOperation trigger);
+    AsyncReply<bool> Initialize(ResourceContext resourceContext);
 
     [NotMapped]
     [JsonIgnore]

Libraries/Esiur/Resource/Resource.cs

@@ -38,9 +38,9 @@ public class Resource : IResource
         OnDestroy?.Invoke(this);
     }
 
-    public virtual AsyncReply<bool> Trigger(ResourceTrigger trigger)
+    public virtual AsyncReply<bool> Trigger(ResourceOperation trigger)
     {
-        if (trigger == ResourceTrigger.Initialize)
+        if (trigger == ResourceOperation.Initialize)
             return new AsyncReply<bool>(this.Create());
         else
             return new AsyncReply<bool>(true);

Libraries/Esiur/Resource/ResourceOperation.cs

@@ -0,0 +1,110 @@
+/*
+ 
+Copyright (c) 2017 Ahmed Kh. Zamil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+*/
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Esiur.Resource;
+
+public enum ResourceOperation : int
+{
+    /// <summary>
+    /// Resource is requested to open/start its active work.
+    /// </summary>
+    Open = 0,
+
+    /// <summary>
+    /// Resource is requested to initialize.
+    /// </summary>
+    Initialize = 1,
+
+
+    /// <summary>
+    /// Resource configuration should be applied or refreshed.
+    /// </summary>
+    Configure = 2,
+
+    /// <summary>
+    /// Resource is requested to close/stop active work, but may remain loaded.
+    /// </summary>
+    Close = 3,
+
+    /// <summary>
+    /// Resource is requested to terminate and release its resources.
+    /// </summary>
+    Terminate = 4,
+
+    /// <summary>
+    /// Runtime has finished initializing the system/resource graph.
+    /// Safe point for resolving dependencies on other resources.
+    /// </summary>
+    SystemReady = 5,
+
+    /// <summary>
+    /// Runtime is about to reload the system or resource graph.
+    /// Resource should prepare for reload.
+    /// </summary>
+    SystemReloading = 6,
+
+    /// <summary>
+    /// Runtime has finished reloading the system or resource graph.
+    /// Resource may rebind dependencies or refresh state.
+    /// </summary>
+    SystemReloaded = 7,
+
+    /// <summary>
+    /// Runtime is preparing to shut down the system.
+    /// Resource should stop background activity gracefully.
+    /// </summary>
+    SystemTerminating = 8,
+
+    /// <summary>
+    /// Runtime has completed system shutdown/termination.
+    /// Usually used only for final notifications.
+    /// </summary>
+    SystemTerminated = 8,
+
+    /// <summary>
+    /// Resource should persist its current state if supported.
+    /// </summary>
+    Save = 9,
+
+    /// <summary>
+    /// Resource should reload its state from its backing store if supported.
+    /// </summary>
+    Load = 10,
+
+    /// <summary>
+    /// Resource should pause active work without releasing all resources.
+    /// </summary>
+    Pause = 11,
+
+    /// <summary>
+    /// Resource should resume work after pause.
+    /// </summary>
+    Resume = 12
+}

Libraries/Esiur/Resource/ResourceTrigger.cs

@@ -1,41 +0,0 @@
-/*
- 
-Copyright (c) 2017 Ahmed Kh. Zamil
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-*/
-
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace Esiur.Resource;
-public enum ResourceTrigger : int
-{
-    Open = 0,
-    Initialize,
-    Terminate,
-    Configure,
-    SystemInitialized,
-    SystemTerminated,
-    SystemReload,
-}

Libraries/Esiur/Resource/StoreGeneric.cs

@@ -38,7 +38,7 @@ public abstract class Store<T> : IStore where T : IResource
  
  
  
-    public abstract AsyncReply<bool> Trigger(ResourceTrigger trigger);
+    public abstract AsyncReply<bool> Trigger(ResourceOperation trigger);
 
     //public async AsyncReply<T> New(string name = null, object attributes = null, object properties = null)
     //{

Libraries/Esiur/Resource/Warehouse.cs

@@ -226,7 +226,7 @@ public class Warehouse
             //IResource r;
             //if (rk.Value.TryGetTarget(out r))
             //{
-            var rt = await r.Trigger(ResourceTrigger.Initialize);
+            var rt = await r.Trigger(ResourceOperation.Initialize);
             //if (!rt)
             //  return false;
 
@@ -239,7 +239,7 @@ public class Warehouse
 
         foreach (var r in resSnap)
         {
-            var rt = await r.Trigger(ResourceTrigger.SystemInitialized);
+            var rt = await r.Trigger(ResourceOperation.SystemInitialized);
             if (!rt)
             {
                 Global.Log("Warehouse", LogType.Warning, $"Resource failed at SystemInitialized {r.Instance.Name} [{r.Instance.Definition.Name}]");
@@ -267,13 +267,13 @@ public class Warehouse
             if (resource.TryGetTarget(out r))
             {
                 if (!(r is IStore))
-                    bag.Add(r.Trigger(ResourceTrigger.Terminate));
+                    bag.Add(r.Trigger(ResourceOperation.Terminate));
 
             }
         }
 
         foreach (var store in _stores)
-            bag.Add(store.Key.Trigger(ResourceTrigger.Terminate));
+            bag.Add(store.Key.Trigger(ResourceOperation.Terminate));
 
 
         foreach (var resource in _resources.Values)
@@ -282,13 +282,13 @@ public class Warehouse
             if (resource.TryGetTarget(out r))
             {
                 if (!(r is IStore))
-                    bag.Add(r.Trigger(ResourceTrigger.SystemTerminated));
+                    bag.Add(r.Trigger(ResourceOperation.SystemTerminated));
             }
         }
 
 
         foreach (var store in _stores)
-            bag.Add(store.Key.Trigger(ResourceTrigger.SystemTerminated));
+            bag.Add(store.Key.Trigger(ResourceOperation.SystemTerminated));
 
         bag.Seal();
 
@@ -448,9 +448,9 @@ public class Warehouse
 
             if (_warehouseIsOpen)
             {
-                await resource.Trigger(ResourceTrigger.Initialize);
+                await resource.Handle(ResourceOperation.Initialize);
                 if (resource is IStore)
-                    await resource.Trigger(ResourceTrigger.Open);
+                    await resource.Handle(ResourceOperation.Open);
             }
 
             if (resource is IStore)