groupdocs viewer java: Java 문서 렌더링 튜토리얼 – 파일을 HTML, PDF 및 이미지로 변환

Java 애플리케이션을 구축하면서 다양한 문서 형식을 표시, 변환 또는 처리해야 한다면, 올바른 튜토리얼 모음에 도착하신 것입니다. 이 가이드에서는 GroupDocs.Viewer for Java를 사용한 문서 렌더링을 마스터하는 방법을 보여드립니다 – 간단한 파일 변환부터 고급 렌더링 기술까지. 문서 관리 시스템을 만들든, 웹 포털에 미리보기 기능을 추가하든, 레거시 파일을 최신 형식으로 마이그레이션하든, 이 단계별 가이드는 바로 실행 가능한 Java 코드와 실용적인 팁을 제공합니다.

빠른 답변

  • GroupDocs Viewer Java는 무엇을 하나요? 원본 애플리케이션 없이도 100개 이상의 파일 유형을 HTML, PDF, PNG, JPG 등으로 렌더링합니다.
  • 상업용 라이선스가 필요합니까? 평가용 임시 라이선스는 무료이며, 프로덕션 사용에는 유료 라이선스가 필요합니다.
  • 지원되는 Java 버전은 무엇입니까? Java 8 부터 17까지 완전 지원됩니다.
  • 스트림에서 문서를 렌더링할 수 있나요? 예 – API는 InputStream과 함께 작동하여 임시 파일을 피할 수 있습니다.
  • 몇 가지 형식을 변환할 수 있나요? Office, CAD, 이메일, 아카이브 형식을 포함해 100개 이상의 입력 및 출력 형식을 지원합니다.

groupdocs viewer java란?

GroupDocs.Viewer for Java는 HTML, PDF, PNG, JPG와 같은 웹 친화적 형식으로 문서를 변환 및 렌더링하는 서버‑사이드 라이브러리입니다. 각 파일 유형의 복잡성을 단일하고 일관된 API 뒤에 추상화하여 Microsoft Office나 기타 서드‑파티 뷰어를 설치하지 않고도 미리보기, 변환 및 추출 기능을 구축할 수 있게 해줍니다.

groupdocs viewer java를 사용하는 이유

GroupDocs.Viewer는 50개 이상의 입력 형식(DOCX, XLSX, PDF, DWG, PST 등)과 30개 이상의 출력 형식을 지원하며, 전체 문서를 메모리에 로드하지 않고 최대 2 GB 파일을 처리할 수 있습니다. 벤치마크에 따르면 일반적인 2 vCPU 클라우드 인스턴스에서 200페이지 PDF를 HTML로 변환하는 데 2초 미만이 걸리며, 이는 고처리량 웹 서비스에 이상적입니다.

사전 요구 사항

  • Java 8 이상 (Java 11 또는 17 권장).
  • Maven 또는 Gradle을 사용한 의존성 관리.
  • 유효한 GroupDocs Viewer temporary 또는 paid 라이선스 (아래 “Temporary License” 링크 참고).

문서 렌더링 시작하기

GroupDocs Viewer for Java를 어떻게 설치하나요?

pom.xml에 Maven 의존성을 추가하세요 (또는 해당 Gradle 스니펫). 이 한 줄로 모든 필요한 바이너리와 전이적 의존성이 포함됩니다.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-viewer</artifactId>
    <version>23.9</version>
</dependency>

Pro tip: 최신 안정 버전(작성 시점 23.9)을 사용하여 최신 형식 지원 및 성능 향상의 이점을 누리세요.

문서를 HTML로 렌더링하려면 어떻게 하나요?

Viewer는 문서를 로드하고 렌더링하는 주요 클래스입니다. HtmlViewOptions는 출력 형식을 HTML로 설정합니다. Viewer로 문서를 로드하고 HtmlViewOptions를 지정하여 view를 호출하면 됩니다. API가 자동으로 형식을 감지하고 깔끔하고 반응형인 HTML을 반환합니다.

Viewer viewer = new Viewer("sample.docx");
HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources();
viewer.view(options, "output.html");

HtmlViewOptions.forEmbeddedResources() 메서드는 이미지와 CSS를 HTML에 직접 삽입하여 단일 페이지 미리보기에 최적화됩니다.

문서를 PDF로 변환하려면 어떻게 하나요?

PdfViewOptions는 렌더링 출력 형식을 PDF로 지정합니다. PdfViewOptions 인스턴스를 생성하고 view를 호출하세요. 변환 시 레이아웃, 글꼴 및 벡터 그래픽이 보존됩니다.

PdfViewOptions pdfOptions = PdfViewOptions.forStandardConversion();
viewer.view(pdfOptions, "output.pdf");

각 페이지에 대한 PNG 썸네일을 생성하려면 어떻게 하나요?

PngViewOptions는 페이지를 PNG 이미지로 렌더링하기 위한 설정을 정의합니다. PngViewOptions를 사용하고 필요에 따라 해상도를 설정하여 이미지 품질을 조절하세요.

PngViewOptions pngOptions = PngViewOptions.forStandardResolution();
pngOptions.setResolution(150); // DPI
viewer.view(pngOptions, "page_{0}.png");

InputStream에서 직접 문서를 렌더링하려면 어떻게 하나요?

InputStream은 파일이나 네트워크와 같은 소스에서 바이트 스트림을 나타냅니다. 문서가 데이터베이스에 저장되었거나 REST API를 통해 수신될 때 디스크에 쓰는 과정을 피할 수 있습니다.

InputStream stream = getDocumentStreamFromDatabase();
Viewer viewer = new Viewer(stream);
viewer.view(HtmlViewOptions.forEmbeddedResources(), "output.html");

사용 가능한 튜토리얼

아래는 집중된 튜토리얼 전체 목록입니다. 각 링크를 클릭하면 위에서 보여준 패턴을 확장한 전용 가이드가 열리며, 오류 처리, 성능 튜닝 및 실제 사용 사례 세부 정보가 추가됩니다.

오피스 문서 변환 튜토리얼

고급 파일 형식 지원

CAD 및 기술 도면 렌더링

이메일 및 아카이브 처리

프로젝트 관리 통합

특수 렌더링 기술

Document Rendering Fundamentals with GroupDocs.Viewer for Java

추가 리소스

자주 묻는 질문

Q: GroupDocs Viewer Java를 마이크로서비스 아키텍처에서 사용할 수 있나요?
A: 예. 라이브러리는 스트림을 지원하므로 임시 파일을 디스크에 쓰지 않고도 무상태 서비스에서 문서를 렌더링할 수 있습니다.

Q: 한 번에 렌더링할 수 있는 페이지 수에 제한이 있나요?
A: API는 선택된 페이지만 렌더링하도록 허용하여 메모리 사용량을 줄입니다. 1,000페이지 PDF 전체를 렌더링하는 것도 지원되지만, 대용량 파일은 페이지 단위로 처리하는 것이 권장됩니다.

Q: GroupDocs Viewer Java가 검색 인덱싱을 위해 텍스트를 추출하나요?
A: 물론입니다. TextViewOptions를 사용하면 순수 텍스트 출력을 얻을 수 있어 검색 가능한 인덱스를 구축하는 데 이상적입니다.

Q: 비밀번호로 보호된 PDF를 어떻게 처리하나요?
A: Viewer 생성자에 비밀번호를 전달합니다: new Viewer("secure.pdf", "password"). 라이브러리가 문서를 복호화하고 안전하게 렌더링합니다.

Q: 어떤 성능 최적화 옵션이 있나요?
A: viewer.setRenderOptions(RenderOptions.getDefault().setCacheEnabled(true))를 활성화하면 여러 렌더링 간에 파싱된 리소스를 재사용하여 변환 시간을 최대 30 %까지 단축할 수 있습니다.

마지막 업데이트: 2026-06-10
테스트 환경: GroupDocs.Viewer 23.9 for Java
작성자: GroupDocs

관련 튜토리얼