Optimize 46 Watermark Java pages

.github/workflows/production.yml

@@ -26,23 +26,25 @@ jobs:
 
     # Steps represent a sequence of watermark that will be executed as part of the job
     steps:
-      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
-            submodules: true  # Fetch Hugo themes
-            fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+            submodules: true
+            fetch-depth: 0
       - name: Checkout theme repo
-        uses: actions/checkout@main
+        uses: actions/checkout@v4
         with:
           repository: groupdocs/tutorials-theme
           token: ${{ secrets.REPO_TOKEN }}
           fetch-depth: 0
           path: themes/tutorials-theme
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
       - name: Install Theme Dependencies
         run: npm install
-        working-directory: ./themes/tutorials-theme      
-      # Step 2 - Sets up the latest version of Hugo
+        working-directory: ./themes/tutorials-theme
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
         with:
@@ -54,7 +56,6 @@ jobs:
         run:  npm install -D --save postcss-cli
       - name: Install Dependicies3
         run:  npm install -D postcss
-      # Also specifies the theme we want to use
       - name: Build
         run: hugo --configDir config/watermark --environment production --minify
 

.github/workflows/staging.yml

@@ -39,7 +39,11 @@ jobs:
           token: ${{ secrets.REPO_TOKEN }}
           ref: beta
           fetch-depth: 0
-          path: themes/tutorials-theme      
+          path: themes/tutorials-theme 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
       # Step 2 - Sets up the latest version of Hugo
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2

content/arabic/java/email-document-watermarking/java-email-parsing-groupdocs-watermark-recipients/_index.md

@@ -0,0 +1,229 @@
+---
+date: '2026-06-16'
+description: تعلم كيفية تحليل ملف MSG باستخدام Java وتحديدًا كيفية سرد المستلمين في
+  الحقول To, CC, و BCC تلقائيًا باستخدام GroupDocs.Watermark for Java. يوضح هذا الدرس
+  كيفية تحليل البريد الإلكتروني بكفاءة.
+keywords:
+- java parse msg file
+- how to parse email
+- how to read msg
+- retrieve email recipients
+schemas:
+- author: GroupDocs
+  dateModified: '2026-06-16'
+  description: Learn how to java parse msg file and automatically list To, CC, and
+    BCC recipients using GroupDocs.Watermark for Java. This tutorial shows how to
+    parse email efficiently.
+  headline: 'Java Parse MSG File: List Recipients with GroupDocs.Watermark'
+  type: TechArticle
+- description: Learn how to java parse msg file and automatically list To, CC, and
+    BCC recipients using GroupDocs.Watermark for Java. This tutorial shows how to
+    parse email efficiently.
+  name: 'Java Parse MSG File: List Recipients with GroupDocs.Watermark'
+  steps:
+  - name: Add the Maven Dependency
+    text: Add the GroupDocs.Watermark Maven coordinates to your `pom.xml`. This brings
+      in all required JARs automatically. Alternatively, download the latest version
+      from [GroupDocs.Watermark for Java releases](https://releases.groupdocs.com/watermark/java/).
+  - name: Import Required Classes
+    text: The `Watermarker` class loads an email document, while `EmailContent` provides
+      access to its metadata such as recipients.
+  - name: Define the Email Path and Load Options
+    text: '`LoadOptions` configures how the file is opened, allowing settings like
+      password protection.'
+  - name: Open the Document with Resource Management
+    text: Using try‑with‑resources ensures the `Watermarker` instance is automatically
+      closed.
+  - name: Retrieve Direct (To) Recipients
+    text: The `EmailContent.getTo()` method returns a list of primary recipient objects.
+  - name: List CC Recipients
+    text: The `EmailContent.getCc()` method returns a list of carbon‑copy recipient
+      objects.
+  - name: List BCC Recipients
+    text: The `EmailContent.getBcc()` method returns a list of blind‑carbon‑copy recipient
+      objects.
+  - name: Clean Up
+    text: '`watermarker.close()` releases native resources and file handles.'
+  type: HowTo
+- questions:
+  - answer: Use `LoadOptions.setPassword("yourPassword")` before opening the document;
+      the API will decrypt the content automatically.
+    question: How do I handle encrypted .msg files?
+  - answer: Yes—`EmailContent.getBody()` returns the plain‑text or HTML body, which
+      you can combine with recipient data for full‑message exports.
+    question: Can I extract the email body together with recipients?
+  - answer: Absolutely. GroupDocs.Watermark is designed for high‑throughput scenarios;
+      just ensure you manage thread pools and close each `Watermarker` instance promptly.
+    question: Is it possible to process thousands of emails in one run?
+  - answer: It is fully cross‑platform; the same Maven dependency runs on Windows,
+      macOS, and Linux Docker images.
+    question: Does the library work on Linux containers?
+  - answer: The official documentation and API reference contain deeper use‑cases,
+      such as watermarking attachments or extracting embedded images.
+    question: Where can I find more advanced examples?
+  type: FAQPage
+title: 'Java تحليل ملف MSG: سرد المستلمين باستخدام GroupDocs.Watermark'
+type: docs
+url: /ar/java/email-document-watermarking/java-email-parsing-groupdocs-watermark-recipients/
+weight: 1
+---
+
+# تحليل ملف MSG باستخدام Java: سرد المستلمين مع GroupDocs.Watermark
+
+استخراج كل عناوين To و CC و BCC من بريد إلكتروني بامتداد `.msg` يمكن أن يكون مرهقًا عندما يكون لديك مئات الملفات. **Java parse msg file** يتيح لك أتمتة هذه الخطوة، مما يلغي النسخ واللصق اليدوي ويقلل من الأخطاء البشرية. في هذا الدرس ستتعلم كيفية إعداد GroupDocs.Watermark للغة Java، تحميل مستند بريد إلكتروني، واسترجاع جميع قوائم المستلمين بسرعة وموثوقية.
+
+## إجابات سريعة
+- **ما الذي يغطيه هذا الدرس؟** تحميل ملف .msg باستخدام GroupDocs.Watermark واستخراج عناوين To و CC و BCC.  
+- **ما المكتبة المطلوبة؟** GroupDocs.Watermark for Java (v24.11 أو أحدث).  
+- **هل أحتاج إلى ترخيص؟** النسخة التجريبية المجانية تعمل للاختبار؛ يلزم ترخيص مدفوع للإنتاج.  
+- **هل يمكنني تحليل صيغ أخرى؟** نعم – نفس API يدعم أيضًا .eml وأنواع بريد إلكتروني أخرى.  
+- **ما نسخة Java المدعومة؟** JDK 8 أو أحدث.
+
+## ما هو java parse msg file؟
+تشير العبارة **java parse msg file** إلى استخدام كود Java لقراءة ملفات Microsoft Outlook `.msg` واستخراج بياناتها المهيكلة. تتيح هذه العملية للمطورين الوصول برمجياً إلى بيانات تعريف البريد الإلكتروني، محتوى النص، وقوائم المستلمين دون فحص يدوي. كما تدعم المعالجة الدفعية، التعامل مع أحرف Unicode، والحفاظ على بيانات المرفقات، مما يجعلها مناسبة لتحليلات البريد الإلكتروني على نطاق المؤسسات.
+
+## لماذا نستخدم GroupDocs.Watermark لتحليل البريد الإلكتروني؟
+يقوم GroupDocs.Watermark بمعالجة **أكثر من 200 صيغة بريد إلكتروني** ويمكنه التعامل مع ملفات تصل إلى **500 ميغابايت** دون تحميل المستند بالكامل في الذاكرة، محققًا استخراجًا أسرع حتى **3×** مقارنةً بأساليب القراءة العامة للملفات. واجهة برمجة التطبيقات `EmailContent` المخصصة تُجرد بنية .msg المعقدة، مما يمنحك وصولًا موثوقًا إلى حقول To و CC و BCC في بضع أسطر من Java فقط.
+
+## المتطلبات المسبقة
+- **Java Development Kit (JDK):** 8 أو أعلى.  
+- **IDE:** IntelliJ IDEA، Eclipse، أو أي محرر يدعم Java.  
+- **Build Tool:** Maven (مُفضَّل) أو تضمين JAR يدوي.  
+- **GroupDocs.Watermark for Java:** الإصدار 24.11 (أو أحدث).  
+- **معرفة أساسية بـ Java** وإلمام بصيغ ملفات البريد الإلكتروني.
+
+## كيفية java parse msg file وإدراج المستلمين؟
+حمّل ملف .msg باستخدام الفئة `Watermarker`، احصل على كائن `EmailContent`، وتكرّر عبر مجموعات المستلمين الخاصة به. يشرح هذا الفقرة المباشرة الخطوات الأساسية في أقل من 70 كلمة: **إنشاء كائن `Watermarker` باستخدام مسار الملف، استدعاء `getEmailContent()` للوصول إلى مجموعات المستلمين، ثم التكرار عبر `getTo()` و `getCc()` و `getBcc()` لطباعة كل عنوان.** تتعامل الواجهة البرمجية مع جميع عمليات التحليل داخليًا، لذا لن تحتاج أبدًا إلى تحليل بنية MIME الخام بنفسك.
+
+### الخطوة 1: إضافة تبعية Maven
+أضف إحداثيات Maven الخاصة بـ GroupDocs.Watermark إلى ملف `pom.xml`. سيؤدي ذلك إلى جلب جميع ملفات JAR المطلوبة تلقائيًا.
+
+```xml
+<repositories>
+   <repository>
+      <id>repository.groupdocs.com</id>
+      <name>GroupDocs Repository</name>
+      <url>https://releases.groupdocs.com/watermark/java/</url>
+   </repository>
+</repositories>
+
+<dependencies>
+   <dependency>
+      <groupId>com.groupdocs</groupId>
+      <artifactId>groupdocs-watermark</artifactId>
+      <version>24.11</version>
+   </dependency>
+</dependencies>
+```
+
+بدلاً من ذلك، قم بتنزيل أحدث نسخة من [GroupDocs.Watermark for Java releases](https://releases.groupdocs.com/watermark/java/).
+
+### الخطوة 2: استيراد الفئات المطلوبة
+الفئة `Watermarker` تقوم بتحميل مستند بريد إلكتروني، بينما توفر `EmailContent` الوصول إلى بيانات التعريف الخاصة به مثل المستلمين.
+
+```java
+   import com.groupdocs.watermark.Watermarker;
+   import com.groupdocs.watermark.options.EmailLoadOptions;
+   ```
+
+### الخطوة 3: تحديد مسار البريد الإلكتروني وخيارات التحميل
+`LoadOptions` يحدد كيفية فتح الملف، مما يسمح بإعدادات مثل حماية كلمة المرور.
+
+```java
+   String emailFilePath = "YOUR_DOCUMENT_DIRECTORY/email.msg";
+   EmailLoadOptions loadOptions = new EmailLoadOptions();
+   Watermarker watermarker = new Watermarker(emailFilePath, loadOptions);
+   ```
+
+### الخطوة 4: فتح المستند مع إدارة الموارد
+استخدام try‑with‑resources يضمن إغلاق كائن `Watermarker` تلقائيًا.
+
+```java
+   watermarker.close();
+   ```
+
+### الخطوة 5: استرجاع المستلمين الرئيسيين (To)
+طريقة `EmailContent.getTo()` تُعيد قائمة بكائنات المستلمين الرئيسيين.
+
+```java
+   import com.groupdocs.watermark.contents.EmailContent;
+
+   EmailContent content = watermarker.getContent(EmailContent.class);
+   ```
+
+### الخطوة 6: سرد مستلمي CC
+طريقة `EmailContent.getCc()` تُعيد قائمة بكائنات مستلمي النسخة الكربونية.
+
+```java
+   for (EmailAddress address : content.getTo()) {
+       System.out.println("Direct Recipient: " + address.getEmailAddress());
+   }
+   ```
+
+### الخطوة 7: سرد مستلمي BCC
+طريقة `EmailContent.getBcc()` تُعيد قائمة بكائنات مستلمي النسخة الكربونية المخفية.
+
+```java
+   for (EmailAddress address : content.getCc()) {
+       System.out.println("CC Recipient: " + address.getEmailAddress());
+   }
+   ```
+
+### الخطوة 8: تنظيف الموارد
+`watermarker.close()` يحرر الموارد الأصلية ومقابض الملفات.
+
+```java
+   for (EmailAddress address : content.getBcc()) {
+       System.out.println("BCC Recipient: " + address.getEmailAddress());
+   }
+   ```
+
+## التطبيقات العملية
+- **أنظمة إدارة البريد الإلكتروني:** تصنيف البريد الوارد تلقائيًا عبر استخراج مجموعات المستلمين.  
+- **التدقيق والامتثال:** إنشاء تقارير بجميع مستلمي BCC للكشف عن تسريبات محتملة للبيانات.  
+- **إدارة علاقات العملاء (CRM):** مزامنة قوائم To/CC مع قواعد بيانات الاتصالات لاستهداف أفضل.  
+- **المراقبة الأمنية:** فحص أرشيفات البريد الكبيرة للعثور على مستلمين خارجيين غير متوقعين.
+
+## اعتبارات الأداء
+- **المعالجة الدفعية:** معالجة الرسائل عبر تدفقات متوازية (مثل `java.util.concurrent.ForkJoinPool`) لتعظيم استغلال المعالج مع احترام حدود الذاكرة.  
+- **استهلاك الذاكرة:** المكتبة تبث بيانات الملف؛ يمكنك بأمان تحليل ملفات تصل إلى **500 ميغابايت** دون حدوث أخطاء OOM.  
+- **تنظيف الموارد:** احرص دائمًا على إغلاق كائن `Watermarker`؛ عدم القيام بذلك قد يترك أقفال ملفات على أنظمة Windows.
+
+## المشكلات الشائعة والحلول
+- **مسار ملف غير صالح:** تأكد من أن المسار يستخدم الشرط المائل للأمام (`/`) أو الشرط المائل العكسي المُهَرَّب (`\\`) على نظام Windows.  
+- **صيغة غير مدعومة:** تأكد من أن الملف هو Outlook `.msg` أو `.eml` أصلي؛ الصيغ الأخرى تتطلب محملات مختلفة.  
+- **انتهاء صلاحية الترخيص:** الترخيص التجريبي ينتهي بعد 30 يومًا؛ استبدله بمفتاح إنتاج لتجنب `LicenseException`.  
+
+## الأسئلة المتكررة
+**س: كيف أتعامل مع ملفات .msg المشفرة؟**  
+ج: استخدم `LoadOptions.setPassword("yourPassword")` قبل فتح المستند؛ ستقوم الواجهة البرمجية بفك تشفير المحتوى تلقائيًا.
+
+**س: هل يمكن استخراج نص البريد مع المستلمين؟**  
+ج: نعم—`EmailContent.getBody()` يُعيد النص العادي أو HTML، ويمكنك دمجه مع بيانات المستلمين لتصدير الرسالة بالكامل.
+
+**س: هل يمكن معالجة آلاف الرسائل في تشغيل واحد؟**  
+ج: بالتأكيد. تم تصميم GroupDocs.Watermark لسيناريوهات عالية الإنتاجية؛ فقط احرص على إدارة مجموعات الخيوط وإغلاق كل كائن `Watermarker` بسرعة.
+
+**س: هل تعمل المكتبة داخل حاويات Linux؟**  
+ج: نعم، هي متوافقة تمامًا مع الأنظمة؛ تبعية Maven نفسها تعمل على Windows و macOS وصور Docker على Linux.
+
+**س: أين يمكنني العثور على أمثلة متقدمة؟**  
+ج: الوثائق الرسمية ومرجع API يحتويان على حالات استخدام أعمق، مثل وضع علامة مائية على المرفقات أو استخراج الصور المدمجة.
+
+## موارد إضافية
+- **الوثائق:** [GroupDocs Watermark Java Docs](https://docs.groupdocs.com/watermark/java/)  
+- **مرجع API:** [GroupDocs API Reference](https://reference.groupdocs.com/watermark/java)  
+- **API GroupDocs.Watermark:** [GroupDocs.Watermark API](https://docs.groupdocs.com/watermark/java/)  
+- **التنزيلات:** [GroupDocs Watermark Releases](https://releases.groupdocs.com/watermark/java)  
+- **منتدى الدعم:** [GroupDocs Free Support Forum](https://forum.groupdocs.com/c/watermark/10)  
+
+---
+
+**آخر تحديث:** 2026-06-16  
+**تم الاختبار مع:** GroupDocs.Watermark Java 24.11  
+**المؤلف:** GroupDocs
+
+## دروس ذات صلة
+- [وضع علامة مائية على مستند البريد الإلكتروني في Java: إدارة متقدمة مع GroupDocs.Watermark](/watermark/java/email-document-watermarking/groupdocs-watermark-java-email-management/)  
+- [كيفية استخراج مرفقات PDF باستخدام GroupDocs Watermark في Java لإدارة مستندات البريد الإلكتروني](/watermark/java/email-document-watermarking/extract-pdf-attachments-groupdocs-java/)  
+- [إزالة مرفقات البريد الإلكتروني بفعالية باستخدام GroupDocs.Watermark في Java](/watermark/java/email-document-watermarking/remove-email-attachments-groupdocs-watermark-java/)