javax.naming.ldap
클래스 ControlFactory

java.lang.Object 
  |
  +--javax.naming.ldap.ControlFactory

public abstract class ControlFactory

extends Object

이 추상 클래스는 LDAPv3 컨트롤의 작성에 사용하는 팩토리를 표시합니다. LDAPv3 컨트롤은「RFC 2251」으로 정의되고 있습니다.

서비스 프로바이더가 응답 컨트롤을 수신하면(자), 이 프로바이더는 컨트롤 팩토리를 사용해, 특정 또는 임의의 컨트롤 클래스를 돌려줍니다.

도입된 버젼:

1.3

관련 항목:

Control

생성자의 개요

protected

ControlFactory ()

메소드의 개요

abstract Control	getControlInstance (Control ctl) 컨트롤 팩토리를 사용하는 컨트롤을 작성합니다.
static Control	getControlInstance (Control ctl, Context ctx, Hashtable env) 기존의 컨트롤 팩토리를 사용하는 컨트롤을 작성합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

ControlFactory

protected ControlFactory()

메소드의 상세

getControlInstance

public abstract Control  getControlInstance(Control  ctl)
                                    throws NamingException 

컨트롤 팩토리를 사용하는 컨트롤을 작성합니다.

이 팩토리는 서비스 프로바이더가, LDAP 프로토콜로부터 읽어내는 컨트롤을 특수한 컨트롤 클래스로서 돌려줄 때 사용합니다. 이 기구를 사용하지 않으면, 프로바이더는 BER encode 형식의 데이터만을 포함한 컨트롤을 돌려줍니다.

일반적으로,ctl 는 BER encode 데이터를 포함한 기본적인 컨트롤입니다. 팩토리는 특수한 컨트롤을 구현하는데 사용됩니다만, 통상은 BER encode 데이터를 복합화해, 형태 프로텍션된 안전한 방법으로 해당 데이터에 액세스 하는 메소드를 제공합니다.

예를 들어, 팩토리는 기본적인 컨트롤의 BER encode 데이터를 사용해 VirtualListReplyControl 의 인스턴스를 돌려주는 경우가 있습니다.

이 팩토리가 지정 인수를 사용해 컨트롤을 작성할 수 없는 경우, null 를 돌려줍니다. 예외가 슬로우 되는 것은 이 컨트롤 팩토리만이 사용되어 다른 컨트롤 팩토리가 사용되지 않을 때 뿐입니다. 컨트롤의 BER encode 데이터가, 지정된 OID 를 가진다고 보이고 있는 컨트롤과 일치하지 않는 경우에, 예외가 슬로우 됩니다. 이 메소드는 NamingException 를 슬로우 하기 위한(해), 내부적으로 생성되는 예외를 전달할 필요가 있는 경우는 NamingException 에 랩 할 필요가 있습니다.

파라미터:

ctl - null 이외의 컨트롤

반환값:

null 의 가능성이 있는 컨트롤

예외:

NamingException - ctl 가, 컨트롤의 작성에 사용할 수 없게 되는 것 같은 무효인 데이터를 포함하고 있는 경우. 팩토리가 예외를 슬로우 하는 것은 OID 에 의해 식별되는 컨트롤의 생성 방법을 알 수 있고 있는데, 무효인 BER encode 데이터등의 이유로써 컨트롤을 생성할 수 없는 경우 뿐입니다.

getControlInstance

public static Control  getControlInstance(Control  ctl,
                                         Context  ctx,
                                         Hashtable  env)
                                  throws NamingException 

기존의 컨트롤 팩토리를 사용하는 컨트롤을 작성합니다.

컨트롤을 작성하려면 , 다음의 규칙이 사용됩니다.

• 환경의 LdapContext.CONTROL_FACTORIES 프로퍼티로 지정된 컨트롤 팩토리를 사용하고 나서,ctx 에 관련지을 수 있었던 프로바이더 resource file의 동일 프로퍼티로 지정된 컨트롤 팩토리를 사용한다. 이 프로퍼티의 값은 구두점으로 단락지어진 팩토리 클래스명의 리스트이다. 팩토리 클래스는 리스트로 지정된 차례로 사용된다. 컨트롤의 작성에 최초로 성공한 팩토리가 실제로 사용된다. 로드 가능한 팩토리가 없는 경우는 ctl 를 돌려줍니다. 컨트롤 작성중에, 예외가 발생하면(자), 예외는 호출해 측에 인도해집니다.

컨트롤 팩토리는 public 입니다만, 또 인수를 취하지 않는 public constructor를 가질 필요가 있습니다.

파라미터:

ctl - OID 및 BER encode 데이터를 포함한 null 이외의 컨트롤 오브젝트

ctx - 컨트롤이 작성되는 null 의 가능성이 있는 문맥. null 의 경우는 이 정보는 이용할 수 없는

env - null 의 가능성이 있는 문맥 환경. LdapContext.CONTROL_FACTORIES 프로퍼티의 값을 검색하는데 사용된다

반환값:

ctl 를 사용해 생성된 컨트롤 오브젝트, 또는 상기의 알고리즘을 사용해 컨트롤 오브젝트를 생성할 수 없는 경우는 ctl

예외:

NamingException - 네이밍 예외가, 컨트롤 오브젝트를 작성하려고 할 때 발생했을 경우. 액세스 된 팩토리의 1 개가 예외를 슬로우 하면(자), 그 예외는 호출해 측에 보내진다. 팩토리 및 오브젝트 클래스의 로드안 또는 인스턴스 생성중에 에러가 발생하면(자), 그 예외는 NamingException 의 내부에 랩 되고 나서 재차 슬로우 된다