GroupDocs.Watermark Java SDK를 사용하여 Excel 스프레드시트에 워터마크 추가하는 방법

Excel 파일을 무단 배포로부터 보호하거나 브랜드 아이덴티티를 강화하려면 파일이 어떻게 보이든 항상 보이는 시각적 표시를 추가하면 됩니다. 이 튜토리얼에서는 워터마크 추가 방법 — 특히 이미지 워터마크 — 을 GroupDocs.Watermark Java SDK를 사용해 Excel 스프레드시트의 헤더 또는 푸터에 적용하는 방법을 배웁니다. 가이드를 마치면 셀 데이터를 변경하지 않고 로고, 기밀 배지 또는 원하는 커스텀 이미지를 워크북에 직접 삽입할 수 있습니다.

빠른 답변

• “워터마크 추가 방법”은 무엇을 의미하나요? 모든 인쇄 페이지 또는 헤더/푸터와 같은 특정 섹션에 표시되는 이미지(또는 텍스트) 오버레이를 추가하는 것입니다.
• Java에서 이를 지원하는 라이브러리는 무엇인가요? GroupDocs.Watermark Java SDK (최신 릴리스).
• 라이선스가 필요하나요? 개발용으로는 무료 체험판을 사용할 수 있으며, 운영 환경에서는 상용 라이선스가 필요합니다.
• 헤더에 로고를 추가할 수 있나요? 예 – 이미지 워터마크를 사용하고 헤더 옵션(add logo to header)을 설정하면 됩니다.
• 여러 시트를 한 번에 처리할 수 있나요? 워크시트 인덱스를 순회하면서 동일한 워터마크를 각 시트에 적용하면 됩니다.

사전 요구 사항

진행하려면 다음이 필요합니다:

• GroupDocs.Watermark for Java SDK (버전 24.11 이상).
• Java Development Kit (JDK) 8 이상.
• Java와 Excel 파일 구조에 대한 기본적인 이해.

GroupDocs.Watermark for Java SDK 설정

먼저 Maven 의존성을 추가하여 SDK를 클래스패스에 포함시킵니다.

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>

직접 다운로드

Maven을 사용하지 않으려면 공식 릴리스 페이지에서 최신 JAR 파일을 다운로드하세요: GroupDocs 릴리스.

라이선스 획득

• 모든 기능을 평가할 수 있는 무료 체험판 또는 임시 라이선스 키를 받으세요.
• 상용 배포를 위해서는 정식 라이선스를 구매하세요.

초기화 및 설정

Excel 파일을 로드하고 모든 워터마크 작업의 진입점이 되는 Watermarker 인스턴스를 생성합니다.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

// Initialize Load Options
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();

// Create Watermarker instance with your spreadsheet file path
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);

스프레드시트 헤더/푸터에 워터마크 추가하기

아래는 java add image watermark 기능을 시연하고 add logo to header를 수행하는 단계별 프로세스입니다.

단계 1: 로드 옵션 구성

로드 옵션을 정의하고 Watermarker를 다시 인스턴스화합니다. 이렇게 하면 SDK가 워크북을 올바르게 읽을 수 있습니다.

import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.common.VerticalAlignment;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

// Load the document with specified load options
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);

단계 2: 이미지 워터마크 생성 및 구성

삽입하려는 이미지(예: 로고 또는 “CONFIDENTIAL” 배지)를 가리키는 ImageWatermark 객체를 생성합니다. 정렬과 스케일을 조정해 헤더/푸터 영역에 잘 맞도록 합니다.

import com.groupdocs.watermark.watermarks.ImageWatermark;
import com.groupdocs.watermark.watermarks.SizingType;

// Initialize the image watermark with your logo or desired image
ImageWatermark watermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY/logo.png");

// Set alignment and scaling for a proper fit within the header/footer
watermark.setVerticalAlignment(VerticalAlignment.Top);
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setSizingType(SizingType.ScaleToParentDimensions); // Scales with parent dimensions
watermark.setScaleFactor(1); // Adjust scale factor as needed

단계 3: 헤더/푸터 옵션 구성

SDK에 어느 워크시트와 어느 부분(헤더 또는 푸터)에 워터마크를 적용할지 알려줍니다. 여기서 add logo to header를 수행하거나 푸터를 선택할 수 있습니다.

import com.groupdocs.watermark.options.SpreadsheetWatermarkHeaderFooterOptions;

// Set options for applying the watermark
SpreadsheetWatermarkHeaderFooterOptions headerFooterOptions = new SpreadsheetWatermarkHeaderFooterOptions();
headerFooterOptions.setWorksheetIndex(0); // Apply to first worksheet (index 0)

단계 4: 워터마크 추가

준비된 이미지 워터마크를 선택한 헤더/푸터 위치에 연결합니다.

// Add the configured watermark
watermarker.add(watermark, headerFooterOptions);

단계 5: 저장 및 종료

원본 워크북을 그대로 두고 변경 사항을 새 파일에 저장한 뒤 리소스를 해제합니다.

// Save the watermarked document
watermarker.save("YOUR_OUTPUT_DIRECTORY/out_spreadsheet.xlsx");

// Release resources by closing the Watermarker instance
watermarker.close();

문제 해결 팁

• 이미지 경로를 다시 확인하세요; 잘못된 경로는 FileNotFoundException을 발생시킵니다.
• 워크시트 인덱스는 0부터 시작하므로 설정한 인덱스가 실제 존재하는지 확인하세요.
• 워터마크가 왜곡되면 setScaleFactor를 조정하거나 SizingType을 StretchToParentDimensions로 변경해 보세요.

GroupDocs.Watermark Java SDK를 사용해야 하는 이유

• 다중 포맷 지원 – Excel, Word, PowerPoint, PDF 및 이미지와 함께 작동합니다.
• 무손실 편집 – 원본 셀 데이터는 그대로 유지됩니다.
• 성능 최적화 – 대용량 워크북 및 배치 처리에 적합합니다.

실용적인 사용 사례

성능 고려 사항

• 메모리 사용량 – 매우 큰 스프레드시트를 처리할 때 JVM 힙을 모니터링하세요.
• 배치 처리 – 메모리 사용량을 낮게 유지하려면 파일을 그룹으로 처리하세요.
• 객체 재사용 – 여러 파일에 대해 단일 Watermarker 인스턴스를 재사용하면 오버헤드가 감소합니다.

자주 묻는 질문

Q: 하나의 문서에 여러 워터마크를 추가할 수 있나요?
A: 예, 추가 ImageWatermark 인스턴스를 생성하고 각각을 구성한 뒤 watermarker.add()를 호출하면 됩니다.

Q: 스프레드시트에서 기존 워터마크를 제거하려면 어떻게 하나요?
A: 현재 GroupDocs.Watermark는 워터마크 추가에 중점을 두고 있습니다. 제거하려면 워터마크가 없는 새 워크북을 재생성하거나 워터마크 추출을 지원하는 도구를 사용해야 합니다.

Q: 워터마크에 사용할 수 있는 이미지 형식은 무엇인가요?
A: PNG, JPEG 등 일반적인 포맷을 지원하지만, 전체 지원 형식 목록은 GroupDocs 문서를 확인하세요.

Q: 비밀번호로 보호된 스프레드시트에도 워터마크를 적용할 수 있나요?
A: 예, 파일을 열 때 필요한 비밀번호를 제공하면 됩니다.

Q: 문서의 모든 워크시트에 워터마크를 적용하려면 어떻게 해야 하나요?
A: 각 워크시트 인덱스를 순회하면서 워터마크 적용 단계를 반복하고, 각 반복에서 headerFooterOptions.setWorksheetIndex(i)를 설정하면 됩니다.

결론

이제 GroupDocs.Watermark Java SDK를 사용해 java add excel watermark—특히 이미지 워터마크—를 Excel 파일의 헤더 또는 푸터에 삽입하는 완전한 생산 준비 방법을 알게 되었습니다. 이 접근 방식은 브랜딩, 기밀성 표시 또는 기타 시각적 요소를 워크북에 직접 추가하면서도 기본 데이터를 건드리지 않습니다. 텍스트, 도형 등 다른 워터마크 유형도 탐색하고 결합해 보다 풍부한 문서 보호를 구현해 보세요.

마지막 업데이트: 2026-03-20
테스트 환경: GroupDocs.Watermark 24.11 for Java
작성자: GroupDocs