GroupDocs Redaction Java에서 파일 이름에 접미사 추가하는 방법
이 groupdocs redaction java tutorial에서는 GroupDocs.Redaction을 사용해 문서를 레다션할 때 출력 파일 이름에 자동으로 접미사를 추가하는 방법을 배웁니다. 접미사를 추가하면 수동 이름 변경이 필요 없고, 레다션되지 않은 파일이 유출될 위험을 줄이며, 명명 규칙을 활용하는 CI/CD 파이프라인에 깔끔하게 통합됩니다. 이 가이드는 Maven 설정, 스트리밍 문서 로드, 주석 제거, 저장 옵션 구성 등을 간결하고 프로덕션 수준의 코드와 함께 안내합니다.
빠른 답변
- “파일 이름에 접미사 추가”는 무엇을 하나요?
접미사 옵션을 활성화하면 SDK가 출력 파일의 기본 이름에 미리 정의된 문자열(기본값 “_redacted”)을 확장자 앞에 자동으로 추가합니다. 이를 통해 어떤 파일이 처리되었는지 즉시 확인할 수 있고, 원본 콘텐츠가 실수로 배포되는 것을 방지하며, 명명 패턴에 의존하는 다운스트림 자동화를 단순화합니다. - 스트림에서 문서를 로드할 수 있나요?
예—GroupDocs.Redaction은 모든InputStream에서 로드를 지원하므로 클라우드 스토리지나 메모리 내 처리에 적합합니다. - 이 기능에 라이선스가 필요합니까?
무료 체험으로 기본 레다션이 가능하며, 임시 또는 정식 라이선스를 통해 접미사 처리 등 모든 고급 옵션을 사용할 수 있습니다. - 지원되는 형식은 무엇입니까?
라이브러리는 DOCX, PDF, PPTX, XLSX 등 다양한 형식을 처리합니다. - PDF 출력에 래스터화가 필요합니까?
래스터화는 선택 사항이며, 문서를 평탄화하여 추가 보안을 제공해야 할 때 활성화합니다.
“파일 이름에 접미사 추가”는 무엇을 하나요?
접미사 옵션을 활성화하면 SDK가 출력 파일의 기본 이름에 미리 정의된 문자열(기본값 “_redacted”)을 확장자 앞에 자동으로 추가합니다. 이를 통해 어떤 파일이 처리되었는지 즉시 확인할 수 있고, 원본 콘텐츠가 실수로 배포되는 것을 방지하며, 명명 패턴에 의존하는 다운스트림 자동화를 단순화합니다.
왜 이 작업에 GroupDocs.Redaction을 사용하나요?
GroupDocs.Redaction은 자동 접미사 추가, 스트리밍 지원, 배치 처리와 같은 유연한 파일 처리 옵션을 결합한 고성능 Java API를 제공합니다. 50개 이상의 입력 및 출력 형식을 지원하며, 전체 파일을 메모리에 로드하지 않고도 수백 페이지 문서를 처리해 낮은 메모리 사용량과 빠른 실행을 보장합니다.
전제 조건
- Java Development Kit (JDK): 버전 8 이상.
- GroupDocs.Redaction Library: 레다션 작업을 위한 핵심 라이브러리.
- IDE: IntelliJ IDEA, Eclipse 또는 Java 호환 편집기.
- Maven: 의존성 관리를 위해 필요합니다.
지식 전제 조건
Java I/O와 기본 객체 지향 개념에 익숙하면 예제를 더 쉽게 따라갈 수 있습니다.
GroupDocs.Redaction for Java 설정
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: 스트림에서 문서 로드
Overview: InputStream을 사용해 문서를 로드하고 처리하는 방법을 배웁니다.
InputStream은 파일, 네트워크 연결 또는 기타 소스에서 전체 내용을 메모리에 로드하지 않고 바이트 스트림을 읽을 수 있게 하는 Java I/O 클래스입니다.
단계 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();
}
}
- Why:
InputStream을 사용하면 클라우드 버킷, 데이터베이스, 메모리 버퍼 등 다양한 위치에 저장된 문서를 디스크에 먼저 쓰지 않고도 처리할 수 있습니다. 이는 마이크로서비스 아키텍처에서 스트림에서 문서 로드가 필요할 때 필수적인 접근 방식입니다.
기능 2: 주석 삭제 레다션 적용
Overview: DeleteAnnotationRedaction을 사용해 문서에서 모든 주석을 제거합니다.
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());
}
- Why: 이 단계는 민감한 주석(코멘트, 하이라이트 또는 숨겨진 메모)을 문서에서 제거하여 프라이버시와 규정 준수를 강화합니다.
기능 3: 옵션으로 문서 저장
Overview: 레다션된 문서를 래스터화 및 add suffix filename java와 같은 특정 옵션을 사용해 저장하는 방법을 배웁니다.
SaveOptions는 레다션된 문서가 어떻게 기록되는지를 제어하는 설정을 캡슐화하며, 형식, 래스터화 및 명명 규칙 등을 포함합니다.
단계 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());
}
}
- Why: 저장 옵션을 맞춤 설정하면 다양한 출력 형식과 명명 규칙을 유연하게 적용할 수 있습니다.
setAddSuffix(true)를 활성화하면 파일 이름에 접미사 추가가 이루어져 파일이 레다션되었음을 명확히 표시합니다.
문서를 저장할 때 파일 이름에 접미사 추가하기 (Java)
Redactor 클래스는 문서를 로드하고 레다션 작업을 적용하는 핵심 구성 요소입니다. SaveOptions는 레다션된 문서의 저장 방식을 정의하며, 형식, 래스터화 및 명명 규칙을 포함합니다. Redactor 인스턴스를 생성하고 필요한 레다션을 적용한 뒤 setAddSuffix(true)가 설정된 SaveOptions 객체를 구성합니다. redactor.save(outputPath, options)를 호출하면 SDK가 파일 이름에 자동으로 “_redacted”(또는 구성된 접미사)를 추가하므로 수동으로 파일명을 바꿀 필요가 없습니다.
GroupDocs Maven 의존성 개요
groupdocs maven dependency는 단일 <dependency> 항목만으로 전체 Redaction SDK를 프로젝트에 포함시킵니다. 전이 의존성을 처리하고 라이브러리를 최신 상태로 유지하며 빌드 자동화를 단순화합니다. pom.xml에 의존성을 선언하면 수동 JAR 관리가 필요 없고 최신 보안 패치를 자동으로 적용받을 수 있습니다.
접미사 추가가 중요한 이유
접미사를 추가하면 파일이 처리되었음을 즉시 시각적으로 확인할 수 있어 감사 추적, 자동 워크플로 및 규제 준수에 필수적입니다. 스크립트가 레다션된 파일만 필터링하도록 도와주고, 원본 콘텐츠가 실수로 배포되는 것을 방지하며, 정제된 문서에 명확한 라벨링을 요구하는 산업 표준을 충족합니다.
실제 적용 사례
다음과 같은 실제 사용 사례를 살펴보세요:
- 법률 문서 레다션: 클라이언트와 공유하기 전에 계약서를 안전하게 처리합니다.
- 의료 기록 처리: 임상 데이터를 보존하면서 환자 식별자를 보호합니다.
- 재무 보고: 외부 감사 시 민감한 숫자를 비공개로 유지합니다.
- CRM 통합: 제3자 도구로 내보내기 전에 고객 데이터를 자동으로 레다션합니다.
- 협업 도구: 공유 초안에 숨겨진 주석이나 메타데이터가 노출되지 않도록 합니다.
성능 고려 사항
성능 최적화
- 스트리밍(
스트림에서 문서 로드)을 사용해 전체 파일을 메모리에 로드하지 않도록 합니다. Redactor인스턴스를 즉시 닫아 리소스를 해제합니다.
리소스 사용 가이드라인
- 배치 실행 중 CPU와 메모리를 모니터링합니다.
- 파일 크기가 작을 경우
ByteArrayOutputStream을 사용해 메모리 내 저장을 선호합니다.
Java 메모리 관리 모범 사례
- 동일 유형의 파일을 여러 개 처리할 때
Redactor객체를 재사용합니다. try‑with‑resources블록에서close()를 호출해 메모리 누수를 방지합니다.
일반적인 문제와 해결책
| 문제 | 원인 | 해결책 |
|---|---|---|
| 접미사가 표시되지 않음 | 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: 스트리밍(스트림에서 문서 로드)을 사용하고 리소스를 즉시 닫아 메모리 사용량을 최소화하십시오.
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-11-02
테스트 환경: GroupDocs.Redaction 24.9 for Java
작성자: GroupDocs