ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions
10.0.0-beta.1
dotnet add package ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions --version 10.0.0-beta.1
NuGet\Install-Package ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions -Version 10.0.0-beta.1
<PackageReference Include="ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions" Version="10.0.0-beta.1" />
<PackageVersion Include="ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions" Version="10.0.0-beta.1" />
<PackageReference Include="ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions" />
paket add ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions --version 10.0.0-beta.1
#r "nuget: ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions, 10.0.0-beta.1"
#:package ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions@10.0.0-beta.1
#addin nuget:?package=ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions&version=10.0.0-beta.1&prerelease
#tool nuget:?package=ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions&version=10.0.0-beta.1&prerelease
ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions
نمای کلی
این پروژه قراردادهای capability مربوط به Parrot را نگه میدارد.
هدف این پروژه این است که:
- API مصرفی capability را تعریف کند
- قراردادهای لازم برای providerها را مشخص کند
- مرز بین core و providerها را شفاف نگه دارد
این پروژه فاقد پیادهسازی اجرایی است.
ساختار
این پروژه شامل این بخشهاست:
- Builders
- Contracts
- Models
قراردادهای اصلی
ITranslator
API مصرفی capability است و مصرفکننده فقط با این قرارداد کار میکند.
مسئولیتها:
- دریافت ترجمه بر اساس key
- دریافت ترجمه بر اساس culture
- پشتیبانی از formatting
- پشتیبانی از concat
- پشتیبانی از fallback
ITranslationDataProvider
قرارداد providerهای داده است.
هر provider باید بتواند دادههای ترجمه را بارگذاری کند.
ITranslationRefreshService
برای trigger کردن refresh دادهها استفاده میشود.
این قرارداد برای decouple کردن providerها از core تعریف شده است.
ITranslationMissingKeyRegistrar
برای ثبت اختیاری کلیدهای جاافتاده استفاده میشود.
این قرارداد در API مصرفی دیده نمیشود و فقط برای wiring داخلی است.
IParrotBuilder
builder مربوط به registration capability است.
providerها از طریق این builder به registration اصلی متصل میشوند.
مدلها
TranslationEntry
نماینده یک رکورد ترجمه است و شامل:
- key
- culture
- value
نکات طراحی
- این پروژه فقط قراردادها را نگه میدارد
- نباید شامل منطق اجرایی باشد
- نباید به provider خاصی وابسته شود
- باید پایدار و کمتغییر باقی بماند
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
NuGet packages (4)
Showing the top 4 NuGet packages that depend on ZaminX.BuildingBlocks.CrossCutting.Translator.Abstractions:
| Package | Downloads |
|---|---|
|
ZaminX.ApplicationPatterns.HandlerExecution
Package Description |
|
|
ZaminX.BuildingBlocks.CrossCutting.Translator.Parrot
Parrot is the Translator capability of ZaminX for key-based translation with provider-based architecture. |
|
|
ZaminX.BuildingBlocks.CrossCutting.Translator.PostgreSQL
Package Description |
|
|
ZaminX.BuildingBlocks.CrossCutting.Translator.SqlServer
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 10.0.0-beta.1 | 763 | 4/4/2026 |