어노테이션이 배치 정보를 관리하므로 웹 3.0 웹 프로젝트에는 web.xml
파일이 필요하지 않습니다. 웹 배치 디스크립터에
웹 3.0 웹 프로젝트가 필요한 경우, 프로젝트를 마우스 오른쪽 단추로 클릭하고
을 선택하십시오.
웹 배치 디스크립터 편집기를 사용하면 웹 개발 환경에 작성된
모듈에 대한 배치 정보를 지정할 수 있습니다.
정보가
web.xml 파일에 나타납니다.
참고: 웹 배치 디스크립터를 사용하여
배치 디스크립터 속성을 설정하십시오.
이를 사용하여 웹 자원 컨텐츠를 조작하지 마십시오.
웹 프로젝트의 web.xml 파일에서는 웹 애플리케이션 모듈을
배치하기 위해 필요한 정보를 제공합니다. 프로젝트에서 WAR 파일을 빌드하는 데
사용됩니다.
웹 배치 디스크립터 편집기는 동적이고 배치 디스크립터에
다양한 특성 및 설정을 나타내는 많은 섹션을
포함합니다.

웹 배치 디스크립터 편집기에는 다음 섹션이 포함됩니다.
- 웹 애플리케이션 구조
- 웹 배치 디스크립터에서 컨텐츠의 빠른 요약을 제공하고
컨텐츠를 추가, 제거 또는 변경할 수 있도록 허용합니다.
- 절대 순서 지정
- 절대 순서 지정을 사용하여 웹 단편을 스캔하기 위한 순서를
강제 실행하거나 웹 단편의 서브세트를 스캔하십시오.
- 컨텍스트 매개변수
- 서블릿 컨텍스트는 서블릿이 실행 중인 웹 애플리케이션의
서버 보기를 정의합니다. 컨텍스트를 사용하면 서블릿이
이에 대해 사용 가능한 자원에 액세스할 수 있습니다.
- 컨텍스트를 사용하여 서블릿은 이벤트를 로그하고 자원에 대한
URL 자원을 가져오며 컨텍스트의 기타 서블릿이 사용할 수 있는 속성을
설정하고 저장할 수 있습니다. 이러한 특성은 해당 컨텍스트에 대한 웹
애플리케이션의 매개변수를 선언합니다. 중요한 데이터를 보유한 시스템의 이름 또는
웹 마스터의 이메일 주소와 같은 설정 정보를
전달합니다.
- 데이터 소스
- 데이터 소스 정보를 구성하여 애플리케이션에 사용할 수 있는 데이터 소스를
작성하십시오.
- EJB 로컬 참조
- 로컬 홈 및 로컬 인터페이스를 통해 액세스되는
엔터프라이즈 Bean에 대한 참조를 작성하십시오.
- EJB 참조
- 원격 홈 및 원격 인터페이스를 통해 액세스되는
엔터프라이즈 Bean에 대한 참조를 작성하십시오.
- 환경 변수
- 애플리케이션에 대한 환경 항목을 선언하십시오.
- 오류 페이지
- 오류 페이지 위치를 사용하면 서블릿이 지정된 오류 상태 코드 또는 예외
유형을 기반으로 하는 클라이언트에서 URI를 발견하고 이를 제공할 수 있습니다.
- 이러한 특성은 오류 핸들러가 다른 서블릿 또는
JSP 파일인 경우에 사용됩니다. 특성은 웹 애플리케이션에 있는 자원의 경로와
오류 코드 또는 예외 유형 간의 맵핑을 지정합니다.
컨테이너는 정의되는 순서로 목록을 검토하고 상태 코드 또는
예외 클래스에 따라 오류 조건을 일치시키도록
시도합니다. 오류 조건의 첫 번째 성공적인 일치에서
컨테이너는 위치 특성에 정의된 자원을 다시 제공합니다.
- 필터
- 필터 클래스와 초기화 속성을 정의합니다.
- 새 필터를 작성하고 배치 디스크립터에 기존 필터를 추가하거나
배치 디스크립터에서 선택된 필터를 제거합니다.
- 필터 맵핑
- URL 패턴 또는 서블릿에 맵핑하는 필터를 정의합니다.
- JSP 구성
- 자원 콜렉션 또는 태그 라이브러리를 추가하십시오.
- 리스너
- 애플리케이션 리스너를 정의합니다.
- 로케일 인코딩 맵핑 목록
- 인코딩 이름에 로케일 이름을 맵핑합니다.
- 로그인 구성
- 사용자 인증 방법을 구성합니다. 로그인 구성이 지정되는 경우,
사용자는 보안 제한조건 매개변수에서 제한되는 자원에 액세스하기 위해 인증해야 합니다.
- 메시지 대상
- 메시지 구동 Bean의 대상을 지정합니다.
- 메시지 대상 참조
- 메시지 구동 Bean에 메시지 대상 참조를 바인드하도록
J2C 관리 오브젝트의 JNDI(Java™ Naming
and Directory Interface) 이름을 지정합니다.
애플리케이션의 각 메시지 대상 참조를 관리 오브젝트에
맵핑하십시오.
- MIME 맵핑
- 확장과 Mine 유형 간의 맵핑을 정의합니다.
- 지속성 컨텍스트 참조
- 지속성 컨텍스트의 수명을 지정합니다.
- 지속성 단위 참조
- persistence.xml 파일을 지정합니다.
- 사후 구성
- 종속성 인젝션 초기화 이후 실행되는 메소드를 정의합니다.
- 사전 영구 삭제
- 인스턴스가 컨테이너에 의해 제거된다는 것을 암시하는
콜백 알림을 정의합니다.
- 자원 환경 참조
- 웹 애플리케이션의 자원 참조를 연관된 관리 오브젝트에
정의합니다.
- 자원 참조
- 외부 자원에 검색 이름의 참조를 정의합니다.
- 보안 제한조건
- 보안 제한조건은 웹 컨텐츠가 보호되는 방법을 판별합니다.
이러한 특성은 하나 이상의 웹 자원 콜렉션과
보안 제한사항을 연관시킵니다.
- 제한조건은 웹 자원 콜렉션, 권한 부여 제한조건 및
사용자 데이터 제한조건으로 구성됩니다.
- 웹 자원 콜렉션은 대항 자원에 있는 일련의 자원(URL 패턴) 및
HTTP 메소드입니다. 웹 자원 콜렉션에 설명된 URL 패턴과 일치하는
요청 경로를 포함하는 모든 요청은
제한조건을 따릅니다. HTTP 메소드가 지정되지 않은 경우,
보안 제한조건이 모든 HTTP 메소드에 적용됩니다.
- 권한 부여 제한조건은 웹 자원 콜렉션에서 설명하는
자원에 액세스하기 위해 사용자에게 부여되어야 하는
일련의 역할입니다. 지정된 URI에 대한 액세스를 요청하는 사용자에게
권한 부여 제한조건에 지정되는 역할 중 하나라도 제공되지 않는 경우,
사용자는 해당 자원에 대한 액세스에 거부됩니다.
- 사용자 데이터 제한조건은 클라이언트 또는 서버 통신 프로세스의
전송 계층이 컨텐츠 무결성 보증(전송 시 조정 방지) 또는 기밀성 보증(전송 시
읽기 방지)의 요구사항을 충족해야 한다는 것을
나타냅니다.
- 보안 역할
- 보안 역할을 정의합니다.
- 보안 참조
- 대체 역할 이름에 보안 역할에 대한 참조를 정의합니다.
- 서블릿
- 새 서블릿을 작성하고 배치 디스크립터에 기존 서블릿 또는
JSP 파일을 추가하거나 배치 디스크립터에서
JSP 파일의 선택된 서블릿을 제거합니다.
- 세션 구성
- 웹 애플리케이션에 대한 세션 속성을 정의합니다.
- 시작 파일 목록
- 파일이 발견되지 않을 때 제공되는 기본 웹 페이지의 순서 지정된 목록을
구성합니다.
- 시작 파일은 관련 HTML 파일 그룹의 항목 시작점입니다(예: index.html).
- 시작 파일은 부분적 URI 그룹을 사용하여 찾을 수 있습니다. 웹 컨테이너는
부분적인 URI를 사용하여 초기 URI가 발견되지 않을 때 유효한 파일을
찾습니다.
- 소스
- web.xml 소스를 직접적으로 편집하십시오.
웹 배치 디스크립터 편집기에서 탭된 여러 페이지를 사용하여
web.xml 파일을 편집하십시오. 배치 정보를 지정할 때
편집기가 web.xml에 태그 지정한 적절한 XML을 자동으로 통합합니다.
web.xml 파일의 구성 정보 뿐만 아니라,
웹 프로젝트의 기타 배치 디스크립터에 다음 정보가 포함됩니다.
- 바인딩 정보
- 특정 인스턴스에 대한 애플리케이션에 지정되는 배치 정보를
바인드하기 위해 애플리케이션 서버가 정보를
요청합니다. 예를 들어, 자원 또는 외부 종속성의 논리 이름을
자원의 실제 JNDI 이름에 맵핑할 수 있습니다. 또한 그룹
또는 사용자 세트에 보안 역할 정보를 맵핑할 수 있습니다.
- IBM® 바인딩 및 확장기능
정보(ibm-web-bnd.xml 및 ibm-web-ext.xml 파일)
- Java EE 애플리케이션, 웹 애플리케이션 및 엔터프라이즈 Bean에 대한
표준 디스크립터에 대한 추가. 확장기능은 Java Platform,
Enterprise Edition 또는 레거시(이전) 시스템이 현재 WebSphere® Application Server
환경에서 작업할 수 있게 합니다. 또한 공급업체마다 다르거나 현재 스펙에 정의되어
있지 않거나 이후 스펙에 포함될 것으로 예상되는 애플리케이션
동작을 지정하는 데 사용됩니다.
WAR 파일을 기존 웹 프로젝트로 가져오면,
웹 프로젝트의 새 배치 디스크립터로 WAR 파일에 포함되는
배치 디스크립터 파일을 포함할 수 있습니다. 이미 이러한 파일에 정의된
특정 배치 정보는 업데이트된 웹 애플리케이션을 배치할 때
사용됩니다.
web.xml 파일은 웹 프로젝트에 변경사항을
반영하도록 자동으로 업데이트될 수 있습니다. 예를 들어, 새 서블릿 마법사를 사용하여
웹 프로젝트에서 새 서블릿을 작성할 때, 마법사는
적절한 서블릿 항목을 web.xml 파일에 배치합니다.