Java에서 GroupDocs를 사용하여 래스터화와 함께 테두리 추가하는 방법

이 튜토리얼에서는 GroupDocs.Redaction for Java를 사용하여 고급 래스터화를 적용하면서 문서에 테두리 추가 방법을 알아봅니다. 법률 파일, 의료 기록 또는 재무 보고서를 보호하든, 사용자 정의 테두리를 추가하면 삭제된 영역을 강조하고 시각적 레이아웃을 유지하는 데 도움이 됩니다. 설정 과정, 필요한 정확한 코드, 대용량 문서 처리에 대한 성능 팁을 단계별로 안내합니다.

빠른 답변

  • “add border”가 래스터화에서 의미하는 바는 무엇인가요? 콘텐츠가 래스터화된 후 각 페이지에 시각적 프레임을 그려 삭제된 영역에 대한 명확한 시각적 신호를 제공합니다.
  • 어떤 라이브러리가 이 기능을 제공하나요? GroupDocs.Redaction for Java는 내장된 래스터화 및 테두리 옵션을 제공합니다.
  • 라이선스가 필요합니까? 평가용으로는 무료 체험을 사용할 수 있으며, 실제 운영을 위해서는 정식 라이선스가 필요합니다.
  • 대용량 문서를 효율적으로 처리할 수 있나요? 예 — 래스터화를 활성화하고 적절한 DPI를 설정한 뒤, Redactor를 즉시 닫아 네이티브 메모리를 해제합니다.
  • 테두리 색상과 두께를 설정할 수 있나요? 물론입니다; 원하는 색상을 지정하고 옵션 HashMap을 통해 set border width java를 사용할 수 있습니다.

래스터화란 무엇이며 테두리 추가를 원하는 이유는 무엇인가요?

래스터화는 문서의 각 페이지를 이미지로 변환하는 것으로, 기본 텍스트나 그래픽을 완전히 숨겨야 할 때 유용합니다. 래스터화된 이미지 위에 사용자 정의 테두리를 추가하면 삭제가 명확하고 전문적으로 보이며, 특히 규제가 많은 산업에서 유용합니다.

직접적인 답변: 래스터화는 모든 PDF 페이지를 비트맵으로 변환하고, 테두리 추가 옵션은 각 비트맵 페이지 주변에 사각형 프레임을 그려 페이지가 삭제되었음을 즉시 알리면서 원래 레이아웃을 유지합니다.

전제 조건

  • GroupDocs.Redaction for Java 버전 24.9 이상.
  • Java Development Kit (JDK)이 설치되어 있어야 합니다.
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  • 기본 Java 지식(클래스, 메서드, 예외 처리).

GroupDocs.Redaction for Java 설정

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에서 JAR 파일을 직접 다운로드할 수 있습니다.

라이선스 획득

  • Free Trial: 구매 없이 API를 탐색할 수 있습니다.
  • Temporary License: 기간 제한 키를 사용해 확장 테스트를 수행합니다.
  • Full License: 프로덕션 배포에 필요합니다.

기본 초기화 및 설정

먼저, 필요한 핵심 클래스를 가져옵니다:

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

이제 사용자 정의 테두리를 추가할 준비가 되었습니다.

구현 가이드

사용자 정의 래스터화 옵션을 사용하여 테두리 추가하는 방법

문서 로드 및 준비

Redactor 클래스는 GroupDocs.Redaction의 핵심 엔진으로, 메모리 내에서 문서를 로드, 수정 및 저장합니다.

// Load the document you want to process.
final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");

이 코드는 이후 모든 작업을 관리할 Redactor 인스턴스를 생성합니다.

저장 옵션 설정 및 테두리 추가

AdvancedRasterizationOptions.Border 속성은 엔진에게 각 래스터화된 페이지 주변에 테두리를 그리도록 지시합니다.

try {
    // Create SaveOptions and set a suffix for the saved file name.
    SaveOptions so = new SaveOptions();
    so.setRedactedFileSuffix("_scan");

    // Enable rasterization to apply advanced options.
    so.getRasterization().setEnabled(true);

    // Add custom border settings as an advanced option.
    so.getRasterization().addAdvancedOption(
        AdvancedRasterizationOptions.Border,
        new HashMap<String, String>() {
{
            put("borderColor", "black");
            put("borderWidth", "2");
        }
}
    );
    
    redactor.save(so);
} finally {
    redactor.close();
}

핵심 라인 설명

  • so.getRasterization().setEnabled(true);는 문서에 대한 래스터화를 활성화합니다.
  • AdvancedRasterizationOptions.Border는 엔진에게 각 래스터화된 페이지 주변에 테두리를 그리도록 지시합니다.
  • HashMap은 시각적 스타일을 정의합니다: 2픽셀 두께의 검은색 테두리.
  • borderWidth 항목을 변경하여 set border width java를 설정할 수 있습니다. 예를 들어, 더 두꺼운 프레임을 원한다면 borderWidth = 4로 지정합니다.

문제 해결 팁

  • 파일 경로가 올바른지 확인하세요; 그렇지 않으면 FileNotFoundException이 발생합니다.
  • Maven 좌표가 추가한 버전과 일치하는지 확인하세요; 버전이 일치하지 않으면 NoClassDefFoundError가 발생합니다.

process large documents java에 이 접근 방식을 사용하는 이유는?

대용량 PDF를 래스터화하면 메모리를 많이 사용합니다. 테두리를 고급 옵션으로 활성화하면 엔진이 한 번의 패스로 그리기를 처리하게 되어 임시 객체 수가 줄어들고 처리 속도가 빨라집니다. 네이티브 리소스를 즉시 해제하려면 Redactor 객체를 반드시 보여준 대로 닫으세요.

실용적인 적용 사례

  1. Legal Documents: 삭제된 섹션 주변에 명확한 테두리를 두어 검토자에게 준수 여부를 알립니다.
  2. Medical Records: 환자 데이터를 숨기면서도 감사용 원본 레이아웃을 유지합니다.
  3. Financial Reports: 기본 데이터를 변경하지 않고 추가 검토가 필요한 섹션을 강조합니다.

성능 고려 사항

  • Memory Management: 저장이 완료되면 즉시 Redactor를 닫습니다.
  • Batch Processing: 문서를 순차적으로 처리하거나 제한된 동시성을 가진 스레드 풀을 사용해 메모리 부족 오류를 방지합니다.
  • Monitoring: 처리 시간 및 메모리 사용량을 로그에 기록하고, 성능이 저하되면 borderWidth 또는 래스터화 DPI를 조정합니다.

정량적 이점

GroupDocs.Redaction은 60개 이상의 입력 및 출력 포맷(PDF, DOCX, XLSX, PPTX, HTML 및 일반 이미지 형식 포함)을 지원하며, 스트리밍 아키텍처 덕분에 전체 파일을 메모리에 로드하지 않고도 2000페이지 문서를 래스터화할 수 있습니다. 이는 수동 이미지 변환에 비해 대량 배치에서 최대 40 % 빠른 처리를 의미합니다.

결론

이제 GroupDocs.Redaction for Java의 고급 래스터화를 사용하여 문서에 테두리 추가 방법을 알게 되었습니다. 이 기술은 문서 보안을 강화하고, 삭제된 콘텐츠의 가독성을 향상시키며, 대용량 문서 작업에 잘 확장됩니다.

다음 단계

  • 기존 문서 처리 파이프라인에 테두리 로직을 통합합니다.
  • AdvancedRasterizationOptions의 워터마크나 사용자 정의 DPI 설정 등 다른 옵션을 실험해 봅니다.
  • 추가적인 삭제 기능을 위해 GroupDocs.Redaction API를 검토합니다.

자주 묻는 질문

Q: 이 기능을 Microsoft Office가 아닌 문서에도 사용할 수 있나요?
A: 예, GroupDocs.Redaction은 PDF, 이미지 및 기타 많은 형식을 지원합니다.

Q: 래스터화 중 오류를 어떻게 처리하나요?
A: 저장 로직을 try‑catch 블록으로 감싸고, 라이브러리 버전을 확인하며, 파일 경로를 다시 확인합니다.

Q: 한 번에 처리할 수 있는 문서 수에 제한이 있나요?
A: 명확한 제한은 없지만, 순차적으로 처리하거나 제어된 동시성을 사용하면 최고의 성능을 얻을 수 있습니다.

Q: 테두리 색상과 두께를 동적으로 커스터마이징할 수 있나요?
A: 물론입니다 — save() 호출 전에 HashMap의 borderColor와 borderWidth 항목을 수정하면 됩니다.

Q: GroupDocs.Redaction을 다른 시스템과 어떻게 통합하나요?
A: REST‑style API를 사용하거나 Java 라이브러리를 마이크로서비스에 임베드하여 문서 처리 백엔드를 구축합니다.

리소스

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

관련 튜토리얼