====== Naming 서비스 ====== ===== 개요 ===== Naming 서비스는 Java Naming and Directory Interface(JNDI) API를 이용하여 자원(Resource)를 찾을 수 있도록 도와주는 서비스이다.Naming 서비스를 지원하는 Naming 서버에 자원을 등록하여 다른 어플리케이션에서 사용할 수 있도록 공개하고, Naming 서버에 등록되어 있는 자원을 찾아와서 이용할 수 있게 한다. {{:egovframework:rte:itl:naming_service.png|Naming Service 개요}} ==== 주요 개념 ==== === Java Naming and Directory Interface(JNDI) === Java Naming and Directory Interface(JNDI)는 Java 소프트웨어 클라이언트가 이름(name)을 이용하여 데이터 및 객체를 찾을 수 있도록 도와주는 디렉토리 서비스에 대한 Java API이다. * 참조 : http://en.wikipedia.org/wiki/JNDI ===== 설명 ===== Naming 서비스는 사용하는 방식에는 Spring XML Configuration 파일에 설정하는 방식과 JNDI API를 wrapping한 JndiTemplate class를 사용하는 방식이 있다. * [[#Spring XML Configuration 설정|Spring XML Configuration 파일에 설정하는 방식]] :\\ Spring XML Configuration 설정파일에 JNDI 객체를 bean으로 등록하는 방식으로, JNDI 객체를 Lookup만 할 수 있다. 일반적으로 가장 많이 사용된다. * [[#JndiTemplate 클래스 사용|JNDI API를 wrapping한 JndiTemplate class를 사용하는 방식]] :\\ Spring Framework에서 JNDI API를 쉽게 사용할 수 있도록 제공하는 JndiTemplate class를 직접 사용하는 방식으로, JNDI API 기능을 모두 사용해야 할 경우 사용하는 방식이다. ==== Spring XML Configuration 설정 ==== Spring Framework는 XML Configuration 파일에 JNDI 객체를 설정할 수 있다. 단, 설정 파일을 통해서는 JNDI 객체를 lookup하는 것만 가능하므로, bind, rebind, unbind 기능을 사용하려면 [[#Using JndiTemplate]] 방식을 사용해야 한다. Spring Framework은 XML Configuration을 간편하게 할 수 있게 하기 위해 2.0 버전부터 jee tag를 제공하고 있다. 전자정부 개발프레임워크는 Spring 2.5 이상을 기반으로 하기 때문에 본 가이드는 jee tag를 사용한 방식만을 설명한다. === 설정 === jee tag를 사용하기 위해서는 Spring XML Configuration 파일의 머릿말에 namespace와 schemaLocation를 추가해야 한다. *namespace : xmlns:jee="http://www.springframework.org/schema/jee" *schemaLocation : http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee.xsd

=== jndi-lookup tag === jndi-lookup tag는 JNDI 객체를 찾아서 bean으로 등록해주는 tag이다. == tag 설명 ==


    
        
            name=value
            ping=pong
            ...

* With single JNDI environment settings\\ \\ 아래는 단일 JNDI 환경 설정을 사용하여 JNDI 객체를 찾아오는 예제이다.\\ \\


    
        foo=bar

* With multiple JNDI environment settings\\ \\ 아래는 복수 JNDI 환경 설정을 사용하여 JNDI 객체를 찾아오는 예제이다.\\ \\


    
        
        
            foo=bar
            ping=pong

* Complex\\ \\ 아래는 이름 외 다양한 설정을 통해 JNDI 객체를 찾아오는 예제이다.\\ \\

=== local-slsb tag === local-slsb tag는 EJB Stateless SessionBean을 참조하기 위한 tag이다. == tag 설명 ==


    
        
            name=value
            ping=pong
            ...

* Complex\\ \\ local-slsb tag를 사용하기 위해 다양한 설정 값을 이용하는 예제이다.\\ \\

=== remote-slsb tag === remote-slsb tag는 remote EJB Stateless SessionBean을 참조하기 위한 tag이다. == tag 설명 ==


    
        
            name=value
            ping=pong
            ...

* Complex\\ \\ remove-slsb tag를 사용하기 위해 다양한 설정 값을 이용하는 예제이다.\\ \\

==== JndiTemplate 클래스 사용 ==== JndiTemplate class는 JNDI API를 쉽게 사용할 수 있도록 제공하는 wrapper class이다. === bind === 아래 JndiTemplateSample class의 bind 메소드는 JndiTemplate을 이용하여 argument 'resource'를 argument 'name'으로 JNDI 객체로 bind한다.


import javax.naming.NamingException;

import org.springframework.jndi.JndiTemplate;

...

public class JndiTemplateSample
{
    private JndiTemplate jndiTemplate = new JndiTemplate();
    
    ...

    public boolean bind(final String name, Object resource)
    {
        try
        {
            jndiTemplate.bind(name, resource);
            return true;
        }
        catch (NamingException e)
        {
            e.printStackTrace();
            return false;
        }
    }

    ...
}

=== lookup === JndiTemplate을 이용하여 argument 'name'으로 등록되어 있는 자원(resource)를 찾을 수 있다.


    public Object lookupResource(final String name)
    {
        try
        {
            return jndiTemplate.lookup(name);
        }
        catch (NamingException e)
        {
            e.printStackTrace();
            return null;
        }
    }

=== lookup with requiredType === JndiTemplate의 lookup 메소드는 찾고자 하는 자원의 이름 뿐 아니라 원하는 타입(Type)을 지정할 수 있다.


    public Foo lookupFoo(final String fooName)
    {
        try
        {
            return jndiTemplate.lookup(fooName, Foo.class);
        }
        catch (NamingException e)
        {
            e.printStackTrace();
            return null;
        }
    }

=== rebind === JndiTemplate의 rebind 메소드를 사용하여 자원을 재등록할 수 있다.


    public boolean rebind(final String name, Object resource)
    {
        try
        {
            jndiTemplate.rebind(name, resource);
            return true;
        }
        catch (NamingException e)
        {
            e.printStackTrace();
            return false;
        }
    }

=== unbind === JndiTemplate의 unbind 메소드를 사용하여 등록된 자원을 등록해제할 수 있다.


    public boolean unbind(final String name)
    {
        try
        {
            jndiTemplate.unbind(name);
            return true;
        }
        catch (NamingException e)
        {
            e.printStackTrace();
            return false;
        }
    }

===== 참고자료 ===== *[[http://static.springframework.org/spring/docs/2.5.x/api/org/springframework/jndi/JndiTemplate.html|Spring Framework JndiTemplate class API]] *[[http://static.springframework.org/spring/docs/2.5.x/reference/xsd-config.html#xsd-config-body-schemas-jee|The Spring Framework - Reference Documentation A.2.3. The jee schema]] *[[http://java.sun.com/j2se/1.5.0/docs/guide/jndi/index.html|Java SE Guide to JNDI]]