javax.naming.ldap
클래스 InitialLdapContext

java.lang.Object 
  javax.naming.InitialContext 
      javax.naming.directory.InitialDirContext 
          javax.naming.ldap.InitialLdapContext

모든 구현된 인터페이스:

Context, DirContext, LdapContext

public class InitialLdapContext
extends InitialDirContext 
implements LdapContext 

이 클래스는 LDAPv3 스타일의 확장 조작 및 확장 컨트롤을 실행하기 위한 개시 컨텍스트 입니다.

동기에 관한 상세, 초기 컨텍스트 의 작성 방침에 대해서는 javax.naming.InitialContext 및 javax.naming.InitialDirContext를 참조하십시오.

요구 컨트롤

InitialLdapContext 인 초기 컨텍스트를 작성할 때는 요구 컨트롤의 리스트를 지정할 수 있습니다. 리스트내의 컨트롤은 컨텍스트, 또는 컨텍스트 으로부터 파생한 컨텍스트에 의해 실행된 암묵적인 LDAP 바인드 조작을 위한 요구 컨트롤로서 사용됩니다. 이러한 컨트롤을 「접속 요구 컨트롤」이라고 합니다. 컨텍스트 의 접속 요구 컨트롤을 취득하려면, getConnectControls()를 사용합니다.

초기 컨텍스트 생성자 으로 지정된 요구 컨트롤은 검색 및 룩 업등의 후속의 컨텍스트 조작의 컨텍스트 요구 컨트롤로서는 사용되지 않습니다. 컨텍스트 요구 컨트롤은, setRequestControls()를 사용해 설정 및 변경됩니다.

따라서, 컨텍스트에 관련한 요구 컨트롤에는 접속 요구 컨트롤과 컨텍스트 요구 컨트롤의 2 종류세트를 가지는 일이 있습니다. 이것은 컨텍스트 조작과 암묵적인 LDAP 바인드 조작의 양쪽 모두에 적용할 수 있는 위기인 컨트롤을 보낼 필요가 있는 어플리케이션에는 필요합니다. 일반 사용자 의 프로그램은 다음과 같이 처리됩니다.

 InitialLdapContext lctx = new InitialLdapContext(env, critConnCtls);
 lctx.setRequestControls(critModCtls);
 lctx.modifyAttributes(name, mods);
 Controls[] respCtls =  lctx.getResponseControls();

우선, 초기 컨텍스트를 작성하기 위해서 위기인 컨트롤 (critConnCtls)을 지정합니다. 다음에 컨텍스트 조작을 위한 컨텍스트 의 요구 컨트롤 (critModCtls)을 설정합니다. 어떠한 이유이기 때문에 lctx가 재차 서버에 접속할 필요가 있는 경우는 critConnCtls를 사용합니다. 요구 컨트롤의 자세한 것은 LdapContext 인터페이스를 참조하십시오.

구현측인 서비스 프로바이더는 LdapContext 클래스의 「서비스 프로바이더」의 섹션을 숙독해, 구현의 상세를 파악해 주세요.

도입된 버전 :

1.3

관련 항목:

LdapContext, InitialContext, InitialDirContext, NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder)

필드 개요

클래스 javax.naming. InitialContext 로부터 상속된 필드

defaultInitCtx, gotDefault, myProps

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

CONTROL_FACTORIES

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

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

인터페이스 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

생성자 개요

InitialLdapContext ()
환경 프로퍼티 또는 접속 요구 컨트롤을 사용하지 않고, 초기 컨텍스트를 구축합니다.

InitialLdapContext (Hashtable <?,?> environment, Control [] connCtls)
환경 프로퍼티 및 접속 요구 컨트롤을 사용해, 초기 컨텍스트를 구축합니다.

메서드 개요

ExtendedResponse	extendedOperation (ExtendedRequest request) 확장 조작을 실행합니다.
Control []	getConnectControls () 이 컨텍스트에 유효한 접속 요구 컨트롤을 취득합니다.
Control []	getRequestControls () 이 컨텍스트에 유효한 요구 컨트롤을 취득합니다.
Control []	getResponseControls () 이 컨텍스트 으로 마지막에 불려 간 메서드의 결과로서 생성된 응답 컨트롤을 취득합니다.
LdapContext	newInstance (Control [] reqCtls) 이 컨텍스트 의 새로운 인스턴스를 요구 컨트롤을 사용해 생성합니다.
void	reconnect (Control [] connCtls) 지정된 컨트롤과 이 컨텍스트 환경을 사용해 LDAP 서버에 재접속합니다.
void	setRequestControls (Control [] requestControls) 이 컨텍스트 으로 계속해 호출되는 메서드에 요구 컨트롤을 설정합니다.

클래스 javax.naming.directory. InitialDirContext 로부터 상속된 메서드

bind, bind, createSubcontext, createSubcontext, getAttributes, getAttributes, getAttributes, getAttributes, getSchema, getSchema, getSchemaClassDefinition, getSchemaClassDefinition, modifyAttributes, modifyAttributes, modifyAttributes, modifyAttributes, rebind, rebind, search, search, search, search, search, search, search, search

클래스 javax.naming. InitialContext 로부터 상속된 메서드

addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getDefaultInitCtx, getEnvironment, getNameInNamespace, getNameParser, getNameParser, getURLOrDefaultInitCtx, getURLOrDefaultInitCtx, init, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

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

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

인터페이스 javax.naming.directory. DirContext 로부터 상속된 메서드

bind, bind, createSubcontext, createSubcontext, getAttributes, getAttributes, getAttributes, getAttributes, getSchema, getSchema, getSchemaClassDefinition, getSchemaClassDefinition, modifyAttributes, modifyAttributes, modifyAttributes, modifyAttributes, rebind, rebind, search, search, search, search, search, search, search, search

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

addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

생성자 상세

InitialLdapContext

public InitialLdapContext()
                   throws NamingException 

환경 프로퍼티 또는 접속 요구 컨트롤을 사용하지 않고, 초기 컨텍스트를 구축합니다. new InitialLdapContext(null, null)와 동등합니다.

예외:

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

InitialLdapContext

public InitialLdapContext(Hashtable <?,?> environment,
                          Control [] connCtls)
                   throws NamingException 

환경 프로퍼티 및 접속 요구 컨트롤을 사용해, 초기 컨텍스트를 구축합니다. 환경 프로퍼티에 대해서는 javax.naming.InitialContext를 참조하십시오.

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

connCtls는 기가 되는 컨텍스트 인스턴스의 접속 요구 컨트롤로서 사용됩니다. 자세한 내용은 클래스의 기술을 참조하십시오.

파라미터:

environment - 초기 DirContext 작성에 사용되는 환경. null은 비어있는 환경을 나타내는

connCtls - 초기 컨텍스트 의 접속 요구 컨트롤. null인 경우, 접속 요구 컨트롤은 사용되지 않는다

예외:

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

관련 항목:

reconnect(javax.naming.ldap.Control[]), LdapContext.reconnect(javax.naming.ldap.Control[])

메서드의 상세

extendedOperation

public ExtendedResponse  extendedOperation(ExtendedRequest  request)
                                   throws NamingException 

인터페이스 LdapContext 기술:

확장 조작을 실행합니다.이 메서드를 사용해, LDAPv3 확장 조작을 지원 합니다.

정의:

인터페이스 LdapContext 내의 extendedOperation

파라미터:

request - 실행하는 null 이외의 요구

반환값:

null 가능성이 있는 조작의 응답. null은 조작을 해도 응답은 아무것도 생성되지 않는 것을 나타낸다

예외:

NamingException - 확장 조작 실행중에 에러가 발생했을 경우

newInstance

public LdapContext  newInstance(Control [] reqCtls)
                        throws NamingException 

인터페이스 LdapContext 기술:

이 컨텍스트 의 새로운 인스턴스를 요구 컨트롤을 사용해 생성합니다.이 메서드는 multi-thread의 액세스를 위해서 이 컨텍스트 인스턴스를 새롭게 작성하는 편리한 수법입니다. 예를 들어 복수의 thread가 각각 다른 컨텍스트 요구 컨트롤을 사용하고 싶은 경우, 각 thread는 다른 thread와 동기 할 필요가 없고, 이 메서드를 사용해, 이 컨텍스트 독자적인 복사본을 취득해, 컨텍스트 요구 컨트롤을 설정 또는 취득할 수 있습니다.

새로운 컨텍스트에 는 이 컨텍스트과 같은 환경 프로퍼티, 접속 요구 컨트롤이 있습니다. 상세한 것에 대하여는 클래스에 대한 기술을 참조하십시오. 이 컨텍스트과 새로운 컨텍스트 의 사이로 같은 네트워크 접속 또는 그 외의 자원을 공유할 수도 있습니다. 다만, 각 컨텍스트 의 사이에 경합이 발생하는 경우는 공유할 수 없습니다.

정의:

인터페이스 LdapContext 내의 newInstance

파라미터:

reqCtls - 새로운 컨텍스트에 사용하는 null 가능성이 있는 요구 컨트롤. null인 경우는 요구 컨트롤을 사용하지 않고 초기화된다

반환값:

null 이외의 LdapContext 인스턴스

예외:

NamingException - 새로운 인스턴스의 작성중에 에러가 발생했을 경우

관련 항목:

InitialLdapContext

reconnect

public void reconnect(Control [] connCtls)
               throws NamingException 

인터페이스 LdapContext 기술:

지정된 컨트롤과 이 컨텍스트 환경을 사용해 LDAP 서버에 재접속합니다.

이 메서드는 LDAP 바인드 조작을 명시적으로 초기화하는 방법입니다. 이 메서드를 사용해, LDAP 바인드 조작에 요구 컨트롤을 설정하거나 또는 그 조작에 의해 리턴된 응답 컨트롤을 취득하기 위해서 명시적으로 서버에 접속할 수 있습니다.

이 메서드에서는 이 컨텍스트 의 connCtls를 새로운 접속 요구 컨트롤이 되도록 설정합니다. 이 컨텍스트 의 컨텍스트 요구 컨트롤은 영향을 받지 않습니다. 이 메서드가 불려가 면, 그 후에 계속되는 암묵적인 재접속이 connCtls를 사용해 실행됩니다. connCtls는 또, 접속 요구 컨트롤로서 이 컨텍스트 으로부터 파생한 새로운 컨텍스트 인스턴스에도 사용됩니다. 이러한 접속 요구 컨트롤은, setRequestControls() 영향을 받지 않습니다.

구현의 상세한 것에 대하여는 구현측인 서비스 프로바이더는 클래스의 「서비스 프로바이더」섹션을 잘 읽어 주세요.

정의:

인터페이스 LdapContext 내의 reconnect

파라미터:

connCtls - null 가능성이 있는 사용하기 위한 컨트롤. null인 경우, 컨트롤은 사용되지 않는다

예외:

NamingException - 재접속중에 에러가 발생했을 경우

관련 항목:

LdapContext.getConnectControls(), LdapContext.newInstance(javax.naming.ldap.Control[])

getConnectControls

public Control [] getConnectControls()
                             throws NamingException 

인터페이스 LdapContext 기술:

이 컨텍스트에 유효한 접속 요구 컨트롤을 취득합니다. 컨트롤은 JNDI 구현이 소유하고 있어, 불변입니다. 배열, 컨트롤의 어느쪽이나, 호출측은 변경할 수 없습니다.

정의:

인터페이스 LdapContext 내의 getConnectControls

반환값:

null 가능성이 있는 컨트롤의 배열. null은 이 컨텍스트에 대해서 컨트롤이 설정되어 있지 않은 것을 나타낸다

예외:

NamingException - 요구 컨트롤의 취득중에 에러가 발생했을 경우

setRequestControls

public void setRequestControls(Control [] requestControls)
                        throws NamingException 

인터페이스 LdapContext 기술:

이 컨텍스트 으로 계속해 호출되는 메서드에 요구 컨트롤을 설정합니다. 이 요구 컨트롤은 JNDI 구현이 소유하고 있어, 불변입니다. 배열, 컨트롤의 어느쪽이나, 호출측은 변경할 수 없습니다.

이전의 요구 컨트롤을 모두 삭제해, 계속해 이 컨텍스트 으로 호출되는 메서드가 사용하기 위해서 requestControls를 추가합니다.

requestControls는 다음에 setRequestControls()를 호출할 때까지 유효합니다. 더 이상 컨텍스트 메서드에 영향을 주고 싶지 않은 경우는 컨트롤을 해제하기 위해서 null 또는 비어있는 배열을 가지는 setRequestControls()를 명시적으로 호출할 필요가 있습니다. 이 컨텍스트에 효과적인 요구 컨트롤을 확인하려면, getRequestControls()를 사용합니다.

정의:

인터페이스 LdapContext 내의 setRequestControls

파라미터:

requestControls - null 가능성이 있는 사용하기 위한 컨트롤. null인 경우, 컨트롤은 사용되지 않는다

예외:

NamingException - 요구 컨트롤의 설정중에 에러가 발생했을 경우

관련 항목:

LdapContext.getRequestControls()

getRequestControls

public Control [] getRequestControls()
                             throws NamingException 

인터페이스 LdapContext 기술:

이 컨텍스트에 유효한 요구 컨트롤을 취득합니다. 이 요구 컨트롤은 JNDI 구현이 소유하고 있어, 불변입니다. 배열, 컨트롤의 어느쪽이나, 호출측은 변경할 수 없습니다.

정의:

인터페이스 LdapContext 내의 getRequestControls

반환값:

null 가능성이 있는 컨트롤의 배열. null은 이 컨텍스트에 대해서 요구 컨트롤이 설정되어 있지 않은 것을 나타낸다

예외:

NamingException - 요구 컨트롤의 취득중에 에러가 발생했을 경우

관련 항목:

LdapContext.setRequestControls(javax.naming.ldap.Control[])

getResponseControls

public Control [] getResponseControls()
                              throws NamingException 

인터페이스 LdapContext 기술:

이 컨텍스트 으로 마지막에 불려 간 메서드의 결과로서 생성된 응답 컨트롤을 취득합니다. 이 응답 컨트롤은 JNDI 구현이 소유하고 있어, 불변입니다. 배열, 컨트롤의 어느쪽이나, 호출측은 변경할 수 없습니다.

이러한 응답 컨트롤에는 정상적으로 종료한 조작 또는 실패한 조작에 의해 생성된 것이 있습니다.

응답 컨트롤을 돌려줄 수 있는 컨텍스트 메서드가 불려가 면, 이전의 메서드 호출로부터의 응답 컨트롤은 모두 해제됩니다. getResponseControls()는 LDAP 서버로부터 받은 순서로 컨텍스트 메서드가 조작한 LDAP에 의해 생성되는 모든 응답 컨트롤을 리턴합니다. getResponseControls()를 호출하면, 이전의 응답 컨트롤은 해제되지 않습니다. 컨트롤을 돌려줄 수 있는 다음의 컨텍스트 메서드가 불려 갈 때까지 몇 번이라도 호출하거나 같은 컨트롤을 되돌리거나 하는 것이 가능합니다.

정의:

인터페이스 LdapContext 내의 getResponseControls

반환값:

null 가능성이 있는 컨트롤의 배열. null인 경우, 이 컨텍스트 으로 불려 간 이전의 메서드는 컨트롤을 생성하고 있지 않다

예외:

NamingException - 응답 컨트롤의 취득중에 에러가 발생했을 경우