Links Getting Started Administrators Application Developers Catalina Developers Jasper Developers | JNDI Resources HOW-TO| 소개 Introduction |
Tomcat 4에서는 운영하는 웹 어플리케이션에 대해 JNDI InitialContext
구현 인스턴스를 제공합니다. 지원 방식은 Java2 Enterprise
Edition 에서 제공되는 것과 호환됩니다. 이 InitialContext 에 있는
엔트리들은 $CATALINA_HOME/conf/server.xml 에서 설정되고, 웹 어플리케이션에
있는 웹 어플리케이션 배치 지시자(/WEB-INF/web.xml)에 있는 다음의 요소
들에 의해 참조될 것입니다:
<env-entry> - 환경 엔트리 Environment entry,
어플리케이션이 어떻게 동작할 지 설정하는 데 사용되는 단일-값 파라메터.<resource-ref> - 자원 레퍼런스 Resource reference,
전형적으로 Tomcat 4 에 설정된 JDBC DataSource, JavaMail Session,
또는 사용자 객체 팩토리들 같은 자원의 객체 팩토리에 대한 것입니다.<resource-env-ref> - 자원 환경 참고 Resource
environment reference, 서블릿 2.3 에 추가된 resource-ref의 새로운
변환형태이며 인증정보가 필요하지 않은 자원에 대한 보다 설정이 간단하다.
InitialContext 는 웹 어플리케이션이 처음으로 배치될 때, 설정되고,
(읽기전용 모드로 접근가능한) 웹 어플리케이션 컴포넌트에 대해 유효하게 됩니다.
모든 설정된 엔트리와 자원은 JNDI namespace 의 java:comp/env 부분
에 놓이게 되고, 자원에 대한 전형적인 접근은 - 이 경우, JDBC DataSource
에 대해서- 다음과 같이 특정한 것을 찾습니다:
 | | | |
// 현재 환경의 naming Context 획득하기
Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup("java:comp/env");
// data source 찾기
DataSource ds = (DataSource)
envCtx.lookup("jdbc/EmployeeDB");
// 풀로부터 connection 할당하고 사용하기
Connection conn = ds.getConnection();
... db에 접근하기 위해서 이 connection 사용하기 ...
conn.close();
| | | | |
JNDI를 사용하는 프로그래밍 API에 관해서, 또는 Tomcat이 에뮬레이트하는
Java2 Enterprise Edition (J2EE)서버에서 지원되는 특징들에 대해 더 자세한 정보를
얻기 위해서는 다음의 사양서를 참고하기 바랍니다:
|
| JNDI 자원 설정하기 Configuring JNDI Resources |
각각의 유효한 JNDI 자원은 $CATALINA_HOME/conf/server.xml
파일에 다음 요소를 포함하는 것에 근거하여 설정됩니다:
- <Environment> -
JNDI
InitialContext를 통해 웹어플리케이션에 노출되는
스칼라 환경 엔트리에 대한 이름들과 값들을 설정합니다.
(웹어플리케이션 배치 지시자에 있는 <env-entry> 요소를
포함한 것과 같읍니다).
- <Resource> -
이름과 어플리케이션에서 유효한 자원의 데이터 형을 지정합니다.
(웹어플리케이션 배치 지시자에서
<resource-ref> 요소를
포함한 것과 같읍니다).
- <ResourceParams> -
사용할 자원 factory implementation 의 자바 클래스명과 자원 factory 를 설정하는
데 사용되는 JavaBeans 프로퍼티를 설정합니다.
<Context> 요소(특정한 웹 어플리케이션과
연관된) 또는 <DefaultContext> 요소(
자동으로 배치된 어플리케이션을 위한 default 설정 특성들을 지정하는 데 사용되는) 안에
이들 요소들이 몇 개라도 중첩될 수 있습니다.
더우기, 웹 어플리케이션 배치 지시자(/WEB-INF/web.xml)에 포함된
모든 <env-entry>의 이름들과 값들은 초기 컨텍스트에 설정되고,
만일 대응되는 <Environment> 요소에서 (
override 속성이 "true" 로 지정함으로) 허가되었다면 conf/server.xml
로부터 대응되는 값들이 오버라이딩됩니다.
|
| Tomcat 표준 자원 팩토리 Tomcat Standard Resource Factories |
Tomcat 4는 웹 어플리케이션에 서비스를 제공하는 표준 자원 팩토리
시리즈를 포함합니다. 유연성을 갖기 위해서 웹 어플리케이션이나
설치지시자를 수정하지 않고 ($CATALINA_HOME/conf/server.xml 에서)
환경설정을 할 수 있습니다. 아래의 각 서브섹션은 환경설정과 표준 자원
팩토리의 사용에 대해서 자세히 설명합니다.
사용자 자원
팩토리 추가하기 Adding Custom Resource Factories 를 보면,
어떻게 만들고, 설치하고, 설정하고, 사용자의 자원팩토리 클래스를
Tomcat 4에서 사용하는 법을 알 수 있습니다.
NOTE - 표준 자원 팩토리 중에서, "JDBC Data Source" 와
"User Transaction" 팩토리는 다른 플랫폼에서 사용할 수 있도록 되어
있습니다만 그 플랫폼이 Java2 Enterprise Edition (J2EE) 스펙에 따를
경우만 해당됩니다. 직접 제작한 사용자 자원 팩토리를 포함해서 다른
모든 표준 자원 팩토리들은 Tomcat 에서만 사용할 수 있으며 다른 컨
테이너에서 사용할 수 있도록 되어있지는 않습니다.
| JavaMail Sessions |
0. 소개 Introduction
많은 웹 어플리케이션에서, email 메시지 보내기는 시스템 기능에서
요청되는 부분입니다. Java Mail API
는 상대적으로 쉽게 처리할 수 있게 했습니다만, 많은 클라이언트 어플
리케이션이 알고 있어야 할 많은 환경설정을 필요로 합니다. (예를 들면
메시지를 보내는 데 사용되는 SMTP 호스트 명 같은 것입니다.)
Tomcat 4 는 javax.mail.Session 세션 인스턴스를 만드는
표준 자원 팩토리를 포함합니다, server.xml 에 SMTP 서버가
설정/연결되어 있다면 말이죠. 이같은 방법으로 어플리케이션은 email 서버
설정 환경에서 완전히 격리됩니다 - 필요할 때마다 단순히 미리 설정된
세션을 요청하고, 받아오면 됩니다.
이것에 대한 과정들은 아래 설명하겠습니다.
1. 자원 요건 선언하기 Declare Your Resource Requirements
처음에 웹 어플리케이션 설치 지시자(/WEB-INF/web.xml) 를
수정해서 미리 설치된 세션을 찾는 JNDI 명을 선언합니다. 규약에 의하면, 모든
이름은 mail 서브컨텍스트로 결말지어져야 합니다.(제공된 모든
자원 팩토리의 루트가 되는 표준 java:comp/env 네이밍 컨텍스트에
상대적입니다.) 전형적인 web.xml 엔트리는 다음과 같습니다:
| | | |
<resource-ref>
<description>
javax.mail.Session 인스턴스의 팩토리에 대한 자원 참조입니다.
적당한 SMTP 서버에 연결되어 있다면 email 을 보낼 때 사용
됩니다.
Resource reference to a factory for javax.mail.Session
instances that may be used for sending electronic mail
messages, preconfigured to connect to the appropriate
SMTP server.
</description>
<res-ref-name>
mail/Session
</res-ref-name>
<res-type>
javax.mail.Session
</res-type>
<res-auth>
Container
</res-auth>
</resource-ref>
| | | | |
경고 WARNING - 웹 어플리케이션 설치 지시자의 DTD에
요구되는 요소의 순서가 제대로 되어있는지 확실히 해야 합니다!
자세한 내용은
Servlet
Specification 를 보십시오.
2. 이 자원을 사용하는 어플리케이션 코딩하기
Code Your Application's Use Of This Resource
이 자원 참조(resource reference)의 사용법은 다음과 같습니다:
| | | |
Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup("java:comp/env");
Session session = (Session) envCtx.lookup("mail/Session");
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress(request.getParameter("from"));
InternetAddress to[] = new InternetAddress[1];
to[0] = new InternetAddress(request.getParameter("to"));
message.setRecipients(Message.RecipientType.TO, to);
message.setSubject(request.getParameter("subject"));
message.setContent(request.getParameter("content"), "text/plain");
Transport.send(message);
| | | | |
알아둘 점은 어플리케이션이 웹 어플리케이션 설치 지시자에서 선언된
같은 자원참조 이름을 사용한다는 것입니다.
이것은 $CATALINA_HOME/conf/server.xml
에서 설정된 자원 팩토리와 아래처럼 대치될 수 있습니다.
3. Tomcat 의 자원 팩토리 설정하기
Tomcat의 자원 팩토리 환경설정를 하기 위해서는, $CATALINA_HOME/conf/server.xml
파일에서 이 웹 어플리케이션의 Context 요소(or nested inside
a DefaultContext element for the surrounding
<Host> or <Engine> element.)
안에 다음의 요소를 추가합니다.
| | | |
<Context ...>
...
<Resource name="mail/Session" auth="Container"
type="javax.mail.Session"/>
<ResourceParams name="mail/Session">
<parameter>
<name>mail.smtp.host</name>
<value>localhost</value>
</parameter>
</ResourceParams>
...
</Context>
| | | | |
주의할 점은 자원 이름(여기서, mail/Session)은 반드시
웹 어플리케이션 설치 지시자에 지정된 값과 일치해야 합니다.
현재 사용하는 네트웍의 SMTP 서비스를 제공하는 서버의 주소를
mail.smtp.host 파라메터의 값에 변경해 주십시오.
Example 어플리케이션
Tomcat에 포함되어 있는 /examples 어플리케이션은
이 자원 팩토리를 사용하는 예제를 갖고 있습니다. "JSP Examples" 링크
를 통해 접근할 수 있습니다. 실제로 메일 메시지를 보내는 서블릿의
소스 코드는 /WEB-INF/classes/SendMailServlet.java 에
있습니다.
경고 WARNING - 기본 설정환경은 SMTP 서버가
localhost 의 25번 포트를 사용하고 있다고 가정합니다.
그렇지 않다면, $CATALINA_HOME/conf/server.xml 파일을
열어서, mail.smtp.host 파라메터에 맞는 값에 현재
사용하는 네트워크에서 사용가능한 SMTP 서버의 이름으로 수정해주십시오.
|
|
| 커스텀 자원 팩토리 추가하기 Adding Custom Resource Factories |
표준 자원 팩토리의 어느것도 필요하지 않는다면, 직접 팩토리를 만들어서
Tomcat 4 에 통합할 수 있고, 이 팩토리를 사용하기 위해 conf/server.xml
환경파일에 설정해 넣을 수 있습니다. 아래 예제에서 팩토리를 하나
만들어 보겠습니다. 위에 있는
일반적인 JavaBean 자원 으로부터 com.mycompany.MyBean 빈을
어떻게 생성하는지 아는 팩토리입니다.
1. 자원 팩토리 클래스 만들기 Write A Resource Factory Class
JNDI 서비스 제공자 javax.naming.spi.ObjectFactory 인터페이스
를 구현하는 클래스를 만들어야 합니다. 웹 어플리케이션이 이 팩토리에 연결된
컨텍스트 엔트리에 lookup() 을 호출할 때마다, getObjectInstance()
메소드가 다음 argument들과 함께 호출됩니다:
- Object obj - 객체를 생성하는 데 사용되는 위치나
레퍼런스 정보를 포함하는 (null일 수도 있는) object. Tomcat 에서는,
이것은 항상
javax.naming.Reference 타입의 객체가 됩니다.
이 팩토리 클래스의 클래스명과 반환될 객체를 만드는데 사용할 환경
프로퍼티(conf/server.xml에 있는)를 갖고 있는 것입니다.
- Name name - 지정된 이름이 없다면 이 팩토리가
nameCtx, 또는 null에 상대적으로 연결될 이름.
- Context nameCtx -
name 파라메터로 지정된
것이나, name이 기본 초기 컨텍스트에 상대적이라면
null 에 상대적인 컨텍스트.
- Hashtable environment - (null일 수도 있는) 이 객체를
생성하는데 사용되는 환경. 이것은 일반적으로 Tomcat 객체 팩토리에서
무시됩니다.
MyBean 인스턴스를 만들수 있는 자원팩토리를 생성하려면
클래스를 이처럼 만들어야 합니다:
| | | |
package com.mycompany;
import java.util.Enumeration;
import java.util.Hashtable;
import javax.naming.Context;
import javax.naming.Name;
import javax.naming.NamingException;
import javax.naming.RefAddr;
import javax.naming.Reference;
import javax.naming.spi.ObjectFactory;
public class MyBeanFactory implements ObjectFactory {
public Object getObjectInstance(Object obj,
Name name, Context nameCtx, Hashtable environment)
throws NamingException {
// Acquire an instance of our specified bean class
MyBean bean = new MyBean();
// Customize the bean properties from our attributes
Reference ref = (Reference) obj;
Enumeration addrs = ref.getAll();
while (addrs.hasMoreElements()) {
RefAddr addr = (RefAddr) addrs.nextElement();
String name = addr.getType();
String value = (String) addr.getContent();
if (name.equals("foo")) {
bean.setFoo(value);
} else if (name.equals("bar")) {
try {
bean.setBar(Integer.parseInt(value));
} catch (NumberFormatException e) {
throw new NamingException("Invalid 'bar' value " + value);
}
}
}
// Return the customized instance
return (bean);
}
}
| | | | |
이 예제에서, 무조건적으로 새로운 com.mycompany.MyBean 클래스
의 인스턴스를 만들었고, (아래 참고) 이 팩토리를 구성하는
<ResourceParams> 요소에 포함된 파라메터들에 근거하여
프로퍼티들을 populating 했습니다.
알아둘 것은 factory로 명명된 어떤 파라메터도 그냥 넘어가야 합니다.
- 그 파라메터는 팩토리 클래스 자신의 이름을 지칭하는데 사용됩니다. (이 예제에선,
com.mycompany.MyBeanFactory) 설정된 bean의 프로퍼티에 사용되지는
않습니다.
ObjectFactory 에 관한 더 자세한 정보는
JNDI 1.2 Service
Provider Interface (SPI) Specification을 보십시오.
이 클래스를 컴파일 할 때 $CATALINA_HOME/common/lib 와
$CATALINA_HOME/server/lib 디렉토리에 있는 모든 JAR 파일을
포함한 class path 가 필요할 수도 있습니다. 이럴 경우, 팩토리 클래스(
그리고 상관된 bean 클래스)를 $CATALINA_HOME/common/classes
또는 JAR 파일을 $CATALINA_HOME/common/lib 에 위치시키십시오.
이런 방식으로, 필요한 클래스 파일들은 Catalina 내부 자원들과 웹 어플리케이션
모두 반영될 수 있습니다.
2. 자원 요건 선언하기 Declare Your Resource Requirements
다음으로, 웹 어플리케이션 설치 지시자 (/WEB-INF/web.xml)
를 수정해서 이 빈의 새로운 인스턴스를 요청할 때 쓸 JNDI 명을 선언합니다.
가장 간단한 접근은 다음과 같이 <resource-env-ref> 요소
를 사용하는 것입니다:
| | | |
<resource-env-ref>
<description>
Object factory for MyBean instances.
</description>
<resource-env-ref-name>
bean/MyBeanFactory
</resource-env-ref-name>
<resource-env-ref-type>
com.mycompany.MyBean
</resource-env-ref-type>
<resource-env-ref>
| | | | |
주의 WARNING - 웹 어플리케이션 설치 지시자의 DTD
에 요구되는 요소의 순서가 제대로인지 확인하십시오. 자세한 내용은
Servlet
Specification 를 확인하십시오.
3. 이 자원을 사용하는 어플리케이션 코딩하기
Code Your Application's Use Of This Resource
이 자원 환경 참조(resource environment reference)의 사용은
다음과 같습니다:
| | | |
Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup("java:comp/env");
MyBean bean = (MyBean) envCtx.lookup("bean/MyBeanFactory");
writer.println("foo = " + bean.getFoo() + ", bar = " +
bean.getBar());
| | | | |
4. Tomcat의 자원 팩토리 환경설정 Configure Tomcat's Resource Factory
Tomcat의 자원 팩토리 환경설정를 하기 위해서는, $CATALINA_HOME/conf/server.xml
파일에서 이 웹 어플리케이션의 Context 요소(or nested inside
a DefaultContext element for the surrounding
<Host> or <Engine> element.)
안에 다음의 요소를 추가합니다.
| | | |
<Context ...>
...
<Resource name="bean/MyBeanFactory" auth="Container"
type="com.mycompany.MyBean"/>
<ResourceParams name="bean/MyBeanFactory">
<parameter>
<name>factory</name>
<value>com.mycompany.MyBeanFactory</value>
</parameter>
<parameter>
<name>bar</name>
<value>23</value>
</parameter>
</ResourceParams>
...
</Context>
| | | | |
주의할 점은 자원 이름(여기서, bean/MyBeanFactory)은 반드시
웹 어플리케이션 설치 지시자에 지정된 값과 일치해야 합니다. 또한 bar
프로퍼티의 값을 초기화합니다, 이것은 새로운 빈이 반환되기 전에
setBar(23) 가 호출되게 합니다. foo 프로퍼티를
초기화 하지 않았기 때문에, 빈은 기본값이 무엇이든 그것의 생성자에 의해
만들어진 값을 갖게 될 것입니다.
어플리케이션 개발자의 관점과 자원환경참조의 선언할 때, 새로운 인스턴스를
요청하는 데 사용될 프로그래밍할 때 알아두어야 할 것은 Generic JavaBean
Resources 예제에 사용된 접근방식과 동일합니다. 이것이 말하는 바는
JNDI 자원 사용의 장점중의 하나는 기능의 캡슐화(encapsulate funtionality) 입니다.
- 자원을 사용하는 어플리케이션의 소스를 수정할 필요없이 기반 구현을 바꿀 수
있습니다. 단, 호환되는 API를 유지해야 합니다.
원본:http://jakarta.apache.org/tomcat/tomcat-4.0-doc/jndi-resources-howto.html
|
|
