Excel 문서에 GroupDocs.Watermark Java로 워터마크 적용 방법

소개

이 가이드에서는 Java용 GroupDocs.Watermark 라이브러리를 사용하여 Excel 파일에 워터마크를 적용하는 방법을 배웁니다. Excel 문서를 효율적으로 관리하고 처리하는 것은 워터마크 적용이나 콘텐츠 추출과 같은 작업에 필수적입니다. 이 튜토리얼은 Java에서 GroupDocs.Watermark 라이브러리를 활용하여 이러한 프로세스를 간소화하는 방법을 보여줍니다.

빠른 답변

Excel에 워터마크를 적용하려면 어떤 라이브러리를 사용할 수 있나요? GroupDocs.Watermark for Java.
같은 API로 Excel에서 이미지를 추출할 수 있나요? 예 – 도형 이미지를 직접 읽을 수 있습니다.
프로덕션 사용에 라이선스가 필요합니까? 상업용 라이선스가 필요하며, 무료 체험판을 사용할 수 있습니다.
지원되는 Java 버전은 무엇인가요? JDK 8 이상.
라이브러리를 추가하는 방법이 Maven뿐인가요? 아니요, JAR 파일을 직접 다운로드할 수도 있습니다.

“Excel에 워터마크 적용”이란?

Excel에 워터마크를 적용한다는 것은 프로그래밍 방식으로 텍스트, 이미지 또는 도형 오버레이를 Excel 워크북에 추가하여 인쇄하거나 볼 때 모든 시트에 워터마크가 표시되도록 하는 것을 의미합니다. 이는 지적 재산을 보호하고 문서 상태(예: 초안, 기밀)를 표시하는 데 도움이 됩니다.

Excel에 GroupDocs.Watermark를 사용하는 이유

전체 기능 API – .xlsx, .xls 및 이전 형식까지 지원합니다.
Microsoft Office 의존성 없음 – 서버‑사이드 Java 환경 어디서든 실행됩니다.
내장된 도형 처리 – Excel 워크시트에서 이미지를 읽고, 수정하거나 추출할 수 있습니다.
성능 최적화 – 대용량 워크북을 최소 메모리 사용량으로 처리합니다.

사전 요구 사항

JDK 8 이상이 설치되어 있어야 합니다.
의존성 관리를 위한 Maven(또는 수동 JAR 처리).
기본 Java 프로그래밍 지식.

필요한 라이브러리 및 종속성

프로젝트에 GroupDocs.Watermark를 종속성으로 포함합니다. Maven을 통해 추가하거나 직접 다운로드할 수 있습니다:

Maven

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

직접 다운로드
또는 최신 버전을 GroupDocs.Watermark for Java releases에서 다운로드하십시오.

환경 설정 요구 사항

JDK 8 이상이 설치 및 구성되어 있는지 확인하십시오.
의존성 관리를 원한다면 Maven이 설정되어 있어야 합니다.

지식 사전 요구 사항

Java 프로그래밍에 대한 기본 이해.
Java에서 파일 처리에 익숙함.

GroupDocs.Watermark for Java 설정

시작하려면 Maven을 통해서든 공식 사이트에서 직접 다운로드하든 라이브러리를 설치해야 합니다. GroupDocs는 기능을 테스트할 수 있는 무료 체험판을 제공하며, 장기 사용을 위한 라이선스도 제공됩니다:

Free Trial – 제한된 기능이지만 평가에 적합합니다.
Temporary License – 짧은 기간 동안 모든 기능을 사용할 수 있습니다.
Purchase License – 상업적 배포에 필요합니다.

설치가 완료되면 다음과 같이 초기화하여 Excel 문서를 작업할 수 있습니다:

Excel에 워터마크 적용 방법

이 섹션에서는 스프레드시트를 로드하고, 이미지(또는 도형)를 추출한 뒤, 워터마크 적용을 준비하는 과정을 단계별로 안내합니다.

기능 1: 스프레드시트 내용 로드 및 접근

단계 1: 스프레드시트 로드 옵션 정의

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();

Purpose: 스프레드시트를 로드할 때 필요한 특정 옵션을 구성합니다.

단계 2: 문서 경로로 Watermarker 초기화

"YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx"을 실제 파일 경로로 교체하십시오.

Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);

Explanation: 워크북을 완전히 제어할 수 있는 Watermarker 인스턴스를 생성합니다.

단계 3: 스프레드시트 내용 접근

SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);

Functionality: 워크시트, 셀 및 도형을 나타내는 풍부한 객체 모델을 반환합니다.

기능 2: Excel에서 이미지 추출 (도형)

개요

Excel은 사진, 차트 및 텍스트 상자를 도형으로 저장합니다. 아래 코드는 이러한 도형을 추출하여 워터마크를 적용하기 전에 Excel에서 이미지를 추출하거나 속성을 검사할 수 있게 합니다.

단계 4: 각 워크시트 반복

for (SpreadsheetWorksheet worksheet : content.getWorksheets()) {

Purpose: 모든 워크시트를 순회하여 개별 도형에 접근합니다.

단계 5: 워크시트 내 각 도형 반복

for (SpreadsheetShape shape : worksheet.getShapes()) {
    // Display various properties of the shape
    System.out.println(shape.getAutoShapeType());
    System.out.println(shape.getMsoDrawingType());
    System.out.println(shape.getText());

    if (shape.getImage() != null) {
        System.out.println(shape.getImage().getWidth());
        System.out.println(shape.getImage().getHeight());
        System.out.println(shape.getImage().getBytes().length);
    }

    // Display other properties of the shape
    System.out.println(shape.getId());
    System.out.println(shape.getAlternativeText());
    System.out.println(shape.getX());
    System.out.println(shape.getY());
    System.out.println(shape.getWidth());
    System.out.println(shape.getHeight());
    System.out.println(shape.getRotateAngle());
    System.out.println(shape.isWordArt());
    System.out.println(shape.getName());
}

Explanation: 도형 유형, 텍스트 내용 및 이미지 속성(가능한 경우)을 포함한 상세 정보를 추출합니다. 여기서 Excel에서 이미지를 추출하여 추가 처리나 보관에 사용할 수 있습니다.

단계 6: Watermarker 인스턴스 닫기

watermarker.close();

Significance: 작업이 완료된 후 Watermarker 인스턴스를 닫아 리소스를 해제합니다.

실용적인 적용 사례

이 기능들은 실제 시나리오에 적용될 수 있습니다:

Document Automation – Excel 보고서에서 데이터를 자동으로 추출하고 처리하여 워크플로를 간소화합니다.
Data Integrity Checks – 재무 스프레드시트에서 도형 및 삽입된 이미지를 검증하여 규정 준수를 확인합니다.
Integration with BI Tools – 추출된 도형 데이터를 비즈니스 인텔리전스 플랫폼에 전달하여 보다 풍부한 분석을 수행합니다.

성능 고려 사항

대용량 Excel 파일을 다룰 때:

메모리 사용량을 낮추기 위해 필요한 시트나 도형만 처리합니다.
Excel에서 이미지를 추출만 필요하다면 셀과 수식을 건너뜁니다.
실제 부하 조건에서 테스트하고 코드를 프로파일링하여 병목 현상을 파악합니다.

결론

Java용 GroupDocs.Watermark의 이러한 기능을 마스터하면 Excel 워크북에 효율적으로 워터마크를 적용하고, 삽입된 이미지를 추출하며, Excel 처리를 더 큰 자동화 파이프라인에 통합할 수 있습니다. 텍스트 워터마크 추가, 워터마크 회전, 워크시트 내용에 따라 조건부 적용과 같은 추가 기능도 살펴보세요.

다음 단계

워터마크 API를 탐색하여 사용자 정의 텍스트 또는 이미지 워터마크를 추가합니다.
도형 추출을 OCR과 결합하여 이미지 내부 텍스트를 읽습니다.
PDF, Word 및 이미지 형식을 위한 GroupDocs SDK를 탐색하여 통합 문서 처리 솔루션을 구축합니다.

FAQ 섹션

GroupDocs.Watermark란?
- 문서 내 워터마크 및 기타 콘텐츠를 처리하기 위한 강력한 Java 라이브러리입니다.
GroupDocs.Watermark를 다른 파일 유형과 함께 사용할 수 있나요?
- 예, PDF, 이미지, Word 파일 등 다양한 형식을 지원합니다.
일반적인 문제를 어떻게 해결하나요?
- 공식 GroupDocs 포럼에서 지원을 확인하거나 문서를 참고하십시오.
GroupDocs.Watermark 사용 시 모범 사례는 무엇인가요?
- 항상 Watermarker 인스턴스를 닫고, 필요한 시트만 처리하며, 대용량 파일을 다룰 때 메모리를 모니터링하십시오.
더 많은 예제를 어디서 찾을 수 있나요?
- GitHub 저장소에서 다양한 코드 샘플과 프로젝트를 확인할 수 있습니다.

자주 묻는 질문

Q: Excel 워크북의 모든 시트에 텍스트 워터마크를 어떻게 추가하나요?
A: 워크북을 로드한 후 TextWatermark 객체를 생성하고 각 워크시트에 대해 watermarker.add(watermark, new SpreadsheetWatermarkOptions())를 호출합니다.

Q: Excel 파일에서 PNG 이미지만 추출할 수 있나요?
A: 예. 처리하기 전에 shape.getImage().getBytes()를 확인하고 shape.getImage().getImageFormat()으로 이미지 형식을 검사합니다.

Q: 특정 키워드가 포함된 시트에만 워터마크를 적용할 수 있나요?
A: 물론입니다. content.getWorksheets()를 순회하면서 셀 값을 검사하고, 일치하는 시트에 대해 조건부로 watermarker.add(...)를 호출합니다.

Q: 라이브러리가 비밀번호로 보호된 Excel 파일을 지원하나요?
A: 예. Watermarker를 생성하기 전에 SpreadsheetLoadOptions에 setPassword("yourPassword")를 사용해 비밀번호를 전달합니다.

Q: 이 튜토리얼에서 사용된 GroupDocs.Watermark 버전은 무엇인가요?
A: 예제는 GroupDocs.Watermark 24.11을 대상으로 합니다.

리소스

Documentation: GroupDocs Watermark Documentation
API Reference: GroupDocs API Reference
Download: Latest Release

Last Updated: 2026-04-01
Tested With: GroupDocs.Watermark 24.11 for Java
Author: GroupDocs

{< /blocks/products/pf/tutorial-page-section >} {< /blocks/products/pf/main-container >} {< /blocks/products/pf/main-wrap-class >} {< blocks/products/products-backtop-button >}