Free Java Email Library to Convert EML & MSG to PDF
Open Source Java Email Processing Library for Converting Email Files (EML, MSG) to PDF. It Supports Handling Attachments and Inline Images and Multiple Email Formats inside Java apps.
Co to jest Email-to-PDF Converter?
W dzisiejszym cyfrowym środowisku pracy możliwość konwertowania komunikacji e‑mailowej na trwałe, przenośne dokumenty PDF stała się coraz bardziej cenna. Email-to-PDF Converter (wcześniej EML to PDF Converter) to wszechstronna biblioteka Java, która rozwiązuje właśnie ten problem. Dostępna na GitHubie, ta otwartoźródłowa aplikacja zapewnia programistom i organizacjom niezawodny sposób przekształcania plików e‑mail (formaty .eml i .msg) w profesjonalne dokumenty PDF zachowujące formatowanie, załączniki i metadane.
Email to PDF Converter jest wszechstronnym narzędziem opartym na Javie, które konwertuje pliki e‑mail na format PDF, zachowując formatowanie, obrazy wbudowane oraz załączniki. Oryginalnie opracowany przez Nicka Russlera, projekt na licencji Apache oferuje trzy odrębne tryby użycia: jako biblioteka Java do integracji w aplikacjach, jako narzędzie wiersza poleceń do przetwarzania wsadowego oraz jako aplikacja desktopowa z interfejsem graficznym. Biblioteka radzi sobie z złożonym procesem parsowania struktur e‑mail, czyszczenia nieprawidłowych nagłówków MIME, konwersji treści do HTML oraz ostatecznego renderowania jako PDF przy użyciu potężnego silnika renderującego wkhtmltopdf.
Rozpoczęcie pracy z Email-to-PDF Converter
Przed użyciem Email-to-PDF Converter upewnij się, że masz zainstalowane środowisko uruchomieniowe Java oraz wkhtmltopdf. Najnowsze wersje dostępne są w repozytorium GitHub, w tym instalator windows setup.exe oraz niezależny od platformy plik JAR.
Instalacja biblioteki Email-to-PDF Converter z GitHub
git clone https://github.com/nickrussler/email-to-pdf-converter.git Możesz pobrać bibliotekę bezpośrednio ze strony GitHub.
Inteligentna konwersja plików e‑mail do PDF przy użyciu Javy
Biblioteka Email to PDF Converter zapewnia kompleksowe rozwiązanie do przekształcania plików e‑mail w powszechnie dostępne dokumenty PDF w aplikacjach Java. W swojej istocie biblioteka parsuje struktury MIME e‑mail i konwertuje je do czystego, dobrze sformatowanego HTML przed generowaniem PDF. Takie podejście gwarantuje, że złożone układy e‑mail, formatowany tekst i osadzone elementy są poprawnie renderowane w końcowym dokumencie. Ten podstawowy przykład pobiera plik EML i konwertuje go do PDF przy użyciu domyślnych ustawień. Biblioteka zajmuje się całą złożonością parsowania struktury e‑mail, wyodrębniania treści wbudowanych i generowania ostatecznego PDF.
Jak skonwertować plik EML do dokumentu PDF przy użyciu biblioteki Java?
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();
}
}
}
Obsługa załączników podczas konwersji e‑mail do PDF przy użyciu Javy
Biblioteka Email-to-PDF Converter udostępnia opcje wyodrębniania załączników e‑mail osobno. Użytkownicy mogą skonfigurować, czy załączniki mają być wyodrębniane do dedykowanego katalogu oraz opcjonalnie dołączyć listę nazw załączników w samym dokumencie PDF. Poniższy przykład kodu pokazuje, jak osobno parsować wiadomość e‑mail przed procesem konwersji, co umożliwia inspekcję lub modyfikację treści e‑mail przed generowaniem PDF. Obiekt ConversionOptions zapewnia programowy dostęp do wszystkich parametrów konfiguracyjnych dostępnych w interfejsie wiersza poleceń.
Jak zarządzać załącznikami podczas konwersji e‑mail do PDF przy użyciu Javy?
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();
}
}
}
Wsparcie wielu formatów e‑mail
Email-to-PDF Converter obsługuje zarówno formaty plików EML, jak i MSG, co czyni go kompatybilnym z różnymi klientami poczty elektronicznej. Pliki EML są standardowymi, tekstowymi formatami e‑mail używanymi przez wiele aplikacji pocztowych, natomiast pliki MSG są własnościowym formatem Microsoft Outlook. To podwójne wsparcie formatów zapewnia elastyczność w różnych ekosystemach pocztowych.
Obsługa obrazów wbudowanych podczas eksportu e‑mail do PDF
Jedną z wyróżniających się funkcji jest prawidłowa obsługa obrazów wbudowanych w treść e‑mail. Otwarta biblioteka Email-to-PDF Converter poprawnie identyfikuje i przetwarza te obrazy, zapewniając ich wyświetlanie w odpowiednich miejscach w wygenerowanym pliku PDF, a nie jako oddzielne załączniki.
