GroupDocs.Redaction for Java로 텍스트 가리기

이 튜토리얼에서는 GroupDocs.Redaction을 사용하여 Java 기반 문서에서 텍스트를 가리는 방법을 배웁니다. 개인 정보를 마스킹하고, 민감한 문자열을 안전한 플레이스홀더로 교체하며, 배치 친화적인 방식으로 여러 파일을 처리하는 방법을 확인할 수 있습니다. 최종적으로 프라이버시를 보호하고 GDPR/HIPAA 요구사항을 충족하며 기존 Java 애플리케이션에 원활히 통합되는 프로덕션 준비 솔루션을 갖게 됩니다.

빠른 답변

  • 어떤 라이브러리를 사용하나요? GroupDocs.Redaction for Java.
  • 개인 정보를 마스킹할 수 있나요? Yes – use exact‑phrase redaction with replacement options.
  • 배치 처리를 지원하나요? Absolutely, you can loop through multiple files with the same Redactor instance.
  • 라이선스가 필요합니까? A free trial works for evaluation; a commercial license is required for production.
  • 필요한 Java 버전은 무엇인가요? JDK 8 or higher.

‘텍스트 가리기’란 무엇인가요?

가리기는 문서에서 기밀 데이터를 영구적으로 제거하거나 가리는 작업입니다. GroupDocs.Redaction을 사용하면 특정 문자열을 찾아 안전한 플레이스홀더로 교체하고, 정제된 파일을 저장할 수 있습니다—모두 수동 편집 없이 가능합니다.

왜 Java용 GroupDocs.Redaction을 사용하나요?

GroupDocs.Redaction for Java는 50개 이상의 입력 및 출력 형식(PDF, DOCX, XLSX, PPTX, TXT, RTF 포함)을 지원하며 전체 문서를 메모리에 로드하지 않고 수백 페이지 파일을 처리할 수 있어 표준 서버 하드웨어에서 고처리량 배치 작업을 수행합니다.

필수 조건

  • Java Development Kit (JDK): 버전 8 이상.
  • IDE: IntelliJ IDEA, Eclipse 또는 Java 호환 편집기.
  • Maven: 의존성 관리를 위해.
  • Basic Java knowledge: 클래스, 메서드 및 예외 처리에 대한 이해.

GroupDocs.Redaction for Java 설정

시작하려면 Maven 프로젝트에 라이브러리를 추가하십시오.

Maven 설정

Add the repository and dependency to your pom.xml file:

<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 Java 문서에서 다운로드하십시오.

라이선스 획득

Free Trial로 시작하고, 확장 테스트를 위해 Temporary License를 요청하거나, 프로덕션 사용을 위해 Commercial License를 구매할 수 있습니다.

GroupDocs.Redaction을 사용하여 문서에서 텍스트 가리기

다음 섹션에서는 개인 정보를 마스킹하고 민감한 텍스트를 교체하는 데 필요한 정확한 단계들을 안내합니다.

1단계: Redactor 초기화

Redactor는 문서를 로드하고, 가리기 규칙을 적용하며, 출력을 기록하는 핵심 클래스입니다.

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

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new LoadOptions());

2단계: 정확 구문 가리기 적용

ExactPhraseRedaction은 정확한 문자열 일치를 검색하고, ReplacementOptions는 일치된 텍스트가 어떻게 교체될지를 정의합니다.

redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]"));
  • 매개변수:
    • "John Doe" – 가리려는 정확한 텍스트.
    • ReplacementOptions("[personal]") – 원본 내용을 교체할 문자열로, 실제로 개인 정보를 마스킹합니다.

3단계: 가린 문서 저장

Redactor.save는 수정된 문서를 새 파일에 저장하거나 원본을 덮어쓰며, 원본 형식을 유지합니다.

redactor.save();

4단계: 리소스 정리

항상 Redactor.close()를 호출하여 네이티브 리소스를 해제하고 메모리 누수를 방지하십시오.

finally {
    redactor.close();
}

맞춤 콜백으로 개인 정보 마스킹하기

맞춤 콜백을 사용하면 각 가리기 이벤트에 대응할 수 있어 로깅, 조건부 교체 또는 감사 추적에 유용합니다.

콜백 클래스 생성

IRedactionCallback은 각 가리기 작업 전후에 호출되는 메서드를 정의합니다.

class RedactionDump implements IRedactionCallback {
    @Override
    public void onRedacted(IRedaction redaction) {
        // Custom processing or logging for each redaction event.
    }
}

Redactor 인스턴스화 시 콜백 사용

RedactorSettings를 통해 콜백 구현을 전달하면 엔진이 처리 중에 이를 호출하도록 할 수 있습니다.

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new LoadOptions(), new RedactorSettings(new RedactionDump()));

실제 적용 사례

  • 법률 계약: 초안 공유 전에 클라이언트 이름, 주민등록번호(SSN) 또는 기밀 조항을 자동으로 숨깁니다.
  • 의료 기록: 연구 파트너에게 기록을 내보낼 때 환자 식별자와 같은 개인 정보를 마스킹합니다.
  • 기업 커뮤니케이션: 외부 배포 전에 내부 프로젝트 코드와 같은 민감한 텍스트를 교체하여 우발적인 유출을 방지합니다.

성능 고려 사항

대용량 또는 다수의 파일을 처리할 때 다음 팁을 기억하십시오:

  • 배치 처리: 파일 컬렉션을 순회하여 시작 오버헤드를 줄입니다.
  • 메모리 관리: Redactor를 각 파일 처리 후 해제하고, 동시에 많은 문서를 메모리에 보관하지 않도록 합니다.
  • 프로파일링: Java 프로파일러(예: VisualVM)를 사용해 I/O 또는 가리기 로직의 병목 현상을 찾습니다.

자주 묻는 질문

Q: GroupDocs.Redaction을 사용하여 PDF에서 텍스트를 가릴 수 있나요?
A: 예, 이 라이브러리는 PDF, DOCX, XLSX, PPTX 및 기타 많은 형식을 지원합니다.

Q: 가리기를 되돌릴 수 있나요?
A: 아니요. 가리기는 원본 내용을 영구적으로 제거하므로 소스 파일의 백업을 유지하십시오.

Q: 매우 큰 문서를 효율적으로 처리하려면 어떻게 해야 하나요?
A: 문서를 청크 단위로 처리하고, 배치 모드를 사용하며, 프로파일링 도구로 메모리 사용량을 모니터링하십시오.

Q: 지원되는 다른 텍스트 형식은 무엇인가요?
A: DOCX와 PDF 외에도 TXT, RTF, XLSX, PPTX 등을 가릴 수 있습니다.

Q: 기존 워크플로에 GroupDocs.Redaction을 통합할 수 있나요?
A: 물론입니다. API는 웹 서비스, 백그라운드 작업 또는 CI/CD 파이프라인에서 호출할 수 있습니다.

리소스

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

관련 튜토리얼