eml to pdf java – GroupDocs로 이메일을 PDF로 변환

많은 기업에서 이메일 메시지를 변경할 수 없는 PDF로 보관하는 것은 규정 준수, 법적 조사 및 손쉬운 공유를 위해 필수적입니다. 이 튜토리얼에서는 GroupDocs.Conversion을 사용하여 .eml 파일을 Java에서 PDF로 변환하는 방법을 보여주며, 최종 문서에 표시되는 이메일 필드를 완전히 제어할 수 있습니다. 민감한 헤더를 숨기는 방법, Maven 종속성을 구성하는 방법, 대량 배치에 대한 성능 최적화 방법을 확인할 수 있습니다.

빠른 답변

  • 이메일을 PDF로 변환하는 라이브러리는 무엇인가요? GroupDocs.Conversion for Java.
  • 필요한 Maven 아티팩트는 무엇인가요? com.groupdocs:groupdocs-conversion.
  • 보낸 사람/받는 사람 세부 정보를 숨길 수 있나요? Yes—use EmailLoadOptions to control visibility.
  • 프로덕션에 라이선스가 필요합니까? A valid GroupDocs license is needed for non‑trial use.
  • 지원되는 Java 버전은 무엇인가요? Java 8 or higher.

이메일을 PDF로 변환이란?

Email to PDF 변환은 .msg, .eml 또는 기타 이메일 형식을 정적이고 휴대 가능한 PDF 문서로 변환합니다. 이 과정은 원본 메시지 레이아웃을 유지하면서 이메일 주소, 헤더, CC/BCC 필드 및 첨부 파일과 같은 민감한 정보를 수정할 수 있게 합니다.

Java용 GroupDocs.Conversion을 사용하는 이유

GroupDocs.Conversion은 java pdf conversion library를 제공하며, EML, MSG, PDF, DOCX, HTML 등을 포함해 100개 이상의 입력 및 출력 형식을 지원합니다. 세밀한 EmailLoadOptions를 제공하여 이메일의 어느 부분이 PDF에 표시될지 정확히 결정할 수 있으며, Maven과 원활하게 통합되어 종속성 관리를 쉽게 할 수 있습니다.

전제 조건

  • **Java Development Kit (JDK) 8+**이 설치되어 있어야 합니다.
  • Maven은 종속성 관리를 위해 사용합니다 (아래 maven dependency groupdocs conversion 섹션을 참조).
  • Java 및 Maven 프로젝트에 대한 기본적인 이해가 필요합니다.

Java용 GroupDocs.Conversion 설정

pom.xml에 GroupDocs 저장소와 변환 종속성을 추가합니다. 이것이 필요한 groupdocs conversion maven 구성입니다.

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/conversion/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-conversion</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

라이선스 획득

  • Free Trial – 비용 없이 모든 기능을 탐색합니다.
  • Temporary License – 장기 평가를 위한 단기 키를 요청합니다.
  • Purchase – 프로덕션 배포를 위한 전체 라이선스를 획득합니다.

고급 옵션으로 eml를 pdf java로 변환하는 방법?

EmailLoadOptions는 변환 중에 이메일의 어느 부분이 렌더링될지 정의합니다. .eml 파일을 로드하고, 표시할 필드를 구성한 뒤 변환기를 호출합니다—모두 몇 단계로 간단히 수행됩니다. 이 답변은 70단어 이하로 전체 워크플로를 제공합니다. EmailLoadOptions를 생성하고, PDF 변환 설정을 지정한 뒤, 변환 메서드를 호출하며 발생할 수 있는 예외를 처리합니다.

단계 1: Email Load Options 구성

EmailLoadOptions를 사용하면 보낸 사람, 수신자, 헤더와 같은 개별 이메일 섹션의 표시 여부를 전환할 수 있습니다.

import com.groupdocs.conversion.options.load.EmailLoadOptions;

EmailLoadOptions loadOptions = new EmailLoadOptions();
loadOptions.setDisplayHeader(false);
loadOptions.setDisplayFromEmailAddress(false);
loadOptions.setDisplayToEmailAddress(false);
loadOptions.setDisplayEmailAddress(false);
loadOptions.setDisplayCcEmailAddress(false);
loadOptions.setDisplayBccEmailAddress(false);
loadOptions.setConvertOwned(false); // Prevent conversion of fields that are owned by the document

단계 2: Converter 초기화

Converter는 제공된 로드 및 변환 옵션을 사용하여 변환을 수행하는 엔진입니다.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG", () -> loadOptions);

단계 3: PDF 변환 옵션 설정

PdfConvertOptions는 페이지 크기 및 압축과 같은 PDF 출력 설정을 구성합니다.

PdfConvertOptions options = new PdfConvertOptions();

단계 4: 변환 수행

정의한 PDF 옵션과 대상 파일 경로를 사용하여 convert를 호출합니다. 이 메서드는 성공 여부를 나타내는 boolean 값을 반환합니다.

converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertEmailWithAlteringFieldsVisibility.pdf", options);

msg를 pdf java로 변환하는 방법 (동일 옵션 재사용)

EmailLoadOptions는 변환 중에 이메일의 어느 부분이 렌더링될지 정의합니다. Outlook .msg 파일을 처리해야 하는 경우 동일한 EmailLoadOptions와 Converter 워크플로를 사용할 수 있습니다. 소스 파일 경로를 .msg 파일로 교체하면 됩니다. 또한 로드 옵션을 조정하여 특정 헤더를 숨기거나 표시할 수 있으며, 동일한 PdfConvertOptions를 재사용하여 다양한 형식에서 일관된 출력 품질을 유지할 수 있습니다.

단계 1: Email Load Options 구성 (재사용)

import com.groupdocs.conversion.options.load.EmailLoadOptions;

EmailLoadOptions emailLoadOptions = new EmailLoadOptions();
emailLoadOptions.setDisplayHeader(false);
emailLoadOptions.setDisplayFromEmailAddress(false);
emailLoadOptions.setDisplayToEmailAddress(false);
emailLoadOptions.setDisplayEmailAddress(false);
emailLoadOptions.setDisplayCcEmailAddress(false);
emailLoadOptions.setDisplayBccEmailAddress(false);
emailLoadOptions.setConvertOwned(false); // Do not convert owned fields

단계 2: Email Load Options로 Converter 초기화

Converter emailConverter = new Converter("EMAIL_FILE_PATH", () -> emailLoadOptions);

실용적인 적용 사례

다음은 email to pdf conversion이 뛰어난 세 가지 실제 시나리오입니다:

  1. Legal Documentation – 이메일 증거를 고객과 공유하기 전에 개인 데이터를 마스킹합니다.
  2. Corporate Archiving – 내부 커뮤니케이션을 표준화된 읽기 전용 형식으로 저장하여 장기 보존합니다.
  3. Personal Organization – 불필요한 주소를 노출하지 않고 중요한 메시지를 깔끔한 PDF 아카이브로 보관합니다.

성능 고려 사항

  • File‑size optimisation – 작은 배치를 처리하거나 PDF 압축(PdfConvertOptions.setCompressionLevel(CompressionLevel.Maximum))을 활성화하여 일반적인 10페이지 이메일의 출력 크기를 2 MB 이하로 유지합니다.
  • Memory management – 다중 메가바이트 .msg 파일을 변환할 때 Java 스트리밍 API를 사용하고 JVM 힙(-Xmx2g)을 늘립니다.
  • Version upgrades – 최신 GroupDocs.Conversion 릴리스는 버전 24.x에 비해 변환 속도를 최대 30 % 향상시킵니다.

일반적인 문제 및 해결책

문제원인해결책
대용량 .msg 파일에서 OutOfMemoryError전체 파일을 메모리에 로드이메일 내용을 스트리밍하거나 JVM 힙 크기(-Xmx2g)를 늘립니다.
PDF에서 이메일 본문 누락displayHeader가 true로 설정되어 본문이 숨겨짐setDisplayHeader(false)가 헤더만 숨기고 본문은 표시하도록 확인합니다.
라이선스 인식 안 됨프로덕션에서 체험 키 사용유효한 프로덕션 라이선스 파일이나 문자열로 교체합니다.

자주 묻는 질문

Q: GroupDocs.Conversion for Java란 무엇인가요?
A: 이는 100개 이상의 파일 형식 간 변환을 지원하는 Java 라이브러리이며, 이메일을 PDF로 변환하는 기능도 포함하고, 높은 정확도와 외부 종속성이 없습니다.

Q: 변환 중 이메일 프라이버시를 어떻게 보장하나요?
A: EmailLoadOptions를 사용하여 변환 전에 보낸 사람, 받는 사람, CC/BCC 주소와 같은 필드를 비활성화합니다.

Q: 이메일 외에 다른 문서 유형도 변환할 수 있나요?
A: 예, 이 라이브러리는 Word, Excel, PowerPoint, 이미지 등 다양한 형식을 지원합니다.

Q: 대용량 이메일 변환을 위한 메모리 요구 사항은 무엇인가요?
A: 최소 2 GB 힙(-Xmx2g)을 할당하고, 메모리 제한을 초과하지 않도록 파일을 배치 처리하는 것을 고려하십시오.

Q: GroupDocs.Conversion에 대한 자세한 정보를 어디서 찾을 수 있나요?
A: 공식 문서(official documentation)와 API 레퍼런스(API reference)를 방문하십시오. 또한 GroupDocs.Conversion for Java Docs와 GroupDocs.Conversion API Reference를 확인하세요.

마지막 업데이트: 2026-05-21
테스트 환경: GroupDocs.Conversion 25.2
작성자: GroupDocs

관련 튜토리얼