content.

Java에서 GroupDocs.Redaction을 사용하여 문서 레드랙션 시 파일명에 접미사 추가하는 방법

기밀 데이터를 레드랙션하는 것만으로는 충분하지 않습니다—저장된 파일이 처리되었음을 명확히 표시해야 합니다. groupdocs maven dependency를 사용하면 이 작업이 간단해집니다, 몇 줄의 코드만으로 출력 파일명에 접미사를 추가할 수 있습니다. 이 가이드에서는 레드랙션된 문서를 저장할 때 파일명에 접미사를 추가하는 방법과 함께 GroupDocs.Redaction for Java를 사용한 로드, 주석 달기 및 저장 방법을 배웁니다. 법률 계약서, 의료 기록, 재무 보고서 등을 보호하든, 이 단계들은 워크플로우를 안전하고 감사 가능하게 유지합니다.

빠른 답변

“add suffix to filename”이 무엇을 하나요?
출력 파일명에 사용자 정의 접미사(예: “_redacted”)를 추가하여 처리된 파일을 즉시 식별할 수 있게 합니다.
스트림에서 문서를 로드할 수 있나요?
예—GroupDocs.Redaction은 모든 InputStream에서 로드를 지원하므로 클라우드 스토리지나 메모리 내 처리에 적합합니다.
이 기능에 라이선스가 필요합니까?
무료 체험판으로 기본 레드랙션을 사용할 수 있으며, 임시 또는 정식 라이선스를 통해 접미사 처리 등 모든 고급 옵션을 사용할 수 있습니다.
지원되는 형식은 무엇인가요?
라이브러리는 DOCX, PDF, PPTX, XLSX 등 다양한 형식을 처리합니다.
PDF 출력에 래스터화가 필요합니까?
래스터화는 선택 사항이며, 문서를 평탄화하여 보안을 강화해야 할 경우에만 활성화합니다.

파일명에 접미사를 추가한다는 것은 무엇인가요?

접미사를 추가하는 것은 파일이 레드랙션되었음을 나타내는 간단한 명명 규칙입니다. 원본(레드랙션되지 않은) 파일이 실수로 공유되는 것을 방지하고 자동 파이프라인이 처리 상태를 추적하는 데 도움이 됩니다.

이 작업에 GroupDocs.Redaction을 사용하는 이유는?

GroupDocs.Redaction은 유창한 Java API를 제공하여 레드랙션 작업과 파일 처리 옵션—예: 파일명에 접미사 추가—을 몇 줄의 코드만으로 결합할 수 있게 합니다. 이를 통해 개발 시간을 절약하고 수동 오류 위험을 줄일 수 있습니다.

전제 조건

Java Development Kit (JDK): 버전 8 이상.
GroupDocs.Redaction Library: 레드랙션 작업을 위한 핵심 라이브러리.
IDE: IntelliJ IDEA, Eclipse 또는 Java 호환 편집기.
Maven: 의존성 관리를 위해.

지식 전제 조건

Java I/O와 기본 객체 지향 개념에 익숙하면 예제를 더 쉽게 따라할 수 있습니다.

Java용 GroupDocs.Redaction 설정

Maven 설정

Maven을 통해 GroupDocs 라이브러리에 접근하려면 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에서 다운로드하세요.

라이선스 획득

Free Trial: 제한 없이 기본 기능에 접근합니다.
Temporary License: 고급 기능을 탐색하기 위해 임시 라이선스를 획득합니다.
Purchase: 장기 사용을 위해 정식 라이선스 구매를 고려하세요.

기본 초기화 및 설정

필요한 import를 추가하여 프로젝트를 초기화합니다:

import com.groupdocs.redaction.Redactor;

이 설정으로 문서 레드랙션 기능을 구현할 준비가 되었습니다.

구현 가이드

기능 1: 스트림에서 문서 로드

개요: 처리를 위해 InputStream에 문서를 로드하는 방법을 배웁니다.

단계별 구현

단계 1.1: InputStream 생성

import java.io.FileInputStream;
import java.io.InputStream;

try (InputStream stream = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    final Redactor redactor = new Redactor(stream);
    try {
        // Document is now loaded and ready for further processing
    } finally {
        redactor.close();
    }
}

왜: InputStream을 사용하면 다양한 형식으로 저장된 문서를 원활히 처리할 수 있어, 클라우드 또는 마이크로서비스 시나리오에서 스트림에서 문서를 로드해야 할 때 필수적입니다.

기능 2: 주석 삭제 레드랙션 적용

개요: DeleteAnnotationRedaction을 사용하여 문서에서 주석을 제거합니다.

단계별 구현

단계 2.1: DeleteAnnotationRedaction 적용

import com.groupdocs.redaction.redactions.DeleteAnnotationRedaction;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply the DeleteAnnotationRedaction to remove annotations from the document
    redactor.apply(new DeleteAnnotationRedaction());
}

왜: 이 단계는 민감한 주석을 제거하여 문서 프라이버시를 강화합니다.

기능 3: 옵션을 사용해 문서 저장

개요: 래스터화 및 파일명에 접미사 추가와 같은 특정 옵션을 사용해 처리된 문서를 저장하는 방법을 배웁니다.

단계별 구현

단계 3.1: SaveOptions 구성

import java.io.ByteArrayOutputStream;
import com.groupdocs.redaction.options.SaveOptions;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply necessary redactions before saving
    redactor.apply(new DeleteAnnotationRedaction());
    try (ByteArrayOutputStream bA = new ByteArrayOutputStream()) {
        SaveOptions options = new SaveOptions();
        options.setRasterizeToPDF(true);  // Option to rasterize document to PDF format
        options.setAddSuffix(true);      // Option to add a suffix to the saved file name
        redactor.save(bA, options.getRasterization());
    }
}

왜: 저장 옵션을 맞춤 설정하면 유연한 출력 형식과 명명 규칙을 사용할 수 있습니다. setAddSuffix(true)를 활성화하면 파일명에 접미사가 추가되어 파일이 레드랙션되었음을 명확히 표시합니다.

groupdocs maven dependency 개요

groupdocs maven dependency는 단일 <dependency> 항목으로 전체 Redaction SDK를 프로젝트에 가져옵니다. 전이 의존성을 처리하고 라이브러리를 최신 상태로 유지하며 빌드 자동화를 단순화합니다. pom.xml에 의존성을 선언하면 수동 JAR 관리가 필요 없으며 최신 보안 패치와의 호환성을 보장합니다.

접미사 추가가 중요한 이유

감사 가능성: 팀이 배포해도 안전한 파일을 즉시 식별할 수 있습니다.
자동화: 스크립트가 접미사별로 파일을 필터링하여 원본 문서가 실수로 처리되는 것을 방지합니다.
규정 준수: 많은 규정에서 정제된 문서에 명확한 라벨링을 요구합니다.

실용적인 적용 사례

다음과 같은 실제 사용 사례를 살펴보세요:

Legal Document Redaction: 클라이언트와 공유하기 전에 계약서를 안전하게 레드랙션합니다.
Medical Record Handling: 환자 식별자를 보호합니다.
Financial Reporting: 민감한 숫자를 비밀로 유지합니다.
CRM Integration: 내보내기 전에 고객 데이터를 자동으로 레드랙션합니다.
Collaboration Tools: 공유 초안이 숨겨진 주석을 노출하지 않도록 합니다.

성능 고려 사항

성능 최적화

load document from stream(스트림 로드)를 사용해 전체 파일을 메모리에 로드하는 것을 피합니다.
Redactor 인스턴스를 즉시 닫아 리소스를 해제합니다.

리소스 사용 가이드라인

배치 실행 중 CPU와 메모리를 모니터링합니다.
파일 크기가 작을 때는 메모리 내 저장을 위해 ByteArrayOutputStream을 선호합니다.

Java 메모리 관리 모범 사례

동일 유형의 여러 파일을 처리할 때 Redactor 객체를 재사용합니다.
누수를 방지하기 위해 try‑with‑resources 블록에서 close()를 호출합니다.

일반적인 문제 및 해결책

Issue	Cause	Fix
접미사가 표시되지 않음	`setAddSuffix(false)` 또는 호출 누락	`save()` 호출 전에 `options.setAddSuffix(true)`가 설정되어 있는지 확인합니다.
대용량 DOCX에서 OutOfMemoryError	전체 파일을 메모리에 로드함	`InputStream` 로드로 전환합니다 (Feature 1 참조).
주석이 여전히 표시됨	저장 전에 레드랙션이 적용되지 않음	`save()` 호출 전에 `redactor.apply(new DeleteAnnotationRedaction())`를 호출합니다.
PDF 래스터화가 적용되지 않음	`setRasterizeToPDF(false)` 또는 누락	플랫 PDF가 필요할 때 `options.setRasterizeToPDF(true)`를 설정합니다.

자주 묻는 질문

Q: GroupDocs.Redaction을 사용해 PDF 문서를 레드랙션할 수 있나요?
A: 예, 라이브러리는 PDF, DOCX, PPTX, XLSX 등 다양한 형식을 지원합니다.

Q: GroupDocs.Redaction으로 대용량 파일을 처리하는 가장 좋은 방법은 무엇인가요?
A: 스트리밍(load document from stream)을 사용하고 리소스를 즉시 닫아 메모리 사용량을 낮게 유지합니다.

Q: 접미사 텍스트를 사용자 정의할 수 있나요?
A: API는 기본 접미사(예: “_redacted”)를 자동으로 추가합니다. 사용자 정의 접미사가 필요하면 저장 후 출력 파일명을 변경하면 됩니다.

Q: GroupDocs.Redaction의 임시 라이선스를 어떻게 얻나요?
A: Temporary License page를 방문하고 안내에 따라 진행합니다.

Q: 문제가 발생하면 어디에서 도움을 받을 수 있나요?
A: 전문가 지원을 위해 GroupDocs Support Forum에 참여하세요.

리소스

Documentation: 자세한 가이드는 GroupDocs Documentation에서 확인하세요.
API Reference: 포괄적인 API 세부 정보는 GroupDocs API Reference에서 확인합니다.
Download: 최신 버전은 GroupDocs Downloads에서 다운로드합니다.
GitHub Repository: 소스 코드를 기여하거나 탐색하려면 GroupDocs GitHub를 방문하세요.

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