[37~38일차] - 게시판 첨부파일 업로드/다운로드 기능
첨부파일
CommonController
- uploadPath 경로 가져오기
- 파일 확장자 체크 변수
- 파일 업로드 메소드
- 파일 다운로드 메소드
업로드/다운로드 구현하기 전에, pom.xml에 파일 업로드 라이브러리를 추가한다.
<!-- 파일업로드 라이브러리 -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.1</version>
</dependency>
또한, servlet-context.xml에 아래 코드를 추가한다.
- uploadPath는 파일이 업로드/다운로드되는 경로이다.
<!-- html폼에서 첨부파일 업로드 설정 10메가 제한 -->
<beans:bean id="multipartResolver"
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<beans:property name="maxUploadSize" value="10485760"></beans:property>
</beans:bean>
<!-- 업로드한 파일이 저장되는 위치: 로컬PC용 -->
<beans:bean id="uploadPath" class="java.lang.String">
<beans:constructor-arg value="C:\\egov\\workspace\\upload" />
</beans:bean>
사전 설정이 끝났다.
1. 파일 업로드 구현 (CommonController.java)
- 첨부파일의 확장자를 확인하는 변수를 생성한다.
- 첨부파일 확장자를 확인하여, 이미지일 때 미리보기 가능, 아니라면 그냥 파일명만 보이게.
private ArrayList<String> extNameArray = new ArrayList<String>() {
{
add("gif");
add("jpg");
add("jpeg");
add("png");
add("bmp");
}
};
public ArrayList<String> getCheckImgArray() {
return checkImgArray;
}
public void setCheckImgArray(ArrayList<String> checkImgArray) {
this.checkImgArray = checkImgArray;
}
- 파일을 업로드할 경로를 가져온다.
- 아래 경로는 servlet-context.xml에 빈으로 등록되어있는 uploadPath에서 가져온다.
@Resource(name="uploadPath")
private String uploadPath;
public String getUploadPath() {
return uploadPath;
}
public void setUploadPath(String uploadPath) {
this.uploadPath = uploadPath;
}
- 파일 업로드를 구현할 메소드를 생성한다.
- servlet-context.xml에 지정한 폴더에 실제 파일을 저장하도록 구현
public String[] fileUpload(MultipartFile file) throws IOException {
String realFileName = file.getOriginalFilename(); //jsp에서 전송한 파일명 -> 확장자 구할 때 사용
//만약 파일이 여러개면 아래 부분에 변수 처리 로직이 더 들어가야 한다.
//폴더에 저장할 PK용 파일명 만들기(아래)
UUID uid = UUID.randomUUID(); //unique id 생성 : 폴더에 저장할 파일명으로 사용
//String saveFileName = uid.toString()+"."+realFileName.split("\\.")[1]; //문제발생하여 아래코드로 대체
String saveFileName = uid.toString()+"."+StringUtils.getFilenameExtension(realFileName);
//realFileName.split("\\."); realFileName을 .으로 분할해서 파일변수로 만드는 메소드
//ex. abc.jpg -> realFileName[0]=abc, realFileName[1]=jpg
String[] files = new String[] {saveFileName}; //saveFileName 스트링형을 배열변수 files로 형변환
byte[] fileData = file.getBytes(); //jsp폼에서 전송된 파일이 fileData변수(메모리)에 저장된다.
//uploadPath경로의 saveFileName이름을 가진 파일이 타겟이 된다.
File target = new File(uploadPath,saveFileName); //파일 저장하기 바로 전 설정 저장
FileCopyUtils.copy(fileData, target); //실제로 target폴더에 파일로 저장되는 메소드 = 업로드끝
return files; // 1개 이상의 파일 업로드 시, 저장된 파일명을 배열로 저장한 변수
//첨부파일이 한개 이상일 수 있기 때문에, BoardVO에 save_file_names가 배열형이기 때문에.
}- jsp에서 전송한 실제 파일명을 realFileName 변수에 저장한다.
- unique id를 랜덤으로 생성하여 uid 변수에 저장한다.
- 생성한 uid + realFileName의 확장자를 saveFileName 변수에 저장한다.
- saveFileName을 files 배열 변수에 반환한다.
- jsp 폼에서 전송된 파일이 fileData변수(메모리)에 저장한다.
- File 클래스형 target 변수에 uploadPath 경로의 saveFileName라는 이름을 가진 파일을 저장한다.
- FileCopyUtils 메소드를 사용하여 target 파일에 fileData 내용을 복사한다. = 업로드 끝
FileCopyUtils.copy(File in, File out)
- 지정한 입력 File내용을 지정한 출력 File에 복사한다. 리턴값은 복사한 byte수.
- 업로드 후, files 반환(saveFileName 저장되어있는 배열 변수)
- BoardVO에 저장 파일 이름과 실제 파일 이름을 저장할 멤버변수를 생성한다.
private String[] save_file_names; // 폴더에 저장되는 실제파일명을 배열형으로 변경할 때 사용한 변수
private String[] real_file_names; // DB에 저장되는 한글파일명을 배열형으로 변경할 때 사용한 변수
public String[] getReal_file_names() {
return real_file_names;
}
public void setReal_file_names(String[] real_file_names) {
this.real_file_names = real_file_names;
}
- boardMapper.xml에 insertAttach 쿼리를 추가한다.
<insert id="insertAttach">
insert into tbl_attach(save_file_name, real_file_name, bno)
values (#{save_file_name},#{real_file_name},(select bno from tbl_board order by bno desc limit 1))
</insert>- select bno from tbl_board order by bno desc limit 1
- 업로드 할 때는 입력된 bno가 없기 때문에 bno=#{bno} 사용 불가능하다. 따라서 위의 쿼리를 사용하여 bno를 검색하여 입력한다.
- IF_BoardDAO.java 와 BoardDAOImpl
public void insertAttach(String save_file_name, String real_file_name) throws Exception;- BoardDAOImpl에는 insertBoard 안에 추가한다.
@Transactional
@Override
public void insertBoard(BoardVO boardVO) throws Exception {
// 게시물 등록 DAO연결(아래)
boardDAO.insertBoard(boardVO);
// 첨부파일 등록 DAO연결(아래)
String[] save_file_names = boardVO.getSave_file_names();
String[] real_file_names = boardVO.getReal_file_names();
//첨부파일이 여러개일 때 상황 대비
if(save_file_names == null) {return;} //첨부파일 없을때
int index = 0;
String real_file_name="";
for(String save_file_name:save_file_names) {
real_file_name=real_file_names[index];
boardDAO.insertAttach(save_file_name, real_file_name);
index=index+1;
}
}
- AdminController.java의 oard_write에 업로드 관련 소스를 추가한다.
2. 파일 다운로드 구현 (CommonController.java)
- 파일 다운로드를 구현할 메소드를 생성한다.
@RequestMapping(value="/download", method=RequestMethod.GET)
@ResponseBody //이 어노테이션으로 지정된 메소드는 페이지 이동처리 아니고, RestAPI처럼 현재 페이지에서 구현 결과 내용을 전송 받음
public FileSystemResource download(
@RequestParam("save_file_name") String save_file_name,
@RequestParam("real_file_name") String real_file_name,
HttpServletResponse response
) throws Exception { //파일시스템리소스로 현재 페이지에서 반환받음.
File file = new File(uploadPath + "/"+ save_file_name); //다운받을 파일 경로 지정
response.setContentType("application/download; utf-8"); //파일"내용" 중 한글이 깨지는 것 방지
real_file_name = URLEncoder.encode(real_file_name, "UTF-8").replaceAll("\\+", "%20");
//위의 URLEncoder는 파일"명"이 한글(일본어, 베트남어)일 떄, 깨지는 것 방지.
response.setHeader("Content-Disposition", "attachment; filename="+real_file_name);
return new FileSystemResource(file); //실제 다운로드 시작
}- File 클래스형 file 변수에 uploadPath에서 지정한 경로의 save_file_name을 저장한다.