Word to PDF java: 보호된 Word 파일을 GroupDocs로 변환

이 포괄적인 튜토리얼에서는 GroupDocs.Conversion을 사용하여 word to pdf java 변환을 수행하는 방법을 배웁니다. 비밀번호로 보호된 Word 문서를 여는 방법, 특정 페이지 범위 선택, DPI 조정, 페이지 회전, 차원 맞춤 등을 단계별로 안내하여 결과 PDF가 정확한 요구 사항에 맞도록 합니다.

빠른 답변

  • 어떤 라이브러리가 변환을 처리합니까? GroupDocs.Conversion for Java.
  • 비밀번호로 보호된 Word 파일을 변환할 수 있나요? 예 – WordProcessingLoadOptions를 통해 비밀번호를 제공하십시오.
  • 특정 페이지로 변환을 제한하려면 어떻게 해야 하나요? PdfConvertOptions에서 setPageNumber()와 setPagesCount()를 사용하십시오.
  • DPI를 구성할 수 있나요? 물론입니다; options.setDpi(yourValue)를 호출하십시오.
  • GroupDocs를 추가하려면 Maven이 필요합니까? 예 – Maven 저장소와 의존성을 포함하십시오 (Maven groupdocs dependency 섹션을 참조).

word to pdf java 변환이란?

Word to pdf java 변환은 Java 코드를 사용하여 Microsoft Word 문서를 PDF 파일로 변환하는 과정입니다. GroupDocs.Conversion은 복잡한 렌더링 로직을 추상화하여 보안 처리 및 출력 품질과 같은 비즈니스 규칙에 집중할 수 있게 합니다.

Java에서 Word PDF 변환 작업에 GroupDocs를 사용하는 이유

GroupDocs.Conversion은 50개 이상의 입력 및 출력 포맷을 지원하고, 전체 파일을 메모리에 로드하지 않고 수백 페이지 문서를 처리하며, 순수 Java에서 실행됩니다—네이티브 바이너리가 필요 없습니다. 이는 안정성과 속도가 중요한 고처리량 서버 환경에 이상적이며, 기존 Java 애플리케이션과도 쉽게 통합됩니다.

전제 조건

  • JDK 8 이상 설치 및 구성됨.
  • 기본 Java 개발 경험.
  • GroupDocs.Conversion 라이선스 접근 권한(무료 체험 가능).

필요한 라이브러리 및 의존성

GroupDocs.Conversion을 사용하려면 Maven 저장소와 의존성을 pom.xml에 포함하십시오:

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

라이선스 획득

GroupDocs.Conversion은 기능 테스트를 위한 무료 체험 버전을 제공합니다. 장기 사용을 위해서는 GroupDocs 구매에서 임시 또는 정식 라이선스를 획득하는 것을 고려하십시오.

Java용 GroupDocs.Conversion 설정

Maven 설정

위의 Maven 스니펫은 필요한 모든 JAR가 자동으로 다운로드되도록 보장합니다.

기본 초기화

Converter 클래스는 문서 로딩 및 변환을 조정하는 진입점입니다.

보호된 문서를 로드하기 위해 Converter 인스턴스를 생성하십시오:

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Set password for protected documents if necessary:
loadOptions.setPassword("your_password_here");

Converter converter = new Converter("path_to_your_document.docx", () -> loadOptions);

loadOptions 객체는 convert password protected word 시나리오를 처리하는 곳입니다.

구현 가이드

아래에서는 견고한 java convert word pdf 워크플로우에 필요한 각 기능을 자세히 살펴봅니다.

비밀번호로 보호된 문서를 PDF로 변환

Definition: WordProcessingLoadOptions는 암호화된 파일의 비밀번호를 포함한 Word 문서 로딩 옵션을 지정합니다.
Definition: PdfConvertOptions는 페이지 범위, DPI, 회전 및 차원과 같은 PDF 출력 설정을 정의합니다.

Direct answer: new Converter("input.docx", new WordProcessingLoadOptions("password")) 로 Word 파일을 로드하고 converter.convert(new PdfConvertOptions(), "output.pdf") 를 호출하십시오 – 라이브러리가 문서를 해제하고 한 단계로 PDF를 생성합니다.

단계별 구현

  1. 비밀번호로 로드 옵션 초기화 – 올바른 비밀번호를 제공하십시오.
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("12345"); // Replace with your actual password.
  1. 컨버터 설정 및 변환 – PDF 옵션을 정의하고 실행하십시오.
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertedDocument.pdf";
PdfConvertOptions options = new PdfConvertOptions();

Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleProtectedDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

Explanation: loadOptions 객체는 문서를 해제하고, PdfConvertOptions는 필요에 따라 출력 설정을 조정할 수 있게 합니다.

PDF 변환 시 페이지 지정

Direct answer: PdfConvertOptions.setPageNumber(startPage)와 setPagesCount(pageCount)를 사용하여 렌더링할 페이지를 지정하고, 일반적으로 변환을 실행하십시오.

단계별 구현

  1. 페이지 범위 설정 – 컨버터에 렌더링할 페이지를 알려줍니다.
PdfConvertOptions options = new PdfConvertOptions();
options.setPageNumber(2); // Start from page 2.
options.setPagesCount(1); // Convert only one page.
  1. 변환 과정 – 동일한 Converter 인스턴스를 재사용합니다.
String convertedFile = "YOUR_OUTPUT_DIRECTORY/SelectedPagesPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

Explanation: setPageNumber()는 첫 페이지를 정의하고, setPagesCount()는 처리할 페이지 수를 제한합니다.

PDF 변환 시 페이지 회전

Direct answer: 변환 전에 PdfConvertOptions.setRotate(Rotation.On90)(또는 다른 enum 값)를 호출하여 모든 출력 페이지를 선택한 각도로 회전시킵니다.

  1. 회전 옵션 설정 – 회전 enum을 선택하십시오.
import com.groupdocs.conversion.options.convert.Rotation;

PdfConvertOptions options = new PdfConvertOptions();
options.setRotate(Rotation.On180); // Rotate pages 180 degrees.
  1. 변환 실행 – 이전과 동일한 패턴을 사용합니다.
String convertedFile = "YOUR_OUTPUT_DIRECTORY/RotatedPagesPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

Explanation: 회전은 가로 스캔을 수정하거나 특정 레이아웃 요구 사항을 충족시킬 수 있습니다.

PDF 변환 시 DPI 설정

Direct answer: convert를 호출하기 전에 PdfConvertOptions.setDpi(300)(또는 원하는 정수)으로 이미지 해상도를 조정하십시오; 높은 DPI는 파일 크기가 커지는 대가로 더 선명한 그래픽을 제공합니다.

  1. DPI 설정 구성
PdfConvertOptions options = new PdfConvertOptions();
options.setDpi(300); // Set DPI to 300 for high resolution.
  1. 맞춤 DPI로 변환 수행
String convertedFile = "YOUR_OUTPUT_DIRECTORY/HighResolutionPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

Explanation: 높은 DPI는 시각적 충실도를 향상시키지만 파일 크기가 증가합니다—대상 매체에 따라 선택하십시오.

PDF 변환 시 너비와 높이 설정

Direct answer: PdfConvertOptions.setWidth(1240) 및 setHeight(1754)를 사용하여 명시적인 픽셀 차원을 정의하면 출력 PDF가 특정 페이지 크기에 맞게 강제됩니다.

  1. 차원 정의
PdfConvertOptions options = new PdfConvertOptions();
options.setWidth(1024); // Set width to 1024 pixels.
options.setHeight(768); // Set height to 768 pixels.
  1. 맞춤 크기로 변환
String convertedFile = "YOUR_OUTPUT_DIRECTORY/SizedPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

Explanation: 맞춤 차원은 특정 화면 크기나 인쇄 형식에 맞는 PDF를 생성할 때 유용합니다.

GroupDocs를 사용하여 Word를 PDF java로 변환하는 방법

new Converter("doc.docx", new WordProcessingLoadOptions("pwd")) 로 보호된 Word 파일을 로드하고, 필요한 PdfConvertOptions(페이지, DPI, 회전, 크기)를 구성한 뒤 converter.convert(options, "output.pdf") 를 호출하십시오. 이 한 줄 패턴은 복호화, 렌더링 및 파일 쓰기를 처리하여 외부 도구 없이도 프로덕션 준비된 PDF를 제공합니다. Java 8 이상을 지원하는 모든 플랫폼에서 작동합니다.

일반적인 문제 및 해결책

문제가능한 원인해결 방법
IncorrectPasswordException잘못된 비밀번호가 제공되었습니다.비밀번호 문자열을 다시 확인하고, 공백을 제거하십시오.
FileNotFoundException잘못된 파일 경로절대 경로를 사용하거나 작업 디렉터리를 확인하십시오.
출력 PDF가 흐릿함DPI가 너무 낮음options.setDpi()를 사용하여 DPI를 높이십시오.
페이지가 뒤집혀 표시됨회전이 설정되지 않았거나 잘못 설정됨options.setRotate(Rotation.On180)(또는 다른 enum) 를 사용하십시오.
변환된 파일이 예상보다 큼높은 DPI와 큰 차원DPI를 낮추거나 너비/높이를 조정하여 크기와 품질을 균형 맞추십시오.

자주 묻는 질문

Q: 비밀번호와 읽기 전용 보호가 모두 적용된 Word 문서를 변환할 수 있나요?
A: 예. WordProcessingLoadOptions.setPassword()를 통해 열기 비밀번호를 제공하십시오. 변환 중에는 읽기 전용 플래그가 무시됩니다.

Q: GroupDocs.Conversion이 .doc(레거시) 파일도 .docx와 같이 지원합니까?
A: 물론입니다. 라이브러리는 두 형식을 투명하게 처리합니다.

Q: java convert word pdf 성능이 대용량 파일에서 어떻게 확장됩니까?
A: GroupDocs는 데이터를 스트리밍하고 각 변환 후 리소스를 해제합니다. 매우 큰 파일의 경우 JVM 힙 크기를 늘리고 완료 시 Converter.dispose()를 호출하십시오.

Q: 여러 문서를 배치로 변환할 수 있나요?
A: 예. 파일 경로를 반복하면서 각 파일에 대해 새로운 Converter를 생성하고, 적절히 동일한 PdfConvertOptions를 재사용하십시오.

Q: 개발 빌드에 상용 라이선스가 필요합니까?
A: 평가를 위해 무료 체험이 가능하지만, 프로덕션 배포에는 유효한 GroupDocs.Conversion 라이선스가 필요합니다.


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

관련 튜토리얼