JavaTM Platform
Standard Ed. 6

javax.security.sasl
接口 SaslClientFactory


public interface SaslClientFactory

用于创建 SaslClient 实例的接口。实现此接口的类必须是线程安全的,并且可同时处理多个请求。它还必须具有不接受参数的公共构造方法。

客户端通常不直接访问此接口,而是使用 Sasl 静态方法访问此接口。但是,特定的环境可以提供和安装一个新的或不同的 SaslClientFactory

从以下版本开始:
1.5
另请参见:
SaslClient, Sasl

方法摘要
 SaslClient createSaslClient(String[] mechanisms, String authorizationId, String protocol, String serverName, Map<String,?> props, CallbackHandler cbh)
          使用提供的参数创建 SaslClient。
 String[] getMechanismNames(Map<String,?> props)
          返回与指定的机制选择策略相符的机制的名称数组。
 

方法详细信息

createSaslClient

SaslClient createSaslClient(String[] mechanisms,
                            String authorizationId,
                            String protocol,
                            String serverName,
                            Map<String,?> props,
                            CallbackHandler cbh)
                            throws SaslException
使用提供的参数创建 SaslClient。

参数:
mechanisms - 要试用的机制名称的非 null 列表。每个名称都是 SASL 机制的 IANA 注册名。(例如 "GSSAPI"、"CRAM-MD5")。
authorizationId - 用于授权的标识,可能为 null,与协议有关。如果为 null 或空,则服务器根据客户端的验证证书派生出一个授权 ID。SASL 验证成功完成后,就允许指定的实体进行访问。
protocol - 非 null 的协议(例如 "ldap")字符串名,将为它执行验证。
serverName - 服务器的非 null 完全限定主机名,要对该服务器进行验证。
props - 可能为 null 的属性集,用于选择 SASL 机制并配置所选机制的验证交换。有关标准属性的列表,请参阅 Sasl 类。也可包括其他可能特定于机制的属性。忽略与所选机制无关的属性,包括带有非字符串键的所有映射条目。
cbh - SASL 机制使用的回调处理程序(可能为 null),以便为完成验证而从应用程序/库获得更多的信息。例如,SASL 机制可能需要从调用者获得验证 ID、密码和领域。使用 NameCallback 来请求验证 ID。使用 PasswordCallback 来请求密码。如果要从领域列表中选择,则使用 RealmChoiceCallback 来请求领域,如果必须输入领域,则使用 RealmCallback 来请求领域。
返回:
使用所提供参数创建的 SaslClient,可能为 null。如果为 null,则此工厂无法使用所提供的参数生成 SaslClient
抛出:
SaslException - 如果因为错误而无法创建 SaslClient

getMechanismNames

String[] getMechanismNames(Map<String,?> props)
返回与指定的机制选择策略相符的机制的名称数组。

参数:
props - 可能为 null 的属性集,用于指定 SASL 机制的安全策略。例如,如果 props 包含值为 "true" 的属性 Sasl.POLICY_NOPLAINTEXT,则该工厂必须不返回任何易于受到简单被动式攻击危害的 SASL 机制。有关策略属性的完整列表,请参阅 Sasl 类。如果 props 中有与策略无关的属性则忽略该属性,包括带有非字符串键的所有映射条目。
返回:
非 null 的数组,包含 IANA 注册的 SASL 机制名。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策