** etc.

Let’s go.

GroupDocs.Redaction Java로 텍스트 가리기 방법

오늘날 데이터 중심의 환경에서 문서의 텍스트를 안전하고 효율적으로 가리는 방법은 개발자와 컴플라이언스 담당자 모두에게 중요한 과제입니다. 개인 식별자, 기밀 클라이언트 정보, 내부 프로젝트 코드 등을 숨겨야 할 때, GroupDocs.Redaction for Java는 정확한 구문을 찾아 안전한 오버레이로 교체할 수 있는 신뢰할 수 있는 방법을 제공합니다. 이 튜토리얼에서는 래스터화된 PDF로 저장하는 방법도 보여주며, 각 페이지를 이미지 기반 PDF로 변환해 보관 기준을 충족시킵니다.

빠른 답변

가리기용 기본 클래스는? Redactor
구문을 색상 오버레이로 교체할 수 있나요? 예, ExactPhraseRedaction와 ReplacementOptions를 사용합니다.
래스터화된 PDF를 생성하려면? SaveOptions.getRasterization().setEnabled(true)로 래스터화를 활성화합니다.
예제에서 사용된 PDF 컴플라이언스 레벨은? PdfComplianceLevel.PdfA1a.
프로덕션 사용에 라이선스가 필요합니까? 프로덕션 배포에는 유효한 GroupDocs.Redaction 라이선스가 필요합니다.

Java에서 “텍스트를 가리는 방법”이란?

가리기는 파일에서 민감한 내용을 영구적으로 제거하거나 가리는 과정입니다. GroupDocs.Redaction을 사용하면 이름이나 ID와 같은 정확한 구문을 프로그래밍 방식으로 검색하고, 빨간 오버레이, 검은 상자 또는 사용자 정의 시각 요소로 교체하여 원본 데이터가 복구되지 않도록 할 수 있습니다.

Java용 GroupDocs.Redaction을 사용해야 하는 이유

정확한 구문 매칭으로 오탐을 방지합니다.
내장 래스터화 기능으로 장기 보관을 위한 PDF/A‑준수 이미지 전용 PDF를 만들 수 있습니다.
다양한 포맷 지원으로 DOCX, PDF, PPTX 등 여러 문서 유형에 동일한 코드를 적용할 수 있습니다.
성능 중심 API로 메모리 사용량을 최소화하면서 대용량 문서 세트를 배치 처리할 수 있습니다.

사전 요구 사항

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

GroupDocs.Redaction for Java (v24.9 이상).
Java Development Kit (JDK) 8+.
IntelliJ IDEA, Eclipse, NetBeans 등 IDE.
의존성 관리를 위한 Maven.

필요 라이브러리 및 의존성

GroupDocs.Redaction for Java – pom.xml에 저장소와 의존성을 추가합니다(아래 코드 블록 참고).
선택 사항: 원하는 로깅 라이브러리.

지식 사전 조건

기본 Java 문법 및 파일 I/O.
Maven pom.xml 구조에 대한 이해.

GroupDocs.Redaction for Java 설정

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>

직접 다운로드

또는 GroupDocs.Redaction for Java releases에서 최신 버전을 직접 다운로드할 수 있습니다.

라이선스 획득

무료 체험 – 라이선스 키 없이 API를 사용해 볼 수 있습니다.
임시 라이선스 – 평가 기간을 연장할 때 사용합니다.
정식 라이선스 – 프로덕션 환경에 필수입니다.

기본 초기화 및 설정

다음은 샘플 DOCX 파일을 가리키는 Redactor 인스턴스를 생성하는 최소 코드입니다:

import com.groupdocs.redaction.Redactor;

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");

텍스트 가리기 – 정확한 구문 예제

1단계: 필요한 클래스 가져오기

다음 임포트문을 통해 가리기 엔진과 교체 옵션에 접근할 수 있습니다:

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.ReplacementOptions;
import com.groupdocs.redaction.redactions.ExactPhraseRedaction;

2단계: 가리기 생성 및 적용

아래 스니펫은 “John Doe” 구문을 찾아 빨간 오버레이로 교체합니다:

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");
try {
    RedactorChangeLog result = redactor.apply(new ExactPhraseRedaction(
        "John Doe", new ReplacementOptions(java.awt.Color.RED)));
    
    if (result.getStatus() != RedactionStatus.Failed) {
        // Successfully redacted the text
    }
} finally { 
    redactor.close(); 
}

이것이 중요한 이유: ReplacementOptions를 사용하면 가리기의 시각 스타일을 제어할 수 있어 숨긴 내용이 복사‑붙여넣기나 OCR로 복구되지 않도록 보장합니다.

래스터화된 PDF로 저장하기

1단계: SaveOptions 클래스 가져오기

다음 클래스들을 사용해 PDF 출력 옵션(래스터화 및 컴플라이언스 레벨)을 구성합니다:

import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.options.PdfComplianceLevel;

2단계: 저장 옵션 구성 및 적용

가리기를 수행한 뒤 문서를 래스터화된 PDF로 내보낼 수 있습니다. 아래 예제는 5페이지만 래스터화하고 PDF/A‑1a 준수를 강제합니다:

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");
try {
    SaveOptions options = new SaveOptions();

    // Enable rasterization for converting pages into images.
    options.getRasterization().setEnabled(true);
    
    // Set the starting page and count for rasterization.
    options.getRasterization().setPageIndex(5);
    options.getRasterization().setPageCount(1);

    // Define PDF compliance level.
    options.getRasterization().setCompliance(PdfComplianceLevel.PdfA1a);

    // Append a suffix to avoid filename conflicts.
    options.setAddSuffix(true);

    // Save the document with these configurations.
    redactor.save(options);
} finally { 
    redactor.close(); 
}

핵심 포인트: PDF를 래스터화하면 각 페이지가 이미지로 변환되어 숨겨진 텍스트 레이어가 사라지고 문서가 변조 방지됩니다—법적 보관에 이상적입니다.

실무 적용 사례

민감 데이터 가리기 – 계약서를 공유하기 전에 개인 식별자를 자동으로 숨깁니다.
문서 보관 – 최종 보고서를 래스터화된 PDF/A로 변환해 장기 컴플라이언스를 충족합니다.
대량 콘텐츠 업데이트 – 수백 개 파일의 오래된 용어를 단일 스크립트로 교체합니다.

성능 고려 사항

각 작업 후 Redactor를 닫아 파일 핸들 및 메모리를 해제합니다.
배치 처리 – 파일 목록을 로드하고 반복하면서 가능한 경우 단일 Redactor 인스턴스를 재사용합니다.
리소스 모니터링 – 대규모 가리기 작업 중 CPU와 힙 사용량을 확인하려면 Java 프로파일링 도구를 활용합니다.

자주 묻는 질문

Q: Maven 프로젝트에 GroupDocs.Redaction을 어떻게 설치하나요?
A: Maven 설정 섹션에 표시된 대로 GroupDocs 저장소와 groupdocs-redaction 의존성을 pom.xml에 추가합니다.

Q: 이 라이브러리를 사용해 PDF 파일의 텍스트를 가릴 수 있나요?
A: 예, GroupDocs.Redaction은 PDF, DOCX, PPTX 등 다양한 포맷을 지원합니다.

Q: 정확한 구문을 찾지 못하면 어떻게 되나요?
A: RedactorChangeLog가 Failed 상태를 반환합니다. 구문의 철자와 대소문자를 확인하세요.

Q: 매우 큰 문서를 효율적으로 처리하려면 어떻게 해야 하나요?
A: 페이지 범위를 작게 나누어 처리하고, 필요할 때만 래스터화를 활성화하며, 항상 Redactor를 닫아 리소스를 해제합니다.

Q: 특정 페이지 범위만 래스터화된 PDF로 저장할 수 있나요?
A: 물론입니다. options.getRasterization().setPageIndex()와 setPageCount()를 사용해 원하는 페이지만 래스터화하도록 지정합니다.

결론

이제 GroupDocs.Redaction Java로 텍스트를 가리는 방법과 래스터화된 PDF로 저장하는 방법에 대한 완전한 가이드를 확인했습니다. 이 절차를 따르면 민감 정보를 보호하고, 컴플라이언스 요구 사항을 충족하며, 프로덕션 환경에서도 높은 성능을 유지할 수 있습니다.

다음 단계

공식 문서를 탐색해 API를 더 깊이 파악하세요.
RegexRedaction, ImageRedaction 등 다른 가리기 유형을 실험해 보세요.
GroupDocs Support Forum에서 커뮤니티와 소통하며 팁과 모범 사례를 공유하세요.

마지막 업데이트: 2026-02-26
테스트 환경: GroupDocs.Redaction Java 24.9
작성자: GroupDocs