[java] Java Apache POI를 사용하여 Excel 파일의 데이터 유효성 검사 오류 경고 설정하기

14 Nov 2023

java

Apache POI는 Java에서 Microsoft Office 파일(예: Excel, Word)을 다룰 수 있는 라이브러리입니다. 이 라이브러리를 사용하면 Java 프로그램에서 Excel 파일을 생성, 읽기, 수정 및 삭제할 수 있습니다. 이 글에서는 Apache POI를 사용하여 Excel 파일의 데이터 유효성 검사 오류 경고를 설정하는 방법을 알아보겠습니다.

Apache POI 의존성 추가하기

먼저 프로젝트에 Apache POI 의존성을 추가해야 합니다. Maven을 사용하는 경우 pom.xml 파일에 다음 의존성을 추가합니다:

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

Gradle을 사용하는 경우 build.gradle 파일에 다음 의존성을 추가합니다:

implementation 'org.apache.poi:poi:4.1.2'

Excel 파일 생성하기

Apache POI를 사용하여 Excel 파일을 생성하는 방법은 다음과 같습니다:

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

public class ExcelWriter {

    public static void main(String[] args) {
        Workbook workbook = new XSSFWorkbook();
        Sheet sheet = workbook.createSheet("Sheet1");

        // 데이터 입력 및 유효성 검사 규칙 설정

        // 파일 저장
        try (FileOutputStream outputStream = new FileOutputStream("example.xlsx")) {
            workbook.write(outputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위의 예제에서는 XSSFWorkbook 클래스를 사용하여 Workbook 객체를 생성합니다. 옵션으로 HSSFWorkbook 클래스를 사용하여 .xls 파일을 생성할 수도 있습니다.

Workbook 객체에서 createSheet 메서드를 호출하여 시트를 생성합니다. 생성한 시트에 데이터를 입력하고, 유효성 검사 규칙을 설정할 수 있습니다.

유효성 검사 오류 경고 설정하기

Apache POI를 사용하여 유효성 검사 오류 경고를 설정하기 위해 Sheet 객체의 addValidationData 메서드를 사용합니다. 다음 예제는 Sheet 객체에 날짜 유효성 검사 규칙을 추가하는 방법을 보여줍니다:

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.ss.util.CellRangeAddressList;
import org.apache.poi.xssf.usermodel.XSSFDataValidation;
import org.apache.poi.xssf.usermodel.XSSFSheet;

public class ExcelValidation {

    public static void main(String[] args) {
        Workbook workbook = new XSSFWorkbook();
        Sheet sheet = workbook.createSheet("Sheet1");

        // 데이터 입력

        DataValidationHelper validationHelper = sheet.getDataValidationHelper();
        CellRangeAddressList addressList = new CellRangeAddressList(0, 0, 0, 0);
        DataValidationConstraint constraint = validationHelper.createDateConstraint(
                DataValidationConstraint.OperatorType.BETWEEN,
                "2022-01-01", "2022-12-31", "yyyy-mm-dd");
        DataValidation validation = validationHelper.createValidation(constraint, addressList);
        sheet.addValidationData(validation);

        // 파일 저장
        try (FileOutputStream outputStream = new FileOutputStream("example.xlsx")) {
            workbook.write(outputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위의 예제에서는 DataValidationHelper 클래스를 사용하여 CellRangeAddressList를 생성하고, DataValidation 객체를 생성합니다. 이후 Sheet 객체의 addValidationData 메서드를 호출하여 유효성 검사 규칙을 추가합니다.

위의 예제는 날짜 형식의 유효성 검사 규칙을 추가하였지만, Apache POI는 다양한 유효성 검사 규칙을 지원합니다. 자세한 내용은 Apache POI 문서를 참고하십시오.

결론

이렇게 Java에서 Apache POI를 사용하여 Excel 파일의 데이터 유효성 검사 오류 경고를 설정하는 방법을 알아보았습니다. Apache POI의 다양한 기능을 활용하여 Excel 파일을 자유롭게 다룰 수 있습니다. 추가적인 정보는 Apache POI 공식 웹사이트를 참조하십시오.