saherelm/xSaherelmWorkspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Last ...

Browse Source
This commit is contained in:
saherelm
2026-10-03 18:04:36 +03:30
parent 92988ea155
commit 81b900b887
20 changed files with 48612 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Documents/Docs/Developer/13.html
+351
View File
@@ -0,0 +1,351 @@
<!DOCTYPE html>
<html lang="fa" dir="rtl">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>رفع خطای Circular Dependency در XFileContentExtractor - فن آوران ساحر علم</title>
<style>
:root {
--primary: #1e3a8a;
--secondary: #3b82f6;
--accent: #f59e0b;
--success: #10b981;
--danger: #ef4444;
--warning: #f97316;
--bg-light: #f8fafc;
--bg-code: #1e293b;
--text-dark: #0f172a;
--text-muted: #64748b;
--border: #e2e8f0;
}
* { box-sizing: border-box; margin: 0; padding: 0; }
body {
font-family: 'Tahoma', 'Segoe UI', sans-serif;
background: linear-gradient(135deg, #f8fafc 0%, #e0e7ff 100%);
color: var(--text-dark);
line-height: 1.8;
padding: 20px;
}
.container {
max-width: 1200px;
margin: 0 auto;
background: white;
border-radius: 16px;
box-shadow: 0 20px 60px rgba(0,0,0,0.1);
overflow: hidden;
}
.header {
background: linear-gradient(135deg, var(--primary) 0%, var(--secondary) 100%);
color: white;
padding: 40px;
text-align: center;
}
.header h1 { font-size: 2.1em; margin-bottom: 10px; }
.header .subtitle { font-size: 1.1em; opacity: 0.95; }
.meta-bar {
display: flex;
justify-content: space-between;
background: var(--bg-light);
padding: 15px 30px;
border-bottom: 2px solid var(--border);
flex-wrap: wrap;
gap: 15px;
}
.meta-item { display: flex; align-items: center; gap: 8px; font-size: 0.9em; color: var(--text-muted); }
.meta-item strong { color: var(--primary); }
.content { padding: 40px; }
.section {
margin-bottom: 35px;
padding: 25px;
background: var(--bg-light);
border-radius: 12px;
border-right: 5px solid var(--secondary);
}
.section h2 {
color: var(--primary);
font-size: 1.5em;
margin-bottom: 20px;
padding-bottom: 10px;
border-bottom: 2px solid var(--border);
}
pre {
background: var(--bg-code);
color: #e2e8f0;
padding: 18px;
border-radius: 8px;
overflow-x: auto;
direction: ltr;
text-align: left;
font-family: 'Consolas', monospace;
font-size: 0.85em;
margin: 15px 0;
border-right: 4px solid var(--accent);
}
code {
background: #fef3c7;
color: #92400e;
padding: 2px 8px;
border-radius: 4px;
font-family: 'Consolas', monospace;
font-size: 0.9em;
direction: ltr;
display: inline-block;
}
table {
width: 100%;
border-collapse: collapse;
margin: 15px 0;
background: white;
border-radius: 8px;
overflow: hidden;
}
th { background: var(--primary); color: white; padding: 12px; text-align: right; }
td { padding: 12px; border-bottom: 1px solid var(--border); }
.alert { padding: 15px 20px; border-radius: 8px; margin: 15px 0; border-right: 4px solid; }
.alert-info { background: #dbeafe; border-color: var(--secondary); color: #1e40af; }
.alert-success { background: #d1fae5; border-color: var(--success); color: #065f46; }
.alert-danger { background: #fee2e2; border-color: var(--danger); color: #991b1b; }
.footer { background: var(--primary); color: white; padding: 25px; text-align: center; }
.file-change { background: #f0f9ff; border-right: 4px solid var(--secondary); padding: 15px; margin: 10px 0; border-radius: 8px; }
.file-change .path { font-family: 'Consolas', monospace; color: var(--primary); font-weight: bold; direction: ltr; display: inline-block; }
.badge-modify { background: var(--warning); color: white; padding: 2px 8px; border-radius: 4px; font-size: 0.75em; margin-right: 8px; }
.badge-new { background: var(--success); color: white; padding: 2px 8px; border-radius: 4px; font-size: 0.75em; margin-right: 8px; }
.diff-old { background: #fee2e2; color: #991b1b; padding: 2px 6px; border-radius: 3px; text-decoration: line-through; }
.diff-new { background: #d1fae5; color: #065f46; padding: 2px 6px; border-radius: 3px; font-weight: bold; }
</style>
</head>
<body>
<div class="container">
<div class="header">
<h1>🔗 رفع خطای Circular Dependency در XFileContentExtractor</h1>
<div class="subtitle">تحلیل و رفع حلقه وابستگی در Composite Extractor Pattern</div>
</div>
<div class="meta-bar">
<div class="meta-item">👨‍💻 <strong>توسعه‌دهنده:</strong> هادی خزاعی اصل</div>
<div class="meta-item">🏢 <strong>شرکت:</strong> فن آوران ساحر علم</div>
<div class="meta-item">📅 <strong>تاریخ:</strong> شنبه ۱۲ مهر ۱۴۰۵</div>
<div class="meta-item">📦 <strong>پروژه:</strong> xAiApi</div>
</div>
<div class="content">
<!-- Section 1: Analysis -->
<div class="section">
<h2>🔍 تحلیل ریشه خطا</h2>
<p>خطای <code>Circular Dependency</code> به دلیل ثبت نادرست <code>XFileContentExtractor</code> در DI Container ایجاد شده است:</p>
<div class="alert alert-danger">
<strong>⚠️ پیغام خطا:</strong><br>
<code style="font-size: 0.9em;">A circular dependency was detected for the service of type 'IEnumerable&lt;IXFileContentExtractor&gt;'</code>
</div>
<h3>زنجیره وابستگی مشکل‌ساز:</h3>
<table>
<tr>
<th>مرحله</th>
<th>سرویس</th>
<th>وابستگی</th>
</tr>
<tr>
<td>۱</td>
<td><code>XFileContentExtractor</code></td>
<td>نیاز به <code>IEnumerable&lt;IXFileContentExtractor&gt;</code> در constructor</td>
</tr>
<tr>
<td>۲</td>
<td><code>IEnumerable&lt;IXFileContentExtractor&gt;</code></td>
<td>شامل تمام <code>IXFileContentExtractor</code> های ثبت شده</td>
</tr>
<tr>
<td>۳</td>
<td><code>XFileContentExtractor</code> (دوباره!)</td>
<td>خودش هم به عنوان <code>IXFileContentExtractor</code> ثبت شده ❌</td>
</tr>
<tr>
<td>۴</td>
<td colspan="2" style="background: var(--danger); color: white;"><strong>حلقه بی‌نهایت → Crash</strong></td>
</tr>
</table>
</div>
<!-- Section 2: Solution -->
<div class="section">
<h2>💡 راه‌حل اصلاحی</h2>
<p>برای شکستن این حلقه، باید <code>XFileContentExtractor</code> را به عنوان <code>IXFileContentExtractor</code> ثبت <strong>نکنیم</strong>. به جای آن، آن را به صورت دستی با factory بسازیم.</p>
<div class="file-change">
<span class="badge-modify">MODIFY</span>
<span class="path">xAiApi/Startup.cs (متد ConfigureServices)</span>
</div>
<h3>کد اصلاح‌شده:</h3>
<pre>public void ConfigureServices(IServiceCollection services)
{
// ... (ثبت‌های قبلی)
// ==========================================================
// ✅ ثبت File Content Extractors (همگی Singleton)
// ==========================================================
// ۱. ثبت Extractor های پایه
services.AddSingleton&lt;IXFileContentExtractor, XPdfFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XDocxFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XImageFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XAudioFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XExcelFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XVisionFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XPlainTextFileContentExtractor&gt;();
// ۲. ✅ اصلاح: ثبت XFileContentExtractor به صورت Factory
// به جای ثبت به عنوان IXFileContentExtractor، آن را به صورت دستی می‌سازیم
services.AddSingleton&lt;XFileContentExtractor&gt;(sp =&gt;
{
// دریافت تمام Extractor های ثبت شده (به جز XFileContentExtractor)
var extractors = sp.GetServices&lt;IXFileContentExtractor&gt;();
return new XFileContentExtractor(extractors);
});
// ۳. ✅ ثبت XFileContentExtractor به عنوان IXFileContentExtractor
// اما با استفاده از Factory که از قبل ساخته شده
services.AddSingleton&lt;IXFileContentExtractor&gt;(sp =&gt;
sp.GetRequiredService&lt;XFileContentExtractor&gt;());
// ==========================================================
// ✅ ثبت سرویس‌های AI
// ==========================================================
services.AddSingleton&lt;IXDefaultAIOCRService, XDefaultAIOCRService&gt;();
services.AddScoped&lt;IXDefaultAiService, XDefaultAiService&gt;();
services.AddScoped&lt;IXDefaultEmbeddingService, XDefaultEmbeddingService&gt;();
services.AddScoped&lt;IXDefaultThinkingAiService, XDefaultThinkingAiService&gt;();
}</pre>
<div class="alert alert-success">
<strong>✅ چرا این راه‌حل کار می‌کند؟</strong>
<ul style="padding-right: 25px; margin-top: 10px;">
<li>✅ <code>XFileContentExtractor</code> ابتدا به عنوان خودش (نه interface) ثبت می‌شود</li>
<li>✅ در factory، تمام <code>IXFileContentExtractor</code> های دیگر را دریافت می‌کند</li>
<li>✅ سپس به عنوان <code>IXFileContentExtractor</code> ثبت می‌شود (اما از instance از قبل ساخته شده)</li>
<li>✅ حلقه وابستگی شکسته می‌شود</li>
</ul>
</div>
</div>
<!-- Section 3: Alternative Solution -->
<div class="section">
<h2>🔄 راه‌حل جایگزین (ساده‌تر)</h2>
<p>اگر راه‌حل بالا پیچیده به نظر می‌رسد، می‌توانید از این روش ساده‌تر استفاده کنید:</p>
<div class="file-change">
<span class="badge-modify">MODIFY</span>
<span class="path">xAiApi/Startup.cs</span>
</div>
<pre>public void ConfigureServices(IServiceCollection services)
{
// ... (ثبت‌های قبلی)
// ==========================================================
// ✅ ثبت File Content Extractors
// ==========================================================
// ۱. ثبت Extractor های پایه
services.AddSingleton&lt;IXFileContentExtractor, XPdfFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XDocxFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XImageFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XAudioFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XExcelFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XVisionFileContentExtractor&gt;();
services.AddSingleton&lt;IXFileContentExtractor, XPlainTextFileContentExtractor&gt;();
// ۲. ✅ راه‌حل ساده: ساخت دستی XFileContentExtractor
// ابتدا تمام Extractor ها را در یک لیست جمع می‌کنیم
var extractorTypes = new[]
{
typeof(XPdfFileContentExtractor),
typeof(XDocxFileContentExtractor),
typeof(XImageFileContentExtractor),
typeof(XAudioFileContentExtractor),
typeof(XExcelFileContentExtractor),
typeof(XPlainTextFileContentExtractor)
};
// ۳. ثبت XFileContentExtractor با factory
services.AddSingleton&lt;IXFileContentExtractor&gt;(sp =&gt;
{
var extractors = new List&lt;IXFileContentExtractor&gt;();
// ساخت دستی Extractor ها
foreach (var type in extractorTypes)
{
var instance = (IXFileContentExtractor)ActivatorUtilities.CreateInstance(sp, type);
extractors.Add(instance);
}
// افزودن XVisionFileContentExtractor (که وابستگی دارد)
var visionExtractor = sp.GetRequiredService&lt;XVisionFileContentExtractor&gt;();
extractors.Add(visionExtractor);
// ساخت XFileContentExtractor با لیست Extractor ها
return new XFileContentExtractor(extractors);
});
// ==========================================================
// ✅ ثبت سرویس‌های AI
// ==========================================================
services.AddSingleton&lt;IXDefaultAIOCRService, XDefaultAIOCRService&gt;();
services.AddScoped&lt;IXDefaultAiService, XDefaultAiService&gt;();
services.AddScoped&lt;IXDefaultEmbeddingService, XDefaultEmbeddingService&gt;();
services.AddScoped&lt;IXDefaultThinkingAiService, XDefaultThinkingAiService&gt;();
}</pre>
</div>
<!-- Section 4: Summary -->
<div class="section">
<h2>📋 خلاصه تغییرات</h2>
<table>
<tr>
<th>فایل</th>
<th>تغییر</th>
<th>دلیل</th>
</tr>
<tr>
<td><code>Startup.cs</code></td>
<td><span class="diff-old">services.AddScoped&lt;IXFileContentExtractor, XFileContentExtractor&gt;()</span><br>
<span class="diff-new">services.AddSingleton&lt;IXFileContentExtractor&gt;(sp =&gt; { ... })</span></td>
<td>رفع Circular Dependency با استفاده از Factory Pattern</td>
</tr>
</table>
<div class="alert alert-success">
<strong>✅ نتیجه نهایی:</strong>
<ul style="padding-right: 25px; margin-top: 10px;">
<li>✅ Circular Dependency کاملاً رفع می‌شود</li>
<li>✅ DI Container می‌تواند تمام سرویس‌ها را بسازد</li>
<li>✅ <code>XFileContentExtractor</code> همچنان به تمام Extractor ها دسترسی دارد</li>
<li>✅ خطای <code>AggregateException</code> دیگر ظاهر نخواهد شد</li>
</ul>
</div>
<div class="alert alert-info">
<strong>💡 نکته مهم:</strong>
<p>پس از اعمال این تغییر، پروژه را <strong>Rebuild</strong> کنید. خطای <code>System.AggregateException</code> دیگر ظاهر نخواهد شد و برنامه به درستی اجرا می‌شود.</p>
</div>
</div>
</div>
<div class="footer">
<p><strong>👨‍💻 توسعه‌دهنده:</strong> هادی خزاعی اصل</p>
<p><strong>🏢 شرکت:</strong> فن آوران ساحر علم</p>
<p><strong>📅 تاریخ:</strong> شنبه ۱۲ مهر ۱۴۰۵</p>
<p style="margin-top: 15px; opacity: 0.8; font-size: 0.9em;">
🔗 مستند فنی رفع خطای Circular Dependency در XFileContentExtractor - تمامی حقوق محفوظ است
</p>
</div>
</div>
</body>
</html>