The DefaultContext Component

DefaultContext 엘리먼트는 Context에 대한 설정세팅의 서브셋을 나타냅니다. 이 엘리먼트는 자동으로 생성되는 Context들에 대한 디폴트 설정 프로퍼티(default configuration properties)를 나타내기 위해 Engine 또는 Host 엘리먼트 내에 포함시킬 수 있습니다.

Catalina가 여기에서 저장한 설정 프로퍼티를 근거로 하여 자동으로 Context를 생성해 주는 상황에 대한 자세한 정보는 어플리케이션의 자동배치(Automatic Application Deployment)와 사용자 웹어플리케이션(User Web Applications)을 참고하십시오.

속성(Attributes)

공통속성(Common Attributes)

DefaultContext의 모든 구현체는 다음 속성들을 지원하게 됩니다:

속성 설명
cookies
true(디폴트)로 지정하면 클라이언트가 쿠키를 지원하는 경우 세션확인의 통신수단(session identifier communication)으로 쿠키를 사용합니다. false로 지정하면 세션확인의 통신수단으로 쿠키 사용을 하지 않고, 어플리케이션에 의한 URL 다시쓰기(URL rewriting)에만 의존한다는 의미입니다.

crossContext
true로 지정하면 이 어플리케이션에서 ServletContext.getContext() 호출을 통해 이 가상호스트에서 실행중인 다른 웹어플리케이션에 대한 요청 디스패쳐(request dispatcher)를 성공적으로 얻을 수 있습니다. 보안상의 이유로 false(디폴트)로 지정하면 getContext()는 언제나 null을 반환하게 됩니다.

reloadable
true로 지정하면, Catalina는 /WEB-INF/classes/와 /WEB-INF/lib 안 클래스 들의 변경여부를 감시하다가, 변경이 발견되면 웹어플리케이션을 자동으로 재적재(reload)합니다. 이 기능은 개발중에는 매우 유용하지만 얼마간의 실행부하(runtime overhead)가 발생하므로, 실제 운영할 용도로 어플리케이션을 배치(deploy)할 때는 사용하지 않도록 합니다. 그러나 이미 배치가 끝난 어플리케이션이라도 Manager 웹어플리케이션을 이용하면 필요할 때 재적재 하도록 할 수 있습니다.

wrapperClass
이 컨텍스트로 관리할 서블릿 들에 대해 사용할 org.apache.catalina.Wrapper 구현 클래스의 Java 클래스명입니다. 지정하지 않으면 디폴트값이 사용됩니다.

기본구현체(Standard Implementation)

DefaultContext의 기본구현체는 org.apache.catalina.core.DefaultContext 클래스입니다. 이 클래스는 위에 나열한 공통속성 외에도 다음과 같은 추가 속성을 제공합니다:

속성 설명
swallowOutput
이 값이 true 이면, 웹어플리케이션에서 System.out과 System.err 으로 보내지는 바이트 출력은 모두 웹어플리케이션의 로거로 재지정(redirect)됩니다. 이 값을 지정하지 않으면 false로 인식합니다.

useNaming
이 웹어플리케이션에서 Java2 Enterprise Edition (J2EE) 플랫폼 규약에 맞는 JNDI InitialContext를 사용가능하게 하도록 설정하려면 true(디폴트값)로 지정합니다.

특별기능(Special Features)

컨텍스트 파라미터(Context Parameters)
이 엘리먼트 안에 <Parameter> 엘리먼트 들을 중첩시키면, 웹어플리케이션에서 서블릿-컨텍스트 초기화 파라미터(servlet context initialization parameters)로 이용가능한 파라미터이름-값 들을 설정할 수 있습니다. 예를 들어 다음과 같이 하면 초기화 파라미터를 생성할 수 있습니다:
<DefaultContext ...>
  ...
  <Parameter name="companyName" value="My Company, Incorporated"
         override="false"/>
  ...
</DefaultContext>
이는 웹어플리케이션 배치 디스크립터(/WEB-INF/web.xml) 안에 다음과 같은 엘리먼트를 포함시키는 것과 동일합니다:
<context-param>
  <param-name>companyName</param-name>
  <param-value>My Company, Incorporated</param-value>
</context-param>
하지만 이 값을 커스터마이즈하기 위해 배치 디스크립터를 변경할 필요는 없습니다.

<Parameter> 엘리먼트에서는 다음과 같은 속성을 사용할 수 있습니다:

속성 설명
description
이 컨텍스트 초기화 파라미터에 대한 간략한 설명이며, 생략가능

name
생성할 컨텍스트 초기화 파라미터의 이름.

override
웹어플리케이션 배치 디스크립터에서 여기에서 지정한 초기화 파라미터와 같은 이름의 <context-param>를 지정했을 때 그 파라미터 값의 덮어쓰기(override)를 허용하지 않으려면 false로 설정합니다. 디폴트값은 true입니다.

value
웹어플리케이션에서 ServletContext.getInitParameter()을 호출할 때 반환할 파라미터 값.
환경항목(Environment Entries)
웹어플리케이션에서 환경항목자원(environment entry resources)으로 사용할 수 있도록 항목의 이름-값 들을 설정할 수 있습니다. 이 설정은 <Environment> 항목을 이 엘리먼트 내에 중첩시키면 됩니다. 예를 들어 아래와 같이 환경항목을 생성할 수 있습니다:
<DefaultContext ...>
  ...
  <Environment name="maxExemptions" value="10"
         type="java.lang.Integer" override="false"/>
  ...
</DefaultContext>
이는 웹어플리케이션 배치 디스크립터(/WEB-INF/web.xml)에서 다음의 엘리먼트를 포함시킨 것과 동일합니다:
<env-entry>
  <env-entry-name>maxExemptions</param-name>
  <env-entry-value>10</env-entry-value>
  <env-entry-type>java.lang.Integer</env-entry-type>
</env-entry>
그러나 이 값을 커스터마이즈하기 위해 배치 디스크립터를 변경할 필요는 없습니다.

<Environment> 엘리먼트에서는 다음과 같은 속성들을 사용할 수 있습니다:

속성 설명
description
(선택사항)이 환경항목에 대한 사람이 읽기 쉬운 간단한 설명

name
생성할 환경항목의 이름. java:comp/env 컨텍스트에 대한 상대적인 이름입니다.

override
웹어플리케이션 배치 디스크립터에서 <env-entry>으로 같은 이름의 환경항목을 지정하는 경우, 여기에서 지정한 값을 덮어쓰기(override) 하지 않도록 하고 싶으면 false로 지정합니다. 이 값을 지정하지 않으면 덮어쓰기가 허용됩니다.

type
이 환경항목에 대해 웹어플리케이션이 예상하는 완전한(fully qualified) Java 클래스명. 반드시 웹어플리케이션 배치 디스크립터의 <env-entry-type>의 규칙에 맞는 값이어야 합니다. 그 규칙에 맞는 값 들은: java.lang.Boolean, java.lang.Byte, java.lang.Character, java.lang.Double, java.lang.Float, java.lang.Integer, java.lang.Long, java.lang.Short, 또는 java.lang.String 입니다.

value
웹어플리케이션이 JNDI 컨텍스트로부터 요청해서 반환 받을 환경항목의 값. 이 값은 반드시 위의 type에 정의된 Java type으로 변환 가능해야 합니다.
Lifecycle Listeners
만약 이 Context가 언제 시작되고 종료되는지 어떤 Java 객체가 알 필요가 있다면, 이 엘리먼트 안에 Listener 엘리먼트를 포함시켜서 그 Java 클래스명을 선언하면 됩니다. 이 때 지정하는 Java 클래스는 org.apache.catalina.LifecycleListener 인터페이스를 반드시 구현해야 하며, 해당 생명주기 이벤트 발생에 대해 통지를 받게 될 것입니다. 리스너의 설정은 다음과 같습니다:
<DefaultContext  ...>
  ...
  <Listener className="com.mycompany.mypackage.MyListener" ... >
  ...
</DefaultContext>
Listener는 이 엘리먼트에 설정될 추가 프로퍼티를 얼마든지 가질 수 있음을 기억하십시오. 속성명은 표준 프로퍼티 메소드(getter/setter) 명명규칙을 사용하는 해당 JavaBean 속성명에 매칭됩니다.
자원정의(Resource Definitions)
웹어플리케이션 배치 디스크립터의 <resource-ref>와 <resource-env-ref> 엘리먼트의 JNDI 탐색(lookup)에 대해 반환될 자원의 특성도 선언 가능합니다. 그리고 어떤 자원에 대해서 객체팩토리를 사용하고(Tomcat이 아직 모르는 경우) 그 객체팩토리를 설정하는데 사용할 프로퍼티를 설정하려면, 반드시 그 자원과 같은 이름으로 자원 파라미터(Resource Parameters)를 추가로 정의해야 합니다.

예를 들어 다음과 같이 자원정의가 가능합니다:
<DefaultContext ...>
  ...
  <Resource name="jdbc/EmployeeDB" auth="Container"
            type="javax.sql.DataSource"
     description="Employees Database for HR Applications"/>
  ...
</DefaultContext>
이것은 웹어플리케이션 배치 디스크립터(/WEB-INF/web.xml)에 다음의 엘리먼트를 포함시킨 것과 동일합니다:
<resource-ref>
  <description>Employees Database for HR Applications</description>
  <res-ref-name>jdbc/EmployeeDB</res-ref-name>
  <res-ref-type>javax.sql.DataSource</res-ref-type>
  <res-auth>Container</res-auth>
</resource-ref>
그러나 이 값을 커스터마이즈하기 위해 배치 디스크립터를 변경할 필요는 없습니다.

<Resource> 엘리먼트에서는 다음과 같은 속성들을 사용할 수 있습니다:

속성 설명
auth
해당 자원관리자에 인증(sign on)할 때, 웹어플리케이션 프로그램의 코드상에서 직접 할지, 또는 컨테이너가 직접 어플리케이션의 행위(behalf)에 따라 할지를 지정합니다. 이 속성의 값은 반드시 Application 또는 Container 중 하나여야 합니다. 이 속성은, 웹어플리케이션이 웹어플리케이션 배치 디스크립터에서 <resource-ref> 엘리먼트를 사용하는 경우에는 반드시 필요합니다. 그러나 <resource-env-ref>를 대신 사용하는 경우에는 선택사항입니다.

description
(선택사항)이 자원에 대한 사람이 읽기 쉬운 간단한 설명

name
생성할 자원의 이름. java:comp/env 컨텍스트에 대한 상대적인 이름입니다.

scope
이 자원관리자를 통해 얻어진 연결(connection)의 공유를 허가할 것인지 지정합니다. 이 속성의 값은 반드시 Shareable 또는 Unshareable 중 하나여야 합니다. 지정하지 않으면 연결은 공유가능(shareable)이 됩니다.

type
웹어플리케이션이 이 자원에 대해 탐색(lookup)을 실행할 때 기대하는 완전한 Java 클래스명.
자원 파라미터(Resource Parameters)
이 엘리먼트는 웹어플리케이션에서 해당 자원의 이름에 대해 JNDI 탐색을 수행할 때, 객체를 반환하는데 사용할 자원관리자(또는 객체팩토리)를 설정하는 역할을 합니다. $CATALINA_HOME/conf/server.xml의 <Context>나 <DefaultContext> 엘리먼트 내의 <Resource> 엘리먼트로 지정된 모든 자원 이름, 그리고/또는 웹어플리케이션 배치 디스크립터에서 <resource-ref> 나 <resource-env-ref> 엘리먼트에서 선언된 모든 자원 이름에 대해서는 반드시 자원 파라미터(resource parameters)를 정의해야 그 자원에 성공적으로 액세스할 수 있습니다.

자원 파라미터는 이름으로 정의되며, 정확하게 어떤 파라미터 이름들의 집합을 지원하는가는 당신이 사용하고 있는 자원관리자(또는 객체팩토리)에 따라 달라집니다. 즉 해당 팩토리 클래스의 JavaBeans 프로퍼티 중 설정가능한(settable) 프로퍼티의 이름과 일치해야 합니다. JNDI 구현체는 지정한 팩토리 클래스의 인스턴스에 대해 JavaBeans의 모든 해당 속성 설정메소드를 호출함으로써 모든 설정을 마친 다음에야, 이 팩토리 인스턴스를 JNDI lookup() 호출을 통해 사용가능하도록 할 것입니다.

예로 JDBC 데이터 소스에 대한 자원 파라미터 설정은 아래와 같이 됩니다:
<DefaultContext ...>
  ...
  <ResourceParams name="jdbc/EmployeeDB">
    <parameter>
      <name>driverClassName</name>
      <value>org.hsql.jdbcDriver</value>
    </parameter>
    <parameter>
      <name>driverName</name>
      </value>jdbc:HypersonicSQL:database</value>
    </parameter>
    <parameter>
      <name>user</name>
      <value>dbusername</value>
    </parameter>
    <parameter>
      <name>password</name>
      <value>dbpassword</value>
    </parameter>
  </ResourceParams>
  ...
</DefaultContext>
만약 특정 자원 타입에 대해 팩토리 클래스의 Java 클래스명을 지정할 필요가 있다면, <ResourceParams> 엘리먼트 내의 <parameter> 항목에 factory라는 이름을 사용하면 됩니다.

<ResourceParams> 엘리먼트가 가질 수 있는 속성은 다음과 같습니다:

속성 설명
name
설정할 자원의 이름이며, java:comp/env 컨텍스트에 대한 상대적인 이름이 됩니다. 이 이름은 $CATALINA_HOME/conf/server.xml 내에 <Resource> 엘리먼트로 정의된 자원, 그리고/또는 웹어플리케이션 배치 디스크립터 내에 <resource-ref> 또는 <resource-env-ref>로 참조되는 자원의 이름과 반드시 일치해야 합니다.
자원링크(Resource Links)
이 엘리먼트는 어떤 전역 JNDI 자원으로의 링크를 생성하는데 사용합니다. 그 연결명에 대하여 JNDI 탐색을 실행하면 링크된 전역자원이 반환됩니다.

예를 들어 다음과 같이 자원링크를 생성할 수 있습니다:
<DefaultContext ...>
  ...
  <ResourceLink name="linkToGlobalResource"
            global="simpleValue"
            type="java.lang.Integer"
  ...
</DefaultContext>
<ResourceLink> 엘리먼트가 가질 수 있는 속성은 다음과 같습니다:

속성 설명
global
전역 JNDI 컨텍스트내의 링크된 전역자원의 이름.

name
생성할 자원링크의 이름이며, java:comp/env에 대한 상대적인 이름입니다.

type
이 자원링크에 대해 탐색을 실행할 때 웹어플리케이션이 기대하는 완전한 Java 클래스명.