Java에서 GroupDocs.Redaction을 사용한 텍스트 가리기: 완전 가이드

오늘날 빠르게 변화하는 디지털 세계에서 문서에서 텍스트를 가리는 방법은 많은 개발자들이 직면하는 질문입니다. 개인 데이터를 보호하거나 규정을 준수하거나 단순히 초안을 정리하는 경우, 이 가이드는 Java용 GroupDocs.Redaction을 사용하여 정규식 기반 가리기 적용 방법을 빠르고 안전하게 수행하는 방법을 안내합니다.

우리는 라이브러리 설정, 정규식 패턴 작성, 저장 옵션 구성부터 가리기의 중요성을 보여주는 실제 사용 사례까지 모든 내용을 다룰 것입니다.

빠른 답변

GroupDocs.Redaction의 주요 목적은 무엇인가요? 다양한 문서 형식에서 민감한 텍스트를 찾아 마스킹하는 신뢰할 수 있는 API를 제공합니다.
가리기에 정규식을 어떻게 적용하나요? 패턴을 사용해 RegexRedaction 객체를 생성하고 이를 Redactor.apply() 메서드에 전달합니다.
라이선스가 필요합니까? 무료 체험판은 개발에 사용할 수 있으며, 유료 라이선스는 프로덕션에서 전체 기능을 사용할 수 있게 해줍니다.
PDF뿐만 아니라 DOCX 파일도 가릴 수 있나요? 예—GroupDocs.Redaction은 PDF, DOCX, PPTX 등 다양한 형식을 지원합니다.
성능을 향상시키는 가장 좋은 방법은 무엇인가요? Redactor 인스턴스를 즉시 닫고 정규식 패턴을 가능한 한 간단하게 유지합니다.

텍스트 가리기란 무엇이며 왜 중요한가요?

텍스트 가리기는 문서에서 민감한 정보를 영구적으로 제거하거나 가리는 과정입니다. 이를 통해 사회보장번호, 의료 기록, 재무 정보와 같은 기밀 데이터가 무단으로 복구되거나 열람되는 것을 방지할 수 있습니다.

텍스트 가리기에 정규식을 사용하는 이유

정규식을 사용하면 전화번호, 신용카드 번호 등 다양한 데이터 형식에 대응하는 유연한 패턴을 정의할 수 있습니다. GroupDocs.Redaction과 정규식을 함께 사용하면 숨길 내용을 정확히 제어하면서 구현을 간결하게 유지할 수 있습니다.

사전 요구 사항

시작하기 전에 다음이 준비되어 있는지 확인하세요:

**Java Development Kit (JDK)**가 설치되어 있어야 합니다 (Java 8 이상).
Java 문법 및 정규식에 대한 기본적인 이해가 필요합니다.
코드를 실행하고 디버깅할 수 있는 IntelliJ IDEA 또는 Eclipse와 같은 IDE가 필요합니다.

Java용 GroupDocs.Redaction 설정

먼저 라이브러리를 프로젝트에 추가합니다.

Maven 설정

Maven을 사용하는 경우 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>

직접 다운로드

또는 최신 JAR 파일을 GroupDocs.Redaction for Java releases에서 다운로드합니다.

기본 초기화

라이브러리를 사용할 수 있게 되면 문서 가리기를 시작할 수 있습니다:

// Import the necessary classes from GroupDocs.Redaction
import com.groupdocs.redaction.Redactor;

public class RedactionExample {
    public static void main(String[] args) {
        // Initialize the redactor with your document path
        final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX");
        // Ensure you close resources after operations
        try { /* Your code here */ } finally { redactor.close(); }
    }
}

Java에서 정규식을 사용해 텍스트를 가리는 방법

아래 단계별 안내는 텍스트를 가리는 방법을 정규식 패턴으로 구현하는 과정을 보여줍니다.

기능 1: 정규식 텍스트 가리기

개요: 이 기능은 핵심 RegexRedaction 워크플로를 시연합니다.

Step 3.1: Import Required Classes

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.redactions.RegexRedaction;
import com.groupdocs.redaction.redactions.ReplacementOptions;

Step 3.2: Initialize Redactor and Apply Regex Pattern

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX");
try {
    // Define a regex pattern to find sequences of numbers and apply a replacement color.
    // The pattern: Two digits, optional whitespace, two more digits, non-digit characters,
    // followed by six digits.
    redactor.apply(new RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", 
        new ReplacementOptions(java.awt.Color.BLUE)));

Regex Explanation: 이 패턴은 특정 형식(예: 날짜 또는 ID 번호)을 따르는 숫자 시퀀스를 매칭합니다. ReplacementOptions는 파란색 오버레이를 사용해 가려진 영역을 표시합니다.

Step 3.3: Configure Save Options

    // Configure save options
    SaveOptions saveOptions = new SaveOptions();
    saveOptions.setAddSuffix(true);  // Adds suffix to indicate processing
    saveOptions.setRasterizeToPDF(false);  // Preserves original format

    // Save the redacted document
    redactor.save(saveOptions);
} finally {
    redactor.close();  // Always close resources to prevent memory leaks
}

Save Options: 접미사를 추가하면 어떤 파일이 처리되었는지 명확해지고, 원본 형식을 유지함으로써 원치 않는 변환을 방지합니다.

문제 해결 팁

정규식이 숨기려는 데이터를 정확히 포착하는지 확인하세요.
파일 경로를 다시 확인하고 애플리케이션에 읽기/쓰기 권한이 있는지 점검하세요.

기능 2: 저장 옵션 구성

개요: 가리기 후 출력 파일을 세밀하게 조정합니다.

Step 3.4: Customize Save Settings

import com.groupdocs.redaction.options.SaveOptions;

SaveOptions saveOptions = new SaveOptions();
saveOptions.setAddSuffix(true);  // Indicates processing by adding a suffix
saveOptions.setRasterizeToPDF(false);  // Keeps original format intact

Key Configuration: 이 스니펫은 출력 파일 이름을 관리하고 원본 문서 구조를 유지하는 데 도움이 됩니다.

실용적인 적용 사례

텍스트를 가리는 방법이 필수적인 실제 시나리오:

법률 문서 – 외부 변호사와 초안을 공유하기 전에 클라이언트 식별자를 숨깁니다.
의료 기록 – 환자 이름, ID, 건강 번호 등을 마스킹해 HIPAA 규정을 준수합니다.
재무 보고서 – 분기 요약을 배포할 때 기밀 계좌 번호를 제거합니다.

성능 고려 사항

메모리 관리: Redactor 인스턴스를 항상 (redactor.close()) 닫아 리소스를 해제합니다.
효율적인 정규식: 간단한 패턴이 더 빠르게 실행되므로 가능한 복잡한 표현은 피하세요.
배치 처리: 대량 문서를 처리할 때는 파일을 배치로 나누어 메모리 사용량을 예측 가능하게 유지합니다.

일반적인 문제와 해결책

Issue	Solution
Regex matches too much	온라인 정규식 테스트 도구로 패턴을 검증하고 문자 클래스를 좁혀 보세요.
Output file name conflict	`setAddSuffix(true)`를 사용하거나 `saveOptions.setOutputPath()`로 사용자 지정 출력 경로를 지정하세요.
Memory leak on large PDFs	PDF를 페이지별로 처리하거나 JVM 힙 크기(`-Xmx2g`)를 늘리세요.

자주 묻는 질문

Q: SaveOptions에서 setAddSuffix(true)의 목적은 무엇인가요?
A: 출력 파일 이름에 자동으로 접미사(예: _redacted)를 추가해 어떤 파일이 처리되었는지 명확히 표시합니다.

Q: 텍스트 가리기에 숫자 외의 정규식 패턴을 사용할 수 있나요?
A: 물론입니다. 이메일, 전화번호, 사용자 정의 ID 등 유효한 Java 정규식을 RegexRedaction에 전달하면 원하는 텍스트를 가릴 수 있습니다.

Q: 가리기 중 오류가 발생하면 어떻게 처리해야 하나요?
A: 가리기 로직을 try‑catch 블록으로 감싸고 예외를 로그에 기록한 뒤, finally 절에서 항상 Redactor를 닫아 리소스를 해제합니다.

Q: PDF 가리기가 지원되나요?
A: 네. GroupDocs.Redaction은 PDF, DOCX, PPTX 등 다양한 형식을 지원합니다.

Q: 대규모 가리기 프로젝트의 모범 사례는 무엇인가요?
A: 배치 처리를 사용하고, 정규식 패턴을 단순하게 유지하며, 프로파일링 도구로 메모리 사용량을 모니터링합니다.

참고 자료

깊이 있는 내용과 공식 가이드를 확인하세요:

Documentation: GroupDocs Redaction Documentation
API Reference: GroupDocs API Reference

Last Updated: 2026-03-01
Tested With: GroupDocs.Redaction 24.9 for Java
Author: GroupDocs