Java에서 GroupDocs를 사용한 래스터화로 테두리 추가하는 방법

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

빠른 답변

• 래스터화에서 “add border”는 무엇을 의미하나요? 내용이 래스터화된 후 각 페이지에 시각적 프레임을 그립니다.
• 이 기능을 제공하는 라이브러리는? GroupDocs.Redaction for Java.
• 라이선스가 필요합니까? 평가용으로는 무료 체험판을 사용할 수 있으며, 프로덕션에서는 정식 라이선스가 필요합니다.
• 대용량 문서를 효율적으로 처리할 수 있나요? 예 – 래스터화를 활성화하고 Redactor를 즉시 닫아 메모리를 해제하십시오.
• 테두리 색상을 설정할 수 있나요? 물론입니다; HashMap 옵션을 통해 원하는 색상과 너비를 지정할 수 있습니다.

래스터화란 무엇이며 테두리 추가가 필요한 이유는?

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

사전 요구 사항

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

라이선스 획득

• 무료 체험: 구매 없이 API를 탐색할 수 있습니다.
• 임시 라이선스: 제한된 기간의 키를 사용해 장기 테스트를 수행합니다.
• 정식 라이선스: 프로덕션 배포에 필요합니다.

기본 초기화 및 설정

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

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

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

구현 가이드

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

문서 로드 및 준비

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

Redactor 인스턴스를 생성하여 이후 모든 작업을 관리합니다.

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

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 픽셀 너비의 검은색 테두리.

문제 해결 팁

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

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

대용량 PDF를 래스터화하면 메모리를 많이 사용합니다. 테두리를 고급 옵션으로 활성화하면 엔진이 한 번에 그리기를 처리하게 되어 임시 객체 수가 줄어들고 처리 속도가 빨라집니다. 항상 예시와 같이 Redactor 객체를 닫아 네이티브 리소스를 즉시 해제하십시오.

실용적인 적용 사례

1. 법률 문서: 가린 섹션 주변에 명확한 테두리를 두어 검토자에게 규정 준수를 알립니다.
2. 의료 기록: 원본 레이아웃을 유지하면서 환자 데이터를 숨깁니다.
3. 재무 보고서: 기본 데이터를 변경하지 않고 추가 검토가 필요한 섹션을 강조합니다.

성능 고려 사항

• 메모리 관리: 저장이 끝나는 즉시 Redactor를 닫습니다.
• 배치 처리: 문서를 순차적으로 처리하거나 제한된 동시성을 가진 스레드 풀을 사용해 메모리 부족 오류를 방지합니다.
• 모니터링: 처리 시간과 메모리 사용량을 기록하고, 성능이 저하될 경우 borderWidth 또는 래스터화 DPI를 조정합니다.

결론

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

다음 단계

• 기존 문서 처리 파이프라인에 테두리 로직을 통합하십시오.
• 워터마크나 사용자 정의 DPI 설정 등 다른 AdvancedRasterizationOptions를 실험해 보세요.
• 추가적인 가림 기능을 위해 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 라이브러리를 마이크로서비스에 임베드하여 문서 처리 백엔드를 구축하십시오.

리소스

• GroupDocs.Redaction Documentation
• API Reference
• Download Latest Version
• GitHub Repository
• Free Support Forum
• Temporary License

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