Foundatio - .Net Core用于构建分布式应用程序的可插拔基础块

简介

Foundatio - 用于构建分布式应用程序的可插拔基础块

•想要针对抽象接口进行构建，以便我们可以轻松更改实现。希望这些块对依赖注入友好。

•缓存：我们最初使用的是开源 Redis 缓存客户端，但后来它变成了具有高许可成本的商业产品。不仅如此，而且没有任何内存实现，因此每个开发人员都需要设置和配置 Redis。

•消息总线：我们最初关注的是NServiceBus（伟大的产品），但它的许可成本很高（他们也必须吃），但对 OSS 不友好。我们还研究了MassTransit，但发现缺少 Azure 支持并且本地设置很麻烦。我们想要一个可以在本地或云中运行的简单消息总线。

•存储：我们找不到任何在内存、文件存储或 Azure Blob 存储中解耦和支持的现有项目。

总而言之，如果您希望在允许应用扩展的同时进行无痛开发和测试，请使用 Foundatio！

使用

功能

•Caching

•Queues

•Locks

•Messaging

•Jobs

•File Storage

•Metrics

Caching

缓存允许您快速存储和访问数据，ICacheClient我们提供了四种不同的从接口派生的缓存实现：

•InMemoryCacheClient：内存缓存客户端实现。此缓存实现仅在进程的生命周期内有效•HybridCacheClient：此缓存实现同时使用 anICacheClient和 theInMemoryCacheClient并使用 anIMessageBus来保持缓存跨进程同步

•RedisCacheClient：Redis 缓存客户端实现•RedisHybridCacheClient：HybridCacheClient使用RedisCacheClientasICacheClient和RedisMessageBusas的实现IMessageBus

-ScopedCacheClient：此缓存实现采用一个实例ICacheClient和一个字符串scope。范围是每个缓存键的前缀。这使得确定所有缓存键的范围并轻松删除它们变得非常容易。

using Foundatio.Caching;
ICacheClient cache = new InMemoryCacheClient();
await cache.SetAsync("test", 1);
var value = await cache.GetAsync<int>("test");

Queues

队列提供先进先出 (FIFO) 消息传递。IQueue我们提供了四种不同的从接口派生的队列实现：

•InMemoryQueue：内存队列实现。此队列实现仅在进程的生命周期内有效。

•RedisQueue：一个 Redis 队列实现。

•AzureServiceBusQueue：Azure 服务总线队列实现。

•AzureStorageQueue：Azure 存储队列实现。

•SQSQueue：AWS SQS 实施。

using Foundatio.Queues;

IQueue<SimpleWorkItem> queue = new InMemoryQueue<SimpleWorkItem>();

await queue.EnqueueAsync(new SimpleWorkItem {
    Data = "Hello"
});

var workItem = await queue.DequeueAsync();

Locks

锁确保在任何给定时间只能由一个消费者访问资源。ILockProvider我们提供了两种从接口派生的不同锁定实现：

•CacheLockProvider：使用缓存在进程之间进行通信的锁实现。

•ThrottlingLockProvider：一种只允许一定数量的锁通过的锁实现。您可以使用它来限制对某些外部服务的 api 调用，它会在所有请求该锁的进程中限制它们。

•ScopedLockProvider：这个锁实现需要一个实例ILockProvider和一个字符串scope。范围是每个锁定键的前缀。这使得确定所有锁的范围并轻松释放它们变得非常容易。

using Foundatio.Lock;
ILockProvider locker = new CacheLockProvider(new InMemoryCacheClient(), new InMemoryMessageBus());
var testLock = await locker.AcquireAsync("test");
// ...
await testLock.ReleaseAsync();
ILockProvider throttledLocker = new ThrottlingLockProvider(new InMemoryCacheClient(), 1, TimeSpan.FromMinutes(1));
var throttledLock = await throttledLocker.AcquireAsync("test");
// .
await throttledLock.ReleaseAsync();

Messaging

允许您发布和订阅流经您的应用程序的消息。IMessageBus我们提供了四种不同的从接口派生的消息总线实现：

•InMemoryMessageBus：内存消息总线实现。此消息总线实现仅在进程的生命周期内有效。

•RedisMessageBus : Redis 消息总线实现。

•RabbitMQMessageBus : RabbitMQ 实现。

•AzureServiceBusMessageBus：Azure 服务总线实现。

using Foundatio.Messaging;
IMessageBus messageBus = new InMemoryMessageBus();
await messageBus.SubscribeAsync<SimpleMessageA>(msg => {
// Got message
});
await messageBus.PublishAsync(new SimpleMessageA { Data = "Hello" });

Jobs

所有作业都必须从IJob接口派生。我们还有一个可以派生的JobBase基类，它提供 JobContext 和日志记录。然后，您可以通过调用RunAsync()作业或创建JobRunner类的实例并调用其中一个 Run 方法来运行作业。JobRunner 可用于轻松地将您的作业作为 Azure Web 作业运行。

using Foundatio.Jobs;
public class HelloWorldJob : JobBase {
public int RunCount { get; set; }
protected override Task<JobResult> RunInternalAsync(JobContext context) {
   RunCount++;
   return Task.FromResult(JobResult.Success);
}
}

File Storage

IFileStorage我们提供从接口派生的不同文件存储实现：

•InMemoryFileStorage：内存文件实现。此文件存储实现仅在进程的生命周期内有效。

•FolderFileStorage：使用硬盘驱动器进行存储的文件存储实现。

•AzureFileStorage：Azure Blob 存储实现。

•S3FileStorage：AWS S3 文件存储实现。

•RedisFileStorage : Redis 文件存储实现。

•MinioFileStorage Minio文件存储实现。

•AliyunFileStorage : 一个阿里云文件存储实现。

•SshNetFileStorage：一个 SFTP 文件存储实现。   

 using Foundatio.Storage;
IFileStorage storage = new InMemoryFileStorage();
await storage.SaveFileAsync("test.txt", "test");
string content = await storage.GetFileContentsAsync("test.txt")

Metrics

IMetricsClient我们提供了五个从接口派生的实现：

•InMemoryMetricsClient：内存中的指标实现。

•RedisMetricsClient：一个 Redis 指标实现。

•StatsDMetricsClient：一个 statsd 指标实现。

•MetricsNETClient：一个Metrics.NET实现。

•AppMetricsClient：一个AppMetrics实现。

•CloudWatchMetricsClient：AWS CloudWatch实施。

IMetricsClient metrics = new InMemoryMetricsClient();
metrics.Counter("c1");
metrics.Gauge("g1", 2.534);
metrics.Timer("t1", 50788);

Github地址

https://github.com/FoundatioFx/Foundatio 最后大家如果喜欢我的文章，还麻烦给个关注并点个赞, 希望net生态圈越来越好！