|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | constructor | 메서드 | |||||||||
public interface Context
이 인터페이스는 이름에서 객체에의 바인딩세트로부터 구성되는 네이밍 컨텍스트를 나타냅니다. 이 인터페이스에는 이러한 바인딩을 검사 및 갱신하는 메서드가 포함되어 있습니다.
대부분의 메서드에는 Name 파라미터 및 String를 사용하는 overload 된 버전이 있습니다. 이러한 overload 된 버전은, Name 파라미터 및 String 파라미터가 같은 이름으로 다른 표기의 경우에
같은 메서드의 overload 된 버전이 똑같이 동작한다고 하는 점으로써 동등합니다. 아래의 메서드의 설명에서는 1개의 버전
만이 완전하게 문서화 되고 있습니다. 2번째의 버전에 는 최초의 버전에 의 링크가 있어, 같은 문서가 양쪽 모두에 적용됩니다.
연합을 지원하는 시스템에서는 Context 메서드에 대한 String 이름 인수는 컴퍼짓이름입니다. CompositeName 인스턴스인 이름 인수는 컴퍼짓이름으로 간주해져CompositeName 인스턴스가 아닌 Name 인수는 CompoundName 인스턴스, 또는 복합명의 그 외의 구현인 복합명으로 간주해집니다. 이것에 의해 NameParser.parse() 결과를 Context 메서드에 대한 인수로서 사용할 수 있습니다. JNDI 1.2 이전에는 모든 이름 인수가 컴퍼짓이름으로 간주해지고 있었습니다.
게다가 연합을 지원하는 시스템에서는 list() 및 listBindings()로 부터 NamingEnumeration에 리턴된 이름은 모두, 캐릭터 라인으로서 나타내지는 컴퍼짓이름입니다. 이름의 캐릭터 라인 구문에 대해서는 CompositeName를 참조하십시오.
연합을 지원 하고 있지 않는 시스템에서는 (Name 또는 String 형식의) 이름 인수 및 NamingEnumeration로 리턴된 이름은 서비스 프로바이더의 판단에의해 합성 이름 공간의 이름은 아니고, 독자적인 이름 공간의 이름이 되는 일이 있습니다.
lookup 메서드에서는 비어있는 이름을 인도할 때, 같은 네이밍 컨텍스트를 나타내는 새로운 Context 인스턴스가 리턴됩니다
. 병행성을 제어하기 위해서 NamingEnumeration를 돌려주는 컨텍스트 오퍼레이션은 열거가 사용중 때, 또는 그 오퍼레이션으로 생성되는 참조가 실행중 때에는 완료하고 있지 않는 것으로 간주해집니다.
JNDI 어플리케이션에서는 네이밍 서비스와 디렉토리 서비스로부터 액세스 되는 환경을 정의하는 다양한 설정이나 프로퍼티를 전달할 방법이 필요하게 됩니다. 예를 들어 어느 컨텍스트에 서는 서비스에 액세스 하기 위해서 시큐러티 자격의 지정이 필요하게 됩니다. 다른 컨텍스트에 서는 서버 구성 정보를 지정할 필요가 있습니다. 이것들은 컨텍스트 의 「환경」으로 불립니다. Context 인터페이스에서는 이 환경을 취득 및 갱신하기 위한 메서드가 제공되고 있습니다.
환경은 컨텍스트 메서드가 있는 컨텍스트 으로부터 다음의 컨텍스트에 진행되는 것에 따라, 친컨텍스트 으로부터 상속됩니다. 1개의 컨텍스트 의 환경을 변경해도, 그 외의 컨텍스트 의 환경에는 직접 영향을 주지 않습니다.
환경 프로퍼티의 사용, 또는 유효성의 검사, 혹은 그 양쪽 모두가 언제 행해질까는 구현에 의존합니다. 예를 들어 디렉토리에 「로그인」하기 위해서 서비스 프로바이더로 시큐러티 관련의 프로퍼티가 사용된다고 합니다. 이 로그인 프로세스는 컨텍스트이 작성되었을 때, 또는 컨텍스트 으로 메서드가 최초로 불려 갔을 때에 발생합니다. 이것이 언제 발생하는지 및 발생할지 어떨지는 구현에 의존합니다. 컨텍스트에 대해서 환경 프로퍼티의 추가 또는 삭제를 했을 때에 변경의 유효성의 검사를 하는 타이밍도, 구현에 의존합니다. 예를 들어 어느 프로퍼티의 검사는 변경을 했을 때, 또는 컨텍스트 으로 다음의 오퍼레이션이 실행되었을 때에 행해지든가 혹은 전혀 행해지지 않습니다.
컨텍스트에 의 참조를 포함한 객체에서는 그 컨텍스트 의 환경이 검사됩니다. clear text의 패스워드등이 중요한 정보는 구현으로 보호되고 있는지를 모르는 경우에는 보존하지 말아 주세요.
JNDI 어플리케이션으로 필요한 환경을 설정하는 태스크를 간단하게 하기 위해서
어플리케이션 컴퍼넌트와 서비스 프로바이더가 「resource file」와 함께 분배되는 일이 있습니다. JNDI resource file는 키와 값의 페어의 리스트를 포함한, 프로퍼티 파일 형식의 파일입니다 (java.util.Properties를
참조). 키는 프로퍼티의 이름 (java.naming.factory.object 등)으로 값은 그 프로퍼티에 정의된 형식의 캐릭터 라인입니다. 이하에
JNDI resource file의 예를 나타냅니다.
JNDI 클래스 라이브러리에서는 resource file를 읽기, 프로퍼티치를 자유롭게 사용할 수 있도록 합니다. JNDI resource file는 불특정의 사용자가 읽어들일 가능성이 있습니다. clear text의 패스워드등이 중요한 정보는 여기에 보존하지 말아 주세요.java.naming.factory.object=com.sun.jndi.ldap.AttrsToCorba:com.wiz.from.Person java.naming.factory.state=com.sun.jndi.ldap.CorbaToAttrs:com.wiz.from.Person java.naming.factory.control=com.sun.jndi.ldap.ResponseControlFactory
JNDI resource file에는 「프로바이더」및 「어플리케이션」의 2 종류가 있습니다.
[prefix/]jndiprovider.propertiesprefix는 프로바이더의 컨텍스트 구현의 패키지명으로 피리어드 (. )는 slash (/)에 변환됩니다. 예를 들어 서비스 프로바이더가com.sun.jndi.ldap.LdapCtx 라고 하는 클래스명의 컨텍스트 구현을 정의한다고 합니다. 이 프로바이더의 프로바이더 자원은, com/sun/jndi/ldap/jndiprovider.properties 라는 이름이 됩니다. 클래스가 패키지에 없는 경우, 자원의 이름은 jndiprovider.properties가 됩니다.
JNDI 클래스 라이브러리의 특정의 메서드에서는 JNDI 팩토리의 리스트를 지정하는 표준 JNDI 프로퍼티가 사용됩니다.
ClassLoader.getResources()를
사용해, classpath
jndi.properties 라는 이름의 「어플리케이션 resource file」가 모두 검색됩니다. 게다가 파일 java.home/lib/jndi.properties가 존재해, 읽기
가능한 경우는 추가의 어플리케이션 resource file로 간주해집니다. java.home는
java.home 시스템 프로퍼티로 지정된 디렉토리를 나타냅니다. 이러한 파일에 포함되는 프로퍼티는 모두, 초기 컨텍스트
의 환경에 배치됩니다. 이 환경은 다른 컨텍스트에 상속됩니다.
1개 이상의 어플리케이션 resource file에 있는 프로퍼티의 경우, JNDI 에서는 최초의 값이 사용되는지, 또는 의미가 있는 경우에 한정해, 모든 값이 연결됩니다. 자세한 것은 이하에 나타냅니다. 예를 들어 3개의 jndi.properties resource file에 java.naming.factory.object 프로퍼티가 있는 경우, 객체 팩토리의 리스트는 3개의 파일 모두로부터의 프로퍼티치의 연결이 됩니다. 이 방식을 사용하면, 배치 가능한 컴퍼넌트의 각각으로 export 하는 팩토리가 리스트 표시됩니다. JNDI 에서는 팩토리 클래스를 검색할 경우에 이러한 export 리스트가 모두 수집 및 사용됩니다.
어플리케이션 resource file는 java.home/lib에 있는 파일이 이전의 Java 플랫폼으로도 사용된다고 하는 점을 제외해, Java 2 플랫폼으로부터 시작하는 것이 가능하게 됩니다.
JNDI 클래스 라이브러리로 프로퍼티의 값을 결정할 필요가 있는 경우는 아래의 2개의 소스로부터 값을 순서에 머지의해 실행합니다.
서비스 프로바이더로 프로퍼티의 값을 결정할 필요가 있는 경우, 일반적으로 환경으로부터 값이 직접 취득됩니다. 서비스 프로바이더는 독자적인 프로바이더 resource file에 배치되는 프로바이더 고유의 프로퍼티를 정의할 수 있습니다. 그 경우는 전의 단락으로 설명한 값을 머지 할 필요가 있습니다.
이와 같이, 각 서비스 프로바이더의 개발자는 그 서비스 프로바이더로 사용하는 팩토리의 리스트를 지정할 수 있습니다. 이것들은 어플리케이션 또는 애플릿의 배치자가 지정하는 어플리케이션 자원으로 변경할 수 있습니다. 또, 사용자가 변경할 수도 있습니다.
| 필드 개요 | |
|---|---|
static String |
APPLET
다른 프로퍼티를 검색할 경우에 사용하는 초기 컨텍스트 생성자 애플릿을 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
AUTHORITATIVE
요구된 서비스의 권한을 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
BATCHSIZE
서비스의 프로토콜에 의해 데이터를 돌려줄 때 사용하는 배치 사이즈를 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
DNS_URL
JNDI URL 컨텍스트 (dns://somehost/wiz.com 등)에 사용하는 DNS 호스트명 및 도메인명을 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
INITIAL_CONTEXT_FACTORY
사용하는 초기 컨텍스트 팩토리를 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
LANGUAGE
서비스에 사용하는 우선 언어를 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
OBJECT_FACTORIES
사용하는 객체 팩토리의 리스트를 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
PROVIDER_URL
사용하는 서비스 프로바이더의 구성 정보를 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
REFERRAL
이 정수의 값은 java.naming.referral 입니다. |
static String |
SECURITY_AUTHENTICATION
사용하는 시큐러티 레벨을 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
SECURITY_CREDENTIALS
서비스에 대한 호출측을 인증하는 주체의 자격을 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
SECURITY_PRINCIPAL
서비스에 대한 호출측을 인증하는 주체의 식별 정보를 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
SECURITY_PROTOCOL
사용하는 시큐러티 프로토콜을 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
STATE_FACTORIES
사용하는 상태 팩토리의 리스트를 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
static String |
URL_PKG_PREFIXES
URL 컨텍스트 팩토리를 로드할 때 사용하는 패키지 접두사의 리스트를 지정하기 위한, 환경 프로퍼티의 이름을 보관 유지하는 정수입니다. |
| 메서드 개요 | |
|---|---|
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)
이름 첨부 컨텍스트를 파기해, 이름 공간으로부터 삭제합니다. |
Hashtable <?,?> |
getEnvironment ()
이 컨텍스트 으로 유효한 환경을 취득합니다. |
String |
getNameInNamespace ()
독자적인 이름 공간에서 이 컨텍스트 의 완전한 이름을 취득합니다. |
NameParser |
getNameParser (Name name)
지정된 컨텍스트에 관련한 파서를 취득합니다. |
NameParser |
getNameParser (String name)
이름 첨부 컨텍스트에 관련한 파서를 취득합니다. |
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)
이름 첨부 객체를 안바인드 합니다. |
| 필드의 상세 |
|---|
static final String INITIAL_CONTEXT_FACTORY
이 정수의 값은 java.naming.factory.initial 입니다.
InitialContext,
InitialDirContext,
NamingManager.getInitialContext(java.util.Hashtable),
InitialContextFactory,
NoInitialContextException,
addToEnvironment(String, Object),
removeFromEnvironment(String),
APPLET,
정수 필드값 static final String OBJECT_FACTORIES
이 정수의 값은 java.naming.factory.object 입니다.
NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable),
ObjectFactory,
addToEnvironment(String, Object),
removeFromEnvironment(String),
APPLET,
정수 필드값 static final String STATE_FACTORIES
이 정수의 값은 java.naming.factory.state 입니다.
NamingManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable),
StateFactory,
addToEnvironment(String, Object),
removeFromEnvironment(String),
APPLET,
정수 필드값 static final String URL_PKG_PREFIXES
이 정수의 값은 java.naming.factory.url.pkgs 입니다.
NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable),
NamingManager.getURLContext(java.lang.String, java.util.Hashtable),
ObjectFactory,
addToEnvironment(String, Object),
removeFromEnvironment(String),
APPLET,
정수 필드값 static final String PROVIDER_URL
이 정수의 값은 java.naming.provider.url 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
APPLET,
정수 필드값 static final String DNS_URL
이 정수의 값은 java.naming.dns.url 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String AUTHORITATIVE
이 정수의 값은 java.naming.authoritative 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String BATCHSIZE
이 정수의 값은 java.naming.batchsize 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String REFERRAL
이 정수의 값은 java.naming.referral 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String SECURITY_PROTOCOL
이 정수의 값은 java.naming.security.protocol 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String SECURITY_AUTHENTICATION
이 정수의 값은 java.naming.security.authentication 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String SECURITY_PRINCIPAL
이 정수의 값은 java.naming.security.principal 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String SECURITY_CREDENTIALS
이 정수의 값은 java.naming.security.credentials 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String LANGUAGE
이 정수의 값은 java.naming.language 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
정수 필드값 static final String APPLET
이 정수의 값은 java.naming.applet 입니다.
addToEnvironment(String, Object),
removeFromEnvironment(String),
InitialContext,
정수 필드값 | 메서드의 상세 |
|---|
Object lookup(Name name)
throws NamingException
name - 검색하는 객체의 이름
NamingException - 네이밍 예외가 발생했을 경우lookup(String),
lookupLink(Name)
Object lookup(String name)
throws NamingException
lookup(Name)를
참조하십시오.
name - 검색하는 객체의 이름
NamingException - 네이밍 예외가 발생했을 경우
void bind(Name name,
Object obj)
throws NamingException
name - 비어있지 않은 바인드 되는 이름obj - null
가능성이 있는 바인드 되는 객체
NameAlreadyBoundException - 이름이 이미
바인드 되고 있는 경우
InvalidAttributesException - 객체에 모든 필수 속성이 지정되어 있지 않은 경우
NamingException - 네이밍 예외가 발생했을 경우bind(String, Object),
rebind(Name, Object),
DirContext.bind(Name, Object, javax.naming.directory.Attributes)
void bind(String name,
Object obj)
throws NamingException
bind(Name, Object)를
참조하십시오.
name - 비어있지 않은 바인드 되는 이름obj - null
가능성이 있는 바인드 되는 객체
NameAlreadyBoundException - 이름이 이미
바인드 되고 있는 경우
InvalidAttributesException - 객체에 모든 필수 속성이 지정되어 있지 않은 경우
NamingException - 네이밍 예외가 발생했을 경우
void rebind(Name name,
Object obj)
throws NamingException
객체가 DirContext인 경우, 이름에 관련된 기존의 속성이, 객체의 속성과 치환됩니다. 치환되지 않는 경우, 이름에 관련된 기존의 속성은 변경되지 않은 채입니다.
name - 비어있지 않은 바인드 되는 이름obj - null
가능성이 있는 바인드 되는 객체
InvalidAttributesException - 객체에 모든 필수 속성이 지정되어 있지 않은 경우
NamingException - 네이밍 예외가 발생했을 경우rebind(String, Object),
bind(Name, Object),
DirContext.rebind(Name, Object, javax.naming.directory.Attributes),
DirContext
void rebind(String name,
Object obj)
throws NamingException
rebind(Name, Object)를
참조하십시오.
name - 비어있지 않은 바인드 되는 이름obj - null
가능성이 있는 바인드 되는 객체
InvalidAttributesException - 객체에 모든 필수 속성이 지정되어 있지 않은 경우
NamingException - 네이밍 예외가 발생했을 경우
void unbind(Name name)
throws NamingException
name
종단의 기본 부분 이외의 모두에 의해 이름이 붙여진 타겟 컨텍스트
으로부터, name
종단의 기본명을 삭제합니다.
이 메서드는 나무등입니다. 종단의 기본명이 타겟 컨텍스트 으로 바인드되어 있지 않은 경우에서도, 성공합니다. 다만, 중간 컨텍스트이 존재하지 않는 경우는 NameNotFoundException이 발생 됩니다.
이름에 관련된 속성이 삭제됩니다. 중간 컨텍스트은 변경되지 않습니다.
name - 안바인드 하는 이름. 공백은 불가
NameNotFoundException - 중간 컨텍스트이 존재하지 않는 경우
NamingException - 네이밍 예외가 발생했을 경우unbind(String)
void unbind(String name)
throws NamingException
unbind(Name)를
참조하십시오.
name - 안바인드 하는 이름. 공백은 불가
NameNotFoundException - 중간 컨텍스트이 존재하지 않는 경우
NamingException - 네이밍 예외가 발생했을 경우
void rename(Name oldName,
Name newName)
throws NamingException
oldName - 기존의 바인딩의 이름. 공백은 불가newName - 새로운 바인딩의 이름. 공백은 불가
NameAlreadyBoundException - newName가 이미
바인드 되고 있는 경우
NamingException - 네이밍 예외가 발생했을 경우rename(String, String),
bind(Name, Object),
rebind(Name, Object)
void rename(String oldName,
String newName)
throws NamingException
rename(Name, Name)를
참조하십시오.
oldName - 기존의 바인딩의 이름. 공백은 불가newName - 새로운 바인딩의 이름. 공백은 불가
NameAlreadyBoundException - newName가 이미
바인드 되고 있는 경우
NamingException - 네이밍 예외가 발생했을 경우
NamingEnumeration <NameClassPair > list(Name name)
throws NamingException
이 컨텍스트에 바인딩이 추가되는지, 또는 이 컨텍스트 으로부터 바인딩이 삭제되는 경우, 이전에 리턴된 열거에의 영향은 정의되지 않습니다.
name - 리스트 표시하는 컨텍스트
의 이름
NamingException - 네이밍 예외가 발생했을 경우list(String),
listBindings(Name),
NameClassPair
NamingEnumeration <NameClassPair > list(String name)
throws NamingException
list(Name)를
참조하십시오.
name - 리스트 표시하는 컨텍스트
의 이름
NamingException - 네이밍 예외가 발생했을 경우
NamingEnumeration <Binding > listBindings(Name name)
throws NamingException
이 컨텍스트에 바인딩이 추가되는지, 또는 이 컨텍스트 으로부터 바인딩이 삭제되는 경우, 이전에 리턴된 열거에의 영향은 정의되지 않습니다.
name - 리스트 표시하는 컨텍스트
의 이름
NamingException - 네이밍 예외가 발생했을 경우listBindings(String),
list(Name),
Binding
NamingEnumeration <Binding > listBindings(String name)
throws NamingException
listBindings(Name)를
참조하십시오.
name - 리스트 표시하는 컨텍스트
의 이름
NamingException - 네이밍 예외가 발생했을 경우
void destroySubcontext(Name name)
throws NamingException
이 메서드는 나무등입니다. 종단의 기본명이 타겟 컨텍스트 으로 바인드되어 있지 않은 경우에서도, 성공합니다. 다만, 중간 컨텍스트이 존재하지 않는 경우는 NameNotFoundException이 발생 됩니다.
연합 네이밍 시스템에서는 1개의 네이밍 시스템으로부터의 컨텍스트이 다른 네이밍 시스템의 이름에 바인드 됩니다. 그 후, 컴퍼짓이름을 사용해 외부 컨텍스트 의 오퍼레이션을 검색 및 실행할 수 있습니다. 다만, 외부 컨텍스트은 바인드 된 컨텍스트 의 서브 컨텍스트은 아니기 때문에 이 컴퍼짓이름을 사용해 컨텍스트를 파기하려고 하면, NotContextException로 실패합니다. 대신에 unbind()를 사용해, 외부 컨텍스트 의 바인딩을 삭제합니다. 외부 컨텍스트를 파기하려면, 외부 컨텍스트 의 「네이티브인」네이밍 시스템으로부터 컨텍스트 으로 destroySubcontext()를 실행할 필요가 있습니다.
name - 파기되는 컨텍스트
의 이름. 공백은 불가
NameNotFoundException - 중간 컨텍스트이 존재하지 않는 경우
NotContextException - 이름이 바인드 되고 있지만 컨텍스트
의 이름이 없는 또는 해당하는 형태의 컨텍스트
의 이름이 없는 경우
ContextNotEmptyException - 지정된 컨텍스트이 비어있지 않은 경우
NamingException - 네이밍 예외가 발생했을 경우destroySubcontext(String)
void destroySubcontext(String name)
throws NamingException
destroySubcontext(Name)를
참조하십시오.
name - 파기되는 컨텍스트
의 이름. 공백은 불가
NameNotFoundException - 중간 컨텍스트이 존재하지 않는 경우
NotContextException - 이름이 바인드 되고 있지만 컨텍스트
의 이름이 없는 또는 해당하는 형태의 컨텍스트
의 이름이 없는 경우
ContextNotEmptyException - 지정된 컨텍스트이 비어있지 않은 경우
NamingException - 네이밍 예외가 발생했을 경우
Context createSubcontext(Name name)
throws NamingException
name - 비어있지 않은 작성되는 컨텍스트
의 이름
NameAlreadyBoundException - 이름이 이미
바인드 되고 있는 경우
InvalidAttributesException - 서브 컨텍스트
의 작성에
필수 속성의 지정이 필요한 경우
NamingException - 네이밍 예외가 발생했을 경우createSubcontext(String),
DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes)
Context createSubcontext(String name)
throws NamingException
createSubcontext(Name)를
참조하십시오.
name - 비어있지 않은 작성되는 컨텍스트
의 이름
NameAlreadyBoundException - 이름이 이미
바인드 되고 있는 경우
InvalidAttributesException - 서브 컨텍스트
의 작성에
필수 속성의 지정이 필요한 경우
NamingException - 네이밍 예외가 발생했을 경우
Object lookupLink(Name name)
throws NamingException
name - 검색하는 객체의 이름
NamingException - 네이밍 예외가 발생했을 경우lookupLink(String)
Object lookupLink(String name)
throws NamingException
lookupLink(Name)를
참조하십시오.
name - 검색하는 객체의 이름
NamingException - 네이밍 예외가 발생했을 경우
NameParser getNameParser(Name name)
throws NamingException
name - 파서의 취득원의 컨텍스트
의 이름
NamingException - 네이밍 예외가 발생했을 경우getNameParser(String),
CompoundName
NameParser getNameParser(String name)
throws NamingException
getNameParser(Name)를
참조하십시오.
name - 파서의 취득원의 컨텍스트
의 이름
NamingException - 네이밍 예외가 발생했을 경우
Name composeName(Name name,
Name prefix)
throws NamingException
name), 상위 컨텍스트
의 1개를 기준으로 한 이 컨텍스트
의 이름 (prefix)을 지정하면, 이 메서드는 관련된 네이밍 시스템에 해당하는 구문을 사용해, 2개의 이름의 복합을 리턴합니다. 즉, name에
의해 이 컨텍스트에 관련해 객체에 이름을 붙이는 경우, 결과는 같은 객체의 이름이 됩니다만, 상위 컨텍스트에 관련하고 있습니다. 이름은 null 로 할 수 없습니다.
예를 들어이 컨텍스트이 초기 컨텍스트에 관련해 wiz.com 라고 명명해졌을 경우는
composeName("east", "wiz.com")
east.wiz.com가 리턴됩니다
. 이 컨텍스트
의 이름이 org/research인 경우는
composeName("user/jane", "org/research")
org/research/user/jane가 리턴됩니다
.
composeName("user/jane", "research")
research/user/jane가 리턴됩니다
.
name - 이 컨텍스트에 관련한 이름prefix - 상위 컨텍스트
의 1개에 관련한 이 컨텍스트
의 이름
prefix 및 name
변환
NamingException - 네이밍 예외가 발생했을 경우composeName(String, String)
String composeName(String name,
String prefix)
throws NamingException
composeName(Name, Name)를
참조하십시오.
name - 이 컨텍스트에 관련한 이름prefix - 상위 컨텍스트
의 1개에 관련한 이 컨텍스트
의 이름
prefix 및 name
변환
NamingException - 네이밍 예외가 발생했을 경우
Object addToEnvironment(String propName,
Object propVal)
throws NamingException
propName - 추가하는 환경 프로퍼티의 이름. null 이외propVal - 추가하는 프로퍼티의 값. null 이외
NamingException - 네이밍 예외가 발생했을 경우getEnvironment(),
removeFromEnvironment(String)
Object removeFromEnvironment(String propName)
throws NamingException
propName - 삭제하는 환경 프로퍼티의 이름. null 이외
NamingException - 네이밍 예외가 발생했을 경우getEnvironment(),
addToEnvironment(String, Object)
Hashtable <?,?> getEnvironment()
throws NamingException
호출측은 리턴된 객체를 변경할 수 없습니다. 컨텍스트에 대한 효과는 정의되지 않습니다. 이 컨텍스트 의 환경은, addToEnvironment() 및 removeFromEnvironment()에 의해 변경되는 일이 있습니다.
NamingException - 네이밍 예외가 발생했을 경우addToEnvironment(String, Object),
removeFromEnvironment(String)
void close()
throws NamingException
이 메서드는 나무등입니다. 이미 닫혀진 컨텍스트 으로 이 메서드를 호출해도, 효과는 없습니다. 닫혀진 컨텍스트 으로 다른 메서드를 호출할 수 없습니다. 결과는 미정도리의 동작이 됩니다.
NamingException - 네이밍 예외가 발생했을 경우
String getNameInNamespace()
throws NamingException
많은 네이밍 서비스에는 각 이름 공간의 객체에 대한 「완전한 이름」의 개념이 있습니다. 예를 들어 LDAP 엔트리에는 식별명이 있어, DNS 레코드에는 완전 수식명이 있습니다. 이 메서드에의해 클라이언트 어플리케이션으로 이 이름을 취득할 수 있습니다. 이 메서드로 리턴된 캐릭터 라인은 JNDI 컴퍼짓이름은 아니고, 컨텍스트 메서드에 직접 건네줄 수 없습니다. 완전한 이름의 개념이 미를 가지지 않는 네이밍 시스템에서는 OperationNotSupportedException이 발생 됩니다.
OperationNotSupportedException - 네이밍 시스템에 완전한 이름의 개념이 없는 경우
NamingException - 네이밍 예외가 발생했을 경우
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | constructor | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.