DOCX를 이미지로 변환하고 GroupDocs Redaction Java를 사용하여 Word 문서에서 민감 정보 가리기

Microsoft Word 파일에서 민감 정보를 보호하는 것은 문서 중심 애플리케이션을 구축하는 개발자에게 매일 직면하는 과제입니다. 개인 데이터를 숨기거나 GDPR을 준수하거나 외부 검토를 위한 법적 계약서를 준비해야 할 경우, convert docx to image를 레드액션 전에 수행하면 원본 레이아웃을 유지하면서 내용이 안전하게 가려집니다. 이 가이드에서는 프로세스가 convert word to pdf를 효과적으로 수행하는 방법도 보여주며, 민감 데이터 레드액션에 적합한 래스터화된 PDF를 제공합니다.

빠른 답변

• “convert docx to image”가 무엇을 의미하나요? Word 파일의 각 페이지를 비트맵으로 래스터화하여 레이아웃을 보존하고 신뢰할 수 있는 레드액션을 가능하게 합니다.
• 필요한 Maven 아티팩트는 무엇인가요? com.groupdocs:groupdocs-redaction (groupdocs maven dependency 섹션을 참조).
• Java에서 텍스트를 숨길 수 있나요? 예—ImageAreaRedaction을 RegionReplacementOptions와 함께 사용하여 단색을 오버레이합니다.
• 라이선스가 필요합니까? 평가용으로는 체험 라이선스로 충분하지만, 프로덕션에서는 상용 라이선스가 필요합니다.
• 출력은 PDF인가요, 이미지 파일인가요? 래스터화 단계에서 각 페이지가 이미지인 PDF가 생성되어 레드액션 준비가 됩니다.

“convert docx to image”란 무엇인가요?

DOCX 파일을 래스터화하면 모든 페이지가 이미지(보통 PDF에 포함)로 변환됩니다. 이 변환은 선택 가능한 텍스트를 제거하여 이후 레드액션을 되돌릴 수 없고 변조 방지됩니다. 문서를 이미지 기반 PDF로 전환하면 나중에 적용되는 레드액션을 텍스트 복사만으로 되돌릴 수 없게 되어 규정 준수 워크플로에 필수적입니다.

Java용 GroupDocs Redaction을 사용하는 이유

Java용 GroupDocs Redaction은 보안 문서 정화에 대한 원스톱 솔루션을 제공합니다. 원본 Word 레이아웃을 픽셀 단위로 정확히 보존하고, 개별 영역이나 전체 페이지를 대상으로 할 수 있으며, Maven 하나의 의존성으로 통합됩니다. 이 라이브러리는 Windows, Linux, macOS를 지원하고, 전체 문서를 메모리에 로드하지 않고도 500 MB까지 파일을 처리할 수 있으며, 성능 향상 및 새로운 포맷 지원을 위해 분기별로 업데이트됩니다.

사전 요구 사항

• JDK 8 이상이 설치되어 있어야 합니다.
• IntelliJ IDEA, Eclipse 또는 NetBeans와 같은 IDE.
• Maven 아티팩트 또는 직접 JAR을 다운로드할 수 있는 인터넷 연결.
• 기본 Java 지식 및 Maven 사용 경험.

Java용 GroupDocs.Redaction 설정

Maven 의존성 (groupdocs maven dependency)

공식 GroupDocs 저장소와 Redaction 라이브러리를 pom.xml에 추가합니다:

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

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-redaction</artifactId>
        <version>24.9</version>
    </dependency>
</dependencies>

Direct Download – Maven을 사용하지 않으려면 공식 페이지에서 최신 JAR를 다운로드하세요: GroupDocs.Redaction for Java releases.

라이선스 획득

1. GroupDocs 포털에서 free trial license를 요청합니다.
2. 프로덕션 배포 시 commercial license를 구매하고 체험 키를 영구 키로 교체합니다.

단계별 가이드

단계 1: 필요한 클래스 가져오기 (how to rasterize word)

RasterizationOptions 클래스는 각 페이지를 이미지로 렌더링하는 방식을 구성합니다. Redactor 클래스는 문서에 레드액션 규칙을 적용하기 위한 진입점입니다. API를 사용하기 전에 이들을 import하십시오.

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.RasterizationOptions;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.nio.file.Files;
import java.nio.file.Paths;

단계 2: DOCX 로드 및 래스터화 (convert docx to image)

RasterizationOptions는 GroupDocs에 각 페이지를 이미지로 렌더링하도록 지시합니다. ByteArrayOutputStream은 결과를 메모리에 보관하여 중간 파일을 쓰지 않고 다음 단계로 바로 전달할 수 있게 합니다. 이 단계는 또한 convert word to pdf를 백그라운드에서 수행하며, 각 래스터화된 페이지가 PDF 컨테이너에 저장됩니다.

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
ByteArrayOutputStream stream = new ByteArrayOutputStream();

try (Redactor rasterizer = new Redactor(inputFilePath)) {
    // Enable rasterization options.
    RasterizationOptions options = new RasterizationOptions();
    options.setEnabled(true);
    
    // Save the document as a byte array in rasterized form.
    rasterizer.save(stream, options);
}

Explanation: RasterizationOptions는 GroupDocs에 각 페이지를 이미지로 렌더링하도록 지시합니다. ByteArrayOutputStream은 결과를 메모리에 보관하여 중간 파일을 쓰지 않고 다음 단계로 바로 전달할 수 있게 합니다. 이 단계는 또한 convert word to pdf를 백그라운드에서 수행하며, 각 래스터화된 페이지가 PDF 컨테이너에 저장됩니다.

단계 3: 레드액션을 위한 래스터화된 출력 준비

ByteArrayInputStream은 메모리 내 PDF를 래핑하여 레드액션 엔진이 직접 읽을 수 있게 합니다. 이는 디스크에 임시 파일을 만들 필요를 없애고 I/O 오버헤드를 줄여 대량 배치 처리 시 특히 중요합니다.

ByteArrayInputStream inputStream = new ByteArrayInputStream(stream.toByteArray());

이제 래스터화된 PDF가 InputStream 형태로 제공되며, 이를 레드액션 엔진에 바로 전달할 수 있습니다.

단계 4: 이미지 영역 레드액션 적용 (how to redact word)

ImageAreaRedaction은 startPoint와 size로 정의된 사각형 영역을 대상으로 합니다. RegionReplacementOptions를 사용하면 오버레이 색상(예시에서는 파란색)과 교체 사각형의 크기를 선택할 수 있습니다. 레드액션을 적용한 후 문서는 민감 영역이 안전하게 가려진 래스터화된 PDF로 저장됩니다. 이는 hide text java 개발자가 기밀 Word 콘텐츠를 다룰 때 필요한 핵심 방법입니다.

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.RedactorChangeLog;
import com.groupdocs.redaction.redactions.ImageAreaRedaction;
import com.groupdocs.redaction.redactions.RegionReplacementOptions;
import java.awt.Color;
import java.awt.Dimension;
import java.awt.Point;
import java.io.FileOutputStream;

try (Redactor redactor = new Redactor(inputStream)) {
    // Define the area for redaction.
    Point startPoint = new Point(1160, 2375);
    Dimension size = new Dimension(1050, 720);

    // Set up replacement options with a blue color overlay.
    RegionReplacementOptions replaceWithBlue = new RegionReplacementOptions(Color.BLUE, size);

    // Apply the image area redaction.
    RedactorChangeLog result = redactor.apply(new ImageAreaRedaction(startPoint, replaceWithBlue));

    if (result.getStatus() != Redactor.RedactionStatus.Failed) {
        // Save the final document to an output directory.
        String outputPath = "YOUR_OUTPUT_DIRECTORY/sample_raster.pdf";
        try (FileOutputStream fileStream = new FileOutputStream(outputPath)) {
            RasterizationOptions saveOptions = new RasterizationOptions();
            saveOptions.setEnabled(false);
            redactor.save(fileStream, saveOptions);
        }
    }
}

Explanation:

• ImageAreaRedaction은 startPoint와 size로 정의된 사각형 영역을 대상으로 합니다.
• RegionReplacementOptions를 사용하면 오버레이 색상(예시에서는 파란색)과 교체 사각형의 크기를 선택할 수 있습니다.
• 레드액션을 적용한 후 문서는 민감 영역이 안전하게 가려진 래스터화된 PDF로 저장됩니다. 이는 hide text java 개발자가 기밀 Word 콘텐츠를 다룰 때 필요한 핵심 방법입니다.

Word를 PDF로 변환하고 민감 데이터 레드액션하는 방법

DOCX를 로드하고 이미지 기반 PDF로 래스터화한 뒤 하나 이상의 ImageAreaRedaction 객체를 적용합니다. 래스터화는 자동으로 convert word to pdf를 수행하여 각 페이지를 비트맵으로 삽입하므로, 이후 레드액션은 텍스트가 더 이상 선택 가능하지 않아 변조 방지됩니다.

레드액션 엔진은 메모리 내 PDF 스트림에서 직접 작동하므로 디스크에 임시 파일을 쓸 필요가 없습니다. 레드액션 후에는 최종 PDF를 클라이언트에 스트리밍하거나 데이터베이스에 저장하거나 클라우드 스토리지에 업로드할 수 있습니다.

GroupDocs를 사용한 Java에서 텍스트 숨기기

ImageAreaRedaction API를 사용해 숨기고자 하는 영역 위에 단색 사각형을 오버레이합니다. 사각형의 좌상단(startPoint)과 너비/높이(size)를 정의하고 RegionReplacementOptions 색상을 지정합니다. redactor.apply(redaction)을 호출하면 라이브러리가 래스터화된 페이지에 사각형을 그려 원본 텍스트가 포함되지 않은 PDF로 저장합니다.

이 접근 방식은 래스터화 단계에서 텍스트 레이어를 제거하기 때문에 언어에 독립적인 모든 문서에 적용 가능하며, 숨긴 콘텐츠가 복구될 수 없음을 보장합니다.

실용적인 적용 사례 (how to redact word)

성능 고려 사항

• Memory Management: 스트림(ByteArrayOutputStream / ByteArrayInputStream)을 사용해 전체 파일을 메모리에 로드하지 않도록 합니다.
• CPU Usage: 래스터화는 CPU 집약적이므로 대용량 DOCX 파일에 대해 JVM 힙(-Xmx2g)을 늘리는 것을 고려하십시오.
• Version Updates: 성능 개선 및 버그 수정을 위해 GroupDocs 라이브러리를 최신 버전(예: 24.9)으로 유지합니다.
• File Size Limits: 스트리밍을 사용할 경우 메모리 부족 오류 없이 최대 500 MB 문서를 처리할 수 있습니다.

일반적인 문제 및 해결책 (hide text java)

자주 묻는 질문

Q: “convert docx to image”가 실제로 생성하는 것은 무엇인가요?
A: 각 페이지가 삽입된 비트맵인 PDF를 생성하여 텍스트를 선택할 수 없게 하고 레드액션에 안전하게 만듭니다.

Q: GroupDocs Redaction을 다른 파일 형식에도 사용할 수 있나요?
A: 예, PDF, 이미지 및 기타 50가지 이상의 입력·출력 형식을 지원합니다.

Q: 체험 라이선스는 어떻게 작동하나요?
A: 체험 라이선스는 30일 동안 모든 기능을 잠금 해제하여 제한 없이 래스터화와 레드액션을 평가할 수 있게 합니다.

Q: 여러 영역을 한 번에 레드액션할 방법이 있나요?
A: 물론입니다—redactor.apply()를 여러 번 호출하거나 ImageAreaRedaction 객체 컬렉션을 전달하면 됩니다.

Q: DOCX를 먼저 PDF로 변환해야 하나요?
A: 아닙니다. Redactor는 DOCX를 직접 래스터화하고 한 단계에서 PDF를 출력할 수 있습니다.

마지막 업데이트: 2026-07-25
테스트 환경: GroupDocs.Redaction 24.9 (Java)
작성자: GroupDocs

관련 튜토리얼

• How to use groupdocs redaction for Java: Pre‑Rasterization in Word Documents
• How to Redact Images in Word Documents Using GroupDocs.Redaction for Java – A Comprehensive Guide
• How to Redact Documents with GroupDocs Redaction Java License from File Path – A Step‑by‑Step Guide