OfX 9.0.0

OfX

public string XId { get; set; }
[XOf(nameof(XId))] public string X { get; set; }

OfX is an open-source library focused on Attribute-based data mapping. It streamlines data handling across services, reduces boilerplate code, and improves maintainability.

Full Documentation | Getting Started |Expression Language

Quick Start

dotnet add package OfX

// 1. Configure OfX
builder.Services.AddOfX(cfg =>
{
    cfg.AddAttributesContainNamespaces(typeof(UserOfAttribute).Namespace!);
    cfg.AddModelConfigurationsFromNamespaceContaining<SomeModelAssemblyMarker>();
});

// 2. Define a custom OfXAttribute
public sealed class UserOfAttribute(string propertyName) : OfXAttribute(propertyName);

// 3. Configure the model
[OfXConfigFor<UserOfAttribute>(nameof(Id), nameof(Name))]
public sealed class User
{
    public string Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
}

// 4. Use attributes in your DTOs
public sealed class SomeDataResponse
{
    public string UserId { get; set; }

    [UserOf(nameof(UserId))]
    public string UserName { get; set; }

    [UserOf(nameof(UserId), Expression = "Email")]
    public string UserEmail { get; set; }
}

Key Features

• Attribute-based Mapping: Declarative data fetching using custom attributes
• Powerful Expression Language: SQL-like DSL for complex queries, filtering, aggregation, and projections
• Multiple Data Providers: Support for EF Core, MongoDB, and more
• Multiple Transports: gRPC, NATS, RabbitMQ, Kafka, Azure Service Bus
• GraphQL Integration: Seamless integration with HotChocolate

Expression Examples

// Simple property access
[UserOf(nameof(UserId), Expression = "Email")]
public string UserEmail { get; set; }

// Navigation properties
[ProvinceOf(nameof(ProvinceId), Expression = "Country.Name")]
public string CountryName { get; set; }

// Filtering
[UserOf(nameof(UserId), Expression = "Orders(Status = 'Done')")]
public List<OrderDTO> CompletedOrders { get; set; }

// Aggregation
[UserOf(nameof(UserId), Expression = "Orders:sum(Total)")]
public decimal TotalSpent { get; set; }

// Projection
[UserOf(nameof(UserId), Expression = "{Id, Name, Address.City as CityName}")]
public UserInfo UserDetails { get; set; }

// GroupBy
[UserOf(nameof(UserId), Expression = "Orders:groupBy(Status).{Status, :count as Count}")]
public List<OrderSummary> OrdersByStatus { get; set; }

For complete expression syntax including filters, indexers, functions, aggregations, boolean functions, coalesce, ternary operators, and more, visit Expression Documentation.

Packages

Documentation

Visit ofxmapper.net for:

• Getting Started Guide
• Configuration Options
• Expression Language Reference
• Data Provider Setup
• Transport Configuration
• API Reference

Contributing

Contributions are welcome! Please visit our GitHub repository to:

• Report issues
• Submit pull requests
• Request features

License

This project is licensed under the Apache-2.0 license.