🏷️
JSTL & JSP 치트시트

Core 태그, Formatting 서식, fn 내장 함수 및 EL(Expression Language) 문법 퀵 레퍼런스
#jstl#jsp#java#spring#template#el#fmt#taglib최종 업데이트: 2026-09-26
JSTL & JSP 치트시트 핵심 명령어 및 실전 가이드

Core 태그, Formatting 서식, fn 내장 함수 및 EL(Expression Language) 문법 퀵 레퍼런스
## 1. Taglib 선언 & 환경 설정 (Directives)
```xml
<!-- 1. 표준 JSTL 1.2 선언 (Java EE / javax 기반) -->
<%@ taglib prefix="c"   uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ taglib prefix="fn"  uri="http://java.sun.com/jsp/jstl/functions" %>
<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>
<%@ taglib prefix="x"   uri="http://java.sun.com/jsp/jstl/xml" %>

<!-- 2. Jakarta EE 9+ 선언 (Spring Boot 3.x / Tomcat 10+) -->
<%@ taglib prefix="c"   uri="jakarta.tags.core" %>
<%@ taglib prefix="fmt" uri="jakarta.tags.fmt" %>
<%@ taglib prefix="fn"  uri="jakarta.tags.functions" %>

<!-- Spring Boot 3 Gradle 의존성 예시 -->
<!-- implementation 'jakarta.servlet.jsp.jstl:jakarta.servlet.jsp.jstl-api' -->
<!-- implementation 'org.glassfish.web:jakarta.servlet.jsp.jstl' -->
```

## 2. 변수 선언 & 안전 출력 (c:set, c:out)
```xml
<!-- 변수 선언 (기본 scope는 page) -->
<c:set var="userName" value="${user.name}" />
<c:set var="userRole" value="ADMIN" scope="session" />

<!-- 객체의 프로퍼티 직접 수정 -->
<c:set target="${userDto}" property="status" value="ACTIVE" />

<!-- c:out: XSS 공격 방어 필수 출력 (escapeXml="true" 기본 적용) -->
<c:out value="${userInput}" default="등록된 내용이 없습니다." />

<!-- HTML 태그를 그대로 렌더링해야 할 때만 escapeXml="false" 사용 -->
<c:out value="${board.htmlContent}" escapeXml="false" />

<!-- 변수 제거 -->
<c:remove var="tempToken" scope="session" />
```

## 3. 조건 분기 처리 (c:if, c:choose)
```xml
<!-- 1. 단일 조건 검사 (c:if는 else가 없음에 유의) -->
<c:if test="${not empty user}">
  <p>환영합니다, <c:out value="${user.name}"/>님!</p>
</c:if>

<!-- 검사 결과를 boolean 변수에 저장하여 재사용 -->
<c:if test="${user.age >= 19}" var="isAdult" scope="page" />

<!-- 2. 다중 조건 분기 (if-else if-else / switch 문 대체) -->
<c:choose>
  <c:when test="${user.role eq 'ADMIN'}">
    <span class="badge badge-red">최고 관리자</span>
  </c:when>
  <c:when test="${user.role eq 'MANAGER'}">
    <span class="badge badge-blue">운영자</span>
  </c:when>
  <c:when test="${user.point >= 1000}">
    <span class="badge badge-green">우수 회원</span>
  </c:when>
  <c:otherwise>
    <span class="badge badge-gray">일반 회원</span>
  </c:otherwise>
</c:choose>
```

## 4. 컬렉션 & 숫자 반복 순회 (c:forEach)
```xml
<!-- 1. 리스트/배열 순회와 varStatus 상태값 활용 -->
<c:forEach items="${userList}" var="item" varStatus="status">
  <tr class="${status.first ? 'first-row' : ''} ${status.last ? 'last-row' : ''}">
    <td>${status.count}</td> <!-- 1부터 시작하는 순번 (1, 2, 3...) -->
    <td>${status.index}</td> <!-- 0부터 시작하는 인덱스 (0, 1, 2...) -->
    <td><c:out value="${item.username}" /></td>
    <td>${status.current.email}</td> <!-- 현재 순회 객체 -->
  </tr>
</c:forEach>

<!-- 2. 숫자 범위 반복 (1부터 10까지 2씩 증가) -->
<c:forEach var="num" begin="1" end="10" step="2">
  <span>${num}</span> <!-- 1, 3, 5, 7, 9 -->
</c:forEach>

<!-- 3. 문자열 구분자 분리 순회 (c:forTokens) -->
<c:forTokens items="Java,Spring,JSP,Kotlin,SQL" delims="," var="tech">
  <span class="tag">${tech}</span>
</c:forTokens>
```

## 5. URL 생성 & 페이지 이동 (c:url, c:redirect)
```xml
<!-- c:url: Context Path 자동 부착 및 특수문자 안전 인코딩 -->
<!-- 결과 예시: /my-app/board/view?boardId=42&page=1 -->
<c:url value="/board/view" var="detailUrl">
  <c:param name="boardId" value="${article.id}" />
  <c:param name="page" value="${param.page}" />
  <c:param name="keyword" value="${param.keyword}" />
</c:url>
<a href="${detailUrl}">상세 보기</a>

<!-- 클라이언트 리다이렉트 (Context Path 자동 포함) -->
<c:if test="${empty sessionScope.loginUser}">
  <c:redirect url="/auth/login">
    <c:param name="redirectUrl" value="${pageContext.request.requestURI}" />
  </c:redirect>
</c:if>

<!-- 외부/내부 JSP 조각 컴포넌트 임포트 -->
<c:import url="/WEB-INF/views/common/header.jsp">
  <c:param name="pageTitle" value="대시보드" />
</c:import>
```

## 6. 날짜 & 시간 서식화 (fmt:formatDate)
```xml
<!-- 날짜 포맷팅 (java.util.Date 타입 객체 전달 필요) -->
<fmt:formatDate value="${now}" pattern="yyyy-MM-dd HH:mm:ss" />
<!-- 출력: 2026-09-26 14:30:00 -->

<fmt:formatDate value="${article.createdAt}" pattern="yyyy년 MM월 dd일 (E)" />
<!-- 출력: 2026년 09월 26일 (토) -->

<!-- 시간만 출력 -->
<fmt:formatDate value="${now}" type="time" timeStyle="short" />

<!-- 타임존 지정 (글로벌 서비스 KST 고정) -->
<fmt:setTimeZone value="Asia/Seoul" />
<fmt:formatDate value="${utcDate}" pattern="yyyy-MM-dd HH:mm" />

<!-- 문자열 날짜를 Date 객체로 파싱 (fmt:parseDate) -->
<fmt:parseDate value="20260926" pattern="yyyyMMdd" var="parsedDate" />
<fmt:formatDate value="${parsedDate}" pattern="yyyy.MM.dd" />
```

## 7. 숫자, 통화 & 퍼센트 서식 (fmt:formatNumber)
```xml
<!-- 1. 천 단위 콤마 서식 (pattern 지정) -->
<fmt:formatNumber value="${product.price}" pattern="#,###" /> 원
<!-- 출력: 1,590,000 원 -->

<!-- 2. 통화(Currency) 서식 (로케일 통화 기호 자동) -->
<fmt:formatNumber value="52000" type="currency" currencySymbol="₩" />
<!-- 출력: ₩52,000 -->

<!-- 3. 백분율(Percent) 서식 (0.854 -> 85%) -->
<fmt:formatNumber value="${growthRate}" type="percent" />

<!-- 4. 소수점 자릿수 고정 (최소 2자리, 최대 4자리) -->
<fmt:formatNumber value="12.3" pattern="#,##0.00" />
<!-- 출력: 12.30 -->

<!-- 5. 포맷된 숫자 문자열을 순수 숫자로 역파싱 (fmt:parseNumber) -->
<fmt:parseNumber value="1,250,000" pattern="#,###" var="cleanNumber" />
<!-- ${cleanNumber + 50000} => 1300000 -->
```

## 8. 내장 문자열 함수 모음 (fn:*)
```xml
<!-- 1. 컬렉션/문자열 길이 계산 (가장 빈번하게 사용) -->
목록 개수: ${fn:length(userList)}개
비밀번호 길이: ${fn:length(user.password)}자

<!-- 2. 문자열 포함 여부 검사 (대소문자 구분 / 무시) -->
<c:if test="${fn:contains(user.email, '@company.com')}">사내 계정</c:if>
<c:if test="${fn:containsIgnoreCase(fileName, '.pdf')}">PDF 문서</c:if>

<!-- 3. 시작/끝 문자열 검사 -->
<c:if test="${fn:startsWith(url, 'https://')}">보안 연결</c:if>
<c:if test="${fn:endsWith(fileName, '.png')}">PNG 이미지</c:if>

<!-- 4. 부분 문자열 자르기 & 위치 찾기 -->
${fn:substring(productCode, 0, 4)} <!-- 0부터 4 이전까지 추출 -->
${fn:substringAfter(file, '.')}     <!-- 구분자 뒤 문자열: 확장자 추출 -->
${fn:substringBefore(file, '.')}    <!-- 구분자 앞 문자열: 파일명 추출 -->
${fn:indexOf(description, '중요')}   <!-- 문자열 시작 인덱스 반환 (-1 if not found) -->

<!-- 5. 문자열 치환 & 분할/결합 -->
${fn:replace(content, 'Java', 'Kotlin')}
${fn:trim('   앞뒤 공백 제거   ')}

<!-- 배열 분할 후 결합 예시 -->
<c:set var="tagArr" value="${fn:split('spring,java,jstl', ',')}" />
<c:out value="${fn:join(tagArr, ' #')}" />
```

## 9. EL (Expression Language) 핵심 연산자
```xml
<!-- 1. empty 연산자 (null, 빈 문자열, 빈 컬렉션 통합 검사) -->
<!-- null, "", new ArrayList() (size=0), new HashMap() 모두 true -->
<c:if test="${empty boardList}">
  <p>등록된 게시글이 없습니다.</p>
</c:if>
<c:if test="${not empty sessionScope.loginUser}">
  <p>로그인 상태입니다.</p>
</c:if>

<!-- 2. 비교 연산자 (기호 또는 영문 축약어 모두 사용 가능) -->
${a == b}  또는  ${a eq b}   <!-- 동등 비교 (equals 자동 호출) -->
${a != b}  또는  ${a ne b}   <!-- 불일치 -->
${a < b}   또는  ${a lt b}   <!-- Less Than -->
${a > b}   또는  ${a gt b}   <!-- Greater Than -->
${a <= b}  또는  ${a le b}   <!-- Less or Equal -->
${a >= b}  또는  ${a ge b}   <!-- Greater or Equal -->

<!-- 3. 논리 연산자 & 삼항 연산자 -->
<c:if test="${user.active and (user.role eq 'ADMIN' or user.role eq 'STAFF')}">
  접근 허용
</c:if>

<!-- 인라인 조건 삼항 연산자 -->
<span class="${item.stock > 0 ? 'in-stock' : 'sold-out'}">
  ${item.stock > 0 ? '구매 가능' : '품절'}
</span>
```

## 10. EL 내장 객체 & 스코프 탐색
```xml
<!-- 1. 파라미터 접근 (HttpServletRequest.getParameter) -->
검색어: ${param.keyword}
정렬순서: ${param.sortBy}
체크박스 다중값(배열): ${paramValues.category[0]}

<!-- 2. 컨텍스트 패스 및 요청 정보 (pageContext) -->
컨텍스트 루트 경로: ${pageContext.request.contextPath}
요청 URI: ${pageContext.request.requestURI}
클라이언트 IP: ${pageContext.request.remoteAddr}

<!-- 3. 4대 스코프 명시적 접근 (스코프 생략 시 page -> request -> session -> application 순 자동 탐색) -->
${pageScope.localVar}
${requestScope.modelAttribute}
${sessionScope.loginUser.id}
${applicationScope.globalConfig}

<!-- 4. 헤더 & 쿠키 접근 -->
브라우저 정보: ${header['User-Agent']}
세션 쿠키 값: ${cookie.JSESSIONID.value}
```

## 11. 실무 빈출 패턴 & 트러블슈팅
```xml
<!-- 1. 텍스트 개행(줄바꿈 \n)을 <br/>로 치환하는 정석 기법 -->
<% pageContext.setAttribute("newLineChar", "\n"); %>
${fn:replace(fn:escapeXml(article.content), newLineChar, "<br/>")}

<!-- 2. 자바스크립트 코드 내 안전한 EL 변수 주입 (따옴표 누락 방지 & XSS 예방) -->
<script>
  const currentUserId = '<c:out value="${user.id}" />';
  const isAuthorized  = ${user.isAuthorized ? 'true' : 'false'};
</script>

<!-- 3. 페이징 네비게이션 반복 예시 -->
<ul class="pagination">
  <c:forEach var="p" begin="${pageInfo.startPage}" end="${pageInfo.endPage}">
    <li class="${p eq pageInfo.currentPage ? 'active' : ''}">
      <a href="<c:url value="/board/list"><c:param name="page" value="${p}"/></c:url>">${p}</a>
    </li>
  </c:forEach>
</ul>
```
💬
JSTL & JSP 치트시트

의견 및 질문

댓글 수정

댓글 삭제
