javax.naming
클래스 InitialContext

java.lang.Object 
  javax.naming.InitialContext

모든 구현된 인터페이스:

Context

알려진 직계 서브 클래스:

InitialDirContext

public class InitialContext
extends Object 
implements Context 

이 클래스는 네이밍 조작을 실행하기 위한 개시 컨텍스트 입니다.

네이밍 조작은 모두, 컨텍스트를 기준으로 합니다. 초기 컨텍스트에 는 Context 인터페이스가 구현되어 이름을 해결하는 개시점이 제공됩니다.

초기 컨텍스트이 구축되면, 생성자에게 건네지는 환경 파라미터 및 임의의 어플리케이션 resource file로 정의된 프로퍼티에 의해 환경이 초기화됩니다. 게다가 시스템 프로퍼티 또는 애플릿 파라미터 (Context.APPLET 사용에 한다)로서 소수의 표준 JNDI 프로퍼티가 지정되는 일도 있습니다. 이러한 특별한 프로퍼티는 Context 및 LdapContext 인터페이스 문서의 필드 상세 섹션에 리스트 표시됩니다.

JNDI 에서는 다음의 2개의 소스로부터 값을 순서에 머지 해, 각 프로퍼티의 값이 결정됩니다.

1. 생성자 환경 파라미터 및 (해당하는 프로퍼티의) 애플릿 파라미터와 시스템 프로퍼티로 최초로 출현하는 프로퍼티
2. 어플리케이션 resource file (jndi.properties)

이 2개의 소스, 또는 1개 이상의 어플리케이션 resource file의 프로퍼티에 대해, 프로퍼티의 값이 다음과 같이 결정됩니다. 프로퍼티가 JNDI 팩토리의 리스트를 지정하는 표준 JNDI 프로퍼티의 1개의 경우 (Context 를 참조), 값은 모두 1개의 구두점으로 단락지어진 리스트에 연결됩니다. 다른 프로퍼티의 경우는 검색된 최초의 값만이 사용됩니다.

초기 컨텍스트 의 구현은 실행시로 결정됩니다. 디폴트의 정책에 서는 초기 컨텍스트 팩토리의 클래스명을 포함한, 환경 프로퍼티 java.naming.factory.initial 가 사용됩니다. 이 정책에 대한 예외는 이하에 설명하도록, URL 캐릭터 라인을 해결할 경우에 작성됩니다.

이름 파라미터로서 URL 캐릭터 라인 (scheme_id:rest_of_name 형식의 String)이 메서드에게 건네지면, 그 쪽식을 처리하는 URL 컨텍스트 팩토리가 검색되어 URL 해결에 사용됩니다. 이러한 팩토리가 발견되지 않는 경우는 java.naming.factory.initial로 지정된 초기 컨텍스트이 사용됩니다. 같이 최초의 컴퍼넌트가 URL 캐릭터 라인의 CompositeName 객체가 이름 파라미터로서 메서드에게 건네지면, URL 컨텍스트 팩토리가 검색되어 최초의 이름 컴퍼넌트의 해결에 사용됩니다. URL 컨텍스트 팩토리가 검색되는 방법의자세한 내용은 NamingManager.getURLContext()를 참조하십시오.

초기 컨텍스트 및 URL 컨텍스트 팩토리를 검색하는 디폴트 정책는 NamingManager.setInitialContextFactoryBuilder()를 호출하는 것으로 오버라이드(override) 되는 일이 있습니다.

초기 컨텍스트를 인스턴스화할 수 없는 경우, NoInitialContextException가 발생 됩니다. 이 예외는 InitialContext 구축시 만이 아니고, InitialContext 라고 대화할 때에 예외를 발생시킵니다. 예를 들어 초기 컨텍스트 의 구현에서는 실제의 메서드가 호출되는 경우에 한정해 컨텍스트이 검색되는 경우도 있습니다. 어플리케이션은 초기 컨텍스트 의 유무가 언제 판별되려면 존하지 않습니다.

환경 프로퍼티 java.naming.factory.initial가 null 이외의 경우, InitialContext 생성자에서는 거기로 지정한 초기 컨텍스트이 작성됩니다. 그 시점에서 문제가 발생했을 경우, 관련된 초기 컨텍스트 팩토리로 예외가 발생 됩니다. 다만, 언제 검증되는지 및 초기의 컨텍스트, 환경 프로퍼티 (즉 접속)에 관한 문제가 언제 사용자에 게 표시될까는 프로바이더의 구현에 의존합니다. 컨텍스트 으로 오퍼레이션이 실행될 때까지 대기하는 경우도, 컨텍스트 구축시에 곧바로 실행하는 경우도 있습니다.

InitialContext 인스턴스는 병행 액세스에 대해서 복수의 thread에서는 동기화 되지 않습니다. 다른 InitialContext 인스턴스를 조작하는 복수 thread에서는 동기화는 필요 없습니다. 단일의 InitialContext에 동시에 액세스 할 필요가 있는 thread는 그 자체로 동기화 되어 필요한 락을 제공할 필요가 있습니다.

도입된 버전 :

JNDI 1.1 / Java 2 Platform, Standard Edition, v 1.3

관련 항목:

Context, NamingManager.setInitialContextFactoryBuilder

필드 개요

protected Context	defaultInitCtx NamingManager.getInitialContext()를 호출한 결과를 보관 유지하는 필드입니다.
protected boolean	gotDefault 초기 컨텍스트이 NamingManager.getInitialContext()의 호출에 의해 취득되었는지를 나타내는 필드입니다.
protected Hashtable <Object, Object >	myProps 이 InitialContext에 관련한 환경입니다.

인터페이스 javax.naming. Context 로부터 상속된 필드

APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

생성자 개요

	InitialContext () 초기 컨텍스트를 구축합니다.
protected	InitialContext (boolean lazy) 초기화하지 않는 옵션을 가지는 초기화 컨텍스트를 구축합니다.
	InitialContext (Hashtable <?,?> environment) 지정한 환경을 사용해 초기 컨텍스트를 구축합니다.

메서드 개요

Object	addToEnvironment (String propName, Object propVal) 이 컨텍스트 의 환경에 새로운 환경 프로퍼티를 추가합니다.
void	bind (Name name, Object obj) 이름을 객체에 바인드 합니다.
void	bind (String name, Object obj) 이름을 객체에 바인드 합니다.
void	close () 이 컨텍스트를 닫습니다.
Name	composeName (Name name, Name prefix) 이 컨텍스트를 기준으로 한 이름을 가지는 이 컨텍스트 의 이름을 변환합니다.
String	composeName (String name, String prefix) 이 컨텍스트를 기준으로 한 이름을 사용해, 이 컨텍스트 의 이름을 붙입니다.
Context	createSubcontext (Name name) 새로운 컨텍스트를 작성해 바인드 합니다.
Context	createSubcontext (String name) 새로운 컨텍스트를 작성해 바인드 합니다.
void	destroySubcontext (Name name) 지정된 컨텍스트이 파기되어 이름 공간으로부터 삭제됩니다.
void	destroySubcontext (String name) 이름 첨부 컨텍스트를 파기해, 이름 공간으로부터 삭제합니다.
protected Context	getDefaultInitCtx () NamingManager.getInitialContext()를 호출해 초기 컨텍스트를 취득해, defaultInitCtx 로 캐쉬에 포함합니다.
Hashtable <?,?>	getEnvironment () 이 컨텍스트 으로 유효한 환경을 취득합니다.
String	getNameInNamespace () 독자적인 이름 공간에서 이 컨텍스트 의 완전한 이름을 취득합니다.
NameParser	getNameParser (Name name) 지정된 컨텍스트에 관련한 파서를 취득합니다.
NameParser	getNameParser (String name) 이름 첨부 컨텍스트에 관련한 파서를 취득합니다.
protected Context	getURLOrDefaultInitCtx (Name name) name를 해결하는 컨텍스트를 취득합니다.
protected Context	getURLOrDefaultInitCtx (String name) 캐릭터 라인명 name를 해결하는 컨텍스트를 취득합니다.
protected void	init (Hashtable <?,?> environment) 지정한 환경을 사용해 초기 컨텍스트를 초기화합니다.
NamingEnumeration <NameClassPair >	list (Name name) 바인드 된 객체의 클래스명과 함께, 지정된 컨텍스트 으로 바인드 된 이름을 열거합니다.
NamingEnumeration <NameClassPair >	list (String name) 바인드 된 객체의 클래스명과 함께, 이름 첨부 컨텍스트 으로 바인드 된 이름을 열거합니다.
NamingEnumeration <Binding >	listBindings (Name name) 바인드 된 객체와 함께, 지정된 컨텍스트 으로 바인드 된 이름을 열거합니다.
NamingEnumeration <Binding >	listBindings (String name) 바인드 된 객체와 함께, 이름 첨부 컨텍스트 으로 바인드 된 이름을 열거합니다.
Object	lookup (Name name) 지정된 객체를 취득합니다.
Object	lookup (String name) 이름 첨부 객체를 취득합니다.
Object	lookupLink (Name name) 이름의 종단의 기본 컴퍼넌트를 제외한 링크를 동반하는 지정된 객체를 취득합니다.
Object	lookupLink (String name) 이름의 종단의 기본 컴퍼넌트를 제외한 링크를 동반하는 이름 첨부 객체를 취득합니다.
void	rebind (Name name, Object obj) 이름을 객체에 바인드 해, 기존의 바인딩을 덧쓰기합니다.
void	rebind (String name, Object obj) 이름을 객체에 바인드 해, 기존의 바인딩을 덧쓰기합니다.
Object	removeFromEnvironment (String propName) 이 컨텍스트 의 환경에서 환경 프로퍼티를 삭제합니다.
void	rename (Name oldName, Name newName) 새로운 이름을 이전의 이름에 바인드 된 객체에 바인드 해, 이전의 이름을 안바인드 합니다.
void	rename (String oldName, String newName) 새로운 이름을 이전의 이름에 바인드 된 객체에 바인드 해, 이전의 이름을 안바인드 합니다.
void	unbind (Name name) 지정된 객체를 안바인드 합니다.
void	unbind (String name) 이름 첨부 객체를 안바인드 합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

myProps

protected Hashtable <Object,
Object > myProps

이 InitialContext에 관련한 환경입니다. null에 초기화되어 환경을 받는 생성자, 또는 init() 메서드에 의해 갱신됩니다.

관련 항목:

addToEnvironment(java.lang.String, java.lang.Object), removeFromEnvironment(java.lang.String), getEnvironment()

defaultInitCtx

protected Context  defaultInitCtx

NamingManager.getInitialContext()를 호출한 결과를 보관 유지하는 필드입니다. 최초로 getDefaultInitCtx()가 불려 갔을 때에 getDefaultInitCtx()에 의해 설정됩니다. 그 후 getDefaultInitCtx()를 호출하면, defaultInitCtx 값이 리턴됩니다 .

관련 항목:

getDefaultInitCtx()

gotDefault

protected boolean gotDefault

초기 컨텍스트이 NamingManager.getInitialContext()의 호출에 의해 취득되었는지를 나타내는 필드입니다. true인 경우, 결과는 defaultInitCtx에 있습니다.

생성자 상세

InitialContext

protected InitialContext(boolean lazy)
                  throws NamingException 

초기화하지 않는 옵션을 가지는 초기화 컨텍스트를 구축합니다. 이것은, InitialContext 생성자가 불려 갔을 때에 환경 파라미터의 값이 불명한 경우에 서브 클래스의 생성자 으로 사용되는 일이 있습니다. 서브 클래스의 생성자에서는 이 생성자가 불려가 환경의 값이 계산되어, 값을 돌려주기 전에 init()가 호출됩니다.

파라미터:

lazy - true는 초기 컨텍스트이 초기화되지 않는 것을 나타낸다. false는 new InitialContext()를 호출하는 것과 같다

예외:

NamingException - 네이밍 예외가 발생했을 경우

도입된 버전 :

1.3

관련 항목:

init(Hashtable)

InitialContext

public InitialContext()
               throws NamingException 

초기 컨텍스트를 구축합니다. 환경 프로퍼티는 지정되지 않습니다. new InitialContext(null)와 같습니다.

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

InitialContext(Hashtable)

InitialContext

public InitialContext(Hashtable <?,?> environment)
               throws NamingException 

지정한 환경을 사용해 초기 컨텍스트를 구축합니다. 환경 프로퍼티는 클래스 개요로 설명합니다.

이 생성자에서는 environment 변경 또는 참조의 보존은 행해지지 않습니다만, 복제가 보존됩니다.

파라미터:

environment - 초기 컨텍스트 의 작성에 사용되는 환경. null은 비어있는 환경을 나타낸다

예외:

NamingException - 네이밍 예외가 발생했을 경우

메서드의 상세

init

protected void init(Hashtable <?,?> environment)
             throws NamingException 

지정한 환경을 사용해 초기 컨텍스트를 초기화합니다. 환경 프로퍼티는 클래스 개요로 설명합니다.

이 메서드에서는 environment가 변경되어 참조가 보존됩니다. 호출측에서는 변경되지 않습니다.

파라미터:

environment - 초기 컨텍스트 의 작성에 사용되는 환경. null은 비어있는 환경을 나타낸다

예외:

NamingException - 네이밍 예외가 발생했을 경우

도입된 버전 :

1.3

관련 항목:

InitialContext(boolean)

getDefaultInitCtx

protected Context  getDefaultInitCtx()
                             throws NamingException 

NamingManager.getInitialContext()를 호출해 초기 컨텍스트를 취득해, defaultInitCtx 로 캐쉬에 포함합니다. 이전에 실행한 것을 알 수 있도록 gotDefault를 설정합니다.

반환값:

null 이외의 캐쉬가 끝난 초기 컨텍스트

예외:

NoInitialContextException - 초기 컨텍스트이 발견되지 않는 경우

NamingException - 네이밍 예외가 발견되었을 경우

getURLOrDefaultInitCtx

protected Context  getURLOrDefaultInitCtx(String  name)
                                  throws NamingException 

캐릭터 라인명 name를 해결하는 컨텍스트를 취득합니다. name 명이 URL 캐릭터 라인의 경우는 URL 컨텍스트를 검색합니다. 발견되지 않았던 경우, 또는 name가 URL 캐릭터 라인이 아닌 경우는 getDefaultInitCtx()가 리턴됩니다 .

서브 클래스에서 이 메서드가 어떻게 사용될까는 getURLOrDefaultInitCtx(Name)의 설명을 참조하십시오.

파라미터:

name - 컨텍스트 의 취득 대상이 되는 null 이외의 이름

반환값:

name 또는 캐쉬가 끝난 초기 컨텍스트 의 URL 컨텍스트. 결과는 null은 아니다

예외:

NoInitialContextException - 초기 컨텍스트이 발견되지 않는 경우

NamingException - 네이밍 예외가 발견되었을 경우

관련 항목:

NamingManager.getURLContext(java.lang.String, java.util.Hashtable)

getURLOrDefaultInitCtx

protected Context  getURLOrDefaultInitCtx(Name  name)
                                  throws NamingException 

name를 해결하는 컨텍스트를 취득합니다. name 명의 최초의 컴퍼넌트가 URL 캐릭터 라인의 경우는 URL 컨텍스트를 검색합니다. 발견되지 않았던 경우, 또는 name 최초의 컴퍼넌트가 URL 캐릭터 라인이 아닌 경우는 getDefaultInitCtx()가 리턴됩니다 .

InitialContext 서브 클래스를 작성할 때는 다음과 같이의해 이 메서드를 사용합니다. 이 메서드를 사용하는 새로운 메서드를 정의해, 필요한 서브 클래스의 초기 컨텍스트를 취득합니다.

protected XXXContext getURLOrDefaultInitXXXCtx(Name name)  throws NamingException { Context answer = getURLOrDefaultInitCtx(name); if (! (answer instanceof XXXContext)) { if (answer == null) {     throw new NoInitialContextException(); } else {         throw new NotContextException("Not an XXXContext"); }       }       return (XXXContext) answer; }

서브 클래스의 새로운 메서드에 구현을 지정하는 경우는 이 새롭게 정의된 메서드를 사용해, 초기 컨텍스트를 취득합니다.

public Object XXXMethod1(Name name, ...) {      throws NamingException { return getURLOrDefaultInitXXXCtx(name). XXXMethod1(name, ...); } 

파라미터:

name - 컨텍스트 의 취득 대상이 되는 null 이외의 이름

반환값:

name 또는 캐쉬가 끝난 초기 컨텍스트 의 URL 컨텍스트. 결과는 null은 아니다

예외:

NoInitialContextException - 초기 컨텍스트이 발견되지 않는 경우

NamingException - 네이밍 예외가 발견되었을 경우

관련 항목:

NamingManager.getURLContext(java.lang.String, java.util.Hashtable)

lookup

public Object  lookup(String  name)
              throws NamingException 

인터페이스 Context 기술:

이름 첨부 객체를 취득합니다. 자세한 내용은 Context.lookup(Name)를 참조하십시오.

정의:

인터페이스 Context 내의 lookup

파라미터:

name - 검색하는 객체의 이름

반환값:

name에 바인드 되는 객체

예외:

NamingException - 네이밍 예외가 발생했을 경우

lookup

public Object  lookup(Name  name)
              throws NamingException 

인터페이스 Context 기술:

지정된 객체를 취득합니다. name가 비어있는 경우는 이 컨텍스트 의 새로운 인스턴스를 리턴합니다. 이 컨텍스트과 같은 네이밍 컨텍스트를 나타냅니다만, 환경은 개별적으로 변경할 수가 있어 동시에 액세스 할 수도 있습니다.

정의:

인터페이스 Context 내의 lookup

파라미터:

name - 검색하는 객체의 이름

반환값:

name에 바인드 되는 객체

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.lookup(String), Context.lookupLink(Name)

bind

public void bind(String  name,
                 Object  obj)
          throws NamingException 

인터페이스 Context 기술:

이름을 객체에 바인드 합니다. 자세한 내용은 Context.bind(Name, Object)를 참조하십시오.

정의:

인터페이스 Context 내의 bind

파라미터:

name - 비어있지 않은 바인드 되는 이름

obj - null 가능성이 있는 바인드 되는 객체

예외:

NameAlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

InvalidAttributesException - 객체에 모든 필수 속성이 지정되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

bind

public void bind(Name  name,
                 Object  obj)
          throws NamingException 

인터페이스 Context 기술:

이름을 객체에 바인드 합니다. 이름의 종단의 기본 부분 이외의 모든 컴퍼넌트에 의해 이름이 붙여진, 모든 중간 컨텍스트 및 타겟 컨텍스트이 이미 존재하고 있을 필요가 있습니다.

정의:

인터페이스 Context 내의 bind

파라미터:

name - 비어있지 않은 바인드 되는 이름

obj - null 가능성이 있는 바인드 되는 객체

예외:

NameAlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

InvalidAttributesException - 객체에 모든 필수 속성이 지정되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.bind(String, Object), Context.rebind(Name, Object), DirContext.bind(Name, Object, javax.naming.directory.Attributes)

rebind

public void rebind(String  name,
                   Object  obj)
            throws NamingException 

인터페이스 Context 기술:

이름을 객체에 바인드 해, 기존의 바인딩을 덧쓰기합니다. 자세한 내용은 Context.rebind(Name, Object)를 참조하십시오.

정의:

인터페이스 Context 내의 rebind

파라미터:

name - 비어있지 않은 바인드 되는 이름

obj - null 가능성이 있는 바인드 되는 객체

예외:

InvalidAttributesException - 객체에 모든 필수 속성이 지정되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

rebind

public void rebind(Name  name,
                   Object  obj)
            throws NamingException 

인터페이스 Context 기술:

이름을 객체에 바인드 해, 기존의 바인딩을 덧쓰기합니다. 이름의 종단의 기본 컴퍼넌트 이외의 모두에 의해 이름이 붙여진, 모든 중간 컨텍스트 및 타겟 컨텍스트이 이미 존재하고 있을 필요가 있습니다.

객체가 DirContext인 경우, 이름에 관련된 기존의 속성이, 객체의 속성과 치환됩니다. 치환되지 않는 경우, 이름에 관련된 기존의 속성은 변경되지 않은 채입니다.

정의:

인터페이스 Context 내의 rebind

파라미터:

name - 비어있지 않은 바인드 되는 이름

obj - null 가능성이 있는 바인드 되는 객체

예외:

InvalidAttributesException - 객체에 모든 필수 속성이 지정되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.rebind(String, Object), Context.bind(Name, Object), DirContext.rebind(Name, Object, javax.naming.directory.Attributes), DirContext

unbind

public void unbind(String  name)
            throws NamingException 

인터페이스 Context 기술:

이름 첨부 객체를 안바인드 합니다. 자세한 내용은 Context.unbind(Name)를 참조하십시오.

정의:

인터페이스 Context 내의 unbind

파라미터:

name - 안바인드 하는 이름. 공백은 불가

예외:

NameNotFoundException - 중간 컨텍스트이 존재하지 않는 경우

NamingException - 네이밍 예외가 발생했을 경우

unbind

public void unbind(Name  name)
            throws NamingException 

인터페이스 Context 기술:

지정된 객체를 안바인드 합니다. name 종단의 기본 부분 이외의 모두에 의해 이름이 붙여진 타겟 컨텍스트 으로부터, name 종단의 기본명을 삭제합니다.

이 메서드는 나무등입니다. 종단의 기본명이 타겟 컨텍스트 으로 바인드되어 있지 않은 경우에서도, 성공합니다. 다만, 중간 컨텍스트이 존재하지 않는 경우는 NameNotFoundException이 발생 됩니다.

이름에 관련된 속성이 삭제됩니다. 중간 컨텍스트은 변경되지 않습니다.

정의:

인터페이스 Context 내의 unbind

파라미터:

name - 안바인드 하는 이름. 공백은 불가

예외:

NameNotFoundException - 중간 컨텍스트이 존재하지 않는 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.unbind(String)

rename

public void rename(String  oldName,
                   String  newName)
            throws NamingException 

인터페이스 Context 기술:

새로운 이름을 이전의 이름에 바인드 된 객체에 바인드 해, 이전의 이름을 안바인드 합니다. 자세한 내용은 Context.rename(Name, Name)를 참조하십시오.

정의:

인터페이스 Context 내의 rename

파라미터:

oldName - 기존의 바인딩의 이름. 공백은 불가

newName - 새로운 바인딩의 이름. 공백은 불가

예외:

NameAlreadyBoundException - newName가 이미 바인드 되고 있는 경우

NamingException - 네이밍 예외가 발생했을 경우

rename

public void rename(Name  oldName,
                   Name  newName)
            throws NamingException 

인터페이스 Context 기술:

새로운 이름을 이전의 이름에 바인드 된 객체에 바인드 해, 이전의 이름을 안바인드 합니다. 2개의 이름은 이 컨텍스트를 기준으로 합니다. 이전의 이름에 관련된 속성은 새로운 이름에 관련지을 수 있습니다. 이전의 이름의 중간 컨텍스트은 변경되지 않습니다.

정의:

인터페이스 Context 내의 rename

파라미터:

oldName - 기존의 바인딩의 이름. 공백은 불가

newName - 새로운 바인딩의 이름. 공백은 불가

예외:

NameAlreadyBoundException - newName가 이미 바인드 되고 있는 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.rename(String, String), Context.bind(Name, Object), Context.rebind(Name, Object)

list

public NamingEnumeration <NameClassPair > list(String  name)
                                      throws NamingException 

인터페이스 Context 기술:

바인드 된 객체의 클래스명과 함께, 이름 첨부 컨텍스트 으로 바인드 된 이름을 열거합니다. 자세한 내용은 Context.list(Name)를 참조하십시오.

정의:

인터페이스 Context 내의 list

파라미터:

name - 리스트 표시하는 컨텍스트 의 이름

반환값:

이 컨텍스트 의 바인딩의 이름과 클래스명의 열거. 열거의 요소의 형태는 NameClassPair

예외:

NamingException - 네이밍 예외가 발생했을 경우

list

public NamingEnumeration <NameClassPair > list(Name  name)
                                      throws NamingException 

인터페이스 Context 기술:

바인드 된 객체의 클래스명과 함께, 지정된 컨텍스트 으로 바인드 된 이름을 열거합니다. 서브 컨텍스트 의 내용은 포함되지 않습니다.

이 컨텍스트에 바인딩이 추가되는지, 또는 이 컨텍스트 으로부터 바인딩이 삭제되는 경우, 이전에 리턴된 열거에의 영향은 정의되지 않습니다.

정의:

인터페이스 Context 내의 list

파라미터:

name - 리스트 표시하는 컨텍스트 의 이름

반환값:

이 컨텍스트 의 바인딩의 이름과 클래스명의 열거. 열거의 요소의 형태는 NameClassPair

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.list(String), Context.listBindings(Name), NameClassPair

listBindings

public NamingEnumeration <Binding > listBindings(String  name)
                                        throws NamingException 

인터페이스 Context 기술:

바인드 된 객체와 함께, 이름 첨부 컨텍스트 으로 바인드 된 이름을 열거합니다. 자세한 내용은 Context.listBindings(Name)를 참조하십시오.

정의:

인터페이스 Context 내의 listBindings

파라미터:

name - 리스트 표시하는 컨텍스트 의 이름

반환값:

이 컨텍스트 의 바인딩의 열거. 열거의 각 요소는 Binding 형

예외:

NamingException - 네이밍 예외가 발생했을 경우

listBindings

public NamingEnumeration <Binding > listBindings(Name  name)
                                        throws NamingException 

인터페이스 Context 기술:

바인드 된 객체와 함께, 지정된 컨텍스트 으로 바인드 된 이름을 열거합니다. 서브 컨텍스트 의 내용은 포함되지 않습니다.

이 컨텍스트에 바인딩이 추가되는지, 또는 이 컨텍스트 으로부터 바인딩이 삭제되는 경우, 이전에 리턴된 열거에의 영향은 정의되지 않습니다.

정의:

인터페이스 Context 내의 listBindings

파라미터:

name - 리스트 표시하는 컨텍스트 의 이름

반환값:

이 컨텍스트 의 바인딩의 열거. 열거의 각 요소는 Binding 형

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.listBindings(String), Context.list(Name), Binding

destroySubcontext

public void destroySubcontext(String  name)
                       throws NamingException 

인터페이스 Context 기술:

이름 첨부 컨텍스트를 파기해, 이름 공간으로부터 삭제합니다. 자세한 내용은 Context.destroySubcontext(Name)를 참조하십시오.

정의:

인터페이스 Context 내의 destroySubcontext

파라미터:

name - 파기되는 컨텍스트 의 이름. 공백은 불가

예외:

NameNotFoundException - 중간 컨텍스트이 존재하지 않는 경우

NotContextException - 이름이 바인드 되고 있지만 컨텍스트 의 이름이 없는 또는 해당하는 형태의 컨텍스트 의 이름이 없는 경우

ContextNotEmptyException - 지정된 컨텍스트이 비어있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

destroySubcontext

public void destroySubcontext(Name  name)
                       throws NamingException 

인터페이스 Context 기술:

지정된 컨텍스트이 파기되어 이름 공간으로부터 삭제됩니다. 이름에 관련된 속성도 삭제됩니다. 중간 컨텍스트은 파기되지 않습니다.

이 메서드는 나무등입니다. 종단의 기본명이 타겟 컨텍스트 으로 바인드되어 있지 않은 경우에서도, 성공합니다. 다만, 중간 컨텍스트이 존재하지 않는 경우는 NameNotFoundException이 발생 됩니다.

연합 네이밍 시스템에서는 1개의 네이밍 시스템으로부터의 컨텍스트이 다른 네이밍 시스템의 이름에 바인드 됩니다. 그 후, 컴퍼짓이름을 사용해 외부 컨텍스트 의 오퍼레이션을 검색 및 실행할 수 있습니다. 다만, 외부 컨텍스트은 바인드 된 컨텍스트 의 서브 컨텍스트은 아니기 때문에 이 컴퍼짓이름을 사용해 컨텍스트를 파기하려고 하면, NotContextException로 실패합니다. 대신에 unbind()를 사용해, 외부 컨텍스트 의 바인딩을 삭제합니다. 외부 컨텍스트를 파기하려면, 외부 컨텍스트 의 「네이티브인」네이밍 시스템으로부터 컨텍스트 으로 destroySubcontext()를 실행할 필요가 있습니다.

정의:

인터페이스 Context 내의 destroySubcontext

파라미터:

name - 파기되는 컨텍스트 의 이름. 공백은 불가

예외:

NameNotFoundException - 중간 컨텍스트이 존재하지 않는 경우

NotContextException - 이름이 바인드 되고 있지만 컨텍스트 의 이름이 없는 또는 해당하는 형태의 컨텍스트 의 이름이 없는 경우

ContextNotEmptyException - 지정된 컨텍스트이 비어있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.destroySubcontext(String)

createSubcontext

public Context  createSubcontext(String  name)
                         throws NamingException 

인터페이스 Context 기술:

새로운 컨텍스트를 작성해 바인드 합니다. 자세한 내용은 Context.createSubcontext(Name)를 참조하십시오.

정의:

인터페이스 Context 내의 createSubcontext

파라미터:

name - 비어있지 않은 작성되는 컨텍스트 의 이름

반환값:

새롭게 작성된 컨텍스트

예외:

NameAlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

InvalidAttributesException - 서브 컨텍스트 의 작성에 필수 속성의 지정이 필요한 경우

NamingException - 네이밍 예외가 발생했을 경우

createSubcontext

public Context  createSubcontext(Name  name)
                         throws NamingException 

인터페이스 Context 기술:

새로운 컨텍스트를 작성해 바인드 합니다. 지정한 이름의 새로운 컨텍스트를 작성해, (이름의 종단의 기본 컴퍼넌트 이외의 모두에 의해 이름이 붙여진) 타겟 컨텍스트 으로 바인드 합니다. 모든 중간 컨텍스트 및 타겟 컨텍스트이 이미 존재하고 있을 필요가 있습니다.

정의:

인터페이스 Context 내의 createSubcontext

파라미터:

name - 비어있지 않은 작성되는 컨텍스트 의 이름

반환값:

새롭게 작성된 컨텍스트

예외:

NameAlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

InvalidAttributesException - 서브 컨텍스트 의 작성에 필수 속성의 지정이 필요한 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.createSubcontext(String), DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes)

lookupLink

public Object  lookupLink(String  name)
                  throws NamingException 

인터페이스 Context 기술:

이름의 종단의 기본 컴퍼넌트를 제외한 링크를 동반하는 이름 첨부 객체를 취득합니다. 자세한 내용은 Context.lookupLink(Name)를 참조하십시오.

정의:

인터페이스 Context 내의 lookupLink

파라미터:

name - 검색하는 객체의 이름

반환값:

종단 링크 (있는 경우)를 이라고도 줄 없는 name에 바인드 된 객체

예외:

NamingException - 네이밍 예외가 발생했을 경우

lookupLink

public Object  lookupLink(Name  name)
                  throws NamingException 

인터페이스 Context 기술:

이름의 종단의 기본 컴퍼넌트를 제외한 링크를 동반하는 지정된 객체를 취득합니다. name에 바인드 된 객체가 링크가 아닌 경우는 객체 자체가 리턴됩니다 .

정의:

인터페이스 Context 내의 lookupLink

파라미터:

name - 검색하는 객체의 이름

반환값:

종단 링크 (있는 경우)를 이라고도 줄 없는 name에 바인드 된 객체

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.lookupLink(String)

getNameParser

public NameParser  getNameParser(String  name)
                         throws NamingException 

인터페이스 Context 기술:

이름 첨부 컨텍스트에 관련한 파서를 취득합니다. 자세한 내용은 Context.getNameParser(Name)를 참조하십시오.

정의:

인터페이스 Context 내의 getNameParser

파라미터:

name - 파서의 취득원의 컨텍스트 의 이름

반환값:

복합명의 구문을 구문 분석의해 기본 컴퍼넌트로 하는 이름의 파서

예외:

NamingException - 네이밍 예외가 발생했을 경우

getNameParser

public NameParser  getNameParser(Name  name)
                         throws NamingException 

인터페이스 Context 기술:

지정된 컨텍스트에 관련한 파서를 취득합니다. 이름 공간의 연합에서는 다양한 네이밍 시스템으로 이름의 구문이 구문 분석 됩니다. 어플리케이션으로부터 이 메서드를 사용하면, 특정의 네이밍 시스템의 네이밍 변환에 의해 이름을 기본 컴퍼넌트에 구문 분석 하는 파서를 취득할 수 있습니다. 단일의 네이밍 시스템에서는 이 메서드에 의해 리턴된 NameParser 객체는 동일하지 않으면 안됩니다 (equals() 테스트를 사용).

정의:

인터페이스 Context 내의 getNameParser

파라미터:

name - 파서의 취득원의 컨텍스트 의 이름

반환값:

복합명의 구문을 구문 분석의해 기본 컴퍼넌트로 하는 이름의 파서

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.getNameParser(String), CompoundName

composeName

public String  composeName(String  name,
                          String  prefix)
                   throws NamingException 

이 컨텍스트를 기준으로 한 이름을 사용해, 이 컨텍스트 의 이름을 붙입니다. 초기 컨텍스트은 그 자체 이외의 컨텍스트를 기준으로의해 이름을 붙일 수 있을 것은 없기 때문에 prefix 파라미터의 값은 비어있는 이름 ("")으로 할 필요가 있습니다.

정의:

인터페이스 Context 내의 composeName

파라미터:

name - 이 컨텍스트에 관련한 이름

prefix - 상위 컨텍스트 의 1개에 관련한 이 컨텍스트 의 이름

반환값:

prefix 및 name 변환

예외:

NamingException - 네이밍 예외가 발생했을 경우

composeName

public Name  composeName(Name  name,
                        Name  prefix)
                 throws NamingException 

이 컨텍스트를 기준으로 한 이름을 가지는 이 컨텍스트 의 이름을 변환합니다. 초기 컨텍스트은 그 자체 이외의 컨텍스트를 기준으로의해 이름을 붙일 수 있을 것은 없기 때문에 prefix 파라미터의 값은 비어있는 이름으로 할 필요가 있습니다.

정의:

인터페이스 Context 내의 composeName

파라미터:

name - 이 컨텍스트에 관련한 이름

prefix - 상위 컨텍스트 의 1개에 관련한 이 컨텍스트 의 이름

반환값:

prefix 및 name 변환

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.composeName(String, String)

addToEnvironment

public Object  addToEnvironment(String  propName,
                               Object  propVal)
                        throws NamingException 

인터페이스 Context 기술:

이 컨텍스트 의 환경에 새로운 환경 프로퍼티를 추가합니다. 프로퍼티가 이미 존재하는 경우, 값은 덧쓰기됩니다. 환경 프로퍼티의자세한 내용은 클래스의 설명을 참조하십시오.

정의:

인터페이스 Context 내의 addToEnvironment

파라미터:

propName - 추가하는 환경 프로퍼티의 이름. null 이외

propVal - 추가하는 프로퍼티의 값. null 이외

반환값:

프로퍼티의 이전의 값, 또는 프로퍼티가 이전에는 환경에 없었던 경우는 null

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.getEnvironment(), Context.removeFromEnvironment(String)

removeFromEnvironment

public Object  removeFromEnvironment(String  propName)
                             throws NamingException 

인터페이스 Context 기술:

이 컨텍스트 의 환경에서 환경 프로퍼티를 삭제합니다. 환경 프로퍼티의자세한 내용은 클래스의 설명을 참조하십시오.

정의:

인터페이스 Context 내의 removeFromEnvironment

파라미터:

propName - 삭제하는 환경 프로퍼티의 이름. null 이외

반환값:

프로퍼티의 이전의 값, 또는 프로퍼티가 환경에 없었던 경우는 null

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.getEnvironment(), Context.addToEnvironment(String, Object)

getEnvironment

public Hashtable <?,?> getEnvironment()
                              throws NamingException 

인터페이스 Context 기술:

이 컨텍스트 으로 유효한 환경을 취득합니다. 환경 프로퍼티의자세한 내용은 클래스의 설명을 참조하십시오.

호출측은 리턴된 객체를 변경할 수 없습니다. 컨텍스트에 대한 효과는 정의되지 않습니다. 이 컨텍스트 의 환경은, addToEnvironment() 및 removeFromEnvironment()에 의해 변경되는 일이 있습니다.

정의:

인터페이스 Context 내의 getEnvironment

반환값:

이 컨텍스트 의 환경. null 이외

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.addToEnvironment(String, Object), Context.removeFromEnvironment(String)

close

public void close()
           throws NamingException 

인터페이스 Context 기술:

이 컨텍스트를 닫습니다. 이 메서드에서는 가비지 컬렉터에 의해 자동적으로 해방될 때까지 대기하는 것이 아니라, 이 컨텍스트 의 자원이 즉시 해방됩니다.

이 메서드는 나무등입니다. 이미 닫혀진 컨텍스트 으로 이 메서드를 호출해도, 효과는 없습니다. 닫혀진 컨텍스트 으로 다른 메서드를 호출할 수 없습니다. 결과는 미정도리의 동작이 됩니다.

정의:

인터페이스 Context 내의 close

예외:

NamingException - 네이밍 예외가 발생했을 경우

getNameInNamespace

public String  getNameInNamespace()
                          throws NamingException 

인터페이스 Context 기술:

독자적인 이름 공간에서 이 컨텍스트 의 완전한 이름을 취득합니다.

많은 네이밍 서비스에는 각 이름 공간의 객체에 대한 「완전한 이름」의 개념이 있습니다. 예를 들어 LDAP 엔트리에는 식별명이 있어, DNS 레코드에는 완전 수식명이 있습니다. 이 메서드에의해 클라이언트 어플리케이션으로 이 이름을 취득할 수 있습니다. 이 메서드로 리턴된 캐릭터 라인은 JNDI 컴퍼짓이름은 아니고, 컨텍스트 메서드에 직접 건네줄 수 없습니다. 완전한 이름의 개념이 미를 가지지 않는 네이밍 시스템에서는 OperationNotSupportedException이 발생 됩니다.

정의:

인터페이스 Context 내의 getNameInNamespace

반환값:

독자적인 이름 공간에 대한 이 컨텍스트 의 이름. null 이외

예외:

OperationNotSupportedException - 네이밍 시스템에 완전한 이름의 개념이 없는 경우

NamingException - 네이밍 예외가 발생했을 경우