엑셀 다운로드 기능 구현 및 안정성 개선

📌 엑셀 다운로드 기능 구현 및 안정성 개선

1. 문제 상황

기존 목록 조회 기능에서 검색 조건 기반 엑셀 다운로드 기능이 필요했다.
단순 다운로드가 아니라 다음 조건을 만족해야 했다:

• 사용자 검색 조건 유지
• 페이징 무시 (전체 데이터 다운로드)
• 추가 필터 (지역, 정렬, 목적 등) 반영
• 초기 검색 키(initialKey) 대응

---

2. 구현 방식

✔️ Form 기반 POST 요청으로 엑셀 다운로드 처리

 

form.action = "/welfare/listWelExcavateExcel.do";
form.method = "post";
form.submit();

• GET 방식이 아닌 POST 방식을 사용하여
  • 파라미터 길이 제한 회피
  • 복잡한 검색 조건 전달 가능

---

✔️ 검색 조건 동적 세팅

form.searchKeyword.value = keyword;
form.search_condition.value = searchCondition;
form.sido_cd_id.value = sido_cd_id;
form.sidogun_cd_id.value = sidogun_cd_id;

 

• 화면에서 입력된 값을 hidden form에 주입
• 서버에서는 동일한 로직으로 조회 → 엑셀 데이터 일관성 확보

---

✔️ 전체 데이터 조회 처리 (페이징 제거)

form.limit.value = 99999;
form.isPaging.value = "N";

 

• 엑셀 다운로드 시 페이징 제거
• 서버에서 전체 데이터 조회하도록 제어

---

✔️ 초기 검색 키 처리 로직

if (initialKey !== "") {
    searchCondition = "initial";
    keyword = initialKey;
}

 

• 특정 조건(initialKey)이 존재하면
  • 기존 검색 조건을 override
  • 사용자 진입 경로에 따른 검색 분기 처리

---

3. 트러블슈팅 및 개선 포인트

⚠️ 1. form 필드 누락 시 JS 에러 발생

form.searchKeyword.value = keyword; // 필드 없으면 에러

 

✅ 개선

form.searchKeyword?.value = keyword;

 

• optional chaining으로 런타임 에러 방지

---

⚠️ 2. jQuery 의존성 문제

 

$('#searchFrm').attr(...).submit();

• jQuery 미로딩 시 기능 동작 불가

✅ 개선

form.action = "...";
form.method = "post";
form.submit();

• Vanilla JS로 변경하여 의존성 제거

---

⚠️ 3. 대용량 조회 성능 이슈 가능성

• limit = 99999 방식은 단순하지만 위험

✅ 고려 사항

• 데이터 증가 시:
  • 서버 메모리 사용량 증가
  • 응답 지연 가능성

💡 개선 방향

• 스트리밍 다운로드
• 배치 처리 기반 엑셀 생성

---

⚠️ 4. 검색 조건 overwrite 이슈

• initialKey 존재 시 기존 검색 조건 무시됨

💡 개선 방향

• 사용자 의도에 따라:
  • 병합 OR 우선순위 정책 명확화 필요

---

4. 핵심 성과 

• 검색 조건을 유지한 엑셀 다운로드 기능 구현
• POST 기반 요청으로 복잡한 파라미터 안정적 처리
• 페이징 제거를 통한 전체 데이터 다운로드 처리
• optional chaining 적용으로 런타임 안정성 개선
• jQuery 제거로 의존성 최소화 및 유지보수성 향상
• 대용량 데이터 처리 시 발생 가능한 성능 이슈 사전 분석 및 개선 방향 도출