compact3

javax.naming.ldap

Class ControlFactory

java.lang.Object

javax.naming.ldap.ControlFactory

public abstract class ControlFactory
extends Object

这个抽象类是一个用于创建LDAPv3控制厂。LDAPv3控件定义在 RFC 2251。

当一个服务提供商收到一个响应控制时，它使用控制工厂来返回特定的/适当的控制类实现。

从以下版本开始：

一点三

另请参见：

Control

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	ControlFactory() 创建控件工厂的一个新实例。

方法摘要

Modifier and Type	Method and Description
abstract Control	getControlInstance(Control ctl) 使用此控件工厂创建控件。
static Control	getControlInstance(Control ctl, Context ctx, Hashtable<?,?> env) 使用已知的控制工厂创建一个控件。

Methods inherited from class java.lang.Object

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

Constructor Detail

ControlFactory

protected ControlFactory()

创建控件工厂的一个新实例。

方法详细信息

getControlInstance

public abstract Control getControlInstance(Control ctl)
                                    throws NamingException

使用此控件工厂创建控件。

本厂是由服务提供者用来返回控件，它读取LDAP协议作为控制类专业。如果没有这个机制，提供程序将返回只包含在误码率编码格式中的数据的控件。

通常情况下，ctl是一个“基本”控制含有BER编码的数据。工厂是用来创建一个专门的控制实现，通常是通过解码的的的的比特率编码的数据，提供的方法来访问该数据在一个类型的安全和友好的方式。

例如，一个工厂可以使用BER编码的基本控制数据并返回一个virtuallistreplycontrol实例。

如果这个工厂不能创建一个使用提供的参数的控件，则该控件将返回空值。工厂应该只抛出一个例外，如果它是肯定的，它是唯一的工厂，没有其他控制工厂应尝试。这可能发生，例如，如果在控制系统数据不匹配是一个给定的OID控制预期。由于该方法抛出NamingException，其他内部产生的异常应传播必须包裹在NamingException。

参数

ctl -一个非空的控制。

结果

一个可能的空控制。

异常

NamingException -如果 ctl包含无效数据，防止它被用来创建一个控制。工厂应该抛出一个异常，如果它知道如何生产控制（通过OID标识）但不能因为，例如误码数据无效。

getControlInstance

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

使用已知的控制工厂创建一个控件。

下面的规则用于创建控件：

• 使用环境的LdapContext.CONTROL_FACTORIES属性指定的控制工厂，并与ctx供应商资源文件，按顺序。此属性的值是一个正在尝试的工厂级名称的结肠分离列表，第一个成功创建控件的是一个使用过的。如果工厂没有可以加载，返回ctl。如果在创建控件时遇到异常，则向调用方传递异常。

请注意，一个控件工厂必须是公共的，必须有一个不接受参数的公共构造函数。

参数

含 ctl OID和误码率的数据非零的控制对象。

ctx -可能的空背景的控制被创建。如果为空，没有这样的信息是可用的。

env -上下文可能的空环境。这是用来发现的 LdapContext.CONTROL_FACTORIES属性的值。

结果

使用 ctl创建了一个控制对象；或 ctl如果控制对象不能使用上述算法创建的。

异常

NamingException -如果在尝试建立控制对象遇到的是一个命名的例外。如果一个工厂访问了抛出异常，则将其传播到调用方。如果加载和实例化对象的类工厂时遇到了一个错误，唯一的例外是包裹在一个 NamingException然后重抛出。