자바 웹 애플리케이션

우리가 설치한 Tomcat 을 서블릿 컨테이너라고 합니다.
이 컨테이너가 담아서 관리하는 것이 바로 자바 웹 애플리케이션입니다.
서블릿 컨테이너는 자바 웹 애플리케이션이 서블릿/JSP 스펙에 따라서 동작하도록 합니다.

이제 서블릿 컨테이너의 내용물인 자바 웹 애플리케이션에 대해서 알아보겠습니다.

1. "자바 웹 애플리케이션" 정의

자바 웹 애플리케이션은 다음 리스트의 결합으로 번들(꾸러미)화될 수 있고, 이 번들이 다양한 컨테이너에서 작동할 수 있는 것을 말합니다.

서블릿
JSP
자바빈즈, 사용자 유틸리티 클래스, 자바 아카이브 파일(jar)
HTML, 이미지 와 같은 정적 자원
web.xml

위와 같은 파일들이 모여서 자바 웹 애플리케이션을 구성합니다. 그런데 이 구성요소들이 위치할 디렉토리가 스펙으로 정해져 있습니다. 간단하게 요약하면,
서블릿, 자바빈즈, 사용자 유틸리티 클래스는 /WEB-INF/classes, 자바 아카이브 파일은 /WEB-INF/lib, web.xml 파일은 /WEB-INF 에 위치해야 합니다.
다음은 자바 웹 애플리케이션이라면 따라야 하는 디렉토리 구조입니다.

2. "자바 웹 애플리케이션" 디렉토리 구조

만약 Tomcat 의 디폴트 자바 웹 애플리케이션의 디렉토리인 TOMCAT_HOME/webapps 에 bbs 라는 새로운 웹 애플케이션을 추가하고자 한다면, TOMCAT_HOME/webapps 에 다음과 같은 서브 디렉토리를 만들어야 합니다.

/bbs

새로 만들 웹 애플리케이션의 루트 디렉토리입니다.(이를 Document Base 라고 부릅니다)
모든 JSP, HTML 파일을 여기에 위치합니다.
웹 애플리케이션에 필요한 서브 디렉토리(css, js, images, ..)도 이곳에 위치합니다.

/bbs/WEB-INF

웹 애플리케이션 배치 정의자 (web.xml)가 위치합니다.
WEB-INF 디렉토리에 있는 파일은 클라이언트가 웹브라우저를 통해 접근할 수 없습니다.

/bbs/WEB-INF/classes

서블릿, 자바빈즈, 사용자 유틸리티 클래스의 클래스 파일(바이트 코드)이 이곳에 위치합니다.

/bbs/WEB-INF/lib

자바 웹 애플리케이션이 사용하는 자바 아카이브 파일이 이곳에 위치합니다.
예를들면 JDBC 드라이버나 태그 라이브러리를 구성하는 jar 파일은 이곳에 저장해야 합니다.
자바 웹 애플리케이션 디렉토리에서 주목해야 할 것은 자바 클래스 파일이 위치하는 곳이 두 군데 라는 것입니다. 하나는 /WEB-INF/classes 이고 다른 하나는 /WEB-INF/lib 입니다.
만일 똑같은 이름의 클래스가 이 두곳에 같이 위치한다면 어떻게 될까요?
Tomcat 클래스 로더가 클래스 파일을 찾는 순서에서 /WEB-INF/classes 가 /WEB-INF/lib 보다 앞섭니다. 따라서 Tomcat 클래스 로더는 /WEB-INF/classes 에 있는 클래스를 찾아서 메모리에 로딩하므로 자연히 /WEB-INF/lib 에 있는 클래스는 무시됩니다.

3. 배치 정의자 (Deployment Descriptor) : web.xml

웹 애플리케이션의 심장은 배치 정의자 (Deployment Descriptor)라고 불리는 web.xml 파일입니다.
web.xml 은 /WEB-INF 디렉토리에 위치합니다.
배치 정의자는 웹 애플리케이션의 모든 설정 정보를 정의합니다.
다음은 배치 정의자 파일로 할 수 있는 설정 정보와 간단한 배치 정의자 예입니다.

배치 정의자로 할 수 있는 설정 정보

서블릿컨텍스트 초기화 파라미터
필터
리스너
servlet 정의
servlet 초기화 파라미터
servlet 매핑
session 설정
welcome 파일 리스트
에러 페이지

간단한 배치 정의자 예

web.xml

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
  http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
  version="2.4">
  
  <servlet>
    <servlet-name>TestServlet</servlet-name>
    <servlet-class>net.java_school.TestServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
      
    <init-param>
      <param-name>name</param-name>
      <param-value>value</param-value>
    </init-param>
  </servlet>

  <servlet-mapping>
    <servlet-name>TestServlet</servlet-name>
    <url-pattern>/servlet/TestServlet</url-pattern>
  </servlet-mapping>
  
  <session-timeout>30</session-timeout>
      
</web-app>

servlet 엘리먼트는 서블릿 정의와 해당 서블릿의 초기 파라미터를 설정합니다.
위의 설정대로라면 고객이 웹브라우저의 주소창에서 http://localhost/servlet/TestServlet 로 요청하면 net.java_school.TestServlet 서블릿이 응답을 할 것입니다.
(아파치 웹서버와 연동하고 있으므로 추가적인 작업이 필요합니다.)

load-on-startup 엘리먼트의 값이 양수이므로 Tomcat 은 웹 애플리케이션이 로드한 후 해당 서블릿의 객체를 생성합니다.

servlet-mapping 엘리먼트는 서블릿과 URL 매핑을 하기 위해 사용됩니다.

session-timeout 엘리먼트는 HttpSession 객체의 라이프타임을 컨트롤합니다.
위와 같이 session-timeout 값이 설정되었다면 서블릿 컨테이너는 HttpSession 객체가 30분 동안 아무런 움직임이 없다면 소멸시킵니다.

4. 팩킹 (Packing)

개발이 완료되었다면 웹 애플리케이션을 번들화하여 다른 서블릿 컨테이너에 배포를 할 수 있습니다.
배포를 하기 위해서는 웹 애플리케이션의 루트 디렉토리에서 다음과 같은 명령을 내려 확장자가 war 인 파일을 만들어야 합니다.
확장자가 jar 이 아닌 war 인 것에 주의를 해주세요.

jar cvf bbs.war .

생성된 bbs.war 파일은 서로 다른 벤더의 서블릿 컨테이너의 디폴트 웹 애플리케이션 폴더에 복사만 하면, 해당 서블릿 컨테이너가 자동으로 우리의 bbs 애플리케이션을 배치하고 로드합니다.

다음 강좌 : 새로운 "자바 웹 애플리케이션" 작성
이전 강좌 : Tomcat 설치