2026-03-14\n테스트 환경: Java용 GroupDocs.Redaction 24.9\n작성자: GroupDocs"

Make sure to keep the horizontal rule “—”. Keep bold formatting.

Now produce final content. Ensure no extra spaces that break formatting. Keep code block placeholders unchanged.

Let’s assemble.# GroupDocs.Redaction을 사용한 Java 문서 가리기

이 튜토리얼에서는 Java 파일 가리기 방법을 효율적으로 GroupDocs.Redaction을 사용하여 알아봅니다. 법률 계약서, 의료 기록, 재무 보고서 등을 다루는 경우, 아래 단계에서는 가리기 정책을 로드하고, 배치로 여러 문서를 처리하며, 원본 형식을 유지한 채 결과를 저장하는 방법을 안내합니다.

빠른 답변

• 보안 문서 처리란 무엇을 의미하나요? 워크플로 전체에서 기밀 데이터를 보호하면서 문서를 처리하고, 가리며, 저장하는 것을 의미합니다.
• 한 번에 여러 파일을 처리할 수 있나요? 예, 샘플 코드는 디렉터리를 순회하며 각 파일에 정책을 적용합니다.
• 민감한 데이터를 어떻게 가릴 수 있나요? 숨길 패턴이나 텍스트를 지정하는 가리기 정책을 정의한 뒤, Redactor를 사용해 적용합니다.
• 프로덕션에 라이선스가 필요합니까? 프로덕션 사용에는 유효한 GroupDocs.Redaction 라이선스가 필요하며, 평가용 트라이얼을 제공합니다.
• 가리기된 문서를 래스터화 없이 저장할 수 있나요? 물론입니다—원본 형식을 유지하려면 RasterizationOptions.setEnabled(false)를 설정하면 됩니다.

GroupDocs.Redaction을 사용한 Java 가리기 방법

보안 문서 처리는 다양한 파일 유형에서 기밀 정보를 자동으로 식별하고 제거하면서 문서의 무결성과 사용성을 유지하는 것을 의미합니다. GroupDocs.Redaction은 Java에서 이를 프로그래밍 방식으로 구현할 수 있게 합니다.

Java에서 GroupDocs.Redaction을 사용하는 이유

• 포괄적인 형식 지원 – PDF, Word, 이미지 등 다양한 형식을 지원합니다.
• 세밀한 정책 제어 – 필요한 항목을 정확히 대상으로 하는 가리기 정책을 생성합니다.
• 확장 가능한 배치 처리 – 한 번의 작업으로 여러 파일을 처리하여 수작업을 줄입니다.
• 내장된 래스터화 옵션 – 추가 보안을 위해 페이지를 래스터화할지 선택할 수 있습니다.

사전 요구 사항

Java용 GroupDocs.Redaction을 구현하기 전에 다음 항목을 준비하십시오:

• 필수 라이브러리: GroupDocs.Redaction 라이브러리 버전 24.9가 필요합니다.
• 환경 설정: 머신에 Java Development Kit (JDK)가 설치되어 있어야 하며, IntelliJ IDEA 또는 Eclipse와 같은 IDE가 필요합니다.
• 지식 사전 조건: Java 프로그래밍에 대한 기본 이해와 파일 I/O 작업에 대한 친숙함이 필요합니다.

Java용 GroupDocs.Redaction 설정

GroupDocs.Redaction을 사용하려면 프로젝트에 라이브러리를 설정하십시오. 방법은 다음과 같습니다:

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

라이선스 획득

GroupDocs.Redaction의 기능을 완전히 활용하려면 라이선스를 획득하는 것을 고려하십시오. 무료 트라이얼을 시작하거나 임시 라이선스를 요청하여 기능을 폭넓게 살펴볼 수 있습니다.

기본 초기화 및 설정

라이브러리를 설치한 후, 필요한 클래스를 임포트하여 Java 애플리케이션에서 초기화합니다:

import com.groupdocs.redaction.*;

구현 가이드

이 섹션에서는 두 가지 핵심 기능인 가리기 정책 로드 및 적용, 그리고 특정 래스터화 옵션으로 처리된 문서를 저장하는 방법을 단계별로 안내합니다.

가리기 정책 로드 및 적용

개요: 이 기능은 파일에서 미리 정의된 가리기 정책을 로드하고 지정된 디렉터리의 모든 문서에 적용합니다. 처리된 파일은 작업 성공 여부에 따라 저장됩니다.

단계 1: RedactionPolicy 초기화

다음과 같이 가리기 정책을 로드합니다:

RedactionPolicy policy = RedactionPolicy.load("YOUR_POLICY_FILE_PATH");

이 단계는 정책이 문서의 민감한 데이터를 가리기 위한 규칙을 정의하기 때문에 중요합니다.

단계 2: 정책을 문서에 적용

디렉터리의 각 파일을 순회하며 정책을 적용합니다:

for (final File fileEntry : new File("YOUR_DOCUMENT_DIRECTORY").listFiles()) {
    final Redactor redactor = new Redactor(fileEntry.getPath());
    try {
        // Apply the loaded redaction policy
        RedactorChangeLog result = redactor.apply(policy);
        
        // Determine output directory based on processing status
        File resultFolder = new File(result.getStatus() != RedactionStatus.Failed ? "YOUR_OUTPUT_DIRECTORY_DONE" : "YOUR_OUTPUT_DIRECTORY_FAILED");
        
        // Save the processed file
        try (FileOutputStream fileStream = new FileOutputStream(resultFolder.getPath() + "/" + fileEntry.getName())) {
            RasterizationOptions options = new RasterizationOptions();
            options.setEnabled(false);
            redactor.save(fileStream, options);
        }
    } finally {
        redactor.close(); // Ensure resources are released
    }
}

매개변수 설명:

• RedactionPolicy.load() – 지정된 경로에서 정책을 로드합니다.
• redactor.apply(policy) – 로드된 정책에 따라 가리기를 실행합니다.

래스터화 옵션으로 처리된 문서 저장

개요: 가리기를 적용한 후, 출력 형식과 품질을 제어하는 특정 래스터화 옵션을 사용하여 문서를 저장합니다.

단계 1: 입력 파일용 Redactor 초기화

처리를 위해 파일을 엽니다:

File inputFile = new File("YOUR_DOCUMENT_DIRECTORY/input.docx");

단계 2: 래스터화 옵션으로 저장

래스터화 설정을 지정하여 처리된 문서를 저장합니다:

try (Redactor redactor = new Redactor(inputFile.getPath())) {
    try (FileOutputStream fileStream = new FileOutputStream(outputFileDirectory.getPath() + "/processed_output.docx")) {
        RasterizationOptions options = new RasterizationOptions();
        options.setEnabled(false);  // Example option to disable rasterization
        redactor.save(fileStream, options);
    }
}

핵심 구성 옵션:

• RasterizationOptions – 가리기 후 문서 저장 방식을 제어하며, 원본 형식을 유지하거나 보안을 위해 이미지로 변환할 수 있습니다.

실용적인 적용 사례

1. 법률 문서 처리 – 초안을 공유하기 전에 민감한 고객 정보를 가립니다.
2. 헬스케어 데이터 관리 – 의료 기록을 가려 환자 기밀성을 보장합니다.
3. 재무 보고 – 이해관계자와 공유되는 보고서의 재무 데이터를 보호합니다.
4. 계약 검토 – 계약 협상 중에 독점적인 조항을 보호합니다.
5. 이메일 보관 – 비즈니스 이메일을 보관할 때 개인정보 보호 규정을 준수합니다.

성능 고려 사항

GroupDocs.Redaction을 사용할 때 성능을 최적화하려면:

• 효율적인 리소스 관리 – 파일을 적절히 닫아 시스템 리소스를 해제합니다.
• 배치 처리 – 메모리 사용을 효율적으로 관리하기 위해 문서를 배치로 처리합니다.
• 가리기 정책 최적화 – 필요한 가리기만 대상으로 정책을 맞춤 설정하여 처리 시간을 단축합니다.

일반적인 함정 및 문제 해결

• 라이선스 누락 예외 – 라이선스 오류가 발생하면 라이선스 파일이 올바르게 배치되고 경로가 애플리케이션에 설정되어 있는지 확인합니다.
• 지원되지 않는 파일 형식 – 파일 형식이 지원 목록에 포함되어 있는지 확인하십시오. 그렇지 않으면 Redactor가 UnsupportedFormatException을 발생시킵니다.
• 대용량 파일 메모리 부족 – 매우 큰 PDF의 경우 JVM 힙 크기(-Xmx2g)를 늘리거나 파일을 작은 청크로 나누어 처리하는 것을 고려하십시오.

자주 묻는 질문

Q: 단일 명령으로 여러 파일을 처리하려면 어떻게 해야 하나요?
A: “문서에 정책 적용” 예제에 표시된 디렉터리 순회 루프를 사용하면 폴더의 모든 파일을 자동으로 처리합니다.

Q: “민감한 데이터 가리기”는 실제로 무엇을 제거하나요?
A: 가리기 정책은 텍스트 패턴, 이미지 또는 메타데이터를 대상으로 할 수 있으며, 이를 검은 상자로 대체하거나 완전히 제거합니다.

Q: 적용하기 전에 가리기 정책을 미리 볼 수 있는 방법이 있나요?
A: 예, 정책을 로드한 뒤 redactor.preview(policy)(지원되는 경우)를 호출하여 미리보기 PDF를 생성할 수 있습니다.

Q: 원본 형식을 잃지 않고 “가리기된 문서 저장”을 하려면 어떻게 해야 하나요?
A: 예시와 같이 RasterizationOptions.setEnabled(false)를 설정하면 원본 파일 형식이 유지됩니다.

Q: 개발 테스트에 라이선스가 필요합니까?
A: 개발에는 임시 또는 트라이얼 라이선스면 충분하지만, 프로덕션 배포에는 정식 라이선스가 필요합니다.

리소스

• 문서: GroupDocs.Redaction Java Docs
• API 레퍼런스: API Reference
• 다운로드: Latest Releases
• GitHub: Source Code on GitHub
• 무료 지원: GroupDocs Forum

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