The GlobalNamingResources Component

Introduction

GlobalNamingResources 엘리먼트는 JNDI의 전역자원을 나타내며, 이 자원들은 Server 안에서 정의됩니다.

Attributes

Nested Components

Special Features

Environment Entries
웹애플리케이션에서 환경항목자원(environment entry resources)으로 사용할 수 있도록 항목의 이름-값 들을 설정할 수 있습니다. 이 설정은 <Environment> 항목을 이 엘리먼트 내에 중첩시키면 됩니다. 예를 들어 아래와 같이 환경항목을 생성할 수 있습니다:
<GlobalNamingResources ...>
  ...
  <Environment name="maxExemptions" value="10"
         type="java.lang.Integer" override="false"/>
  ...
</GlobalNamingResources>
이 설정은 웹애플리케이션 배치 디스크립터(/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> 엘리먼트에서는 다음과 같은 속성들을 사용할 수 있습니다:

Attribute Description
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으로 변환 가능해야 합니다.
Resource Definitions
웹애플리케이션 배치 디스크립터의 <resource-ref>와 <resource-env-ref> 엘리먼트의 JNDI 탐색(lookup)에 대해 반환될 자원의 특성도 선언 가능합니다. 그리고 어떤 자원에 대해서 객체팩토리를 사용하도록(Tomcat이 아직 모르는 경우), 그리고 그 객체팩토리를 설정하는데 사용할 프로퍼티를 설정하려면, 반드시 그 자원과 같은 이름으로 자원 파라미터(Resource Parameters)를 추가로 정의해야 합니다.

예를 들어 다음과 같이 자원정의가 가능합니다:
<GlobalNamingResources ...>
  ...
  <Resource name="jdbc/EmployeeDB" auth="Container"
            type="javax.sql.DataSource"
     description="Employees Database for HR Applications"/>
  ...
</GlobalNamingResources>
이 설정은 웹애플리케이션 배치 디스크립터(/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> 엘리먼트에서는 다음과 같은 속성들을 사용할 수 있습니다:

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

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

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

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

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

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

예로 JDBC 데이터 소스에 대한 자원 파라미터 설정은 아래와 같이 됩니다:
<GlobalNamingResources ...>
  ...
  <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>
  ...
</GlobalNamingResources>
만약 특정 자원 타입에 대해 팩토리 클래스의 Java 클래스명을 지정할 필요가 있다면, <ResourceParams> 엘리먼트 내의 <parameter> 항목에 factory라는 이름을 사용하면 됩니다.

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

Attribute Description
name
설정할 자원의 이름이며, java:comp/env 컨텍스트에 대한 상대적인 이름이 됩니다. 이 이름은 $CATALINA_HOME/conf/server.xml 내에 <Resource> 엘리먼트로 정의된 자원, 그리고/또는 웹애플리케이션 배치 디스크립터 내에 <resource-ref> 또는 <resource-env-ref>로 참조되는 자원의 이름과 반드시 일치해야 합니다.