hrynco/hrynco-rabbitmq
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: preserve current workspace changes

Browse Source 
Save pending configuration, deployment, and documentation work.
This commit is contained in:
Anatolii Hrynchuk
2026-10-03 00:56:29 +03:00
parent 7ff43afe52
commit a26777ca21
2 changed files with 63 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Hrynco.RabbitMq/Hrynco.RabbitMq.csproj
+27 -27
View File
@@ -1,27 +1,27 @@
<Project Sdk="Microsoft.NET.Sdk"> <Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup> <PropertyGroup>
<TargetFramework>net10.0</TargetFramework> <TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>disable</ImplicitUsings> <ImplicitUsings>disable</ImplicitUsings>
<Nullable>enable</Nullable> <Nullable>enable</Nullable>
<RootNamespace>Hrynco.RabbitMq</RootNamespace> <RootNamespace>Hrynco.RabbitMq</RootNamespace>
<PackageId>HrynCo.RabbitMq</PackageId> <PackageId>HrynCo.RabbitMq</PackageId>
<Authors>HrynCo</Authors> <Authors>HrynCo</Authors>
<Description>RabbitMQ publisher and consumer base for HrynCo applications.</Description> <Description>RabbitMQ publisher and consumer base for HrynCo applications.</Description>
<PackageTags>hrynco rabbitmq messaging</PackageTags> <PackageTags>hrynco rabbitmq messaging</PackageTags>
<RepositoryType>git</RepositoryType> <RepositoryType>git</RepositoryType>
<RepositoryUrl>https://gitea.grynco.com.ua/hrynco/hrynco-rabbitmq.git</RepositoryUrl> <RepositoryUrl>https://gitea.hrynco.com/hrynco/hrynco-rabbitmq.git</RepositoryUrl>
<PackageReadmeFile>README.md</PackageReadmeFile> <PackageReadmeFile>README.md</PackageReadmeFile>
</PropertyGroup> </PropertyGroup>
<ItemGroup> <ItemGroup>
<PackageReference Include="RabbitMQ.Client" Version="7.2.1"/> <PackageReference Include="RabbitMQ.Client" Version="7.2.1"/>
<PackageReference Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.0"/> <PackageReference Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.0"/>
<PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.0"/> <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.0"/>
</ItemGroup> </ItemGroup>
<ItemGroup> <ItemGroup>
<None Include="README.md" Pack="true" PackagePath=""/> <None Include="README.md" Pack="true" PackagePath=""/>
</ItemGroup> </ItemGroup>
</Project> </Project>
Hrynco.RabbitMq/README.md
+36 -34
View File
@@ -1,34 +1,36 @@
# HrynCo.RabbitMq # HrynCo.RabbitMq
RabbitMQ publisher and consumer base for HrynCo applications. RabbitMQ publisher and consumer base for HrynCo applications.
## Contents ## Contents
- `RabbitMqSettings` — connection settings record (host, port, user, password, virtual host) - `RabbitMqSettings` — connection settings record (host, port, user, password, virtual host)
- `IRabbitMqPublisher` / `RabbitMqPublisher` — publishes JSON-serialized messages to a named queue - `IRabbitMqPublisher` / `RabbitMqPublisher` — publishes JSON-serialized messages to a named queue
- `RabbitMqConsumerBase<TMessage, TMessageData>` — background service base with connection management, manual ACK/NACK, retry, permanent-validation rejection, and backward-compatible context-aware handling - `RabbitMqConsumerBase<TMessage, TMessageData>` — background service base with connection management, manual ACK/NACK, retry, permanent-validation rejection, and backward-compatible context-aware handling
- `RabbitMqMessageContext` — neutral AMQP delivery metadata (`MessageId`, type, correlation, routing, headers, and redelivery state) - `RabbitMqMessageContext` — neutral AMQP delivery metadata (`MessageId`, type, correlation, routing, headers, and redelivery state)
- `IRabbitMqMessage<TMessageData>` — message contract interface - `IRabbitMqMessage<TMessageData>` — message contract interface
- `CorrelationContext` — correlation ID carrier - `CorrelationContext` — correlation ID carrier
## Packaging ## Packaging
This package is intended for reuse through NuGet. The test project is excluded from packing. This package is intended for reuse through NuGet. The test project is excluded from packing.
## Consumer extension points ## Consumer extension points
Existing consumers can keep overriding `HandleMessageAsync(message, cancellationToken)`. Existing consumers can keep overriding `HandleMessageAsync(message, cancellationToken)`.
Consumers that need AMQP metadata can instead override Consumers that need AMQP metadata can instead override
`HandleMessageAsync(message, context, cancellationToken)`. The base class retains `HandleMessageAsync(message, context, cancellationToken)`. The base class retains
ownership of acknowledgements and retries. ownership of acknowledgements and retries.
Override `TryValidateMessage(...)` for application-specific permanent validation. Override `TryValidateMessage(...)` for application-specific permanent validation.
Returning `false` nacks the delivery without requeue before retry processing begins. Returning `false` nacks the delivery without requeue before retry processing begins.
Keep validation errors free of credentials and sensitive payload values. Keep validation errors free of credentials and sensitive payload values.
Override `HandleMessageRetriesExhaustedAsync(...)` when a consumer must react once to a Override `HandleMessageRetriesExhaustedAsync(...)` when a consumer must react once to a
terminal processing failure, for example by publishing a neutral failure result to the terminal processing failure, for example by publishing a neutral failure result to the
requesting client. The hook runs after the final handler exception and before the original requesting client. The hook runs after the final handler exception and before the original
delivery is nacked without requeue. Hook failures are logged and do not replace the delivery is nacked without requeue. Hook failures are logged and do not replace the
original failure or acknowledgement policy. Application shutdown cancellation does not original failure or acknowledgement policy. Application shutdown cancellation does not
invoke the hook. invoke the hook.
Package repository metadata points to [HrynCo.RabbitMq on Gitea](https://gitea.hrynco.com/hrynco/hrynco-rabbitmq). The hostname change does not alter package versions or messaging behavior.