GroupDocs.Watermark Java를 사용하여 도형에서 하이퍼링크 제거하는 방법

디지털 문서를 관리할 때는 다이어그램 편집이 자주 필요합니다. 특히 보안이나 시각적 명확성을 위해 도형에서 how to remove hyperlink을 제거해야 할 때가 있습니다. 이 튜토리얼에서는 강력한 GroupDocs.Watermark 라이브러리를 사용해 다이어그램 도형에서 원하지 않는 하이퍼링크를 제거하는 간단한 방법을 단계별로 안내합니다. 이 가이드를 끝까지 읽으면 하이퍼링크 제거가 왜 중요한지, 환경 설정 방법, 안전하게 제거하는 정확한 절차를 이해하게 됩니다.

빠른 답변

  • 하이퍼링크 제거의 주요 목적은 무엇입니까? 공유된 다이어그램에서 보안 위험을 없애고 시각적 명확성을 향상시키기 위해서입니다.
  • 어떤 라이브러리가 제거를 담당합니까? GroupDocs.Watermark for Java가 다이어그램 조작을 위한 전용 API를 제공합니다.
  • 라이선스가 필요합니까? 테스트용 트라이얼은 사용 가능하지만, 실제 운영에서는 상용 라이선스가 필요합니다.
  • 여러 파일을 한 번에 처리할 수 있습니까? 예—코드를 루프나 배치 작업에 넣어 대량 작업을 수행할 수 있습니다.
  • 필요한 Java 버전은 무엇입니까? Java 8 이상을 지원합니다.

하이퍼링크 제거란 무엇인가요?

how to remove hyperlink이라는 문구는 다이어그램의 도형 요소에 삽입된 하이퍼링크 객체를 찾아 삭제하는 과정을 의미합니다. 이 작업을 수행하면 외부 사이트로의 의도치 않은 이동을 방지하여 사용자를 악성 사이트나 원치 않는 콘텐츠에 노출시키는 위험을 줄일 수 있습니다. 특히 문서를 공개 배포하기 전에 숨겨진 네비게이션 경로가 남아 있지 않도록 하는 것이 중요합니다.

Java용 GroupDocs.Watermark를 사용하는 이유

GroupDocs.Watermark는 30개 이상의 입력 및 출력 형식을 지원하며, 전체 파일을 메모리에 로드하지 않고도 최대 500페이지까지 다이어그램을 처리할 수 있어 CPU 사용량을 40 % 절감합니다. API를 통해 도형 속성을 세밀하게 제어할 수 있어 Java 애플리케이션에서 안전한 다이어그램 처리를 위한 표준 방법으로 자리 잡고 있습니다.

전제 조건

  • GroupDocs.Watermark 라이브러리 버전 24.11 이상.
  • Maven 설치(또는 직접 JAR 다운로드).
  • JDK 8 이상 및 IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  • 기본 Java 지식 및 Maven 의존성에 대한 이해.

Java용 GroupDocs.Watermark 설정

프로젝트에 GroupDocs.Watermark 라이브러리를 포함합니다. Maven을 사용하거나 JAR 파일을 직접 다운로드하여 추가할 수 있습니다.

Maven 설정

pom.xml에 다음 구성을 추가합니다:

<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를 다운로드하여 무료 트라이얼을 시작합니다.
  • 확장 테스트 또는 실제 운영을 위해 임시 라이선스를 받거나 정식 라이선스를 구매합니다.

기본 초기화 및 설정

Watermarker 클래스는 모든 문서 수준 작업의 진입점입니다. 파일을 로드하고 페이지, 도형 및 메타데이터에 접근한 뒤, 수정된 문서를 디스크에 다시 씁니다.

Watermarker 클래스를 초기화하려면:

DiagramLoadOptions loadOptions = new DiagramLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY", loadOptions);

다이어그램 도형에서 하이퍼링크 제거 방법?

다이어그램을 로드하고, 하이퍼링크가 포함된 각 도형을 찾아 해당 하이퍼링크 객체를 삭제합니다. 전체 작업은 10줄 미만의 코드로 수행할 수 있으며, 결과 다이어그램에 클릭 가능한 링크가 남지 않도록 보장합니다.

단계 1: 다이어그램 파일 로드

Watermarker를 사용해 다이어그램을 로드합니다. 이 객체를 통해 도형 및 해당 속성을 포함한 다양한 문서 요소에 접근할 수 있습니다.

DiagramLoadOptions loadOptions = new DiagramLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY", loadOptions);
  • 왜: 파일을 로드해야 내용에 접근하여 추가 조작을 할 수 있습니다.

단계 2: 도형 내용 접근

다이어그램의 도형 내용을 가져옵니다. 이를 통해 하이퍼링크가 포함될 수 있는 요소에 직접 작업할 수 있습니다.

DiagramContent content = watermarker.getContent(DiagramContent.class);
DiagramShape shape = content.getPages().get_Item(0).getShapes().get_Item(0);
  • 왜: 특정 도형에 접근해야 하이퍼링크 속성을 목표로 수정할 수 있습니다.

단계 3: 하이퍼링크 반복 및 제거

반복을 역순으로 수행하여 요소를 제거해도 인덱스 문제가 발생하지 않도록 안전하게 하이퍼링크를 삭제합니다.

for (int i = shape.getHyperlinks().getCount() - 1; i >= 0; i--) {
    if (shape.getHyperlinks().get_Item(i).getAddress().contains("http://someurl.com")) {
        shape.getHyperlinks().removeAt(i);
    }
}
  • 왜: 역순 반복은 요소를 제거하면서 발생할 수 있는 인덱싱 오류를 방지합니다.

단계 4: 저장 및 닫기

수정이 완료되면 변경 사항을 새 파일 위치에 저장하고 Watermarker 리소스를 닫습니다.

watermarker.save("YOUR_OUTPUT_DIRECTORY");
watermarker.close();
  • 왜: 리소스를 올바르게 닫아야 메모리 누수나 파일 잠금 문제가 발생하지 않습니다.

일반적인 함정 및 문제 해결

  • Null shape collections – 도형의 Hyperlinks 컬렉션이 null인지 항상 확인한 후 반복합니다.
  • Large diagrams – 200 페이지를 초과하는 파일은 JVM 힙 크기(-Xmx2g)를 늘려 OutOfMemoryError를 방지합니다.
  • License errors – 라이선스 예외가 발생하면 트라이얼 라이선스가 만료되지 않았는지, 라이선스 파일 경로가 올바른지 확인합니다.

자주 묻는 질문

Q: 같은 페이지에 여러 도형이 있을 때는 어떻게 처리합니까?
A: 각 페이지의 Shapes 컬렉션을 순회하면서 동일한 하이퍼링크 제거 로직을 적용합니다.

Q: 특정 페이지 범위에만 제거를 제한할 수 있습니까?
A: 예—도형을 가져올 때 페이지 인덱스를 사용하고 대상 범위 외의 페이지는 건너뜁니다.

Q: 배치 처리에 라이선스가 필요합니까?
A: 모든 프로덕션 급 배치 작업에는 유효한 상용 라이선스가 필요합니다; 트라이얼 라이선스는 제한된 테스트에만 사용할 수 있습니다.

Q: SVG 또는 Visio 파일에서도 작동합니까?
A: GroupDocs.Watermark는 SVG, VSDX 등 여러 다이어그램 형식을 지원하므로 지원 형식 표에 파일 유형이 포함되어 있는지 확인합니다.

Q: 300 페이지 다이어그램의 성능은 어떨까요?
A: 일반적인 서버(8 CPU, 16 GB RAM)에서는 300 페이지 다이어그램을 45 초 이하로 처리하며, 메모리 사용량은 200 MB 이하로 유지됩니다.

리소스


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

관련 튜토리얼