Paralax.Persistence.MongoDB
1.0.331
See the version list below for details.
dotnet add package Paralax.Persistence.MongoDB --version 1.0.331
NuGet\Install-Package Paralax.Persistence.MongoDB -Version 1.0.331
<PackageReference Include="Paralax.Persistence.MongoDB" Version="1.0.331" />
paket add Paralax.Persistence.MongoDB --version 1.0.331
#r "nuget: Paralax.Persistence.MongoDB, 1.0.331"
// Install Paralax.Persistence.MongoDB as a Cake Addin #addin nuget:?package=Paralax.Persistence.MongoDB&version=1.0.331 // Install Paralax.Persistence.MongoDB as a Cake Tool #tool nuget:?package=Paralax.Persistence.MongoDB&version=1.0.331
<div align="center">
Paralax Framework
</div>
Overview
The Paralax Framework is a modern, powerful, and modular open-source .NET framework optimized for building microservice architectures. It provides essential components, including encryption, CQRS, logging, messaging, persistence, cloud integration, and HTTP services. Paralax is optimized for .NET 9.0 and integrates seamlessly into cloud-native environments, making it ideal for scalable and resilient distributed systems.
Whether you’re building microservices from scratch or extending existing services, Paralax offers a comprehensive toolkit that is both flexible and easy to integrate.
Key Features
- Modular and Extensible: Tailor your microservices by using only the components you need.
- Security-First: Offers encryption, hashing, signing, and secrets management out of the box.
- Advanced CQRS and Event Sourcing: Full support for the Command-Query Responsibility Segregation (CQRS) pattern and event sourcing for scalable applications.
- Message Brokering: Seamless integration with RabbitMQ, Kafka, and other message brokers.
- HTTP & Web API: Robust HTTP client, server support, and API gateway integration.
- Serialization: Built-in support for both JSON and binary serialization, crucial for optimized data transfer between microservices.
- Cloud-Native: Optimized for Kubernetes, Docker, and other cloud platforms.
- Observability: Built-in support for logging, metrics, and distributed tracing using OpenTelemetry and Jaeger.
- Persistence: Ready-to-use integrations with MongoDB, Redis, and Consul for robust data storage solutions.
- API Documentation: Integration with Swagger and ReDoc to generate comprehensive API documentation.
Table of Contents
Getting Started
Prerequisites
- .NET 9.0 SDK or higher: Download .NET 9.0
- A container platform like Docker or Kubernetes (for cloud-native applications).
Installation
You can install the framework and its core components via NuGet:
dotnet add package Paralax
dotnet add package Paralax.Auth
dotnet add package Paralax.CQRS
dotnet add package Paralax.Logging
dotnet add package Paralax.MessageBrokers
For specialized functionality HTTP, Web API, and message brokers:
dotnet add package Paralax.HTTP
dotnet add package Paralax.WebAPI
dotnet add package Paralax.MessageBrokers.RabbitMQ
dotnet add package Paralax.Tracing.Jaeger
Usage
Once installed, you can start configuring Paralax in your microservices project. Below is an example of configuring logging, tracing, and CQRS with RabbitMQ for message brokering.
public static void Main(string[] args)
{
var builder = WebApplication.CreateBuilder(args);
// Add Paralax components
builder.Services.AddParalaxLogging();
builder.Services.AddParalaxTracing();
builder.Services.AddParalaxCQRS();
builder.Services.AddParalaxMessageBrokerRabbitMQ();
var app = builder.Build();
// Middleware setup
app.UseParalax();
app.Run();
}
Components
Paralax.Auth
The Paralax.Auth module provides authentication and authorization mechanisms, including JWT-based authentication and OAuth2 integrations.
Paralax.CQRS
This module implements the CQRS (Command-Query Responsibility Segregation) pattern, allowing for scalable, event-driven microservices. It provides:
- Commands: Handling write operations.
- Queries: Handling read operations.
- Events: Implementing event sourcing.
Paralax.MessageBrokers
Supports popular messaging systems like RabbitMQ and Kafka. It enables asynchronous communication between microservices and ensures reliable delivery of messages.
Example:
services.AddParalaxMessageBrokerRabbitMQ(options =>
{
options.HostName = "rabbitmq.example.com";
});
Paralax.HTTP
Provides a robust HTTP client and server integration, supporting binary serialization of payloads for performance-critical services.
Paralax.WebAPI
A framework built on top of ASP.NET Core Web API, optimized for building APIs with minimal overhead. It integrates binary serialization for efficient communication and supports Swagger for API documentation.
Paralax.Logging
Out-of-the-box logging integration with support for multiple sinks (e.g., Console, Elasticsearch, etc.). It uses best-in-class logging libraries to ensure visibility into your microservices.
Paralax.Tracing
Integrated distributed tracing with OpenTelemetry and Jaeger for monitoring service calls and diagnosing bottlenecks in complex microservice architectures.
Contributing
We welcome contributions from the open-source community! To contribute, please refer to the Contributing Guide for more details on how to get started.
Reporting Issues
If you encounter bugs or issues while using Paralax, please report them through the GitHub Issues page.
License
The Paralax Framework is licensed under the Apache-2.0 License. See the LICENSE file for details.
Credits
The Paralax Framework is maintained by ITSharpPro. We appreciate contributions from developers around the world who help improve the framework for the global development community.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
-
net8.0
- MongoDB.Driver (>= 2.29.0)
- Paralax (>= 1.0.328)
- Paralax.CQRS.Queries (>= 1.0.328)
-
net9.0
- MongoDB.Driver (>= 2.29.0)
- Paralax (>= 1.0.328)
- Paralax.CQRS.Queries (>= 1.0.328)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Paralax.Persistence.MongoDB:
Package | Downloads |
---|---|
Paralax.MessageBrokers.Outbox.Mongo
Paralax.MessageBrokers.Outbox.Mongo - MongoDB integration for the Outbox pattern in microservices architecture |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.406 | 102 | 10/30/2024 |
1.0.404 | 73 | 10/30/2024 |
1.0.401 | 176 | 10/18/2024 |
1.0.396 | 70 | 10/18/2024 |
1.0.388 | 77 | 10/18/2024 |
1.0.384 | 76 | 10/18/2024 |
1.0.380 | 75 | 10/17/2024 |
1.0.376 | 71 | 10/17/2024 |
1.0.372 | 69 | 10/17/2024 |
1.0.368 | 85 | 10/17/2024 |
1.0.364 | 74 | 10/17/2024 |
1.0.356 | 536 | 10/3/2024 |
1.0.354 | 75 | 10/3/2024 |
1.0.352 | 75 | 10/3/2024 |
1.0.350 | 86 | 10/3/2024 |
1.0.348 | 80 | 10/3/2024 |
1.0.346 | 84 | 10/3/2024 |
1.0.344 | 99 | 10/3/2024 |
1.0.343 | 86 | 10/1/2024 |
1.0.342 | 91 | 9/30/2024 |
1.0.339 | 87 | 9/30/2024 |
1.0.338 | 93 | 9/30/2024 |
1.0.335 | 120 | 9/30/2024 |
1.0.332 | 84 | 9/30/2024 |
1.0.331 | 78 | 9/30/2024 |
1.0.328 | 83 | 9/30/2024 |
1.0.325 | 76 | 9/30/2024 |
1.0.322 | 92 | 9/30/2024 |
1.0.319 | 89 | 9/30/2024 |
1.0.305 | 85 | 9/29/2024 |
1.0.291 | 99 | 9/29/2024 |
1.0.268 | 93 | 9/29/2024 |
1.0.258 | 112 | 9/28/2024 |
1.0.256 | 91 | 9/28/2024 |
1.0.217 | 92 | 9/28/2024 |
1.0.214 | 84 | 9/28/2024 |
1.0.211 | 91 | 9/28/2024 |
1.0.205 | 93 | 9/28/2024 |
1.0.202 | 90 | 9/28/2024 |
1.0.199 | 88 | 9/27/2024 |
1.0.196 | 83 | 9/27/2024 |
1.0.193 | 89 | 9/27/2024 |
1.0.190 | 84 | 9/27/2024 |
1.0.187 | 82 | 9/27/2024 |
1.0.184 | 89 | 9/27/2024 |
1.0.181 | 85 | 9/27/2024 |
1.0.178 | 86 | 9/27/2024 |
1.0.175 | 159 | 9/26/2024 |
1.0.172 | 82 | 9/26/2024 |
1.0.169 | 93 | 9/26/2024 |
1.0.166 | 93 | 9/24/2024 |
1.0.159 | 86 | 9/23/2024 |
1.0.155 | 89 | 9/23/2024 |
1.0.152 | 92 | 9/23/2024 |
Initial release of Paralax.Persistence.MongoDB for integrating MongoDB in microservices.