🏛️ Athena.Cache

Smart caching library for ASP.NET Core with automatic query parameter key generation and table-based cache invalidation.

Athena.Cache는 ASP.NET Core 애플리케이션을 위한 지능형 캐싱 라이브러리입니다. 어트리뷰트 기반의 선언적 캐싱과 자동 무효화를 통해 개발자가 캐시 관리에 신경 쓰지 않고도 높은 성능을 얻을 수 있습니다.

⚡ Quick Start

1. Install Package

dotnet add package Athena.Cache.Core

2. Configure Services

// Program.cs
builder.Services.AddAthenaCacheComplete(options => {
    options.Namespace = "MyApp";
    options.DefaultExpirationMinutes = 30;
});

var app = builder.Build();

app.UseRouting();
app.UseAthenaCache();  // Add after routing
app.MapControllers();

3. Use in Controllers

[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    [HttpGet]
    [AthenaCache(ExpirationMinutes = 30)]
    [CacheInvalidateOn("Users")]
    public async Task<ActionResult<IEnumerable<UserDto>>> GetUsers()
    {
        // This will be automatically cached
        // Cache will be invalidated when Users table changes
        return Ok(await _userService.GetUsersAsync());
    }
}

That’s it! Your API responses are now cached automatically.

✨ Key Features

Automatic Caching

Simply add [AthenaCache] to your controller actions. Cache keys are automatically generated from method parameters.

Smart Invalidation

Use [CacheInvalidateOn("TableName")] to automatically invalidate cache when database tables change.

Zero Memory

Advanced memory optimization techniques reduce allocations by up to 98% for high-performance applications.

Distributed Ready

Seamless Redis integration for distributed caching across multiple application instances.

Source Generator

Compile-time optimizations eliminate reflection overhead and enable AOT compilation support.

Built-in Monitoring

Real-time dashboards, performance metrics, and analytics to optimize your cache performance.

📦 Package Ecosystem

Athena.Cache는 모듈식 패키지 시스템으로 필요한 기능만 선택해서 사용할 수 있습니다.

Package	Description	NuGet
Athena.Cache.Core	기본 캐싱 기능 (MemoryCache)
Athena.Cache.Redis	Redis 분산 캐싱 지원
Athena.Cache.Monitoring	실시간 모니터링 및 알림
Athena.Cache.Analytics	고급 분석 및 인사이트
Athena.Cache.SourceGenerator	컴파일 타임 최적화

🚀 Get Started

Installation Guide Learn the Basics Core Features

🎯 Why Athena.Cache?

Before Athena.Cache

public async Task<UserDto> GetUser(int id)
{
    var cacheKey = $"user_{id}";
    
    if (_cache.TryGetValue(cacheKey, out UserDto cached))
        return cached;
    
    var user = await _userService.GetUserAsync(id);
    
    _cache.Set(cacheKey, user, TimeSpan.FromMinutes(30));
    
    return user;
}

// When user is updated, you need to remember to invalidate cache
public async Task UpdateUser(UserDto user)
{
    await _userService.UpdateUserAsync(user);
    
    // Don't forget this! (but you probably will)
    _cache.Remove($"user_{user.Id}");
    _cache.Remove("users_list");
    // ... and many more related caches
}

With Athena.Cache

[HttpGet("{id}")]
[AthenaCache(ExpirationMinutes = 30)]
public async Task<UserDto> GetUser(int id)
{
    return await _userService.GetUserAsync(id);
}

[HttpPut("{id}")]
[CacheInvalidateOn("Users")]  // Automatically invalidates all related caches
public async Task UpdateUser(int id, [FromBody] UserDto user)
{
    await _userService.UpdateUserAsync(user);
}

그게 전부입니다! 캐시 키 생성, 저장, 무효화가 모두 자동으로 처리됩니다.

🌟 Community & Support

📖 Documentation: Comprehensive guides and API reference
🐛 Issues: Report bugs and request features
💬 Discussions: Ask questions and share experiences
📊 Examples: Sample applications and use cases

📄 License

Athena.Cache is open source software licensed under the MIT License.

Made with ❤️ by Bruno Kim

⭐ Star us on GitHub if you find Athena.Cache useful!