JavaServer Pages 정적 파일 액세스를 위한 웹 컨테이너 구성

웹 컨테이너는 애플리케이션 구성에 따라서 최고 4개의 위치에서 정적 파일 및 JSP(JavaServer Pages) 파일을 검색합니다. 이 검색은 인바운드 요청을 서비스하기 위해 적절한 자원 찾기 및 다음 API에서 리턴되는 결과와 관련됩니다.
URL ServletContext.getResource(String path)
Set ServletContext.getResourcePaths(String path) 
주의: 정적 파일은 fileServing 특성이 사용으로 설정되고 애플리케이션이 /* 서블릿 맵핑을 포함하지 않을 때만 검색됩니다. 또한, JSP 파일은 web.xml 파일에서 정의되는 다른 모든 패턴 외에 다음 확장기능을 갖는 파일을 포함합니다.
  • .jsp
  • .jspx
  • .jsw
  • .jsv
4가지 위치는 우선순위 순서에 따라 다음과 같습니다.
애플리케이션 WAR 디렉토리
웹 컨테이너는 먼저 요청된 자원에 대해 애플리케이션 WAR 디렉토리를 검색합니다. 그러나, getResource() 및 getResourcePaths() 메소드를 사용하여 액세스할 수 있긴 하지만 인바운드 요청을 위해 WEB-INF 또는 META-INF 디렉토리의 자원을 서비스할 수 없습니다.
단편 전 문서 루트
웹 컨테이너는 모든 애플리케이션이 정의한 단편 전 문서 루트를 2차로 검색합니다. 애플리케이션에 대한 WEB-INF 디렉토리에 위치한 ibm-web-ext.xmi 파일에서 단편 전 문서 루트를 정의하십시오. 정적 파일 또는 JSP 파일에 대한 단편 전 문서 루트를 다음과 같이 정의하십시오.
정적 파일:
<fileServingAttributes xmi:id="<user-provided name>"
 name="preFragmentExtendedDocumentRoot"
 value="<user provided value>"/>
JSP 파일:
<jspAttributes xmi:id="<user provided name>" name="preFragmentExtendedDocumentRoot"
 value=<user provided value>"/> 
<user provided name>은 디렉토리의 목록 및/또는 JAR의 목록일 수 있습니다. 예를 들어, 다음과 같습니다.
<fileServingAttributes name="extendedDocumentRoot"
      value="C:\EDR_directory,C:\my\path\to\jarEDR.jar"/>
<user provided name>이 디렉토리의 목록만 포함하며 해당 디렉토리가 JAR 파일을 포함하는 경우, 해당 JAR 파일 내부를 검색하지 않습니다. 해당 디렉토리 내부에서만 정적 파일 및 JSP 파일을 검색하며 JSP 파일 밖에서는 검색하지 않습니다. 정적 또는 JSP 파일이 jar에 있는 경우, 정적 또는 jsp 파일은 JAR 파일의 META-INF 폴더 내부에 있을 수 없으며(제한 폴더이기 때문), <user provided name>이 JAR 파일에 대한 전체 경로를 포함해야 합니다.
주의: 단편 전 문서 루트는 WebSphere® Application Server 버전 9.0의 새 기능입니다.
애플리케이션 WAR 파일의 WEB-INF/Lib 디렉토리에 있는 단편의 META-INF/resources 디렉토리
단편 전 문서 루트를 검색한 후, 웹 컨테이너가 웹 단편을 검색합니다. 웹 단편은 애플리케이션 WEB-INF/lib 디렉토리에 있는 JAR 파일로 구성됩니다. JAR은 JAR 파일 내에서 정의되는 META-INF/resources 디렉토리의 정적 자원을 포함할 수 있습니다. 웹 컨테이너가 META-INF/resources 디렉토리를 검색하지 못하게 하려면 com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing 웹 컨테이너 사용자 정의 특성을 true로 설정하십시오. 사용자 정의 특성의 기본값은 false입니다.
com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing = true
주의: 애플리케이션 WAR 파일에 있는 WEB-INF/Lib 디렉토리에 있는 단편의 META-INF/resources 디렉토리는 WebSphere Application Server 버전 9.0의 새 기능입니다.
확장 문서 루트
마지막으로, 웹 컨테이너가 확장 문서 루트로 정의된 모든 애플리케이션을 검색합니다. 확장 문서 루트는 이전 릴리스에서 사용 가능했으며 애플리케이션 WEB-INF 디렉토리에 위치하는 ibm-web-ext.xmi 파일에서 정의됩니다. 정적 파일 또는 JSP 파일에 대한 확장 문서 루트를 다음과 같이 정의하십시오.
정적 파일:
<fileServingAttributes xmi:id="<user provided name>" name="extendedDocumentRoot"
 value="<user provided value>"/>
JSP 파일:
<jspAttributes xmi:id="<user provided name>" name="extendedDocumentRoot"
 value=<user provide value>"/>
com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing = true
<user provided name>은 디렉토리의 목록 및/또는 JAR의 목록일 수 있습니다. 예를 들어, 다음과 같습니다.
<fileServingAttributes name="extendedDocumentRoot"
      value="C:\EDR_directory,C:\my\path\to\jarEDR.jar"/>
<user provided name>이 디렉토리의 목록만 포함하며 해당 디렉토리가 JAR 파일을 포함하는 경우, 해당 JAR 파일 내부를 검색하지 않습니다. 해당 디렉토리 내부에서만 정적 파일 및 JSP 파일을 검색하며 JSP 파일 밖에서는 검색하지 않습니다. 정적 또는 JSP 파일이 jar에 있는 경우, 정적 또는 jsp 파일은 JAR 파일의 META-INF 폴더 내부에 있을 수 없으며(제한 폴더이기 때문), <user provided name>이 JAR 파일에 대한 전체 경로를 포함해야 합니다.
주의: com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot 사용자 정의 특성을 true로 설정하여 정적 파일 확장 문서 루트로부터 정적 시작 페이지 서비스를 가능하게 할 수 있습니다. 사용자 정의 특성의 기본값은 false입니다.
com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot = true
com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot 특성이 true로 설정되면 웹 컨테이너는 정적 파일 확장 문서 루트에서 유효한 부분 URL로 구성된 요청에 대해 서비스할 정적 시작 파일을 검색합니다. 예를 들어, 요청이 애플리케이션 컨텍스트만 지정하고 시작 파일이 index.html로 지정되는 경우, index.html이 정적 파일 확장 문서로부터 서비스될 경우 해당 특성을 설정해야 합니다.
com.ibm.ws.webcontainer.enablepartialurltoextendeddocumentroot = true
기본값은 false입니다.

이 특성이 true로 설정되는 경우, 웹 컨테이너는 인바운드 요청이 유효한 부분 URL에 대한 것인지 판별할 때 정적 파일 확장 문서 루트의 컨텐츠를 포함합니다. 예를 들어, 요청이 /<application context>/<text>로 끝나는 URL을 지정하고 <text>가 서블릿이나 정적 파일에 맵핑하지 않는 경우, 웹 컨테이너는 <text>가 애플리케이션의 유효한 디렉토리엔 경우에만 이 URL을 유효한 부분 URL로 간주합니다. 결과적으로 <text> 디렉토리가 정적 파일 확장 문서 루트에만 존재하는 경우 URI가 유효한 부분 URI로 간주되기 위해 이 특성이 설정되어야 합니다.

중요사항: 이들 특성은 정적 파일 단편 전 문서 루트의 경우 필수가 아닙니다. 또한, 유효한 부분 URL을 판별할 때, 웹 컨테이너는 JSP 단편 전 및 확장 문서 루트를 고려하지 않습니다.

주제 유형을 표시하는 아이콘 참조 주제



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