GroupDocs.Editor for Java를 사용하여 비밀번호로 Word 저장

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

빠른 답변

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

“비밀번호로 Word 저장”이란?

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

Java용 GroupDocs.Editor를 사용하는 이유

GroupDocs.Editor for Java는 Word 문서 편집을 위한 포괄적인 도구 세트를 제공하며, 비밀번호 보호, 매크로 처리 및 효율적인 메모리 사용을 지원해 엔터프라이즈 및 클라우드 애플리케이션에 이상적입니다. Maven 프로젝트와 원활하게 통합되고, 형식 변환을 제공하며, 폰트 추출 및 페이지 매김 모드와 같은 고급 기능을 포함해 사용자 경험을 향상시킵니다.

  • 전체 기능 편집 – 텍스트, 이미지, 표 및 매크로까지 수정합니다.
  • 비밀번호 처리 – 보호된 파일을 손쉽게 열고 저장합니다.
  • 메모리 최적화 옵션 – 대용량 문서나 클라우드 환경에 이상적입니다.
  • 크로스 플랫폼 – Java 호환 플랫폼 어디서든 작동합니다 (Java 8+).
  • 정량적 이점: GroupDocs.Editor는 30개 이상의 파일 형식을 지원하고 전체 파일을 메모리에 로드하지 않고 500 MB까지의 문서를 편집할 수 있어 피크 RAM 사용량을 **70 %**까지 줄일 수 있습니다.

사전 요구 사항

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

필요 라이브러리 및 종속성

이 튜토리얼에서는 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에서 직접 라이브러리를 다운로드할 수 있습니다.

라이선스 획득

평가 제한 없이 GroupDocs.Editor를 완전히 활용하려면 무료 체험판을 사용하거나 라이선스를 구매하는 것을 고려하십시오. 기능을 폭넓게 탐색하려면 this link에서 임시 라이선스를 획득할 수 있습니다.

Java용 GroupDocs.Editor 설정

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

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

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

구현 가이드

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

기능 1: 문서 로드 및 비밀번호 처리

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

단계 1: 문서 경로 정의

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

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";

단계 2: InputStream 생성

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

InputStream fs = new FileInputStream(inputFilePath);

단계 3: 비밀번호 보호 로드 옵션 설정

WordProcessingLoadOptions는 비밀번호 처리 및 형식 설정을 포함해 Word 문서가 어떻게 로드되는지를 정의합니다.
비밀번호로 보호된 문서를 처리하려면 로드 옵션을 다음과 같이 구성합니다:

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

단계 4: Editor를 사용해 문서 로드

Editor는 지정된 옵션을 사용해 문서를 로드, 편집 및 저장하는 핵심 클래스입니다.
마지막으로 Editor 클래스를 사용해 문서를 열고 작업합니다:

Editor editor = new Editor(fs, loadOptions);

기능 2: 문서 편집 옵션

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

단계 1: 편집 옵션 생성

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

WordProcessingEditOptions editOptions = new WordProcessingEditOptions();

단계 2: 폰트 추출 활성화

FontExtractionOptions는 편집 중 포함된 폰트를 시스템 폰트에 의존하지 않고 추출하도록 제어합니다.
포함된 폰트를 사용하도록 다음 옵션을 구성합니다:

editOptions.setFontExtraction(FontExtractionOptions.ExtractEmbeddedWithoutSystem);

단계 3: 언어 정보 추출

다국어 문서 처리를 위해 언어 정보를 활성화할 수 있습니다:

editOptions.setEnableLanguageInformation(true);

단계 4: 페이지 매김 모드 활성화

특히 긴 문서의 경우 페이지 매김 모드를 켜면 편집이 쉬워집니다:

editOptions.setEnablePagination(true);

기능 3: 콘텐츠 편집 및 문서 저장

Overview: 이 섹션에서는 문서 내용을 수정하고 비밀번호로 Word 저장을 위해 형식 및 비밀번호 보호와 같은 구성을 사용하는 방법을 보여줍니다.

단계 1: 원본 콘텐츠 추출

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

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

단계 2: 문서 콘텐츠 수정

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

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

단계 3: 저장 옵션 설정

WordProcessingSaveOptions는 형식, 비밀번호 보호 및 메모리 최적화와 같은 저장 매개변수를 지정합니다.
형식 및 비밀번호를 포함해 문서를 저장하는 방법을 다음과 같이 구성합니다:

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"));

단계 4: 편집된 문서 저장

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

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);
}

보호된 Word 파일을 여는 방법은?

WordProcessingLoadOptions 인스턴스를 생성하고 setPassword("yourPassword")를 호출한 뒤 이를 Editor 생성자에 전달하면 보호된 파일을 로드할 수 있습니다. 이 간단한 방법은 문서를 메모리 내에서 복호화하여 디스크에 원시 비밀번호를 노출하지 않고도 편집하거나 변환할 수 있게 합니다.

저장 시 비밀번호를 설정하는 방법은?

WordProcessingSaveOptions 객체를 만든 뒤 setPassword("newPassword")를 호출하고, 필요에 따라 setReadOnlyRecommended(true)를 활성화해 추가 보호를 적용합니다. 그런 다음 Editor 인스턴스의 save 메서드에 이 옵션들을 전달하면 파일이 AES‑256 암호화로 저장되어 강력한 보안을 제공합니다. 비밀번호를 설정한 후에는 읽기 전용 권장, 편집 제한, 암호화 표준 적용 등 추가 보안 옵션도 지정할 수 있어 조직의 컴플라이언스 요구 사항을 충족합니다.

편집 후 DOCX를 DOCM으로 변환하는 방법은?

WordProcessingSaveOptions에 WordProcessingFormats.Docm을 지정하면 편집된 DOCX를 매크로가 포함된 DOCM 파일로 변환할 수 있습니다. 이렇게 하면 기존 VBA 매크로가 유지되어 Office에서 정상적으로 작동합니다. 출력 위치를 정의하고 원본 문서와 동일한 비밀번호 또는 읽기 전용 설정을 적용할 수도 있습니다. WordProcessingFormats는 DOCX와 DOCM 같은 지원 출력 형식을 열거합니다.

일반 사용 사례

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

성능 고려 사항

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

  • 메모리 사용 최소화: optimizeMemoryUsage(true)를 활성화합니다.
  • 전체 문서를 메모리에 로드하지 않고 큰 파일을 청크 단위로 처리합니다.
  • 성능 향상 및 버그 수정을 위해 최신 GroupDocs.Editor 릴리스를 정기적으로 업그레이드합니다.
  • 정량적 주장: 최신 버전은 메모리 최적화가 활성화된 상태에서 표준 8코어 서버에서 300페이지 DOCX를 2초 미만에 처리합니다.

자주 묻는 질문

Q: 비밀번호로 보호된 문서를 여는 방법은?
A: WordProcessingLoadOptions를 사용하고 Editor 인스턴스를 만들기 전에 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: 저장 옵션을 만들 때 WordProcessingFormats.Docm을 지정합니다(저장 단계에서와 같이).

결론

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

Last Updated: 2026-07-20
Tested With: GroupDocs.Editor 25.3
Author: GroupDocs

관련 튜토리얼