[java] Apache POI를 이용한 Word 문서 링크 설정

17 Nov 2023

java

Apache POI는 Java에서 Microsoft Office 문서를 다루기 위한 오픈 소스 라이브러리입니다. 이 라이브러리를 사용하여 Word 문서에서 링크를 설정하는 방법을 알아보겠습니다.

먼저, Apache POI의 종속성을 프로젝트에 추가해야 합니다. Maven을 사용한다면 다음과 같이 pom.xml 파일에 종속성을 추가합니다:

<dependencies>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>4.1.2</version>
    </dependency>
</dependencies>

다음으로, Word 문서를 생성하고 링크를 추가하는 예제 코드를 작성해보겠습니다:

import org.apache.poi.xwpf.usermodel.*;
import java.io.FileOutputStream;
import java.io.IOException;

public class WordLinkExample {
    public static void main(String[] args) {
        XWPFDocument document = new XWPFDocument();

        // 링크를 추가할 문단 생성
        XWPFParagraph paragraph = document.createParagraph();
        
        // 링크 추가를 위한 하이퍼링크 객체 생성
        String linkUrl = "https://example.com";
        XWPFHyperlinkRun link = paragraph.createHyperlinkRun(linkUrl);

        // 링크 텍스트 설정
        link.setText("클릭하여 사이트에 접속하세요");

        // Word 문서에 저장
        try (FileOutputStream out = new FileOutputStream("example.docx")) {
            document.write(out);
            System.out.println("Word 문서 생성 완료.");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위의 예제 코드에서는 XWPFDocument 클래스를 사용하여 Word 문서를 생성합니다. XWPFParagraph 클래스를 사용하여 링크를 추가할 문단을 생성하고, XWPFHyperlinkRun 클래스를 사용하여 실제 링크를 생성합니다. 링크의 URL은 문자열로 지정하며, setText 메서드를 사용하여 링크의 텍스트를 설정할 수 있습니다.

링크를 설정한 후에는 XWPFDocument 객체를 파일로 저장하면 됩니다. FileOutputStream 클래스를 사용하여 파일로 저장하고, write 메서드를 호출하여 실제 파일에 쓰는 작업을 수행합니다.

위의 예제 코드를 실행하면 “example.docx”라는 파일이 생성되고, 해당 파일을 열어보면 링크가 포함된 Word 문서를 확인할 수 있습니다.

이렇게 Apache POI를 사용하여 Word 문서에 링크를 설정할 수 있습니다. 더 자세한 정보는 Apache POI 공식 문서를 참고하시기 바랍니다.