DirStateFactory (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.naming.spi
接口 DirStateFactory
- 所有超级接口：
- StateFactory
public interface DirStateFactory
- extends StateFactory
此接口表示一个工厂，该工厂用来获得对象的状态和用于绑定的相应属性。
JNDI 框架允许通过对象工厂动态加载对象实现。
DirStateFactory 扩展了 StateFactory，它允许将 Attributes 实例提供给 getStateToBind() 方法并由该方法返回。DirStateFactory 实现将由 DirContext 服务提供程序使用。当调用方使用 DirContext.bind() 绑定对象时，还可以指定一个与该对象绑定在一起的属性集合。要绑定的对象和属性被传递给工厂的 getStateToBind() 方法。如果该工厂处理这些对象和属性，则它会返回由对象和要绑定的属性组成的相应对。如果该工厂没有处理该对象，则必须返回 null。
例如，调用方可以将一个打印机对象与一些与打印机相关的属性绑定在一起。
ctx.rebind("inky", printer, printerAttrs);
因为 DirStateFactory 扩展了 StateFactory，所以它有两个 getStateToBind() 方法，其中一个方法在属性参数上不同于另一个方法。DirectoryManager.getStateToBind() 将只使用接受属性参数的形式，而 NamingManager.getStateToBind() 将只使用不接受属性参数的形式。
可以使用不同的参数多次调用 DirStateFactory 任何一种形式的 getStateToBind() 方法。该实现是线程安全的。
- 从以下版本开始：
- 1.3
- 另请参见：
DirectoryManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes),DirObjectFactory
| 嵌套类摘要 | |
|---|---|
static class |
DirStateFactory.Result
用于返回 DirStateFactory.getStateToBind() 的结果的对象/属性对。 |
| 方法摘要 | |
|---|---|
DirStateFactory.Result |
getStateToBind(Object obj,
Name name,
Context nameCtx,
Hashtable<?,?> environment,
Attributes inAttrs)
在给定要传输的对象和属性的情况下检索用于绑定的对象的状态。 |
| 从接口 javax.naming.spi.StateFactory 继承的方法 |
|---|
getStateToBind |
| 方法详细信息 |
|---|
getStateToBind
DirStateFactory.Result getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes inAttrs) throws NamingException
- 在给定要传输的对象和属性的情况下检索用于绑定的对象的状态。
DirectoryManager.getStateToBind() 接连在状态工厂中加载。如果某一工厂实现 DirStateFactory，则 DirectoryManager 将调用此方法；否则，它将调用 StateFactory.getStateToBind()。它将持续这样做，直到某一工厂产生非 null 响应。
当某一工厂抛出异常时，该异常被传递给 DirectoryManager.getStateToBind() 的调用方。停止搜索可能产生非 null 应答的其他工厂。工厂只有在可以确定它是惟一需要的工厂并且不应该再尝试其他工厂时才抛出异常。如果此对象工厂无法使用所提供的参数创建对象，则它应该返回 null。
可以有选择地使用
name和nameCtx参数来指定要创建的对象的名称。有关详细信息，请参阅ObjectFactory.getObjectInstance()中“名称和上下文参数”的描述。如果某一工厂使用nameCtx，则它应该将其使用与并发访问同步，因为无法保证上下文实现是线程安全的。name、inAttrs 和 environment 参数都归调用方所有。该实现不会修改这些对象或保存对它们的引用，尽管它可能保存对这些对象的副本的引用。此方法返回的对象归调用方所有。该实现随后不会对它进行修改。它或者包含一个同样归调用方所有的新 Attributes 对象，或者包含对原始 inAttrs 参数的引用。
- 参数：
obj- 将检索其状态的对象（可能为 null）。name- 此对象相对于nameCtx的名称，如果没有指定名称，则该参数为 null。nameCtx- 一个上下文，name参数是相对于该上下文指定的，如果name相对于默认初始上下文，则该参数为 null。environment- 将在创建对象的状态时使用的环境（可能为 null）。inAttrs- 将与对象绑定在一起的属性（可能为 null）。该工厂不得修改 inAttrs。- 返回：
- 一个 Result，它包含用于绑定的对象状态和要绑定的相应属性；如果该对象没有使用此工厂，则返回 null。
- 抛出：
NamingException- 如果此工厂在试图获得对象的状态时遇到异常，并且不再尝试其他工厂。- 另请参见：
DirectoryManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。