java(spring) poi 라이브러리 적용하기 ( 자바 엑셀 다운 예제 POI)

자바를 많이쓰고, 그중에 웹 분야에서는 스프링 프레임워크를 많이 쓰기때문에

통계작업이나 국가기반사업 혹은 CMS 관련 분야에서는 POI를 활용한 엑셀다운을

많이 쓰는것 같아요 .

POI를 적용해보면서 간혹 막히는 부분마다 힘들게 구글링을 했던적이 있어서

검색해도 잘 안나오는 기능들과 모든 기능을 한번씩 사용해봤습니다 ~

jsp와 java 전체소스도 포함되어 있으니 참고하세요.

▶ 먼저 스프링 레거시 프로젝트 (mvc) + maven 기반으로 프로젝트를 생성해준다.

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

▶ 프로젝트 구조잡기 ( PoiController.java 추가 )

굳이 jsp를 추가하지 않고 기본으로 생성되는 home.jsp를 활용하겠다.

PoiController.java를 추가해주면 된다.

src/main/resources/ 밑에 template/img 밑에 test.jpg 를 넣어두었는데

엑셀파일에 이미지 삽입을 위한 사진이다.

결론은 home.jsp는 그대로 사용하고 poiController.java와 test.jpg만 추가해주면 끝!

▶ jsp 작성하기

직접 작성하는 분들은 utf-8 설정을 해주길 바래요~~

ExcelForm은 실제로 데이터를 날짜조회를 한것처럼 예시를 들어봤다.

예를들어 5월1일 부터 5월 30일을 사용자로부터 입력받아서

그 날짜 데이터를 통해 DB를 조회해서 엑셀로 다운로드하는것처럼 !!!!

그래서 엑셀다운 버튼을 클릭하면 formData를 가지고,

poiExcel() 이라는 함수를 타고, /poiExcel uri로 가져갈거다 !

/poiExcel 은 아직 컨트롤러를 작성하지 않았지만, 편의상 미리 작성.

home.jsp 소스 참고

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> <%@ page session="false" %> <%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%> <html> <head> <title>Home</title> </head> <body> <h1> Hello world! </h1> 엑셀로 다운로드를 해보자 <br> <form id="ExcelForm" name="ExcelForm">  <input type="hidden" id="day1" name="day1" value="2021-05-01" /> <input type="hidden" id="day2" name="day2" value="2021-05-30" /> </form> <button onclick='javascript:poiExcel()'>엑셀 다운</button> </body> <script src="https://code.jquery.com/jquery-2.2.1.js"></script> <script type="text/javascript"> function poiExcel() { var formObj = $('#ExcelForm'); formObj.attr('action', '/poiExcel'); formObj.attr('method', 'post'); formObj.submit(); } </script> </html>

▶ poiController.java 작성하기 (1) - 전체 소스는 맨 아래

컨트롤러의 구조를 갖춰주고.

웹에서 넘어온 day1 과 day2 를 잘 받아서 출력해본다.

콘솔창에 2021-05-01 ~ 2021-05-30 이라고 잘 뜨면 컨트롤러 연결이 잘 된것이다 !

그리고 날짜조회를 통해 DB에서 받아온 것처럼 list 에 데이터를 넣어주자 !

▶ poiController.java 작성하기 (2) - 전체 소스는 맨 아래

작성한 list 하단부에 작성해주면 된다 !!!!!

주석으로 설명이 되어있지만.

Workbook 는 엑셀 객체를 생성한다는 개념.

Sheet는 엑셀의 시트

CellStyle는 엑셀의 셀 스타일

Font 는 엑셀의 글씨스타일

Row 는 행, Col 은 열, Cell 은 셀

setCellValue 는 셀에 값을 넣는 개념이다.

순서는 row(행)를 생성하고, col(열)을 작성한 후에 Cell에 적용하는 개념이다.

예를 들어 첫번째행 첫번째열이면 교차점인 첫번째줄의 첫번째 셀이 되는 것이다.

하단의 빨간 네모는 엑셀을 파일로 생성해주는 부분.

이부분까지만 작성하고 톰캣을 실행하여

엑셀다운 버튼을 클릭해봐도 엑셀다운로드가 가능하다 !!!!

타이틀을 작성해서 삽입해놨기때문에 !!!!

▶ poiController.java 작성하기 (3) - 전체 소스는 맨 아래

엑셀파일을 생성해주는 소스코드 위에다가 작성을 해주어야한다 ! ( 헷갈리면 전체소스 참고 )

Cell을 만들고 Cell.setCellValue(" ") ;

이 안에 값을 넣으면 해당 셀에 값이 들어간다.

첫번째 셀에는 순번 이라는 문자열을

두번째 셀에는 이름 이라는 문자열을 삽입했다고 보면 된다 !

▶ poiController.java 작성하기 (4) - 전체 소스는 맨 아래

for문을 통해서 list를 엑셀에 담는 부분이다.

맨 아래부분의 setCellFormula(""); 는 엑셀의 함수식을 적용할 수 있다.

▶ poiController.java 작성하기 (5) - 전체 소스는 맨 아래

엑셀파일에 사진까지 삽입해보자 !!!

src/resources/template/img에 저장해두었던 test.jpg 경로를 작성하고.

anchor.setRow 에는 사진이 삽입될 행을

anchor.setCol 에는 사진이 삽입될 열을 작성해주면된다.

▶ poiController.java 작성하기 (6) - 전체 소스는 맨 아래

작성 후 프로젝트 Run AS 를 통해 톰캣을 올리고 웹 브라우저를 실행해서

엑셀다운 버튼을 클릭해보자 !

그럼 정상적으로 엑셀이 다운로드 된다.

자바에서 작성한대로 엑셀에 잘 담아졌다 !!!

▶ poiController.java 전체소스

poiController.java 소스코드

import java.io.FileInputStream; import java.io.InputStream; import java.util.ArrayList; import java.util.List; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.poi.hssf.usermodel.HSSFCellStyle; import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.apache.poi.ss.usermodel.Cell; import org.apache.poi.ss.usermodel.CellStyle; import org.apache.poi.ss.usermodel.ClientAnchor; import org.apache.poi.ss.usermodel.CreationHelper; import org.apache.poi.ss.usermodel.Drawing; import org.apache.poi.ss.usermodel.Font; import org.apache.poi.ss.usermodel.Picture; import org.apache.poi.ss.usermodel.Row; import org.apache.poi.ss.usermodel.Sheet; import org.apache.poi.ss.usermodel.Workbook; import org.apache.poi.ss.util.CellRangeAddress; import org.apache.poi.util.IOUtils; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; @Controller public class PoiController { @RequestMapping(value = "/poiExcel", method = RequestMethod.POST) public void poiTest(Model model, HttpServletResponse response, HttpServletRequest request) throws Exception{ String day1 = request.getParameter("day1"); // 2021-05-01 String day2 = request.getParameter("day2"); // 2021-05-30 /* 실제로는 DB 데이터를 추출하는 경우가 많기 때문에 날짜데이터를 예시로 든다면. 웹에서 사용자가 day1 과 day2 를 넘겨주고. 컨트롤러에서 service로 데이터를 넘기고. dao에서 mapper를 통해 day1 과 day2 날짜 사이의 데이터들을 출력할 것이다. 그 데이터들은 list 에 담아서 활용한다고 가정해보자 ! */ List<String> list = new ArrayList<String>(); // 활용 팁 : service dao 를 통해 입력받은 2021-05-01 ~ 2021-05-30 일자로 // 데이터 조회를 후 list에 담았다고 가정하자. list.add("박상자"); // 샘플데이터1 list.add("김때찌"); // 샘플데이터2 list.add("안먹어"); // 샘플데이터3 list.add("김철도"); // 샘플데이터4 list.add("강배추"); // 샘플데이터5 Workbook wb = new HSSFWorkbook(); // 엑셀파일 객체 생성 Sheet sheet = wb.createSheet("테스트 시트"); //시트 생성 ( 첫번째 시트이며, 시트명은 테스트 시트 ) CellStyle style = wb.createCellStyle(); // 셀 스타일 생성 Font font = wb.createFont(); // 폰트 스타일 생성 font.setBoldweight(Font.BOLDWEIGHT_BOLD); // 글자 진하게 font.setFontHeight((short)(16*18)); // 글자 크기 font.setFontName("맑은 고딕"); // 글씨체 // 자바의 배열처럼 첫번째 인덱스가 0 부터 시작한다. 첫번째는 0 , 두번째는 1 , 세번째는 2 Row titleRow = sheet.createRow(0); // 타이틀행을 생성한다. 첫번째줄이기때문에 createRow(0) int titleColNum = 0; // 첫번째 열이기 때문에 0 Cell titleCell = titleRow.createCell(titleColNum); // 첫번째행의 첫번째열을 지정한다. titleCell.setCellValue("안녕하세요 \n 테스트입니다."); // setCellValue 셀에 값넣기. titleRow.setHeight((short)920); // Row에서 setHeight를 하면 행 높이가 조정된다. sheet.addMergedRegion(new CellRangeAddress(0,0,0,9)); // 셀 병합 첫번째줄~아홉번째 열까지 병합 // new CellRangeAddress(시작 row, 끝 row, 시작 col, 끝 col) style.setWrapText(true); //문자열을 입력할때 \n 같은 개행을 인식해준다. style.setVerticalAlignment(HSSFCellStyle.VERTICAL_CENTER); // 수직 가운데 정렬 style.setAlignment(CellStyle.ALIGN_CENTER); // 수평 가운데 정렬 style.setFont(font); // 스타일에 font 스타일 적용하기 titleCell.setCellStyle(style); // 정리한 스타일들을 titleCell에 적용해주자 ! //입력받은 날짜 출력하기 Row dayRow = sheet.createRow(1); int dayCol = 0; Cell dayCell = dayRow.createCell(dayCol); // 두번째줄의 첫번째열을 셀로 지정. 즉 두번째줄 첫째칸 dayCell.setCellValue("조회날짜 : " + day1 + " ~ " + day2); // 두번째 행은 입력받은 날짜를 출력 //헤더 만들기 Row headerRow = sheet.createRow(3); // 네번째줄 생성 int headerCol = 0; Cell headerCell = headerRow.createCell(headerCol++); headerCell.setCellValue("순번"); headerCell = headerRow.createCell(headerCol); headerCell.setCellValue("이름"); CellStyle dataStyle = wb.createCellStyle(); // 데이터스타일은 테두리를 만들어보자 dataStyle.setBorderRight(HSSFCellStyle.BORDER_THIN); //오른쪽 테두리 dataStyle.setBorderLeft(HSSFCellStyle.BORDER_THIN); //왼쪽 테두리 dataStyle.setBorderTop(HSSFCellStyle.BORDER_THIN); // 상단 테두리 dataStyle.setBorderBottom(HSSFCellStyle.BORDER_THIN); // 하단 테두리 //데이터 삽입하기 int rowNum = 4; // 네번째줄이 헤더니까 그 밑에서부터 데이터 삽입 int cellNum = 0; Row dataRow = null; // for문을 돌려주기위해. Cell dataCell = null; for(int i = 0; i<list.size(); i++) { cellNum = 0; dataRow = sheet.createRow(rowNum++); // for문 돌면서 행 1줄씩 추가 dataCell = dataRow.createCell(cellNum++); //열 한줄씩 추가 dataCell.setCellValue(i+1); // 첫번째칸은 순번이기때문에 dataCell.setCellStyle(dataStyle); // 테두리 스타일 적용 dataCell = dataRow.createCell(cellNum); // 두번째 열은 이름이니까 dataCell.setCellValue(list.get(i)); // list에 저장된 이름 출력 dataCell.setCellStyle(dataStyle); // 테두리 스타일 적용 } dataRow = sheet.createRow(rowNum++); // 총 인원을 작성해보자 dataCell = dataRow.createCell(0); // 첫번쨰칸 dataCell.setCellValue("총 인원"); dataCell = dataRow.createCell(1); // 두번쨰칸 dataCell.setCellFormula("COUNT(A5:A9)"); // 함수식을 입력할 수 있는 기능 try { /* 사진 삽입 */ String filePath = "template/img/test.jpg"; InputStream is = new FileInputStream(getClass().getClassLoader().getResource(filePath).getFile()); byte[] bytes = IOUtils.toByteArray(is); int picIdx = wb.addPicture(bytes, XSSFWorkbook.PICTURE_TYPE_PNG); is.close(); CreationHelper helper = wb.getCreationHelper(); Drawing drawing = sheet.createDrawingPatriarch(); ClientAnchor anchor = helper.createClientAnchor(); // 이미지 출력할 엑셀 cell,row 위치 anchor.setRow1(12); //13번째줄 anchor.setCol1(4); //3번째 셀 //이미지 그리기 Picture pic = drawing.createPicture(anchor, picIdx); pic.resize(); } catch (Exception e) { e.printStackTrace(); } /* 엑셀 파일 생성 */ response.setContentType("ms-vnd/excel"); response.setHeader("Content-Disposition", "attachment;filename=poiTest.xls"); wb.write(response.getOutputStream()); } }

그 외에도 유용한 기능으로.

sheet.createFreezePane(2,2); // 엑셀 틀 고정: 2열 2행을 틀 고정함.

cell.setCellFormula("SUM(A5:A10)"); // 함수식을 적용한다.

sheet.setDisplayGridlines(false); // 엑셀 눈금선 제거하기

/* 배경색 먹이기 */

style.setFillForegroundColor(IndexedColors.TAN.getIndex());

style.setFillPattern(CellStyle.SOLID_FOREGROUND);

Row Col Cell 생성 개념만 이해된다면

더 많은 데이터도 조건문이나 반복문을 통해 활용할 수 있을것같아요.

poi 라이브러리가 좀 난잡하긴하지만....

전체소스에서 일부분을 카피 해오면서 나눠서 돌려보는 것을 추천합니다 !!!!

▶ 에러사항

카피 혹은 파일을 가져다썼는데도 에러가 나는 경우에는

requestMapping value와 url을 잘 맞춰보세요~

컨택스트 path 를 적용하지 않아서 생길 수 있는 에러입니다 ~!

[keyword]

java poi 예제, java poi 엑셀다운, spring poi 라이브러리, 스프링 poi, 스프링 엑셀 export, 스프링 엑셀다운, spring poi, poi 눈금선, poi 사진, poi 틀고정, poi 함수식, 스프링 poi 예제, 자바 poi, 자바 엑셀 export

'스프링 웹 개발' 카테고리의 다른 글

[java 이미지 리사이즈] 자바를 활용한 이미지 용량 줄이기 (0)	2021.06.08
[mybatis] There is no getter for property named : 파라미터 하나 일때 에러 (0)	2021.06.03
[smtp] 자바에서 네이버 이메일 전송하기 (2)	2021.05.19
리눅스용) ffmpeg 자바 + 스프링 개발 ( 동영상 변환 ) (0)	2021.05.11
윈도우용) ffmpeg 자바 + 스프링 개발 ( 동영상 변환 ) (6)	2021.05.10

배추잠자리 개발 RPG

java(spring) poi 라이브러리 적용하기 ( 자바 엑셀 다운 예제 POI)

'스프링 웹 개발' 카테고리의 다른 글

댓글

티스토리툴바

java(spring) poi 라이브러리 적용하기 ( 자바 엑셀 다운 예제 POI)

'스프링 웹 개발' 카테고리의 다른 글

관련글

댓글

티스토리툴바