본문으로 건너뛰기

web.xml 작성 예제가 있나요?

💡 요약 정리

  • Servlet 2.4 기준의 web.xml 예제를 제공합니다.
  • 서블릿 등록, 서블릿 매핑, 컨텍스트 파라미터 예시가 포함되어 있습니다.
  • 예제의 servlet-class, url-pattern, 파라미터 값은 서비스 환경에 맞게 수정하세요.
  • 파일 위치는 일반적으로 프로젝트/WEB-INF/web.xml 입니다.
  • servlet-name과 servlet-mapping의 servlet-name은 반드시 동일해야 합니다.

예제 안내드립니다. 참고하시어 이용해 주세요.

1. 예제 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/web-app_2_4.xsd" version="2.4">
  <servlet>
    <servlet-name>Select</servlet-name> <!-- 서블릿 이름 -->
    <servlet-class>com.example.Select</servlet-class> <!-- 서블릿 실제 경로 -->
    <init-param> <!-- 서블릿 파라메터 -->
      <param-name>name</param-name>
      <param-value>cafe24</param-value>
    </init-param>
  </servlet>
  <servlet-mapping>
    <servlet-name>Select</servlet-name>
    <url-pattern>/Select.do</url-pattern> <!-- 웹에서 서블릿 접근 이름 -->
  </servlet-mapping>
  <context-param> <!-- 컨텍스트 초기화 파라메터 -->
    <param-name>email</param-name>
    <param-value>hosting@cafe24corp.com</param-value>
  </context-param>
</web-app>

2. 각 항목 설명과 사용 팁

2.1 서블릿 등록(servlet)

  • servlet-name: 서블릿의 식별자입니다. 매핑과 반드시 동일해야 합니다.
  • servlet-class: 실제 서블릿 클래스의 FQCN(패키지를 포함한 전체 경로)입니다. 예: com.example.Select
  • init-param: 서블릿 초기화 파라미터입니다.
    • param-name/param-value에 키-값을 지정해 서블릿에서 초기값으로 사용할 수 있습니다.
서블릿을 변경할 때는 servlet-class를 실제 배포된 클래스 경로와 정확히 일치시키세요.

2.2 매핑(servlet-mapping)

  • servlet-name: 위에서 등록한 서블릿 이름과 동일해야 합니다.
  • url-pattern: 브라우저에서 접근할 경로 패턴입니다. 예: /Select.do
주의: servlet-name이 일치하지 않으면 요청이 서블릿으로 라우팅되지 않습니다.

2.3 컨텍스트 파라미터(context-param)

  • 애플리케이션 전역에서 참조할 수 있는 초기값을 설정합니다.
  • 예제에서는 email 키에 hosting@cafe24corp.com 값을 지정했습니다.
  • 필요에 따라 키와 값을 서비스 환경에 맞게 수정하세요.

3. 배치 위치와 적용 안내

3.1 파일 위치

  • 일반적으로 프로젝트/WEB-INF/web.xml 경로에 배치합니다.

3.2 적용 시 체크리스트

  • 서블릿 이름(servlet-name)과 매핑의 이름이 동일한지
  • servlet-class가 실제 배포 파일의 패키지/클래스 경로와 일치하는지
  • url-pattern이 의도한 접근 경로인지
  • 초기화 파라미터(key/value)가 서비스 로직에 맞는지
  • 네임스페이스, 스키마 관련 URI를 환경에 맞게 정확히 입력했는지
예제를 복사한 뒤 프로젝트 요구사항에 맞게 값만 바꾸어 사용하시면 빠르게 설정을 완료할 수 있습니다.