docs: 更新readme

README.md

@@ -1,3 +1,5 @@
 # TYLDDB-C#
 
 C# version.
+
+A strongly typed constrained distributed file system that can act as a database.

TYLDDB-CSharp.sln

@@ -12,6 +12,10 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TYLDDB.Test", "TYLDDB.Test\TYLDDB.Test.csproj", "{FDFD566C-CB13-43EB-970E-0EC0A21E36C0}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TYLDDB.Utils.FastCache.Test", "TYLDDB.Utils.FastCache.Test\TYLDDB.Utils.FastCache.Test.csproj", "{A58C0A6B-9BD4-4B29-9B5F-5FDFB849D23B}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Test", "Test", "{95BC8FAF-AB03-44A3-A7E7-8E42FA7138E3}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -26,10 +30,18 @@ Global
 		{FDFD566C-CB13-43EB-970E-0EC0A21E36C0}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{FDFD566C-CB13-43EB-970E-0EC0A21E36C0}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{FDFD566C-CB13-43EB-970E-0EC0A21E36C0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A58C0A6B-9BD4-4B29-9B5F-5FDFB849D23B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A58C0A6B-9BD4-4B29-9B5F-5FDFB849D23B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A58C0A6B-9BD4-4B29-9B5F-5FDFB849D23B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A58C0A6B-9BD4-4B29-9B5F-5FDFB849D23B}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
 	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{FDFD566C-CB13-43EB-970E-0EC0A21E36C0} = {95BC8FAF-AB03-44A3-A7E7-8E42FA7138E3}
+		{A58C0A6B-9BD4-4B29-9B5F-5FDFB849D23B} = {95BC8FAF-AB03-44A3-A7E7-8E42FA7138E3}
+	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {19390089-354C-41AD-AF7D-9FB3998A88EA}
 	EndGlobalSection

TYLDDB.Test/Program.cs

@@ -1,27 +1,29 @@
 using TYLDDB;
 using TYLDDB.Test;
 
+string dbFilePath = "./example.lddb";
+
 ///////////////////////////////////////////////////////////////////////////////////////////////////////// 实例化
 LDDB lddb = new LDDB();
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////////// 读取文件
-HighPrecisionTimer readDbTimer = new(); // 从发起读取文件指令到成功读取的总时间
+HighPrecisionTimer readDbTimer = new(); // 从发起读取文件到成功读取的总时间
+lddb.FilePath = dbFilePath;
 readDbTimer.Start();
-lddb.FilePath = "./example.lddb";
 lddb.ReadingFile();
 readDbTimer.Stop();
 WriteTime("从发起读取文件指令到成功读取的总时间为: ", readDbTimer.ElapsedMilliseconds());
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////////// 读取数据库
-HighPrecisionTimer loadDbTimer = new(); // 从发起读取数据库指令到成功返回读取内容的总时间
+HighPrecisionTimer loadDbTimer = new(); // 从发起读取数据库到成功返回读取内容的总时间
 loadDbTimer.Start();
 lddb.LoadDatabase("database1");
 Console.WriteLine(lddb.GetLoadingDatabaseContent()); // 输出database1内容
 loadDbTimer.Stop();
 WriteTime("从发起读取数据库指令到成功返回读取内容的总时间为: ", loadDbTimer.ElapsedMilliseconds());
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////////// 获取所有数据库名称
-HighPrecisionTimer readAllDbNameTimer = new(); // 从发起读取数据库指令到成功返回读取内容的总时间
+HighPrecisionTimer readAllDbNameTimer = new(); // 从发起读取数据库名称到成功返回读取内容的总时间
 readAllDbNameTimer.Start();
 lddb.ReadAllDatabaseName();
 readAllDbNameTimer.Stop();
@@ -32,7 +34,7 @@
         Console.WriteLine(dbName);
     }
 }
-WriteTime("从发起读取数据库指令到成功返回读取内容的总时间为: ", readAllDbNameTimer.ElapsedMilliseconds());
+WriteTime("从发起读取数据库名称到成功返回读取内容的总时间为: ", readAllDbNameTimer.ElapsedMilliseconds());
 
 
 
@@ -50,9 +52,7 @@
 
 Console.ReadLine();
 
-
-
-
+////////////////////////////////////////////////////////////////////////////////////////////////////////// Test Method
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////////// 工具
 static void WriteTime(string what, double time)

TYLDDB.Utils.FastCache.Test/HighPrecisionTimer.cs

@@ -0,0 +1,44 @@
+using System.Diagnostics;
+
+namespace TYLDDB.Utils.FastCache.Test
+{
+    internal class HighPrecisionTimer
+    {
+        private Stopwatch stopwatch;
+
+        public HighPrecisionTimer()
+        {
+            stopwatch = new Stopwatch();
+        }
+
+        // 启动计时器
+        public void Start()
+        {
+            stopwatch.Start();
+        }
+
+        // 停止计时器
+        public void Stop()
+        {
+            stopwatch.Stop();
+        }
+
+        // 重置计时器
+        public void Reset()
+        {
+            stopwatch.Reset();
+        }
+
+        // 获取已用时间（毫秒）
+        public double ElapsedMilliseconds()
+        {
+            return stopwatch.Elapsed.TotalMilliseconds;
+        }
+
+        // 获取已用时间（秒）
+        public double ElapsedSeconds()
+        {
+            return stopwatch.Elapsed.TotalSeconds;
+        }
+    }
+}

TYLDDB.Utils.FastCache.Test/Program.cs

@@ -0,0 +1,76 @@
+using TYLDDB.Utils.FastCache;
+using TYLDDB.Utils.FastCache.Test;
+
+SemaphoreSlimDefault();
+
+Console.ReadLine();
+
+// 普通线程锁的数据库读写运行
+static async void SemaphoreSlimDefault()
+{
+    var setTime = new HighPrecisionTimer();
+    var setAsyncTime = new HighPrecisionTimer();
+    var getByKeyTime = new HighPrecisionTimer();
+    var getByKeyAsyncTime = new HighPrecisionTimer();
+    var getKeysByValueTime = new HighPrecisionTimer();
+    var getKeysByValueAsyncTime = new HighPrecisionTimer();
+    var getAllCacheTime = new HighPrecisionTimer();
+    var getAllCacheAsyncTime = new HighPrecisionTimer();
+
+    var cache = new Cache();
+
+    setTime.Start();
+    cache.Set("TESTKEY1", "TESTVALUE1");
+    setTime.Stop();
+
+    setAsyncTime.Start();
+    await cache.SetAsync("TESTKEY2", "TESTVALUE2");
+    setAsyncTime.Stop();
+
+    getByKeyTime.Start();
+    Console.WriteLine("TESTKEY1对应的值：" + cache.GetByKey("TESTKEY1"));
+    getByKeyTime.Stop();
+
+    getByKeyAsyncTime.Start();
+    Console.WriteLine("TESTKEY2对应的值：" + await cache.GetByKeyAsync("TESTKEY2"));
+    getByKeyAsyncTime.Stop();
+
+    cache.Set("TESTKEY3", "TESTVALUE2");
+
+    Console.WriteLine("TESTVALUE2对应的所有键：");
+    getKeysByValueTime.Start();
+    Console.WriteLine(string.Join(", ", cache.GetKeysByValue("TESTVALUE2")));
+    getKeysByValueTime.Stop();
+
+    Console.WriteLine("TESTVALUE2对应的所有键：");
+    getKeysByValueAsyncTime.Start();
+    Console.WriteLine(string.Join(", ", await cache.GetKeysByValueAsync("TESTVALUE2")));
+    getKeysByValueAsyncTime.Stop();
+
+    // 获取并输出所有缓存项（同步方法）
+    getAllCacheTime.Start();
+    var allCacheSync = cache.GetAllCache();
+    Console.WriteLine("同步获取所有缓存项:");
+    foreach (var kvp in allCacheSync)
+    {
+        Console.WriteLine($"{kvp.Key}: {kvp.Value}");
+    }
+    getAllCacheTime.Stop();
+
+    // 获取并输出所有缓存项（异步方法）
+    getAllCacheAsyncTime.Start();
+    var allCacheAsync = await cache.GetAllCacheAsync();
+    Console.WriteLine("异步获取所有缓存项:");
+    foreach (var kvp in allCacheAsync)
+    {
+        Console.WriteLine($"{kvp.Key}: {kvp.Value}");
+    }
+    getAllCacheAsyncTime.Stop();
+
+
+    Console.WriteLine("时间消耗：");
+    Console.WriteLine($"设置键值(同步)：{setTime.ElapsedMilliseconds()}ms 设置键值(异步)：{setAsyncTime.ElapsedMilliseconds()}ms");
+    Console.WriteLine($"根据键获取值(同步)：{getByKeyTime.ElapsedMilliseconds()}ms 根据键获取值(异步)：{getByKeyAsyncTime.ElapsedMilliseconds()}ms");
+    Console.WriteLine($"根据值获取键(同步)：{getKeysByValueTime.ElapsedMilliseconds()}ms 根据值获取键(异步)：{getKeysByValueAsyncTime.ElapsedMilliseconds()}ms");
+    Console.WriteLine($"获取所有缓存项(同步)：{getAllCacheTime.ElapsedMilliseconds()}ms 获取所有缓存项(异步)：{getAllCacheAsyncTime.ElapsedMilliseconds()}ms");
+}

TYLDDB.Utils.FastCache.Test/TYLDDB.Utils.FastCache.Test.csproj

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\TYLDDB\TYLDDB.csproj" />
+  </ItemGroup>
+
+</Project>

TYLDDB/Basic/Exception.cs

@@ -2,48 +2,6 @@
 
 namespace TYLDDB.Basic
 {
-#if NET8_0_OR_GREATER
-    /// <summary>
-    /// The main error module, most of them use this<br/>
-    /// 主要的错误模块，大部分都使用这个
-    /// </summary>
-    public class TylddbException(string message) : Exception(message) { }
-    /// <summary>
-    /// File opening failure<br/>
-    /// 文件打开失败
-    /// </summary>
-    public class FileOpenFailException(string message) : TylddbException(message) { }
-    /// <summary>
-    /// File read failure<br/>
-    /// 文件读取失败
-    /// </summary>
-    public class FileReadingFailException(string message) : TylddbException(message) { }
-    /// <summary>
-    /// File not found<br/>
-    /// 文件未找到
-    /// </summary>
-    public class FileNotFoundException(string message) : TylddbException(message) { }
-    /// <summary>
-    /// The file path is null or space<br/>
-    /// 文件路径为null或空白
-    /// </summary>
-    public class FilePathIsNullOrWhiteSpace(string message) : TylddbException(message) { }
-    /// <summary>
-    /// Incorrect or invalid data<br/>
-    /// 错误或无效的数据
-    /// </summary>
-    public class InvalidDataException(string message) : TylddbException(message) { }
-    /// <summary>
-    /// Database not found<br/>
-    /// 未找到数据库
-    /// </summary>
-    public class DatabaseNotFoundException(string message) : TylddbException(message) { }
-    /// <summary>
-    /// Description Failed to obtain the database content<br/>
-    /// 数据库内容获取失败
-    /// </summary>
-    public class GetDatabaseContentErrorException(string message) : TylddbException(message) { }
-#else
     /// <summary>
     /// The main error module, most of them use this<br/>
     /// 主要的错误模块，大部分都使用这个
@@ -140,5 +98,4 @@ public class GetDatabaseContentErrorException : TylddbException
         /// </summary>
         public GetDatabaseContentErrorException(string message) : base(message) { }
     }
-#endif
 }

TYLDDB/How-To-Use.md

@@ -0,0 +1,43 @@
+# How to use TYLDDB
+
+## Basic content
+
+### Read database
+
+#### Instantiate the LDDB class
+
+```c#
+LDDB lddb = new LDDB();
+```
+
+If you are using a higher version .NET, you can also write a little simpler.
+
+```c#
+LDDB lddb = new();
+```
+
+#### Read file
+
+```c#
+lddb.FilePath = "./example.lddb";
+lddb.ReadingFile();
+```
+
+The contents of the file are then loaded into memory.
+
+#### Select the database to read
+
+```c#
+lddb.LoadDatabase("database1");
+```
+
+This allows you to select the contents of the database for the next operation
+
+If you want to get all the contents of this database, you can use `lddb.GetLoadingDatabaseContent()` , which returns a string.
+
+#### Gets all database names
+
+```c#
+lddb.ReadAllDatabaseName();
+```
+

TYLDDB/TYLDDB.cs

@@ -1,5 +1,5 @@
-using System.Collections.Generic;
-using System.Threading.Tasks;
+using System;
+using System.Collections.Generic;
 using TYLDDB.Basic;
 using TYLDDB.Utils;
 
@@ -10,19 +10,25 @@
     /// </summary>
     public class LDDB
     {
-        private string _filePath;  // 私有字段存储文件路径
-        private string _fileContent; // 私有字段存储文件内容
-        private string _database;
-        private string _databaseContent;
+        /// <summary>
+        /// Instantiate the LDDB class<br />
+        /// 实例化LDDB类
+        /// </summary>
+        public LDDB()
+        {
+            // TODO
+        }
 
+        ///////////////////////////////////////////////////// 私有字段
+        private string _filePath;  // 存储文件路径
+        private string _fileContent; // 存储文件内容
+        private string _database; // 存储正在访问的数据库
+        private string _databaseContent; // 存储数据库内容
         private bool _isRead = false; // 是否已调用读取文件
-
-#if NET6_0_OR_GREATER
-        private Database database = new();
-#else
+        private event Action OnFileReadComplete;
         private Database database = new Database();
-#endif
 
+        ///////////////////////////////////////////////////// 公开字段
         /// <summary>
         /// Set the path where you want to read the file<br/>
         /// 设置希望读取文件的路径
@@ -36,7 +42,6 @@
                 _filePath = value; // 只有通过验证后才设置值
             }
         }
-
         /// <summary>
         /// Names of all databases in the current file<br />
         /// 当前文件内所有数据库的名称
@@ -62,7 +67,7 @@
         /// </summary>
         public void ReadingFile()
         {
-            _fileContent = ReadFile.ReadTylddbFile(FilePath);
+            _fileContent = Reader.ReadFile(FilePath);
             _isRead = true;
         }