ABP之Caching
Posted yixuanhan
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了ABP之Caching相关的知识,希望对你有一定的参考价值。
简介
ABP提供缓存抽象,默认使用MemoryCache。但是可以替换成其他缓存程序,比如 Abp.RedisCache 是使用Redis实现缓存。
ICacheManager
缓存的主要接口是ICacheManager,我们可以使用它来获得缓存,比如:
public class TestAppService : ApplicationService { private readonly ICacheManager _cacheManager; public TestAppService(ICacheManager cacheManager) { _cacheManager = cacheManager; } public Item GetItem(int id) { //Try to get from cache return _cacheManager .GetCache("MyCache") .Get(id.ToString(), () => GetFromDatabase(id)) as Item; } public Item GetFromDatabase(int id) { //... retrieve item from database } }
在本例中,我们将注入ICacheManager并获得一个名为MyCache的缓存。缓存名称区分大小写,这意味着“MyCache”和“MyCache”是两个不同的缓存。
ICache
ICacheManager.GetCache返回一个ICache,缓存是单例的,是在第一次请求被创建,然后总是返回相同的对象。通过这种方式,我们可以在不同的类(客户端)中使用相同的名称共享相同的缓存。
在示例代码中,我们看到了ICache.Get的简单用法,它有两个参数,
- key:缓存中项的唯一键(字符串)。
- factory:如果没有具有给定键的Item,则调用该Action。工厂方法应该创建并返回实际的Item。如果给定键存在于缓存中,则不调用该Action。
ICache接口还具有GetOrDefault、Set、Remove和Clear等方法,所有方法都有异步版本。
ITypedCache
ICache 接口使用字符串作为key,object对象作为value,ITypedCache是ICache的一个包装器,用于提供类型安全的通用缓存。我们可以使用通用的GetCache扩展方法来获得一个ITypedCache:
ITypedCache<int, Item> myCache = _cacheManager.GetCache<int, Item>("MyCache");
我们还可以使用AsTyped扩展方法将现有的ICache实例转换为ITypedCache。
配置
默认的缓存过期时间是60分钟,如果在60分钟之内不使用缓存中的Item,它就会被自动从缓存中删除。我们可以为所有的缓存配置过期时间,也可以为特定的缓存配置特定时间。
//Configuration for all caches Configuration.Caching.ConfigureAll(cache => { cache.DefaultSlidingExpireTime = TimeSpan.FromHours(2); }); //Configuration for a specific cache Configuration.Caching.Configure("MyCache", cache => { cache.DefaultSlidingExpireTime = TimeSpan.FromHours(8); });
上面这段代码将被放到 PreInitialize方法中,使用此代码,MyCache将在8小时后过期,其他的将在2小时后过期。
一旦缓存首次创建(针对第一个请求),就会调用配置操作。配置并不仅限于DefaultSlidingExpireTime,因为缓存对象是一个ICache,我们可以使用它的属性和方法自由地配置和初始化它。
实体缓存
虽然ABP的缓存系统是通用的,但是如果我们想缓存实体,有EntityCache基类可以做到。如果我们通过实体的Id获取实体并希望通过Id缓存它们,从而避免重复查询数据库,那么我们可以使用这个基类。假设我们有这样一个Person实体:
public class Person : Entity { public string Name { get; set; } public int Age { get; set; } }
假设我们想频繁的通过Id获取其名称Name,首先创建一个类来存取缓存项:
[AutoMapFrom(typeof(Person))] public class PersonCacheItem { public string Name { get; set; } }
不要直接在缓存中存储实体,因为缓存可能需要序列化缓存的对象。实体可能不能被序列化,特别是当实体具有导航属性,这就是为什么我们定义了一个简单的(DTO)类来在缓存中存储数据。我们添加了AutoMapFrom属性,因为我们希望使用AutoMapper将Person实体自动转换为PersonCacheItem对象。如果我们不使用AutoMapper,我们应该覆盖EntityCache类的MapToCacheItem方法来手动转换/映射它。
虽然这不是必需的,但我们最好给缓存类定义一个接口:
public interface IPersonCache : IEntityCache<PersonCacheItem> { }
最后,我们可以创建cache类来缓存Person实体:
public class PersonCache : EntityCache<Person, PersonCacheItem>, IPersonCache, ITransientDependency { public PersonCache(ICacheManager cacheManager, IRepository<Person> repository) : base(cacheManager, repository) { } }
如上所示,我们的Person缓存已准备好使用! 缓存类可以是瞬态的(如本例所示),也可以是单例的。这并不意味着缓存的数据是瞬时的。它总是全局缓存,并在应用程序中以线程安全的方式访问。
当我们想获取一个人的名字时,我们可以使用这个人的Id从缓存中获取,比如:
public class MyPersonService : ITransientDependency { private readonly IPersonCache _personCache; public MyPersonService(IPersonCache personCache) { _personCache = personCache; } public string GetPersonNameById(int id) { return _personCache[id].Name; //alternative: _personCache.Get(id).Name; } }
我们只需注入IPersonCache,获取缓存项,然后获取Name属性。
EntityCache是如何工作的
- 它在第一次调用中从存储库(数据库)获取实体。然后在后续调用中从缓存中获取。
- 如果更新或删除缓存的实体,它将自动使该实体失效,然后在下一个调用中从数据库中检索。
- 它使用IObjectMapper将实体映射到缓存项,IObjectMapper由AutoMapper模块实现,可以覆盖MapToCacheItem方法来手动将实体映射到缓存项。
- 它使用cache类的FullName作为缓存名,可以通过将缓存名传递给基本构造函数来更改它。
- 它是线程安全的。
如果需要更复杂的缓存需求,可以扩展EntityCache或创建自己的解决方案。
Redis缓存集成
默认的缓存管理器使用内存缓存。如果有多个并发web服务器运行相同的应用程序,则可能会出现问题。在这种情况下,可能需要一个分布式/中央缓存服务器,可以使用Redis作为缓存服务器。
首先需要将Abp.RedisCache通过Nuget包安装到应用程序中,然后需要为AbpRedisCacheModule添加DependsOn属性,并在模块的PreInitialize方法中调用UseRedis扩展方法,如下图所示:
//...other namespaces using Abp.Runtime.Caching.Redis; namespace MyProject.AbpZeroTemplate.Web { [DependsOn( //...other module dependencies typeof(AbpRedisCacheModule))] public class MyProjectWebModule : AbpModule { public override void PreInitialize() { //...other configurations Configuration.Caching.UseRedis(); } //...other code } }
Abp.RedisCache默认使用“localhost”作为连接字符串,可以在配置文件中修改:
<add name="Abp.Redis.Cache" connectionString="localhost"/>
还可以向appSettings添加一个设置来设置Redis的数据库id:
<add key="Abp.Redis.Cache.DatabaseId" value="2"/>
不同的数据库id对于在同一服务器中创建不同的键空间(隔离缓存)非常有用。
UseRedis方法还有一个重载,它采取一个操作来直接设置选项值(这将覆盖配置文件中的值)。
有关Redis及其配置的更多信息,请参阅Redis文档: Redis documentation
注意:应该安装并运行Redis服务器来使用ABP中的Redis缓存。
以上是关于ABP之Caching的主要内容,如果未能解决你的问题,请参考以下文章