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

14 Nov 2023

java

Apache POI는 Java에서 Microsoft Office 파일을 다루는 데 사용되는 라이브러리입니다. 이 라이브러리를 사용하여 Excel 파일의 데이터 유효성 검사 메시지를 설정하는 방법을 살펴보겠습니다.

1. Apache POI 라이브러리 추가하기

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

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

2. Excel 파일 열기 및 데이터 유효성 검사 메시지 추가하기

Excel 파일을 열고 데이터 유효성 검사 메시지를 추가하려면 다음과 같은 단계를 따릅니다.

// 1. Excel 파일 열기
Workbook workbook = WorkbookFactory.create(new File("경로/파일명.xlsx"));

// 2. 유효성 검사 규칙 생성하기
DataValidationHelper validationHelper = workbook.getCreationHelper().createDataValidationHelper();
DataValidationConstraint constraint = validationHelper.createFormulaListConstraint("목록1,목록2,목록3");

// 3. 유효성 검사 규칙 적용할 셀 범위 설정하기
CellRangeAddressList addressList = new CellRangeAddressList(0, 10, 0, 0); // 첫 번째 열의 0번째 부터 10번째까지의 행을 선택

// 4. 유효성 검사 규칙 생성 및 셀에 적용하기
DataValidation validation = validationHelper.createValidation(constraint, addressList);
workbook.getSheetAt(0).addValidationData(validation);

// 5. 변경된 내용 저장하기
FileOutputStream fileOut = new FileOutputStream("경로/새로운_파일명.xlsx");
workbook.write(fileOut);
fileOut.close();

// 6. Workbook 객체 닫기
workbook.close();

위의 예시 코드에서는 Excel 파일을 열고 첫 번째 열의 0번째 행부터 10번째 행까지의 셀에 데이터 유효성 검사 메시지를 설정하는 방법을 보여줍니다. “목록1,목록2,목록3”과 같은 문자열 목록을 유효성 검사 규칙으로 만들어 적용한 후 변경된 내용을 새로운 파일로 저장합니다.

3. 결과 확인하기

위의 코드를 실행하여 Excel 파일에 데이터 유효성 검사 메시지를 설정한 후 결과를 확인할 수 있습니다. Excel 파일을 열어 유효성 검사가 적용된 셀을 클릭하면 설정한 목록 중에서 선택할 수 있습니다.

이제 Java Apache POI를 사용하여 Excel 파일의 데이터 유효성 검사 메시지를 설정하는 방법을 알게 되었습니다. 추가로 사용할 수 있는 다양한 기능과 설정에 대해서는 Apache POI 공식 문서를 참고하시기 바랍니다.