javax.naming.ldap
클래스 ControlFactory

java.lang.Object 
  javax.naming.ldap.ControlFactory

public abstract class ControlFactory
extends Object 

이 abstract 클래스는 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을 Throw 하기 위한, 내부적으로 생성되는 예외를 전달할 필요가 있는 경우는 NamingException에 랩 할 필요가 있습니다.

파라미터:

ctl - null 이외의 컨트롤

반환값:

null 가능성이 있는 컨트롤

예외:

NamingException - ctl가 컨트롤의 작성에 사용할 수 없게 되는 것 같은 무효인 데이터를 포함하고 있는 경우. 팩토리가 예외를 Throw 하는 것은 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 생성자를 가질 필요가 있습니다.

파라미터:

ctl - OID 및 BER encode 데이터를 포함한 null 이외의 컨트롤 객체

ctx - 컨트롤이 작성되는 null 가능성이 있는 컨텍스트. null인 경우는 이 정보는 이용할 수 없는

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

반환값:

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

예외:

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