[java] Apache POI를 이용한 Word 문서 디버깅

17 Nov 2023

java

자바에서 Word 문서를 다루는 작업은 종종 필요한 일입니다. Apache POI라는 라이브러리는 Word, Excel, PowerPoint 등의 Microsoft Office 문서를 다루기 위한 강력한 기능을 제공합니다. 이번 포스트에서는 Apache POI를 사용하여 Word 문서를 디버깅하는 방법에 대해 알아보겠습니다.

Apache POI란?

Apache POI는 자바에서 Microsoft Office 파일 형식을 다루기 위한 라이브러리입니다. 여기서는 Apache POI의 Word 파일 다루기 기능에 대해 다룰 예정입니다. Apache POI는 오픈 소스 프로젝트로 개발되어 있으며, 다양한 형식의 Office 파일을 생성, 수정 및 읽기 등의 작업을 수행할 수 있습니다.

Word 문서 디버깅을 위한 Apache POI 사용 방법

Dependency 추가: 먼저, Maven이나 Gradle과 같은 빌드 도구를 사용하여 프로젝트에 Apache POI를 추가해야 합니다. 아래는 Maven을 사용하는 경우의 예시입니다.

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>{버전}</version>
</dependency>

적절한 버전을 선택하여 위의 dependency를 프로젝트의 pom.xml 파일에 추가합니다.

Word 문서 읽기: Apache POI를 사용하여 Word 문서를 읽어오려면 XWPFDocument 클래스를 사용해야 합니다. 아래는 Word 문서를 읽어와서 콘솔에 출력하는 예시입니다.

import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;

public class WordDocumentDebugging {
    public static void main(String[] args) {
        try {
            FileInputStream fis = new FileInputStream(new File("문서경로/문서이름.docx"));
            XWPFDocument document = new XWPFDocument(fis);
            
            for (XWPFParagraph paragraph : document.getParagraphs()) {
                System.out.println(paragraph.getText());
            }
            
            document.close();
            fis.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위의 코드는 XWPFDocument 객체를 생성한 후, getParagraphs() 메서드를 사용하여 모든 문단을 가져와서 콘솔에 출력합니다.

Word 문서 수정: Word 문서를 수정하기 위해서는 XWPFDocument 객체를 이용해야 합니다. 아래는 Word 문서에서 특정 문장을 찾아 수정하는 예시입니다.

import org.apache.poi.xwpf.usermodel.*;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

public class WordDocumentDebugging {
    public static void main(String[] args) {
        try {
            FileInputStream fis = new FileInputStream(new File("문서경로/문서이름.docx"));
            XWPFDocument document = new XWPFDocument(fis);
            
            for (XWPFParagraph paragraph : document.getParagraphs()) {
                String text = paragraph.getText();
                if (text.contains("특정 문장")) {
                    text = text.replace("특정 문장", "수정된 문장");
                    paragraph.getRuns().get(0).setText(text, 0);
                }
            }
            
            FileOutputStream fos = new FileOutputStream(new File("문서경로/수정된 문서이름.docx"));
            document.write(fos);
            
            document.close();
            fis.close();
            fos.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위의 코드는 getParagraphs() 메서드를 사용하여 모든 문단을 가져온 후, 특정 문장을 찾아 수정합니다. 수정된 내용은 setText() 메서드를 사용하여 적용됩니다.

결론

Apache POI를 사용하면 자바에서 Word 문서의 생성, 수정, 읽기 등의 작업을 편리하게 할 수 있습니다. 이번 포스트에서는 Apache POI를 사용하여 Word 문서를 디버깅하는 방법에 대해 알아보았습니다. Apache POI의 기능과 API 문서를 참조하여 자세한 사용 방법을 익히시기 바랍니다.

참고 자료

Apache POI 공식 웹사이트: https://poi.apache.org/
Apache POI API 문서: https://poi.apache.org/apidocs/