JSP 페이지에 주석 작성하는 방법 완벽 정리

JSP 주석이란?

JSP 주석(Comment)은 JSP 컨테이너가 무시하도록 지정하는 텍스트 또는 문장을 의미합니다. JSP 페이지의 특정 부분을 숨기거나 일시적으로 비활성화(주석 처리)하고 싶을 때 JSP 주석이 매우 유용하게 사용됩니다.

JSP 주석은 클라이언트로 전송되는 HTML 소스에 포함되지 않기 때문에, 내부 로직이나 개발 메모를 남기고 싶을 때 HTML 주석보다 더 안전한 선택입니다.

JSP 주석 기본 문법

JSP 주석은 다음과 같은 형식으로 작성합니다.

<%-- 이것은 JSP 주석입니다 --%>

JSP 주석 사용 예제

다음 예제는 JSP 페이지에서 주석을 사용하는 방법을 보여줍니다.

<html>
   <head>
      <title>주석 테스트</title>
   </head>
   <body>
      <h2>주석 테스트 페이지</h2>
      <%-- 이 주석은 페이지 소스에 나타나지 않습니다 --%>
   </body>
</html>

위 코드를 실행하면 다음과 같은 결과가 출력됩니다.

주석 테스트 페이지

브라우저에서 페이지 소스를 확인해 보면 <%-- --%>로 감싼 주석 내용은 전혀 보이지 않는다는 것을 알 수 있습니다.

특수 문자 및 주석 관련 문법 정리

JSP에서는 상황에 따라 특수한 용도로 사용되는 몇 가지 문법 구조가 있습니다. 아래 표는 주석 및 특수 문자 표기 방법을 정리한 것입니다.

번호	문법 및 용도
1	<%-- 주석 --%> JSP 주석입니다. JSP 엔진이 완전히 무시하며 클라이언트에 전송되지 않습니다.
2	<!-- 주석 --> HTML 주석입니다. 브라우저가 무시하지만, 페이지 소스에는 그대로 노출됩니다.
3	<\% 정적인 `<%` 문자 그대로를 출력할 때 사용합니다.
4	%\> 정적인 `%>` 문자 그대로를 출력할 때 사용합니다.
5	\' 작은따옴표(')를 사용하는 속성 값 안에서 작은따옴표 자체를 표현할 때 사용합니다.
6	\" 큰따옴표(")를 사용하는 속성 값 안에서 큰따옴표 자체를 표현할 때 사용합니다.

JSP 주석과 HTML 주석의 차이점

두 주석의 가장 큰 차이는 클라이언트 노출 여부입니다. JSP 주석(<%-- --%>)은 서버 측에서 처리 단계에 제거되므로 사용자에게 절대 노출되지 않습니다. 반면 HTML 주석()은 브라우저가 화면에 표시하지 않더라도 페이지 소스 보기를 통해 누구나 확인할 수 있습니다.

따라서 API 키, 내부 경로, 개발자 메모 등 민감한 정보를 남겨야 한다면 반드시 JSP 주석을 사용하는 것이 좋습니다.