텍스트를 사용하여 GroupDocs.Watermark for Java로 Excel 시트에 워터마크 추가하기

Excel 워크북에 Excel에 워터마크를 적용하는 방법이 필요할 때—특히 민감한 데이터를 포함하고 있는 경우—명확하고 전문적인 텍스트 워터마크를 추가하는 것이 콘텐츠를 보호하고 브랜드 아이덴티티를 강화하는 가장 효과적인 방법 중 하나입니다. 이 튜토리얼에서는 GroupDocs.Watermark 라이브러리를 사용하여 Java에서 Excel 파일에 텍스트 워터마크를 추가하는 정확한 단계를 살펴보며, 프로젝트 설정부터 최종 보안 워크북 저장까지 모두 다룹니다.

빠른 답변

어떤 라이브러리를 사용해야 하나요? GroupDocs.Watermark for Java.
모든 시트에 텍스트 워터마크를 추가할 수 있나요? 예 – 각 워크시트를 반복하면서 동일한 워터마크를 적용합니다.
라이선스가 필요합니까? 평가용으로는 무료 체험판을 사용할 수 있으며, 프로덕션에서는 영구 라이선스가 필요합니다.
지원되는 Java 버전은? JDK 8 이상.
워터마크가 셀 데이터에 영향을 줍니까? 아니요, 워터마크는 워크시트 내 이미지에만 오버레이됩니다.

Excel 워터마킹이란?

Java를 사용하여 Excel에 텍스트 워터마크를 추가하는 이유

보안 – 기밀 또는 독점 정보를 명확히 표시합니다.
브랜드 일관성 – 공유된 모든 스프레드시트에 기업 브랜딩을 강화합니다.
자동화 – Java를 사용하면 워터마크를 프로그래밍 방식으로 삽입할 수 있어 수동 편집 시간을 절약합니다.
크로스 포맷 지원 – .xlsx와 레거시 .xls 파일 모두에서 작동합니다.

사전 요구 사항

Java Development Kit (JDK) 8 이상.
Maven – 의존성 관리를 위해.
Java 구문 및 객체 지향 개념에 대한 기본적인 이해.

GroupDocs.Watermark for Java 설정

시작하려면 Maven 프로젝트에 GroupDocs.Watermark 의존성을 추가합니다.

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>

직접 다운로드

또는 최신 JAR 파일을 GroupDocs.Watermark for Java releases에서 다운로드합니다.

라이선스 획득

Free Trial – 비용 없이 모든 기능을 탐색합니다.
Temporary License – 단기 테스트에 사용합니다.
Purchase – 전체 프로덕션 기능을 활성화합니다.

기본 초기화

import com.groupdocs.watermark.Watermarker;
// Initialize watermarker instance for your document
Watermarker watermarker = new Watermarker("path/to/your/spreadsheet.xlsx");

구현 가이드

기능 1: 텍스트 워터마크 생성 및 속성 구성

워터마크를 생성하고 사용자 정의하려면 텍스트, 폰트, 정렬, 회전 각도 및 스케일을 설정해야 합니다.

단계별 개요

Define Your Watermark

import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.common.VerticalAlignment;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;
import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.SizingType;
import com.groupdocs.watermark.watermarks.TextWatermark;

// Create a new TextWatermark object
text watermark = new TextWatermark("Protected image", new Font("Arial", 8));

// Configure the watermark properties
text watermark.setHorizontalAlignment(HorizontalAlignment.Center);
text watermark.setVerticalAlignment(VerticalAlignment.Center);
text watermark.setRotateAngle(45); // Set rotation angle
text watermark.setSizingType(SizingType.ScaleToParentDimensions);
text watermark.setScaleFactor(1); // Maintain original size scale factor

Text and Font – 명확한 메시지와 읽기 쉬운 폰트를 선택합니다.
Alignment – 대부분의 이미지에 중앙 정렬이 잘 작동합니다.
Rotation & Scaling – 45° 기울임은 워터마크를 눈에 띄게 하면서 이미지가 가려지지 않게 합니다.

기능 2: 워터마킹을 위한 스프레드시트 문서 로드

워크북을 적절한 옵션으로 로드하여 GroupDocs가 내부 이미지를 접근할 수 있도록 합니다.

import com.groupdocs.watermark.options.SpreadsheetLoadOptions;
// Load your Excel spreadsheet
documentLoadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", documentLoadOptions);

기능 3: 워크시트의 이미지에 텍스트 워터마크 추가

첫 번째 워크시트의 이미지를 순회하면서 구성된 워터마크를 적용합니다.

import com.groupdocs.watermark.contents.SpreadsheetContent;
import com.groupdocs.watermark.contents.WatermarkableImageCollection;

// Access content from your loaded document
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
WatermarkableImageCollection images = content.getWorksheets().get_Item(0).findImages();

for (com.groupdocs.watermark.contents.WatermarkableImage image : images) {
    // Add the configured watermark to each image in the worksheet
    image.add(watermark);
}

기능 4: 워터마크가 적용된 스프레드시트 문서 저장 및 닫기

변경 사항을 새 파일에 저장하고 리소스를 정리합니다.

// Save the changes to a new file
watermarker.save("YOUR_OUTPUT_DIRECTORY/spreadsheet-out.xlsx");
// Close the watermarker instance to free resources
watermarker.close();

실용적인 적용 사례

Document Security – 기밀 재무 모델이나 인사 데이터를 보호합니다.
Branding – 모든 공유 보고서에 회사 슬로건이나 법적 고지를 삽입합니다.
Copyright Protection – 모든 내보낸 이미지에 표시하여 표절을 방지합니다.

성능 고려 사항

최신 성능 개선을 활용하려면 GroupDocs.Watermark를 최신 상태로 유지하십시오.
Watermarker 인스턴스를 즉시(close()) 해제하여 메모리를 확보합니다.
매우 큰 워크북의 경우 메모리 사용량을 줄이기 위해 워크시트를 배치로 처리합니다.

일반적인 문제 및 해결책

문제	해결책
워터마크가 보이지 않음	워크시트에 실제로 이미지가 포함되어 있는지 확인하십시오; API는 이미지에만 워터마크를 적용하고 셀에는 적용하지 않습니다.
워터마크 정렬 오류	`HorizontalAlignment` / `VerticalAlignment`를 조정하거나 `RotateAngle`을 변경하십시오.
대용량 파일에서 메모리 부족 오류	JVM 힙(`-Xmx`)을 늘리거나 각 워크시트를 별도로 처리하십시오.
라이선스 오류	프로젝트에 시험판 또는 영구 라이선스 파일이 올바르게 지정되었는지 확인하십시오.

자주 묻는 질문

Q: 모든 Excel 버전에서 사용할 수 있나요?
A: 예, GroupDocs는 .xlsx와 .xls 형식을 모두 지원합니다.

Q: 워터마크가 제대로 표시되지 않으면 어떻게 해야 하나요?
A: 정렬 설정을 다시 확인하고 이미지 크기가 선택한 스케일 팩터에 적합한지 확인하십시오.

Q: 폰트 스타일을 더 세부적으로 커스터마이즈하려면?
A: Font 클래스를 사용하여 굵게, 기울임, 색상 등 다양한 타이포그래피 속성을 설정합니다.

Q: 워크북의 모든 시트에 워터마크를 추가할 수 있나요?
A: 물론입니다—content.getWorksheets()를 순회하면서 각 시트에 동일한 image.add(watermark) 로직을 적용합니다.

Q: 대용량 Excel 파일을 효율적으로 처리하려면?
A: 워크시트를 단계적으로 처리하고, 저장 후 각 Watermarker를 닫으며, 필요에 따라 JVM 힙 크기를 늘리는 것을 고려하십시오.

리소스

이 단계들을 Java 프로젝트에 통합하면 java add watermark excel 파일을 빠르게 추가할 수 있어 보안과 브랜드 일관성을 모두 보장합니다.

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