웹 단편

웹 애플리케이션 개발 시, 다중 웹 모듈은 동일한 컴포넌트를 사용하면 웹 단편 JAR(Java Archive) 파일의 컴포넌트 포함을 고려하십시오. 웹 단편 JAR 파일은 구성 메타데이터 및 컴포넌트 클래스 파일 모두를 포함합니다. 이 방법을 사용하면 애플리케이션에서 애플리케이션으로의 복사가 더 쉬워질 수 있습니다.

웹 모듈 배치 디스크립터 단편(웹 단편)은 web.xml 파일이 제공하는 동일 구성 메타데이터를 제공하지만, WEB-INF/lib 디렉토리의 JAR 파일 내 패키지된 web-fragment.xml 파일로 존재합니다.

프레임워크 개발자는 특정 프레임워크를 사용하는 웹 애플리케이션에 포함된 JAR 파일을 제공합니다. 프레임워크가 서블릿, 필터 또는 기타 웹 모듈 구성을 사용하는 경우, 웹 단편은 기존 웹 모듈 구성에 대한 변경을 요구하지 않고 단순히 JAR 파일을 애플리케이션으로 끌어오는 기능을 제공합니다. 이전에 웹 애플리케이션 개발자는 프레임워크에서 필요한 추가 메타데이터로 구성을 기능 보강해야 합니다. 다른 유스 케이스는 위에서 언급된 요구사항으로 웹 모듈에서 동일한 컴포넌트를 사용합니다. 또한, mock 오브젝트나 스텁을 사용하면 웹 단편으로 더 쉽게 만들 수 있습니다.

웹 단편 스캔은 web-fragment.xml 파일을 검사하는 각 JAR 파일에 대한 성능을 저하시킵니다. 웹 애플리케이션에서 JAR 파일의 수가 높을수록 성능 영향이 높습니다. 성능이 문제되는 경우, metadata-complete를 true로 설정하여 웹 단편 스캔을 사용 안함으로 설정하고 web.xml 파일에 필요한 구성을 포함합니다.
문제점 방지 문제점 방지: 웹 단편 스캔을 사용 안함으로 설정하면 어노테이션 스캔을 사용 안함으로 설정할 수도 있습니다. 그러므로 둘 중 하나가 필요하면 모두가 스캔됩니다.gotcha
중요사항: web.xml 파일의 metadata-complete 요소를 true로 설정하여 단편 스캔을 사용 안함으로 설정합니다. web.xml 파일에서 절대 순서 지정 태그를 사용하여 웹 단편 스캔의 순서를 지정하거나 웹 단편의 서브세트 스캔을 강제 적용합니다. web-fragment.xml 파일에서 상대 순서 지정 태그를 사용하여 다른 단편에 대해 상대적인 순서를 지정합니다.
웹 단편에 포함된 서블릿, 필터 또는 보안 제한조건을 알 수 없는 경우, 웹 애플리케이션에 단편을 포함하면 엔드포인트를 보안 위험에 노출할 수 있습니다. 구성된 모든 서블릿 및 보안 제한조건이 예상대로 작동하는지 확인하십시오.
문제점 방지 문제점 방지: 웹 단편에 충돌이 있는 경우 애플리케이션은 배치되지 않습니다. 애플리케이션 설치 시 충돌이 있는 경우, SystemOut.log 파일을 보고 충돌 중인 항목을 이해합니다.gotcha
참고: 이 주제는 하나 이상의 애플리케이션 서버 로그 파일을 참조합니다. 권장되는 대안은 분배 및 IBM® i 시스템에서 SystemOut.log, SystemErr.log, trace.logactivity.log 파일을 사용하는 대신 HPEL(High Performance Extensible Logging) 로그를 사용하고 인프라를 추적하도록 서버를 구성하는 것입니다. 원시 z/OS® 로깅 기능과 연계하여 HPEL을 사용할 수도 있습니다. HPEL을 사용하는 경우 서버 프로파일 바이너리 디렉토리의 LogViewer 명령행 도구를 사용하여 모든 로그에 액세스하고 정보를 추적할 수 있습니다. HPEL 사용에 대한 자세한 정보는 HPEL을 사용한 애플리케이션 문제점 해결 정보를 참조하십시오.
Servlet 3.0 스펙에서 웹 단편과 어노테이션 병합을 위한 일반 규칙:
  • WEB-INF/lib 디렉토리에 있는 경우 JAR 파일은 어노테이션이나 웹 단편 메타데이터에 대해서만 스캔됩니다. 공유된 라이브러리는 어노테이션 또는 웹 단편 메타데이터에 대해서 스캔되지 않습니다.
  • WEB-INF/클래스 디렉토리의 클래스에 있는 어노테이션이 먼저 병합되며 WEB-INF/lib 디렉토리의 메타데이터보다 우선합니다.
  • web-fragment.xml 파일을 포함하는지 여부와 상관 없이 WEB-INF/lib 디렉토리의 모든 JAR 파일은 웹 단편으로 간주됩니다. web-fragment.xml 파일이 JAR 파일에 존재하지 않으면, 내재적인, 비어 있는 web-fragment.xml 파일이 있는 것으로 간주됩니다.
  • 충돌되는 웹 단편을 검사하기 전에 WEB-INF/lib 디렉토리의 각 JAR 파일에 대한 어노테이션이 해당 web-fragment.xml 파일로 병합됩니다. 그러므로 다른 단편의 어노테이션 충돌로 애플리케이션이 배치되지 못하도록 합니다.
  • 웹 단편 순서 지정을 정의하는 경우, 하나의 웹 단편에 대해 어노테이션 및 웹 단편 메타데이터 모두는 순서에서 나중인 다른 단편 앞에 병합됩니다.
  • WEB-INF/lib 디렉토리의 모든 JAR 파일이 단편으로 간주되기 때문에, <absolute-ordering> 요소의 <others> 요소는 순서 지정의 다른 곳에서 언급되지 않은 모든 JAR 파일에 적용합니다.
 

주제 유형을 표시하는 아이콘 개념 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cweb_webfragments
파일 이름:cweb_webfragments.html