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

14 Nov 2023

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>

데이터 유효성 검사 오류 메시지 설정하기

아래는 Apache POI를 사용하여 Excel 파일의 데이터 유효성 검사 오류 메시지를 설정하는 예제 코드입니다:

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

public class ExcelValidationExample {
    public static void main(String[] args) throws Exception {
        // Excel 파일 로드
        Workbook workbook = WorkbookFactory.create(new File("path/to/excel_file.xlsx"));

        // 첫 번째 시트 선택
        Sheet sheet = workbook.getSheetAt(0);

        // 데이터 유효성 검사 규칙 생성
        DataValidationHelper validationHelper = sheet.getDataValidationHelper();
        CellRangeAddressList addressList = new CellRangeAddressList(1, sheet.getLastRowNum(), 0, 0); // 유효성 검사가 필요한 열 범위 설정
        DataValidationConstraint constraint = validationHelper.createCustomConstraint("=A1:A10"); // 유효성 검사 규칙 생성
        DataValidation validation = validationHelper.createValidation(constraint, addressList); // 유효성 검사 생성

        // 오류 메시지 설정
        validation.createErrorBox("유효성 검사 오류", "잘못된 값입니다. 올바른 값을 입력하세요.");

        // 시트에 유효성 검사 적용
        sheet.addValidationData(validation);

        // Excel 파일 저장
        FileOutputStream outputStream = new FileOutputStream("path/to/output_file.xlsx");
        workbook.write(outputStream);
        outputStream.close();

        System.out.println("데이터 유효성 검사 오류 메시지가 설정되었습니다.");
    }
}

위 코드는 path/to/excel_file.xlsx라는 Excel 파일에서 첫 번째 시트의 첫 번째 열에 데이터 유효성 검사를 적용하고, 오류 메시지를 설정한 뒤, 새로운 Excel 파일인 path/to/output_file.xlsx로 저장하는 예제입니다.

결론

Java Apache POI를 사용하여 Excel 파일의 데이터 유효성 검사 오류 메시지를 설정하는 방법을 알아보았습니다. 이를 통해 Excel 파일에 사용자 정의 오류 메시지를 표시할 수 있으며, 데이터의 정확성과 유효성을 유지할 수 있습니다. 추가적인 정보는 Apache POI 공식 문서를 참고하시기 바랍니다.