مكتبة جافا مجانية للبريد الإلكتروني لتحويل EML & MSG إلى PDF

مكتبة معالجة بريد جافا مفتوحة المصدر لتحويل ملفات البريد الإلكتروني (EML، MSG) إلى PDF. تدعم معالجة المرفقات والصور المضمنة وتعدد صيغ البريد داخل تطبيقات جافا.

ما هو محول البريد الإلكتروني إلى PDF؟

في بيئة العمل الرقمية اليوم، أصبحت القدرة على تحويل رسائل البريد الإلكتروني إلى مستندات PDF ثابتة ومحمولة ذات قيمة متزايدة. محول البريد الإلكتروني إلى PDF (المعروف سابقًا باسم محول EML إلى PDF) هو مكتبة جافا متعددة الاستخدامات تحل هذه المشكلة بالضبط. متوفر على GitHub، يوفر هذا الأداة المفتوحة المصدر للمطورين والمؤسسات طريقة موثوقة لتحويل ملفات البريد الإلكتروني (بتنسيقات .eml و .msg) إلى مستندات PDF احترافية تحافظ على التنسيق، المرفقات، والبيانات الوصفية.

محول البريد الإلكتروني إلى PDF هو أداة متعددة الاستخدامات مبنية على جافا تقوم بتحويل ملفات البريد الإلكتروني إلى صيغة PDF مع الحفاظ على التنسيق، الصور المضمنة، والمرفقات. تم تطويره أصلاً بواسطة نيك راسلر، هذا المشروع المرخص من Apache يقدم ثلاث أوضاع استخدام متميزة: كمكتبة جافا للتكامل مع التطبيقات، كأداة سطر أوامر للمعالجة الدفعية، وكتطبيق سطح مكتب بواجهة رسومية. تتعامل المكتبة مع العملية المعقدة لتحليل هياكل البريد الإلكتروني، تنظيف رؤوس MIME المشوهة، تحويل المحتوى إلى HTML، وأخيرًا تصييره إلى PDF باستخدام محرك العرض القوي wkhtmltopdf.

Previous Next

البدء مع محول البريد الإلكتروني إلى PDF

قبل استخدام محول البريد الإلكتروني إلى PDF، تأكد من وجود بيئة تشغيل جافا و wkhtmltopdf. الإصدارات الأخيرة متاحة في مستودع GitHub، بما في ذلك مثبت windows setup.exe وملف JAR المستقل عن المنصة.

Install Email-to-PDF Converter Library via GitHub

git clone https://github.com/nickrussler/email-to-pdf-converter.git 

يمكنك تنزيل المكتبة مباشرة من صفحة GitHub .

تحويل ملفات البريد الإلكتروني بذكاء إلى PDF عبر جافا

توفر مكتبة محول البريد الإلكتروني إلى PDF حلاً شاملاً لتحويل ملفات البريد الإلكتروني إلى مستندات PDF يمكن الوصول إليها عالميًا داخل تطبيقات جافا. في جوهرها، تقوم المكتبة بتحليل هياكل MIME للبريد وتحويلها إلى HTML نظيف ومنسق جيدًا قبل إنشاء PDF. يضمن هذا النهج أن تخطيطات البريد المعقدة، والنصوص المنسقة، والعناصر المضمنة تُعرض بشكل صحيح في المستند النهائي. يوضح هذا المثال الأساسي كيفية أخذ ملف EML وتحويله إلى PDF باستخدام الإعدادات الافتراضية. تتعامل المكتبة مع كل تعقيدات تحليل بنية البريد، واستخراج المحتوى المضمن، وإنشاء PDF النهائي.

How to Convert EML Email File to PDF Documents via Java Library?

 
import mimeparser.MimeMessageConverter;
import java.io.File;

public class EmailConverterExample {
    public static void main(String[] args) {
        try {
            File emailFile = new File("example.eml");
            File outputPdf = new File("output.pdf");
            
            // Perform the conversion
            MimeMessageConverter.convertToPdf(emailFile, outputPdf);
            
            System.out.println("Conversion completed successfully!");
        } catch (Exception e) {
            System.err.println("Error during conversion: " + e.getMessage());
            e.printStackTrace();
        }
    }
}
 

معالجة المرفقات أثناء تحويل البريد الإلكتروني إلى PDF عبر جافا

توفر مكتبة محول البريد الإلكتروني إلى PDF خيارات لاستخراج مرفقات البريد إلكترونيًا بشكل منفصل. يمكن للمستخدمين تكوين ما إذا كانوا يريدون استخراج المرفقات إلى دليل مخصص وإضافة قائمة بأسماء المرفقات داخل مستند PDF نفسه. يوضح المثال التالي كيفية تحليل رسالة بريد إلكتروني بشكل منفصل عن عملية التحويل، مما يسمح بفحص أو تعديل محتوى البريد قبل إنشاء PDF. يوفر كائن ConversionOptions وصولًا برمجيًا إلى جميع معلمات التكوين المتاحة في واجهة سطر الأوامر.

How Manage Attachments during Email to PDF Conversion via Java?

 
import mimeparser.MimeMessageConverter;
import mimeparser.MimeMessageParser;
import javax.mail.internet.MimeMessage;
import java.io.File;
import java.io.FileInputStream;
import java.util.List;

public class AttachmentHandler {
    public static void main(String[] args) {
        try {
            File emailFile = new File("email-with-attachments.eml");
            
            // Parse the email
            MimeMessageParser parser = new MimeMessageParser();
            parser.parse(new FileInputStream(emailFile));
            
            // Access attachment information
            List attachments = parser.getAttachmentList();
            
            System.out.println("Found " + attachments.size() + " attachments:");
            for (File attachment : attachments) {
                System.out.println("- " + attachment.getName());
            }
            
            // Convert with attachment extraction
            ConversionOptions options = new ConversionOptions();
            options.setExtractAttachments(true);
            options.setAddAttachmentNames(true);
            
            MimeMessageConverter.convertToPdf(
                parser, 
                new File("output-with-attachments.pdf"), 
                options
            );
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

دعم صيغ البريد المتعددة

يدعم محول البريد الإلكتروني إلى PDF كلًا من صيغتي EML و MSG، مما يجعله متوافقًا مع مختلف عملاء البريد. ملفات EML هي صيغ بريد نصية قياسية تُستخدم من قبل العديد من تطبيقات البريد، بينما ملفات MSG هي صيغة البريد المملوكة لبرنامج Microsoft Outlook. يضمن هذا الدعم المزدوج المرونة عبر أنظمة البريد المختلفة.

معالجة الصور المضمنة أثناء تصدير البريد الإلكتروني إلى PDF

إحدى الميزات البارزة هي المعالجة السليمة للصور المضمنة داخل نصوص البريد الإلكتروني. تقوم مكتبة محول البريد الإلكتروني إلى PDF المفتوحة المصدر بتحديد هذه الصور ومعالجتها بشكل صحيح، لضمان ظهورها في المواقع المناسبة داخل مخرجات PDF بدلاً من أن تكون مرفقات منفصلة.

 عربي