groupdocs viewer maven: TXT 파일을 HTML, JPG, PNG 및 PDF로 변환하기 - GroupDocs.Viewer for Java 사용

현대 Java 애플리케이션에서 groupdocs viewer maven은 일반 텍스트(TXT) 문서를 웹용 HTML, 고해상도 이미지 또는 휴대용 PDF 파일로 변환하는 작업을 간단하게 해줍니다. 문서 포털, 아카이브 서비스 또는 미리보기 기능을 구축하든, GroupDocs.Viewer를 사용한 TXT 파일 변환은 시간을 절약하고 맞춤 파서를 만들 필요를 없애줍니다. 이 가이드에서는 전체 설정 과정을 안내하고 convert txt files java를 사용해 HTML(단일 및 다중 페이지), JPG, PNG, PDF로 변환하는 방법을 보여드립니다.

GroupDocs.Viewer for Java를 사용한 TXT 파일을 HTML, JPG, PNG 및 PDF로 변환

빠른 답변

필요한 Maven 아티팩트는 무엇인가요? com.groupdocs:groupdocs-viewer (아래 Maven 스니펫을 참조하세요).
다중 페이지 HTML을 렌더링할 수 있나요? 예 – HtmlViewOptions.forEmbeddedResources를 사용하고 single‑page 플래그를 사용하지 않으세요.
프로덕션에 라이선스가 필요합니까? 평가용으로는 체험판이 작동하지만, 상업적 사용을 위해서는 영구 라이선스가 필요합니다.
지원되는 Java 버전은 무엇인가요? Java 8 이상 (Java 11+ 권장).
이미지 출력에 추가 라이브러리가 필요합니까? 아니요, Viewer 라이브러리에 JPG 및 PNG 지원이 기본 포함되어 있습니다.

groupdocs viewer maven이란?

groupdocs viewer maven은 GroupDocs.Viewer for Java 라이브러리의 Maven 기반 배포판입니다. Microsoft Office나 기타 서드파티 도구 없이 일반 텍스트를 포함한 100여 가지 문서 형식을 HTML, 이미지 또는 PDF로 렌더링하는 간단한 API를 제공합니다.

왜 txt files java를 변환하나요?

크로스 플랫폼 미리보기 – HTML 및 이미지는 브라우저나 모바일 앱에서 표시될 수 있습니다.
표준화된 아카이빙 – PDF는 서식을 보존하고 모든 환경에서 읽을 수 있습니다.
자동화 친화적 – 변환을 배치 작업, 클라우드 서비스 또는 CI 파이프라인에 통합할 수 있습니다.

사전 요구 사항

GroupDocs.Viewer for Java 버전 25.2 이상 (Maven을 통해 제공).
JDK 8 이상 (Java 11 이상 권장).
IntelliJ IDEA, Eclipse, NetBeans와 같은 IDE.
기본 Java 및 Maven 지식.

GroupDocs.Viewer for Java 설정

Add the repository and dependency to your pom.xml:

<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>

라이선스 획득 단계

무료 체험으로 시작하거나 임시 라이선스를 받아 전체 기능을 탐색하세요.
프로덕션에서는 공식 purchase page에서 라이선스를 구매하세요.

기본 초기화 및 설정

위에 표시된 Maven 의존성을 추가합니다.
JDK와 IDE가 올바르게 구성되어 있는지 확인합니다.

이제 구체적인 변환 시나리오를 살펴보겠습니다.

구현 가이드

기능 1: TXT를 다중 페이지 HTML로 렌더링 (multi page html java)

개요

이 예제는 TXT 문서를 다중 페이지 HTML 파일로 변환하며, 별도의 웹 페이지에 걸쳐 줄 바꿈을 유지합니다.

Import Required Libraries

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

Set Up Paths and Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Render the document to HTML using these options
    viewer.view(options);
}

설명: HtmlViewOptions.forEmbeddedResources는 CSS, 폰트 및 이미지를 HTML 출력에 직접 포함시켜 휴대성을 높입니다.

기능 2: TXT를 단일 페이지 HTML로 렌더링 (convert txt to html java)

개요

전체 텍스트 파일을 하나의 HTML 페이지로 압축합니다—빠른 미리보기에 적합합니다.

Import Required Libraries

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

Set Up Paths and Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result_single_page.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_2_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Set the option to render as a single page HTML
    options.setRenderToSinglePage(true);
    
    // Render the document using these options
    viewer.view(options);
}

설명: setRenderToSinglePage(true)는 모든 페이지를 하나의 HTML 파일로 병합합니다.

기능 3: TXT를 JPG로 렌더링

개요

TXT 파일을 고품질 JPEG 이미지로 변환합니다. 이미지만 허용하는 플랫폼에 공유할 때 유용합니다.

Import Required Libraries

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

Set Up Paths and Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.jpg");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a JPEG image
    JpgViewOptions options = new JpgViewOptions(pageFileFullPath);
    
    // Render the document as a JPG using these options
    viewer.view(options);
}

설명: JpgViewOptions를 사용하면 이미지 품질, DPI 및 출력 경로를 제어할 수 있습니다.

기능 4: TXT를 PNG로 렌더링

개요

텍스트 파일에서 무손실 PNG 이미지를 생성합니다—선명하고 확장 가능한 그래픽이 필요할 때 이상적입니다.

Import Required Libraries

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

Set Up Paths and Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.png");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PNG image
    PngViewOptions options = new PngViewOptions(pageFileFullPath);
    
    // Render the document as a PNG using these options
    viewer.view(options);
}

설명: PNG는 무손실 압축을 제공하여 원본 텍스트의 정확한 모습을 보존합니다.

기능 5: TXT를 PDF로 렌더링 (txt to pdf java / convert txt to pdf java)

개요

TXT 문서에서 PDF 파일을 생성합니다—아카이빙, 인쇄 또는 클라이언트 전송에 적합합니다.

Import Required Libraries

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

Set Up Paths and Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.pdf");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PDF
    PdfViewOptions options = new PdfViewOptions(pageFileFullPath);
    
    // Render the document as a PDF using these options
    viewer.view(options);
}

설명: PdfViewOptions는 페이지 레이아웃, 폰트 및 리소스 임베딩을 자동으로 처리합니다.

실용적인 적용 사례

문서 관리 시스템: 레거시 TXT 문서를 HTML로 자동 변환하여 인트라넷 포털에 활용합니다.
출판 플랫폼: 저자가 제출한 TXT 원고를 HTML로 변환해 원활한 CMS 통합을 지원합니다.
아카이빙 솔루션: 오래된 텍스트 파일을 PDF 또는 PNG로 보존하여 장기 저장합니다.
클라우드 스토리지 통합: 실시간으로 변환하고 렌더링된 파일을 AWS S3, Azure Blob 또는 Google Cloud에 저장합니다.

일반적인 문제와 해결책

문제	원인	해결책
출력이 비어 있음	파일 경로가 잘못되었거나 읽기 권한이 없습니다.	`YOUR_DOCUMENT_DIRECTORY`가 실제 TXT 파일을 가리키고 프로세스에 읽기 권한이 있는지 확인하십시오.
이미지 품질이 낮음	기본 DPI가 낮습니다.	`JpgViewOptions.setResolution(int dpi)` 또는 `PngViewOptions.setResolution(int dpi)`를 사용해 DPI를 높이세요(예: 300).
HTML에 깨진 링크가 있음	리소스가 포함되지 않음.	`HtmlViewOptions.forEmbeddedResources`를 사용하거나 사용자 정의 리소스 폴더를 제공하십시오.
라이선스 예외	유효한 라이선스가 설정되지 않음.	`Viewer`를 생성하기 전에 `License license = new License(); license.setLicense("path/to/license.file");` 로 라이선스 파일을 로드하십시오.

자주 묻는 질문

Q: 대용량 TXT 파일(수백 MB)을 GroupDocs.Viewer로 변환할 수 있나요?
A: 예. 라이브러리는 소스 파일을 스트리밍하지만, 매우 큰 문서의 경우 JVM 힙 크기를 늘리는 것이 좋습니다.

Q: JPG 또는 PNG를 생성하기 위해 추가 종속성이 필요합니까?
A: 아니요. Viewer 패키지에 모든 필요한 이미지 처리 라이브러리가 포함되어 있습니다.

Q: PDF 페이지 크기를 사용자 정의할 수 있나요?
A: 물론입니다. 렌더링 전에 PdfViewOptions.setPageSize(PageSize.A4) 또는 다른 PageSize를 사용하세요.

Q: 암호로 보호된 TXT 파일을 어떻게 처리합니까?
A: TXT 파일은 비밀번호를 지원하지 않습니다. 파일이 암호화된 경우 Viewer에 전달하기 전에 먼저 복호화하십시오.

Q: 이 변환을 Docker 컨테이너에서 실행할 수 있나요?
A: 예. JDK를 포함하고 GroupDocs 의존성이 있는 pom.xml을 복사한 뒤 컨테이너 내부에서 Java 애플리케이션을 실행하면 됩니다.

마지막 업데이트: 2026-02-21
테스트 환경: GroupDocs.Viewer 25.2 for Java
작성자: GroupDocs