.

Now produce final content.# GroupDocs.Conversion for Java를 사용하여 암호로 보호된 Word 문서를 Excel로 변환하는 방법

암호로 보호된 Word 문서를 Excel 스프레드시트로 변환하는 것은 데이터를 표 형식으로 분석하거나 공유하고자 할 때 흔히 필요한 작업입니다. 이 튜토리얼에서는 GroupDocs.Conversion API for Java를 사용하여 암호로 보호된 Word 파일을 Excel로 변환하는 방법을 단계별로 배웁니다.

빠른 답변

  • 암호 없이 보호된 Word 파일을 변환할 수 있나요? 아니요 – 로드 옵션을 통해 올바른 암호를 제공해야 합니다.
  • 스프레드시트에 지원되는 출력 형식은 무엇인가요? XLS, XLSX, CSV, ODS를 사용할 수 있습니다.
  • 프로덕션 환경에서 라이선스가 필요합니까? 네, 비시험 배포에는 유효한 GroupDocs 라이선스가 필요합니다.
  • Java 8이면 충분한가요? Java 8 이상을 지원하며, 최신 버전도 동작합니다.
  • 특정 페이지만 변환할 수 있나요? 물론입니다 – 변환 옵션에서 setPageNumber와 setPagesCount를 사용하세요.

“convert password protected word”란 무엇인가요?

이 문구는 암호로 보호된 Word 문서를 열고 그 내용을 다른 파일 형식—여기서는 Excel 스프레드시트—으로 변환하는 과정을 의미합니다. 데이터 추출, 보고서 작성 및 자동화 워크플로우에 유용합니다.

왜 Java용 GroupDocs.Conversion을 사용하나요?

GroupDocs.Conversion은 복잡한 형식, 암호 보호 및 세밀한 변환 설정을 외부 도구 없이 처리할 수 있는 고수준의 언어‑네이티브 API를 제공합니다. 신뢰성이 높고 문서화가 잘 되어 있으며 Java 애플리케이션에 원활하게 통합됩니다.

사전 요구 사항

  • 라이브러리 및 종속성: GroupDocs.Conversion for Java (Maven을 통해 추가).
  • 환경: JDK 8 이상 및 IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  • 지식: 기본 Java 프로그래밍, 파일 I/O 및 API 사용.

GroupDocs.Conversion for Java 설정

Maven 설치

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/conversion/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

라이선스 획득

GroupDocs 웹사이트에서 무료 체험으로 시작하세요. 전체 기능을 사용하려면 라이선스를 구매하거나 임시 라이선스를 요청하십시오.

Java에서 암호로 보호된 문서를 로드하는 방법

암호로 보호된 문서를 로드하려면 암호를 포함하는 load options 객체가 필요합니다. 이 단계에서 파일이 잠금 해제되어 변환기가 내용을 읽을 수 있게 됩니다.

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

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("12345"); // Replace with your document's password.

설명: WordProcessingLoadOptions는 Word 파일 전용으로 설계되었습니다. setPassword를 호출하면 API가 보호된 문서를 열 수 있는 권한을 부여합니다.

Java Word → Spreadsheet 변환 – 고급 옵션

문서를 로드한 후에는 변환 동작을 정의할 수 있습니다—페이지 선택, 형식 지정 및 시각적 스케일링.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.SpreadsheetFileType;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;

SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
options.setPageNumber(2); // Start from page 2.
options.setPagesCount(1); // Convert only one page.
options.setFormat(SpreadsheetFileType.Xls); // Output format as XLS.
options.setZoom(150); // Set zoom level for conversion (scale factor).

설명:

  • setPageNumber와 setPagesCount를 사용하면 특정 페이지 범위를 지정할 수 있어 문서의 일부만 필요할 때 유용합니다.
  • setFormat은 스프레드시트 컨테이너를 선택합니다 (이 경우 XLS).
  • setZoom은 렌더링 스케일을 조정하며, 레이아웃 정확성을 유지하는 데 도움이 됩니다.

변환 수행

로드 옵션과 변환 옵션을 준비했으면 convert 메서드를 호출합니다. API가 내부에서 복잡한 작업을 처리합니다.

String convertedFile = Constants.getConvertedPath("ConvertToSpreadsheetWithAdvancedOptions.xls");
Converter converter = new Converter(Constants.SAMPLE_DOCX_WITH_PASSWORD, () -> loadOptions);
converter.convert(convertedFile, options);

설명: Converter 생성자는 소스 파일 경로와 이전에 정의한 loadOptions를 제공하는 람다를 받습니다. convert 호출은 Excel 파일을 Constants.getConvertedPath가 반환하는 위치에 기록합니다.

일반적인 문제와 해결책

증상가능한 원인해결 방법
“Invalid password” 예외잘못된 비밀번호 문자열 또는 인코딩 문제비밀번호를 확인하고, 여분의 공백이 없는지 확인하며, 정확한 대소문자를 사용하십시오.
출력에 페이지 누락setPageNumber/setPagesCount 값이 잘못됨원본 Word 파일의 페이지 번호를 다시 확인하십시오; 페이지 번호는 1부터 시작합니다.
대용량 파일에서 메모리 부족 오류문서를 전체 메모리로 로드파일을 청크 단위로 처리하거나 JVM 힙 크기(-Xmx)를 늘리세요.
지원되지 않는 형식 오류오래된 GroupDocs 버전 사용최신 라이브러리(예: 25.2)로 업그레이드하십시오.

실용적인 적용 사례

  1. 데이터 관리: 월간 보고서를 Excel로 변환하여 피벗 테이블 분석에 활용합니다.
  2. 문서 보관: 레거시 Word 파일을 스프레드시트로 저장하여 쿼리를 쉽게 수행합니다.
  3. 워크플로 자동화: 변환을 배치 작업에 삽입하여 하위 시스템을 위한 데이터를 준비합니다.

성능 고려 사항

  • 다수의 문서를 처리할 때 단일 Converter 인스턴스를 재사용하여 오버헤드를 줄입니다.
  • 스트림을 즉시 닫습니다(try‑with‑resources)하여 네이티브 리소스를 해제합니다.
  • setZoom은 필요할 때만 조정하세요; 높은 줌 값은 CPU 부하를 증가시킵니다.

결론

이제 GroupDocs.Conversion for Java를 사용하여 암호로 보호된 Word 문서를 Excel 스프레드시트로 변환하는 완전하고 프로덕션 준비된 방법을 갖추었습니다. 이 코드 조각을 애플리케이션에 통합하고 옵션을 비즈니스 규칙에 맞게 조정하면 데이터 추출을 그 어느 때보다 효율적으로 수행할 수 있습니다.

다음 단계

  • 다른 스프레드시트 형식(XLSX, CSV)을 실험해 보세요.
  • 보호된 파일이 있는 디렉터리를 순회하여 배치 변환을 탐색하세요.
  • 워터마크 또는 PDF용 OCR과 같은 추가 GroupDocs 기능을 검토하세요.

FAQ 섹션

  1. GroupDocs.Conversion을 Java에서 사용하는 주요 사용 사례는 무엇인가요?
    GroupDocs.Conversion은 개발자가 다양한 형식 간에 문서를 변환할 수 있게 하며, 데이터 관리 및 워크플로 자동화 작업에 이상적입니다.
  2. 문서 변환 중 오류를 어떻게 처리할 수 있나요?
    올바른 종속성 및 파일 경로를 포함한 모든 사전 요구 사항이 충족되었는지 확인하십시오. Java의 예외 처리 메커니즘을 사용하여 잠재적인 문제를 관리하세요.
  3. GroupDocs.Conversion이 문서 배치 처리를 지원하나요?
    네, 루프를 통해 여러 파일을 처리하여 대량 변환 기능을 확장할 수 있습니다.
  4. 이 API로 암호로 보호된 PDF를 변환할 수 있나요?
    이 튜토리얼은 Word 문서에 초점을 맞추지만, GroupDocs.Conversion은 적절한 로드 옵션을 사용하여 암호로 보호된 PDF를 포함한 다양한 파일 형식을 지원합니다.
  5. 대용량 파일을 변환할 때 메모리 사용량을 어떻게 최적화하나요?
    파일을 청크 단위로 처리하고 Java 도구를 통해 효율적인 가비지 컬렉션을 보장함으로써 최적화합니다.

리소스

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