GroupDocs Viewer for Java를 사용하여 PST를 HTML로 변환하는 방법

Outlook PST 파일에는 수천 개의 메시지가 포함될 수 있어 필요한 정보를 추출하기 어렵습니다. 이 튜토리얼에서는 PST를 HTML로 변환하는 방법을 GroupDocs Viewer for Java와 함께 배우고, 텍스트 또는 발신자/수신자별 필터를 적용하며, 멀티 기가바이트 메일함에서도 메모리 사용량을 낮게 유지하는 방법을 알아봅니다. 마지막에는 관련 이메일만 깨끗한 HTML 페이지로 변환하는 실행 가능한 솔루션을 제공받게 됩니다.

Outlook Data Rendering and Filtering with GroupDocs.Viewer for Java

Outlook Data Rendering and Filtering with GroupDocs.Viewer for Java

빠른 답변

  • 이 튜토리얼에서는 무엇을 다루나요? GroupDocs Viewer for Java를 사용해 Outlook PST 파일을 렌더링하고 필터링한 뒤 HTML로 변환합니다.
  • 필요한 라이브러리 버전은? GroupDocs.Viewer for Java 25.2 이상.
  • 라이선스가 필요합니까? 테스트용으로는 무료 체험 또는 임시 라이선스로 충분하지만, 실제 운영에서는 정식 라이선스가 필요합니다.
  • 특정 이메일만 렌더링할 수 있나요? 네—내장된 필터 API를 사용해 제목, 발신자 또는 내용으로 메시지를 선택할 수 있습니다.
  • 대용량 PST 파일에도 적합한가요? 물론입니다—필터를 사용하면 필요한 항목만 처리해 메모리 사용량을 최소화합니다.

PST를 HTML로 변환하는 것이란?

PST를 HTML로 변환은 Outlook PST(개인 저장소 테이블) 파일을 가져와 이메일 메시지를 HTML 문서로 출력하는 과정입니다. 이 변환은 서식, 첨부 파일 및 인라인 이미지를 유지하면서 콘텐츠를 검색 가능하고 웹 애플리케이션에 쉽게 삽입할 수 있도록 합니다.

Outlook 데이터를 렌더링하기 위해 GroupDocs Viewer for Java를 사용하는 이유는?

GroupDocs Viewer for Java는 Microsoft Outlook이 설치되지 않아도 Outlook PST 파일을 직접 렌더링할 수 있습니다. 100개 이상의 파일 형식을 지원하고, 스트리밍 방식으로 수 기가바이트 규모의 PST 파일을 처리하며, 필요한 메시지만 추출할 수 있는 내장 필터 API를 제공합니다. 이러한 기능을 통해 전체 메일함을 메모리에 로드하는 경우에 비해 처리 시간을 최대 70 %까지 단축할 수 있습니다.

전제 조건

  • GroupDocs.Viewer for Java 버전 25.2 이상 (Maven을 통해 제공)
  • 의존성 관리를 위한 Maven 설치
  • 개발 머신에 Java 8 이상 설치
  • Java 문법 및 객체 지향 개념에 대한 기본 이해

GroupDocs Viewer for Java 설정

pom.xml에 Maven 의존성을 추가합니다:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

라이선스 획득

무료 체험으로 시작하거나 임시 라이선스를 요청해 전체 기능을 살펴볼 수 있습니다. 상업적 배포에는 영구 라이선스가 필요합니다.

기본 초기화 및 설정

Viewer 클래스는 모든 렌더링 작업의 진입점이며, 문서를 로드하고 옵션을 적용한 뒤 출력을 생성합니다.

import com.groupdocs.viewer.Viewer;
// Initialize the Viewer object with the path to your Outlook data file.
Viewer viewer = new Viewer("path/to/your/outlook/file.pst");

구현 가이드

환경이 준비되었으니 이제 Outlook 데이터 파일을 필터링하고 렌더링하는 과정을 살펴보겠습니다.

텍스트 또는 발신자/수신자별 메시지 렌더링 및 필터링

개요

이 기능을 사용하면 특정 키워드, 발신자 주소 또는 수신자 주소와 일치하는 메시지만 렌더링하여 시간과 메모리를 절약할 수 있습니다.

HTML 보기 옵션 설정

HTML 보기 옵션은 CSS 스타일링 및 이미지 처리 방식을 포함해 출력 형식을 제어합니다.

import com.groupdocs.viewer.options.HtmlViewOptions;
// Set up the output directory path
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
// Configure HTML view options to specify where rendered content should be saved.
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(outputDirectory.resolve("output.html").toString());

필터 적용

OutlookOptions 클래스는 Outlook 항목 렌더링을 구성하고 필터 설정을 포함합니다.
OutlookOptions 필터 API를 사용해 제목, 발신자 또는 본문 내용으로 필터링할 수 있습니다. 필터는 PST가 스트리밍되는 동안 실행되므로 일치하는 항목만 메모리에 로드됩니다.

// Create a filter for the viewer
viewOptions.setFilter((item, options) -> {
    // Example: Filter emails containing "Project" in their subject
    return item.getDocumentInfo().getSubject().contains("Project");
});

파일 렌더링

옵션과 필터를 설정한 후 view 메서드를 호출해 일치하는 각 이메일에 대한 HTML 파일을 생성합니다.

// Render the PST file to HTML with applied filters.
viewer.view(viewOptions);

일반적인 문제 및 해결책

  • 권한 오류 – 애플리케이션이 PST 파일에 대한 읽기 권한과 출력 폴더에 대한 쓰기 권한을 가지고 있는지 확인하세요.
  • 누락된 의존성 – 모든 Maven 좌표가 올바른지 다시 확인하고 프로젝트의 의존성 캐시를 새로 고침하세요.
  • 대용량 PST 성능 – 필터를 사용해 처리 항목 수를 제한하고 뷰어 옵션에서 스트리밍 모드를 활성화하세요.

실용적인 적용 사례

  1. 이메일 아카이빙 – 프로젝트 관련 이메일을 자동으로 추출·렌더링해 장기 보관합니다.
  2. 규정 준수 감사 – 법적 검토를 위해 규제 키워드가 포함된 메시지를 추출합니다.
  3. 데이터 마이그레이션 – 필터링된 PST 내용을 HTML로 변환한 뒤 CRM이나 티켓 시스템으로 가져옵니다.

통합 가능성

이 로직을 Spring Boot REST 엔드포인트, PST 업로드를 처리하는 백그라운드 워커, 또는 JavaFX 기반 데스크톱 유틸리티에 삽입할 수 있습니다.

성능 고려 사항

  • 리소스 최적화 – 메타데이터만 필요할 경우 OutlookOptions.setLoadOnlyHeaders(true)를 활성화해 RAM 사용량을 크게 줄이세요.
  • 메모리 관리 – 각 렌더링 작업 후 Viewer 인스턴스를 닫고, 대량 파일을 배치 처리할 경우 System.gc()를 호출해 메모리를 회수합니다.

결론

이제 GroupDocs Viewer for Java를 사용해 PST를 HTML로 변환하는 완전하고 프로덕션 준비된 방법을 갖추었습니다. 발신자, 수신자 또는 텍스트별 강력한 필터링을 적용해 이메일 처리를 효율화하고, 규정 준수 요구 사항을 충족하거나 다운스트림 시스템에 데이터를 공급할 수 있습니다.

자주 묻는 질문

Q: GroupDocs Viewer for Java를 사용하는 주요 목적은 무엇인가요?
A: 외부 소프트웨어 없이 Java 애플리케이션 내에서 Outlook PST 파일을 포함한 다양한 파일 형식을 직접 렌더링하고 필터링할 수 있게 해줍니다.

Q: 라이선스를 구매하지 않고도 이 라이브러리를 사용할 수 있나요?
A: 네, 무료 체험 또는 임시 라이선스로 모든 기능을 평가할 수 있지만, 프로덕션 배포에는 정식 라이선스가 필요합니다.

Q: 대용량 PST 파일을 효율적으로 처리하려면 어떻게 해야 하나요?
A: 필요한 메시지만 처리하도록 필터를 적용하고 스트리밍 모드를 활성화하며, Viewer 인스턴스를 즉시 닫아 메모리를 해제합니다.

Q: 지원되는 파일 형식에 제한이 있나요?
A: GroupDocs Viewer는 PST, MSG, EML, DOCX, PDF 및 이미지 형식을 포함해 100개 이상의 형식을 지원합니다. 정확한 지원 버전은 최신 문서를 참고하세요.

Q: 추가 지원을 어디서 받을 수 있나요?
A: 커뮤니티 도움을 위해 GroupDocs 포럼을 방문하거나 아래 공식 문서 링크를 참고하세요.

리소스

마지막 업데이트: 2026-09-20
테스트 환경: GroupDocs.Viewer for Java 25.2 (또는 이후 버전)
작성자: GroupDocs

관련 튜토리얼