produce final content.# GroupDocs.Editor for Java를 사용하여 비밀번호로 Word 저장하기

이 튜토리얼에서는 Java에서 Word 문서를 편집하면서 비밀번호로 Word 저장하는 방법을 알아봅니다. Java에서 Word 문서 편집이 필요하거나, 비밀번호로 보호하거나, DOCX를 DOCM 형식으로 변환하려는 경우에도 GroupDocs.Editor는 깔끔하고 메모리 효율적인 방법을 제공합니다. 라이브러리 설정, 비밀번호 보호 파일 로드, 편집 옵션 커스터마이징, 최종적으로 문서를 안전하게 저장하는 전체 과정을 단계별로 살펴보겠습니다.

Quick Answers

  • Java에서 Word 문서를 편집할 수 있는 라이브러리는 무엇인가요? GroupDocs.Editor for Java.
  • 비밀번호로 보호된 파일을 열 수 있나요? 예 – 비밀번호와 함께 WordProcessingLoadOptions를 사용합니다.
  • 저장 시 메모리 사용량을 줄이려면 어떻게 해야 하나요? WordProcessingSaveOptions에서 optimizeMemoryUsage(true)를 설정합니다.
  • 프로덕션 환경에 라이선스가 필요합니까? 유효한 GroupDocs.Editor 라이선스가 필요합니다.
  • 매크로와 읽기 전용 보호를 지원하는 형식은 무엇인가요? DOCM 형식.
  • 편집 중에 내장 폰트를 추출하려면 어떻게 해야 하나요? FontExtractionOptions.ExtractEmbeddedWithoutSystem을 사용합니다.
  • 편집 후 DOCX를 DOCM으로 변환할 수 있나요? 예 – 저장 시 WordProcessingFormats.Docm을 지정합니다.

What is “save word with password”?

Word 파일을 비밀번호로 저장한다는 것은 문서가 암호화되어 비밀번호를 아는 사용자만 열 수 있다는 의미입니다. 이는 특히 파일이 전자적으로 저장되거나 전송될 때 기밀 콘텐츠에 대한 보안 레이어를 추가합니다.

Why Use GroupDocs.Editor for Java?

  • 전체 기능 편집 – 텍스트, 이미지, 표, 그리고 매크로까지 수정할 수 있습니다.
  • 비밀번호 처리 – 보호된 파일을 손쉽게 열고 저장할 수 있습니다.
  • 메모리 최적화 옵션 – 대용량 문서나 클라우드 환경에 이상적입니다.
  • 크로스 플랫폼 – Java 호환 플랫폼 어디서든 작동합니다 (Java 8 이상).

Prerequisites

시작하기 전에 Java 프로그래밍에 대한 탄탄한 이해가 필요합니다. Maven 프로젝트 설정 및 Java에서 파일 I/O 작업을 다루는 데 익숙하면 도움이 됩니다. 또한 개발 환경이 Java 8 이상으로 설정되어 GroupDocs.Editor와 원활히 작동하도록 해야 합니다.

Required Libraries and Dependencies

이 튜토리얼에서는 GroupDocs.Editor 라이브러리를 사용합니다. Maven을 사용하여 프로젝트에 포함시키세요:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/editor/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-editor</artifactId>
      <version>25.3</version>
   </dependency>
</dependencies>

또는 GroupDocs.Editor for Java releases에서 직접 라이브러리를 다운로드할 수 있습니다.

License Acquisition

평가 제한 없이 GroupDocs.Editor를 완전히 활용하려면 무료 체험판을 받거나 라이선스를 구매하는 것을 고려하세요. 기능을 충분히 살펴보려면 this link에서 임시 라이선스를 획득할 수 있습니다.

Setting Up GroupDocs.Editor for Java

GroupDocs.Editor를 설치했으면 이제 환경을 초기화하고 구성할 차례입니다:

  1. 위에서 지정한 Maven 의존성을 추가하거나 JAR 파일을 다운로드합니다.
  2. 선호하는 IDE(예: IntelliJ IDEA, Eclipse)에서 기본 프로젝트 구조를 설정합니다.
  3. pom.xml에 Maven을 사용할 경우 필요한 저장소가 포함되어 있는지 확인합니다.

위 단계들을 완료하면 GroupDocs.Editor를 사용해 문서 관리 기능을 구현할 준비가 된 것입니다.

Implementation Guide

프로세스를 세 가지 주요 섹션으로 나눕니다: 문서 로드 및 비밀번호 처리, 문서 편집 옵션, 콘텐츠 편집 및 저장. 각 기능을 단계별로 살펴보겠습니다.

Feature 1: Document Loading and Password Handling

개요: 이 섹션에서는 GroupDocs.Editor for Java를 사용해 비밀번호로 보호된 문서를 로드하는 방법을 보여줍니다. 접근 제어가 필요한 민감한 문서를 다룰 때 필수적입니다.

Step 1: Define the Path to Your Document

먼저 Word 문서의 위치를 지정합니다:

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";

Step 2: Create an InputStream

다음으로 문서를 읽기 위한 파일 입력 스트림을 초기화합니다:

InputStream fs = new FileInputStream(inputFilePath);

Step 3: Set Load Options with Password Protection

비밀번호로 보호된 문서를 처리하려면 로드 옵션을 구성합니다:

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("some_password_to_open_a_document");

Step 4: Load the Document Using Editor

마지막으로 Editor 클래스를 사용해 문서를 열고 작업합니다:

Editor editor = new Editor(fs, loadOptions);

Feature 2: Document Editing Options

개요: 폰트 추출 및 언어 정보와 같은 편집 옵션을 구성하면 문서 처리 기능을 향상시킬 수 있습니다.

Step 1: Create Editing Options

먼저 편집 옵션 객체를 초기화합니다:

WordProcessingEditOptions editOptions = new WordProcessingEditOptions();

Step 2: Enable Font Extraction

내장 폰트를 사용하도록 하려면 다음 옵션을 설정합니다:

editOptions.setFontExtraction(FontExtractionOptions.ExtractEmbeddedWithoutSystem);

Step 3: Extract Language Information

언어 정보를 활성화하면 다국어 문서 처리에 유용합니다:

editOptions.setEnableLanguageInformation(true);

Step 4: Enable Pagination Mode

특히 긴 문서의 경우 편집을 쉽게 하기 위해 페이지네이션 모드를 켭니다:

editOptions.setEnablePagination(true);

Feature 3: Content Editing and Document Saving

개요: 이 섹션에서는 형식 및 비밀번호 보호와 같은 특정 구성으로 비밀번호로 Word 저장하는 방법을 보여줍니다.

Step 1: Extract Original Content

먼저 원본 콘텐츠와 리소스를 추출합니다:

String originalContent = beforeEdit.getContent();
List<IHtmlResource> allResources = beforeEdit.getAllResources();

Step 2: Modify Document Content

필요에 따라 문서 텍스트를 변경합니다. 여기서는 “document"를 “edited document"로 교체합니다:

String editedContent = originalContent.replace("document", "edited document");
EditableDocument afterEdit = EditableDocument.fromMarkup(editedContent, allResources);

Step 3: Set Up Save Options

형식 및 비밀번호를 포함해 문서를 저장하는 방식을 구성합니다:

WordProcessingFormats docmFormat = WordProcessingFormats.Docm;
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docmFormat);
saveOptions.setPassword("password");
saveOptions.setEnablePagination(true);
saveOptions.setLocale(Locale.US);
saveOptions.setOptimizeMemoryUsage(true);
saveOptions.setProtection(new WordProcessingProtection(WordProcessingProtectionType.ReadOnly, "write_password"));

Step 4: Save the Edited Document

마지막으로 편집된 문서를 출력 파일에 기록합니다:

String outputPath = "YOUR_OUTPUT_DIRECTORY/edited_output.docm";
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
editor.save(afterEdit, outputStream, saveOptions);
try (FileOutputStream outputFile = new FileOutputStream(outputPath)) {
    outputStream.writeTo(outputFile);
}

Common Use Cases

  • 보안 문서 처리: 기밀 계약서나 인사 파일을 편집할 때 비밀번호 보호를 사용합니다.
  • 배치 처리: 기업 문서 관리 시스템에서 수십 개 파일의 편집을 자동화합니다.
  • 콘텐츠 검토 워크플로: 검토자가 최종 승인 전에 Word 파일에서 직접 편집하고 댓글을 달 수 있도록 합니다.

Performance Considerations

GroupDocs.Editor를 사용할 때 최적 성능을 보장하려면:

  • 메모리 사용 최소화 – optimizeMemoryUsage(true)를 활성화 상태로 유지합니다.
  • 전체 문서를 메모리에 로드하는 대신 큰 파일을 청크 단위로 처리합니다.
  • 성능 향상 및 버그 수정을 위해 최신 GroupDocs.Editor 릴리스로 정기적으로 업그레이드합니다.

Frequently Asked Questions

Q: 비밀번호로 보호된 문서를 어떻게 열 수 있나요?
A: Editor 인스턴스를 만들기 전에 WordProcessingLoadOptions를 사용하고 setPassword("your_password")를 호출합니다.

Q: 매크로가 포함된 DOCM 파일을 편집할 수 있나요?
A: 예. 매크로를 보존하려면 편집된 문서를 WordProcessingFormats.Docm으로 저장합니다.

Q: 큰 파일을 저장할 때 메모리 사용량을 줄이는 가장 좋은 방법은 무엇인가요?
A: WordProcessingSaveOptions에서 optimizeMemoryUsage(true)를 활성화하고 페이지네이션 모드 사용을 고려합니다.

Q: 편집 중에 내장 폰트를 추출할 수 있나요?
A: 물론 가능합니다. editOptions.setFontExtraction(FontExtractionOptions.ExtractEmbeddedWithoutSystem)을 설정합니다.

Q: 프로덕션 환경에서 GroupDocs.Editor를 사용하려면 특별한 라이선스가 필요합니까?
A: 프로덕션 배포에는 유효한 GroupDocs.Editor 라이선스가 필요합니다; 평가용으로는 임시 라이선스를 얻을 수 있습니다.

Q: 편집 후 DOCX를 DOCM으로 변환하려면 어떻게 해야 하나요?
A: 저장 단계에서와 같이 WordProcessingSaveOptions를 만들 때 WordProcessingFormats.Docm을 지정합니다.

Conclusion

이 가이드에서는 Java에서 Word 문서를 편집하면서 비밀번호로 Word 저장 보호를 적용하는 방법을 다루었습니다. 비밀번호로 보호된 파일을 로드하고, 내장 폰트 추출과 같은 편집 옵션을 커스터마이징하며, 최종적으로 읽기 전용 보호와 메모리 최적화가 적용된 DOCM 형식으로 문서를 저장하는 방법을 배웠습니다. Java 애플리케이션에 GroupDocs.Editor를 통합하면 현대 비즈니스 요구에 부합하는 안전하고 고성능의 문서 처리 솔루션을 구축할 수 있습니다.

Last Updated: 2026-02-19
Tested With: GroupDocs.Editor 25.3
Author: GroupDocs