Java에서 Visio 다이어그램 만들기

Java 코드에서 직접 Visio 다이어그램을 생성하면 문서화 워크플로를 간소화하고 수동 그리기 작업을 없앨 수 있습니다. Conholdate.Total for Java은 Visio 파일을 프로그래밍 방식으로 생성할 수 있는 강력한 SDK를 제공합니다. 이 가이드에서는 Java에서 Visio 다이어그램을 만들고, 마스터 템플릿에서 도형을 추가하고, 위치를 지정하며, 텍스트 스타일을 적용합니다. 끝까지 진행하면 Microsoft Visio에서 추가로 편집할 수 있는 바로 열 수 있는 VSDX 파일을 얻게 됩니다.

Visio 다이어그램 생성 요구 사항

Enterprises often need to produce technical schematics, flowcharts, or network diagrams automatically from data sources. Java developers building reporting dashboards, configuration tools, or CI pipelines frequently face the requirement to generate Visio files without manual intervention. The solution must support master‑based shape creation, precise positioning, and text styling that matches existing Visio stencils. Manual drawing in Visio is time‑consuming and error‑prone, especially when diagrams must be regenerated on each build.

접근 방식: Conholdate.Total를 사용한 Visio 다이어그램 생성

Conholdate.Total for Java 은 VSDX 형식을 지원하는 전용 다이어그램 API를 제공합니다. 이를 통해 마스터 스텐실을 로드하고, 해당 마스터에서 도형을 추가하며, XForm 속성을 통해 도형의 위치를 재조정하고, 텍스트를 첨부하고, 미리 정의된 텍스트 스타일을 적용할 수 있으며, 모두 간단한 Java 호출로 수행됩니다. 다이어그램 클래스에 대한 문서는 공식 문서에서 확인할 수 있으며, 전체 API 참조는 API 참조에서 탐색할 수 있습니다. 이 라이브러리를 사용하면 서버 또는 데스크톱 환경에서 전체 Visio 생성 파이프라인을 자동화할 수 있습니다.

솔루션 구축: Java에서 Visio 다이어그램 만들기

다음 단계에서는 Maven 설정부터 최종 VSDX 파일 저장까지 전체 프로세스를 안내합니다.

Maven 종속성 추가 및 클래스 가져오기

먼저 Conholdate Maven 저장소를 구성하고 SDK 종속성을 pom.xml에 추가합니다.

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

이 튜토리얼에서 사용되는 다이어그램 클래스는 com.aspose.diagram 패키지에 있으며, Conholdate.Total for Java 번들의 일부로 제공됩니다:

import com.aspose.diagram.Diagram;
import com.aspose.diagram.Shape;
import com.aspose.diagram.TypeValue;
import com.aspose.diagram.Txt;
import com.aspose.diagram.SaveFileFormat;

다이어그램 초기화 및 마스터 도형 로드

새로운 Diagram 인스턴스를 만든 다음 스텐실 파일을 로드하고 도형의 기반이 될 마스터를 선택합니다. 여기서는 “Basic Shapes.vss” 스텐실에 포함된 내장 “Rectangle” 마스터를 사용합니다.

// Create a new instance of a diagram
Diagram diagram = new Diagram();

// Define the name of the master (template) to be used for creating shapes
String masterName = "Rectangle";
diagram.addMaster("Basic Shapes.vss", masterName);

마스터에서 도형을 추가하고 위치 설정

마스터를 사용하여 다이어그램에 도형을 추가한 다음, addShape가 반환하는 ID로 도형을 찾아 위치를 조정할 수 있습니다.

// Define the dimensions and position for the new shape
double width = 2, height = 2, pinX = 4.25, pinY = 4.5;

// Add a new rectangle shape to the diagram using the specified master
long rectangleId = diagram.addShape(pinX, pinY, width, height, masterName, 0);

// Retrieve the shape by its ID for modification
Shape rectangle = diagram.getPages().get(0).getShapes().getShape(rectangleId);

// Set the position of the shape by modifying its PinX and PinY properties
rectangle.getXForm().getPinX().setValue(5);
rectangle.getXForm().getPinY().setValue(5);

// Set the type of the shape to indicate it is a standard shape
rectangle.setType(TypeValue.SHAPE);

텍스트 추가 및 텍스트 스타일 적용

텍스트 실행을 도형에 연결하고 다이어그램에 미리 정의된 스타일 시트 중 하나를 적용하여 레이블이 문서의 나머지 부분과 일치하도록 합니다.

// Add text to the shape
rectangle.getText().getValue().add(new Txt("Aspose Diagram"));

// Apply a predefined text style to the shape's text
rectangle.setTextStyle(diagram.getStyleSheets().get(3));

다이어그램을 VSDX로 저장

마지막으로, 다이어그램을 Microsoft Visio에서 열 수 있는 VSDX 파일에 저장합니다.

diagram.save("Visio_out.vsdx", SaveFileFormat.VSDX);