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

웹 배치 디스크립터 편집기에는 다음 섹션이 포함됩니다.
- 웹 애플리케이션 구조
- 웹 배치 디스크립터에서 컨텐츠의 빠른 요약을 제공하고 컨텐츠를 추가, 제거 또는 변경할 수 있도록 허용합니다.
- 절대 순서 지정
- 절대 순서 지정을 사용하여 웹 단편을 스캔하기 위한 순서를 강제 실행하거나 웹 단편의 서브세트를 스캔하십시오.Web3.x 이상에 대해 절대 순서 지정 구성이 적용됩니다.
- 컨텍스트 매개변수
- 서블릿 컨텍스트는 서블릿이 실행 중인 웹 애플리케이션의 서버 보기를 정의합니다. 컨텍스트를 사용하면 서블릿이 이에 대해 사용 가능한 자원에 액세스할 수 있습니다.
- 컨텍스트를 사용하여 서블릿은 이벤트를 로그하고 자원에 대한 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 환경에서 작업할 수 있게 합니다. 또한 공급업체마다 다르거나 현재 스펙에 정의되어 있지 않거나 이후 스펙에 포함될 것으로 예상되는 애플리케이션 동작을 지정하는 데 사용됩니다.
web.xml 파일은 웹 프로젝트에 변경사항을 반영하도록 자동으로 업데이트될 수 있습니다. 예를 들어, 새 서블릿 마법사를 사용하여 웹 프로젝트에서 새 서블릿을 작성할 때, 마법사는 적절한 서블릿 항목을 web.xml 파일에 배치합니다.