Krasowiki.Tools.SimpleStorage 0.1.1

Krasowiki.Tools.SimpleTableStorage

Krasowiki.Tools.SimpleTableStorage is a library that simplifies working with Azure Table Storage. It provides convenient tools for integration with DI (ServiceCollection), simplifies CRUD operations, and makes it easy to add new tables to application logic. The library is a wrapper around Azure.Data.Tables.

Features

• Simplified interaction with Azure Table Storage
• Integration with IServiceCollection
• Easy entity model definition
• Convenient table operations using ISimpleTableClient<>, allowing mockable interactions with Table Storage

Installation

Install the package via NuGet:

Install-Package Krasowiki.Tools.SimpleTableStorage

Usage

Defining Entity Models

Entities can inherit from SimpleTableEntity or implement the standard ITableEntity interface. Using SimpleTableEntity provides ready-to-use fields such as PartitionKey, RowKey, and Timestamp.

using Krasowiki.Tools.SimpleTableStorage;

public class UserEntity : SimpleTableEntity
{
    public string Name { get; set; }
    public int Age { get; set; }
}

If full control over the model is required, you can implement ITableEntity:

Defining a Table Clients Holder

Create an abstraction for the table clients holder class:

public interface ITableClientsHolder
{
    ISimpleTableClient<UserEntity> Users { get; }
    TableClient CustomTable { get; }
}

Implement it by storing clients in properties with get and set:

using Krasowiki.Tools.SimpleTableStorage;
using Azure.Data.Tables;

public class TableClientsHolder : ITableClientsHolder
{
    public ISimpleTableClient<UserEntity> Users { get; set; }
    public TableClient CustomTable { get; set; }
}

Registering in DI

Add Table Storage support to IServiceCollection:

services.AddTableStorageSimply<ITableClientsHolder, TableClientsHolder>("YOUR_STORAGE_ACCOUNT_CONNECTION_STRING");

Using in Code

Access tables through DI:

var serviceProvider = services.BuildServiceProvider();
var tableHolder = serviceProvider.GetRequiredService<ITableClientsHolder>();

var newUser = new UserEntity { PartitionKey = "Users", RowKey = "1", Name = "John Doe", Age = 30 };
await tableHolder.Users.AddEntityAsync(newUser);

Sample Application

The repository contains the Krasowiki.Tools.SimpleTableStorage.SampleApp project, which provides a simple example of how to integrate and use the library.