groupdocs watermark maven – Java로 다이어그램 워터마크 관리

문서에서 워터마크를 관리하는 것은 지적 재산을 보호하고 문서 무결성을 유지하는 데 필수적입니다. 이 튜토리얼에서는 .vsdx와 같은 다이어그램 파일에서 워터마크를 효율적으로 로드, 검색 및 제거하는 방법을 groupdocs watermark maven을 사용해 보여드립니다. 엔터프라이즈 소프트웨어를 구축하거나 문서 워크플로를 자동화하든, 이 기술을 마스터하면 다이어그램 워터마크 관리를 완벽히 제어할 수 있습니다.

빠른 답변

필요한 라이브러리는? GroupDocs.Watermark for Java (Maven을 통해 제공됩니다).
지원되는 다이어그램 형식은? .vsdx, .vdx 및 기타 Visio 형식.
텍스트와 이미지 워터마크를 모두 검색할 수 있나요? 예 – or()로 검색 기준을 결합합니다.
프로덕션에 라이선스가 필요합니까? 유효한 GroupDocs.Watermark 라이선스가 필요합니다.
Maven에 어떻게 통합하나요? 아래에 표시된 저장소와 의존성을 추가합니다.

groupdocs watermark maven이란?

groupdocs watermark maven은 GroupDocs.Watermark 라이브러리의 Maven 기반 통합을 의미합니다. pom.xml에 라이브러리를 선언하면 Maven이 필요한 모든 바이너리를 자동으로 해결해 주므로, 다이어그램을 로드하고, 워터마크를 검색하며, 프로그래밍 방식으로 제거하는 코드에 집중할 수 있습니다.

다이어그램 워터마크 관리에 GroupDocs.Watermark를 사용하는 이유

전체 기능 API – 다양한 다이어그램 유형에서 텍스트, 이미지 및 도형 워터마크를 지원합니다.
정밀한 제거 – 원본 다이어그램 레이아웃을 손상시키지 않고 워터마크를 제거합니다.
확장성 – 대량의 다이어그램 컬렉션을 배치 처리하기에 적합합니다.
Maven 친화적 – 간단한 의존성 관리로 프로젝트를 깔끔하게 유지합니다.

사전 요구 사항

Java Development Kit (JDK) 8+ – 라이브러리와 호환성을 보장합니다.
IDE – IntelliJ IDEA, Eclipse 또는 기타 Java 호환 편집기.
GroupDocs.Watermark for Java – Maven(권장) 또는 직접 JAR 다운로드로 추가합니다.

필수 라이브러리 및 의존성

Maven 설정

Add the following configuration to your pom.xml file:

<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 에서 최신 버전을 다운로드하십시오.

라이선스 획득

무료 체험: 체험 라이선스로 라이브러리를 테스트합니다.
임시 라이선스: 평가용 단기 키를 요청합니다.
구매: 무제한 사용을 위한 프로덕션 라이선스를 획득합니다.

groupdocs watermark maven을 사용하여 다이어그램 문서 로드하기

다이어그램 문서를 로드하는 것은 모든 워터마크 작업 전에 첫 번째 단계입니다. 아래는 DiagramLoadOptions와 함께 Watermarker 인스턴스를 생성하는 최소 예제입니다.

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

public class LoadDiagramDocument {
    public static void main(String[] args) {
        String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/diagram.vsdx";
        DiagramLoadOptions loadOptions = new DiagramLoadOptions();
        
        Watermarker watermarker = new Watermarker(inputFilePath, loadOptions);
        watermarker.close();
    }
}

매개변수:
- inputFilePath – .vsdx 파일 경로.
- loadOptions – 다이어그램 파싱 방식을 제어합니다(예: 비밀번호 보호).

groupdocs watermark maven을 사용한 워터마크 검색

텍스트 워터마크

텍스트 기반 워터마크를 찾으려면 TextSearchCriteria를 정의하고 다이어그램의 첫 페이지를 조회합니다.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.DiagramContent;
import com.groupdocs.watermark.search.TextSearchCriteria;
import com.groupdocs.watermark.search.PossibleWatermarkCollection;

public class SearchTextWatermarks {
    public static void main(String[] args) throws Exception {
        String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/diagram.vsdx";
        Watermarker watermarker = new Watermarker(inputFilePath);

        DiagramContent content = watermarker.getContent(DiagramContent.class);
        
        TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");
        PossibleWatermarkCollection possibleWatermarks = content.getPages().get_Item(0).search(textSearchCriteria);

        watermarker.close();
    }
}

핵심 메서드:
- TextSearchCriteria – 찾고자 하는 정확한 텍스트를 지정합니다.
- PossibleWatermarkCollection – 발견된 일치 항목을 저장합니다.

이미지 워터마크

다이어그램에 로고나 사진 워터마크가 포함된 경우, ImageDctHashSearchCriteria를 사용해 기준 이미지와 비교합니다.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.DiagramContent;
import com.groupdocs.watermark.search.ImageDctHashSearchCriteria;
import com.groupdocs.watermark.search.PossibleWatermarkCollection;

public class SearchImageWatermarks {
    public static void main(String[] args) throws Exception {
        String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/diagram.vsdx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/logo.png";
        
        Watermarker watermarker = new Watermarker(inputFilePath);
        DiagramContent content = watermarker.getContent(DiagramContent.class);

        ImageDctHashSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria(imagePath);
        PossibleWatermarkCollection possibleWatermarks = content.getPages().get_Item(0).search(imageSearchCriteria);

        watermarker.close();
    }
}

핵심 메서드:
- ImageDctHashSearchCriteria – 견고한 매칭을 위해 기준 이미지의 퍼셉추얼 해시를 생성합니다.

워터마크 제거

원하지 않는 워터마크를 식별한 후에는 이를 제거하고 다이어그램의 깨끗한 사본을 저장할 수 있습니다.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.DiagramContent;
import com.groupdocs.watermark.search.TextSearchCriteria;
import com.groupdocs.watermark.search.ImageDctHashSearchCriteria;
import com.groupdocs.watermark.search.PossibleWatermarkCollection;

public class RemoveWatermarks {
    public static void main(String[] args) throws Exception {
        String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/diagram.vsdx";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/updated_diagram.vsdx";

        Watermarker watermarker = new Watermarker(inputFilePath);
        DiagramContent content = watermarker.getContent(DiagramContent.class);

        TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");
        ImageDctHashSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("YOUR_DOCUMENT_DIRECTORY/logo.png");

        PossibleWatermarkCollection possibleWatermarks = content.getPages().get_Item(0).search(textSearchCriteria.or(imageSearchCriteria));
        possibleWatermarks.clear();

        watermarker.save(outputFilePath);
        watermarker.close();
    }
}

핵심 메서드: clear()는 결합된 기준으로 찾은 모든 워터마크를 제거하여 다이어그램을 그대로 유지합니다.

실용적인 적용 사례

엔터프라이즈 소프트웨어 통합 – 비즈니스 앱에 워터마크 관리를 삽입해 독점 다이어그램을 보호합니다.
콘텐츠 관리 시스템(CMS) – 게시 전 무단 로고를 자동으로 감지하고 제거합니다.
법률 문서 워크플로 – 계약 처리의 다양한 단계에서 워터마크를 추가하거나 제거합니다.

일반적인 문제 및 해결 방법

라이선스 오류: Watermarker를 생성하기 전에 라이선스 파일이 올바르게 참조되는지 확인합니다.
대용량 파일: 다이어그램이 100 MB를 초과할 경우 스트리밍 API를 사용하거나 JVM 힙 크기(-Xmx2g)를 늘립니다.
워터마크 미탐지: 검색 기준(텍스트 대소문자, 이미지 유사도 임계값)이 실제 워터마크와 일치하는지 확인합니다.

자주 묻는 질문

Q: 텍스트와 이미지를 동시에 검색할 수 있나요?
A: 예. 제거 예제와 같이 or()로 기준을 결합합니다.

Q: 워터마크를 제거해도 다이어그램 레이아웃이 변경되지 않나요?
A: 전혀 그렇지 않습니다. API가 워터마크 객체만 정확히 대상으로 하여 다른 모든 다이어그램 요소를 보존합니다.

Q: GroupDocs.Watermark가 지원하는 다이어그램 형식은 무엇인가요?
A: .vsdx, .vdx와 같은 Visio 형식 및 기타 벡터 다이어그램 형식을 지원합니다.

Q: 수백 개의 다이어그램을 효율적으로 처리하려면 어떻게 해야 하나요?
A: 배치 루프를 구현하고 가능하면 단일 Watermarker 인스턴스를 재사용하며, Java의 ExecutorService를 이용한 병렬 처리를 고려합니다.

Q: 워터마크 감지를 CI/CD 파이프라인에 통합할 수 있나요?
A: 예. 배포 전 다이어그램을 검증하기 위해 빌드 스크립트(예: Maven 플러그인 또는 Gradle 작업)에 Java 코드를 포함합니다.

결론

groupdocs watermark maven을 활용하면 Java로 다이어그램 파일에서 워터마크를 로드, 검색 및 제거하는 강력하고 Maven으로 관리되는 방법을 얻을 수 있습니다. 이 기능은 문서 보안을 강화하고 콘텐츠 워크플로를 간소화하며 대규모 문서 컬렉션에서도 손쉽게 확장됩니다.

마지막 업데이트: 2025-12-19
테스트 환경: GroupDocs.Watermark 24.11 for Java
작성자: GroupDocs