GroupDocs.Redaction을 사용한 Java 커스텀 포맷 핸들러 구현

오늘날 데이터 기반 환경에서 민감한 정보를 보호하는 것은 협상할 수 없는 요구사항입니다. Implement custom format handler는 파일 유형에 관계없이—법률 계약서, 재무 보고서, 단순 텍스트 덤프 등—작업할 수 있는 유연성을 제공하며, 동시에 GroupDocs.Redaction의 고성능 레드랙션 엔진을 활용합니다. 이 튜토리얼은 평문 파일에 대한 커스텀 포맷 핸들러를 등록하고, 레드랙션을 적용하며, 마지막으로 save redacted document 파일을 안전하게 저장하는 과정을 안내합니다.

빠른 답변

배울 내용

커스텀 포맷 핸들러란?

커스텀 포맷 핸들러는 GroupDocs.Redaction에 비표준 파일 유형을 해석하는 방법을 알려주는 플러그인입니다. 파일 확장자를 문서 클래스에 매핑하여 레드랙션 엔진이 내장 포맷과 마찬가지로 콘텐츠를 읽고, 수정하고, 쓸 수 있게 합니다.

커스텀 포맷에 GroupDocs.Redaction을 사용하는 이유

GroupDocs.Redaction은 45+ input and output formats를 지원하며 전체 문서를 메모리에 로드하지 않고 2 GB까지 파일을 처리할 수 있습니다. 스트리밍 아키텍처는 단순 파일 로딩 방식에 비해 CPU 사용량을 최대 **30 %**까지 감소시켜 대량 배치 작업에 이상적입니다.

사전 요구 사항

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

필수 라이브러리 및 버전

환경 설정 요구 사항

지식 사전 요구 사항

Java용 GroupDocs.Redaction 설정

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>

직접 다운로드

또는 최신 버전을 직접 GroupDocs.Redaction for Java releases에서 다운로드하십시오.

라이선스 획득 단계

  1. Free trial – 비용 없이 전체 기능을 탐색합니다.
  2. Temporary license – 확장 테스트를 위한 기간 제한 키를 얻습니다.
  3. Purchase – 프로덕션 배포를 위한 영구 라이선스를 획득합니다.

기본 초기화 및 설정

라이브러리가 클래스패스에 추가되면 다음과 같이 GroupDocs.Redaction을 초기화합니다:

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

public class InitializeRedaction {
    public static void main(String[] args) throws Exception {
        Redactor redactor = new Redactor("path/to/your/document");
        // Perform operations with the redactor instance.
        redactor.close();
    }
}

GroupDocs.Redaction 설정이 완료되면 이제 how to implement custom format handler에 대해 살펴보고 레드랙션을 적용할 수 있습니다.

Java에서 커스텀 포맷 핸들러 구현 방법

기능 1: 커스텀 포맷 핸들러 등록

개요

custom format handler를 등록하면 고유 확장자를 가진 평문 파일과 같은 특정 문서 유형을 처리하도록 GroupDocs.Redaction의 기능이 확장됩니다.

단계별 구현

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

필요한 구성 클래스를 가져오는 것으로 시작합니다:

import com.groupdocs.redaction.configuration.DocumentFormatConfiguration;
import com.groupdocs.redaction.integration.DocumentFormatInstance;
import com.groupdocs.redaction.examples.java.helper_classes.CustomTextualDocument;
단계 2: 문서 포맷 구성

setExtensionFilter는 커스텀 핸들러가 처리할 파일 확장자를 지정합니다.
setDocumentType은 해당 확장자를 읽고 쓸 수 있는 구체적인 문서 클래스와 연결합니다.
커스텀 포맷을 처리할 파일 확장자와 클래스를 지정하도록 문서 포맷 구성을 설정합니다:

class CustomFormatHandlerRegistration {
    public static void main(String[] args) {
        DocumentFormatConfiguration config = new DocumentFormatConfiguration();
        // Set the file extension for this handler.
        config.setExtensionFilter(".dump");
        // Specify handling by CustomTextualDocument class.
        config.setDocumentType(CustomTextualDocument.class);
        // Add to available formats list.
        DocumentFormatInstance.getDefaultConfiguration().getAvailableFormats().add(config);
    }
}

기능 2: 레드랙션 적용

개요

이 기능은 redact text java 문서를 레드랙션하는 방법을 보여주며, 모든 replace sensitive text 작업이 안전하고 감사 가능하도록 수행됩니다.

단계별 구현

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

레드랙션 수행에 필요한 클래스를 가져옵니다:

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.redactions.ExactPhraseRedaction;
import com.groupdocs.redaction.redactions.ReplacementOptions;
단계 2: Redactor 초기화 및 레드랙션 적용

Redactor는 문서를 로드하고 레드랙션 작업을 적용하는 핵심 클래스입니다.
소스 파일 경로를 사용해 Redactor 인스턴스를 생성하고, 원하는 레드랙션 객체를 추가한 뒤, save redacted document를 새로운 이름으로 저장합니다:

class RedactionApplication {
    public static void main(String[] args) throws Exception {
        final Redactor redactor = new Redactor(YOUR_DOCUMENT_DIRECTORY + "/sample.dump");
        try {
            // Apply an exact phrase redaction.
            redactor.apply(new ExactPhraseRedaction("dolor", false, new ReplacementOptions("[redacted]")));
            // Save the document with a new name.
            redactor.save(new SaveOptions(false, "AnyText"));
        } finally {
            redactor.close();
        }
    }
}

문제 해결 팁

실용적인 적용 사례

다음은 이러한 기술을 적용할 수 있는 실제 시나리오입니다:

  1. Legal document protection – 외부 변호사와 초안을 공유하기 전에 사건 세부 정보를 레드랙션합니다.
  2. Financial records security – 은행 명세서에서 계좌 번호와 개인 식별자를 가립니다.
  3. HR data management – 감사 또는 제3자 검토 시 직원 개인 데이터를 마스킹합니다.
  4. CRM integration – CRM 시스템에서 보고서를 내보내기 전에 고객 PII를 자동으로 레드랙션합니다.
  5. Automated compliance reporting – 규제 문서에 우발적인 데이터 유출이 없도록 보장합니다.

성능 고려 사항

GroupDocs.Redaction을 사용할 때 최적 성능을 위한 다음 팁을 고려하십시오:

일반적인 문제 및 해결책

문제원인해결책
핸들러가 인식되지 않음확장자 필터 불일치setExtensionFilter가 파일 확장자와 정확히 일치하는지 확인하십시오(예: .dump).
레드랙션이 적용되지 않음구문 대소문자 구분ExactPhraseRedaction에서 ignoreCase 플래그를 true로 설정하십시오.
메모리 부족 오류대용량 파일을 동시에 로드파일을 순차적으로 처리하거나 사용 가능한 경우 스트리밍 API를 사용하십시오.

자주 묻는 질문

Q1: What file types can I handle with custom format handlers?
A1: 확장자와 해당 문서 클래스를 지정하면 모든 파일 유형에 대한 핸들러를 구성할 수 있으며, 기본적으로 지원되지 않는 포맷에도 레드랙션을 적용할 수 있습니다.

Q2: How do I obtain a temporary license for GroupDocs.Redaction?
A: GroupDocs’ official site에서 확장 테스트를 위한 임시 라이선스 키를 요청하십시오.

Q3: Can I process large batches of documents efficiently?
A: 예—Performance Considerations 섹션의 배치 처리 팁을 사용하고 각 Redactor 인스턴스를 즉시 닫아 메모리 사용량을 낮게 유지하십시오.

Q4: Is it possible to redact PDF files with the same handler?
A: GroupDocs.Redaction은 이미 PDF에 대한 기본 지원을 제공하므로 커스텀 핸들러는 일반적으로 .dump와 같은 비표준 포맷이나 독점 로그 파일에 사용됩니다.

Q5: Does the API support asynchronous operations?
A: 핵심 API는 동기식이지만 Java CompletableFuture로 호출을 래핑하거나 병렬 스트림을 사용해 동시성을 구현할 수 있습니다.

결론

이제 implement custom format handler와 redact text java 문서를 Java용 GroupDocs.Redaction으로 레드랙션하는 방법을 확실히 이해했을 것입니다. 이러한 기능을 통해 평문 로그부터 복잡한 법률 계약서까지 다양한 문서 유형의 민감한 정보를 보호할 수 있습니다. 전문성을 높이려면 패턴 기반 레드랙션을 탐색하고, 워크플로를 CI/CD 파이프라인에 통합하며, Java 프로파일링 도구로 성능을 모니터링하십시오.

다음 단계

마지막 업데이트: 2026-09-06
테스트 대상: GroupDocs.Redaction 24.9
작성자: GroupDocs

관련 튜토리얼