From b8e98d6917c82f68c86d4f3ef8ace88e00dcabe0 Mon Sep 17 00:00:00 2001 From: MagicalConch <37917403+git102347501@users.noreply.github.com> Date: Wed, 8 Jun 2022 18:07:10 +0800 Subject: [PATCH 1/4] Update Redis-Cache.md --- docs/zh-Hans/Redis-Cache.md | 46 ++++++++++++++++++++++++++++++++++++- 1 file changed, 45 insertions(+), 1 deletion(-) diff --git a/docs/zh-Hans/Redis-Cache.md b/docs/zh-Hans/Redis-Cache.md index cb82a640d5..c9a0d020dd 100644 --- a/docs/zh-Hans/Redis-Cache.md +++ b/docs/zh-Hans/Redis-Cache.md @@ -1 +1,45 @@ -TODO... \ No newline at end of file +# Redis 缓存 + +ABP Framework [缓存系统](Caching.md) 拓展了 [ASP.NET Core 分布式缓存](https://docs.microsoft.com/en-us/aspnet/core/performance/caching/distributed). 因此, 标准 ASP.NET Core 分布式缓存支持的 **任何提供程序** 都可以在您的应用程序中使用，并且可以像 **微软文档** 那样进行配置. + +不过, ABP为 Redis Cache 还提供了一个集成包: [Volo.Abp.Caching.StackExchangeRedis](https://www.nuget.org/packages/Volo.Abp.Caching.StackExchangeRedis). +为何使用中这个包而不是标准的[Microsoft.Extensions.Caching.StackExchangeRedis](https://www.nuget.org/packages/Microsoft.Extensions.Caching.StackExchangeRedis/)包有两个原因. + +1. 它实现 `SetManyAsync` 和 `GetManyAsync` 方法. 这些都不是 Microsoft 缓存库的标准方法，而是由ABP框架[缓存](Caching.md)系统添加的. 当您需要通过单个方法调用设置/获取多个缓存项时，它们**显着提高了性能**. +2. 它 **简化** 了 Redis 缓存 **配置** (将在下面解释). + +> Volo.Abp.Caching.StackExchangeRedis 已经使用了 Microsoft.Extensions.Caching.StackExchangeRedis 包，但对其进行了扩展和改进. +## 安装 + +> 如果使用Redis，则此软件包已安装在应用程序启动模板中. +在项目`.csproj`的文件夹中打开命令行窗口并输入命令: + +````bash +abp add-package Volo.Abp.Caching.StackExchangeRedis +```` + +## 配置 + +Volo.Abp.Caching.StackExchangeRedis 包自动从`IConfiguration`获取Redis[配置](Configuration.md). 因此，您可以在以下位置设置配置 `appsettings.json`: + +````js +"Redis": { + "IsEnabled": "true", + "Configuration": "127.0.0.1" +} +```` +设置`IsEnabled`为可选的，如果未设置将默认视为`true`. + + +或者，您可以[模块](Module-Development-Basics.md)的方法中配置标准的[RedisCacheOptions](https://docs.microsoft.com/en-us/dotnet/api/microsoft.extensions.caching.stackexchangeredis.rediscacheoptions)类： `ConfigureServices` + +````csharp +Configure(options => +{ + //... +}); +```` + +## 另请参阅 + +* [缓存](Caching.md) From 846cb4d6d6a9729573bb16ad3011618cd34e2bfc Mon Sep 17 00:00:00 2001 From: MagicalConch <37917403+git102347501@users.noreply.github.com> Date: Wed, 22 Jun 2022 09:23:15 +0800 Subject: [PATCH 2/4] Update Redis-Cache.md --- docs/zh-Hans/Redis-Cache.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/zh-Hans/Redis-Cache.md b/docs/zh-Hans/Redis-Cache.md index c9a0d020dd..27a420a4bb 100644 --- a/docs/zh-Hans/Redis-Cache.md +++ b/docs/zh-Hans/Redis-Cache.md @@ -1,11 +1,11 @@ # Redis 缓存 -ABP Framework [缓存系统](Caching.md) 拓展了 [ASP.NET Core 分布式缓存](https://docs.microsoft.com/en-us/aspnet/core/performance/caching/distributed). 因此, 标准 ASP.NET Core 分布式缓存支持的 **任何提供程序** 都可以在您的应用程序中使用，并且可以像 **微软文档** 那样进行配置. +ABP Framework [缓存系统](Caching.md) 拓展了 [ASP.NET Core 分布式缓存](https://docs.microsoft.com/zh-cn/aspnet/core/performance/caching/distributed). 因此, 标准 ASP.NET Core 分布式缓存支持的 **任何提供程序** 都可以在你的应用程序中使用，并且可以像 **微软文档** 那样进行配置. 不过, ABP为 Redis Cache 还提供了一个集成包: [Volo.Abp.Caching.StackExchangeRedis](https://www.nuget.org/packages/Volo.Abp.Caching.StackExchangeRedis). 为何使用中这个包而不是标准的[Microsoft.Extensions.Caching.StackExchangeRedis](https://www.nuget.org/packages/Microsoft.Extensions.Caching.StackExchangeRedis/)包有两个原因. -1. 它实现 `SetManyAsync` 和 `GetManyAsync` 方法. 这些都不是 Microsoft 缓存库的标准方法，而是由ABP框架[缓存](Caching.md)系统添加的. 当您需要通过单个方法调用设置/获取多个缓存项时，它们**显着提高了性能**. +1. 它实现 `SetManyAsync` 和 `GetManyAsync` 方法. 这些都不是 Microsoft 缓存库的标准方法，而是由ABP框架[缓存](Caching.md)系统添加的. 当你需要通过单个方法调用设置/获取多个缓存项时，它们**显著提高了性能**. 2. 它 **简化** 了 Redis 缓存 **配置** (将在下面解释). > Volo.Abp.Caching.StackExchangeRedis 已经使用了 Microsoft.Extensions.Caching.StackExchangeRedis 包，但对其进行了扩展和改进. @@ -20,7 +20,7 @@ abp add-package Volo.Abp.Caching.StackExchangeRedis ## 配置 -Volo.Abp.Caching.StackExchangeRedis 包自动从`IConfiguration`获取Redis[配置](Configuration.md). 因此，您可以在以下位置设置配置 `appsettings.json`: +Volo.Abp.Caching.StackExchangeRedis 包自动从`IConfiguration`获取Redis[配置](Configuration.md). 因此，你可以在以下位置设置配置 `appsettings.json`: ````js "Redis": { @@ -31,7 +31,7 @@ Volo.Abp.Caching.StackExchangeRedis 包自动从`IConfiguration`获取Redis[配 设置`IsEnabled`为可选的，如果未设置将默认视为`true`. -或者，您可以[模块](Module-Development-Basics.md)的方法中配置标准的[RedisCacheOptions](https://docs.microsoft.com/en-us/dotnet/api/microsoft.extensions.caching.stackexchangeredis.rediscacheoptions)类： `ConfigureServices` +或者，你可以在[模块](Module-Development-Basics.md)的ConfigureServices方法中配置标准的[RedisCacheOptions](https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.extensions.caching.stackexchangeredis.rediscacheoptions)类： `ConfigureServices` ````csharp Configure(options => From 853242e1f738bc5fdc77c6406fd04786ead5d050 Mon Sep 17 00:00:00 2001 From: MagicalConch <37917403+git102347501@users.noreply.github.com> Date: Thu, 23 Jun 2022 10:02:28 +0800 Subject: [PATCH 3/4] Update docs-nav.json --- docs/zh-Hans/docs-nav.json | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/zh-Hans/docs-nav.json b/docs/zh-Hans/docs-nav.json index d66d11b3cf..203000c6c6 100644 --- a/docs/zh-Hans/docs-nav.json +++ b/docs/zh-Hans/docs-nav.json @@ -167,7 +167,13 @@ }, { "text": "缓存", - "path": "Caching.md" + "path": "Caching.md", + "items": [ + { + "text": "Redis 缓存", + "path": "Redis-Cache.md" + } + ] }, { "text": "日志", From adc58416e05ec730473c4fab1a2b9ce7192ec1dc Mon Sep 17 00:00:00 2001 From: MagicalConch <37917403+git102347501@users.noreply.github.com> Date: Mon, 27 Jun 2022 12:54:24 +0800 Subject: [PATCH 4/4] Update Redis-Cache.md --- docs/zh-Hans/Redis-Cache.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh-Hans/Redis-Cache.md b/docs/zh-Hans/Redis-Cache.md index 27a420a4bb..1c6d3caa42 100644 --- a/docs/zh-Hans/Redis-Cache.md +++ b/docs/zh-Hans/Redis-Cache.md @@ -31,7 +31,7 @@ Volo.Abp.Caching.StackExchangeRedis 包自动从`IConfiguration`获取Redis[配 设置`IsEnabled`为可选的，如果未设置将默认视为`true`. -或者，你可以在[模块](Module-Development-Basics.md)的ConfigureServices方法中配置标准的[RedisCacheOptions](https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.extensions.caching.stackexchangeredis.rediscacheoptions)类： `ConfigureServices` +或者，你可以在[模块](Module-Development-Basics.md)的ConfigureServices方法中配置标准的[RedisCacheOptions](https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.extensions.caching.stackexchangeredis.rediscacheoptions)类： ````csharp Configure(options =>