release v1.0.2

- [feat] allowing getting entity from a context via an ID

Author: JasonXuDeveloper

EasyEcs.Core/Context.cs

@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
-using System.Diagnostics.CodeAnalysis;
 using System.Threading;
 using System.Threading.Tasks;
 
@@ -15,11 +14,11 @@ namespace EasyEcs.Core;
 /// <br/>
 /// You should not have multiple contexts in the same thread.
 /// </summary>
-[SuppressMessage("ReSharper", "SuspiciousTypeConversion.Global")]
 public partial class Context : IAsyncDisposable
 {
     private readonly Random _random = new();
     private readonly List<Entity> _entities = new();
+    private readonly Dictionary<int, Entity> _entitiesById = new();
     private readonly ReaderWriterLockSlim _entitiesLock = new();
     private readonly ConcurrentQueue<Entity> _removeList = new();
     private readonly ConcurrentQueue<SystemBase> _runtimeAddSystemList = new();
@@ -83,6 +82,7 @@ public Entity CreateEntity()
         try
         {
             _entities.Add(entity);
+            _entitiesById.Add(entity.Id, entity);
         }
         finally
         {
@@ -105,6 +105,7 @@ public void DestroyEntity(Entity entity, bool immediate = false)
             try
             {
                 _entities.Remove(entity);
+                _entitiesById.Remove(entity.Id);
             }
             finally
             {
@@ -118,6 +119,17 @@ public void DestroyEntity(Entity entity, bool immediate = false)
         _removeList.Enqueue(entity);
     }
 
+    /// <summary>
+    /// Get an entity by id.
+    /// </summary>
+    /// <param name="id"></param>
+    /// <returns></returns>
+    public Entity GetEntityById(int id)
+    {
+        _entitiesById.TryGetValue(id, out var entity);
+        return entity;
+    }
+
     /// <summary>
     /// Get all entities.
     /// <br/>
@@ -200,6 +212,7 @@ public async ValueTask DisposeAsync()
 
         // clear all entities
         _entities.Clear();
+        _entitiesById.Clear();
         // clear all systems
         _executeSystems.Clear();
         _initSystems.Clear();
@@ -291,6 +304,7 @@ public async ValueTask Update(bool parallel = true)
             try
             {
                 _entities.Remove(entity);
+                _entitiesById.Remove(entity.Id);
             }
             finally
             {

EasyEcs.Core/Entity.cs

@@ -6,8 +6,10 @@ namespace EasyEcs.Core;
 
 /// <summary>
 /// An entity holds several components.
+/// <br/>
+/// It is not recommended to hold a reference to an entity at any time, since it may escape from the context (when destroyed) and cause memory leaks.
+/// Simply get the entity from the context when needed via <see cref="Context.GetEntityById"/> (This operation is roughly O(1)).
 /// </summary>
-[SuppressMessage("ReSharper", "NotAccessedField.Local")]
 public class Entity
 {
     /// <summary>