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