compact3

javax.naming.spi

Interface ObjectFactory

All Known Subinterfaces:

DirObjectFactory

public interface ObjectFactory

此接口表示用于创建对象的工厂。

JNDI框架允许通过对象工厂动态加载对象实现 。 例如，当查找名称空间中绑定的打印机时，如果打印服务将打印机名称绑定到引用，则打印机参考可用于创建打印机对象，以便查找的调用者可以在打印机对象之后直接操作查找。

一个ObjectFactory负责创建特定类型的对象。 在上面的例子中，您可能有一个PrinterObjectFactory来创建打印机对象。

对象工厂必须实现ObjectFactory界面。 此外，工厂类必须是公共的，并且必须有一个不接受参数的公共构造函数。

对象工厂的getObjectInstance()方法可以被多次调用，可能使用不同的参数。 实现是线程安全的。

该类文档中提及的URL是指RFC 1738及其相关RFC定义的URL字符串。 它是符合其中描述的语法的任何字符串，并且可能不总是在java.net.URL类或Web浏览器中具有相应的支持。

从以下版本开始：

1.3

另请参见：

NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>) ， NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>) ， ObjectFactoryBuilder ， StateFactory

方法摘要

Modifier and Type	Method and Description
Object	getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment) 使用指定的位置或引用信息创建对象。

方法详细信息

getObjectInstance

Object getObjectInstance(Object obj,
                         Name name,
                         Context nameCtx,
                         Hashtable<?,?> environment)
                  throws 异常

使用指定的位置或引用信息创建对象。

使用environment提供此对象的特殊environment 。 这样的环境属性的示例是用户身份信息。

NamingManager.getObjectInstance()依次加载对象工厂，并在其上调用此方法，直到产生非空答案。 当对象工厂抛出异常时，异常传递给NamingManager.getObjectInstance()的调用者（并且不会对可能产生非空答案的其他工厂进行搜索）。 如果对象工厂确定它是唯一的预定工厂，并且没有其他对象工厂应该被尝试，那么对象工厂应该只抛出异常。 如果此工厂无法使用提供的参数创建对象，则应返回null。

URL上下文工厂是一个特殊的ObjectFactory，它创建用于解析URL或由URL指定位置的对象的上下文。 URL上下文工厂的getObjectInstance()方法将遵循以下规则。

1. 如果obj为空，则创建一个上下文来解析与此工厂关联的方案的URL。 所得到的上下文不与特定URL绑定：它可以使用此工厂的方案ID来处理任意URL。 例如，在LDAP URL上下文工厂上调用obj设置为null的obj将返回一个可以解析LDAP URL的上下文，例如“ldap：//ldap.wiz.com/o=wiz,c=us”和“ldap： //ldap.umich.edu/o=umich,c=us“。
2. 如果obj是URL字符串，则创建由URL标识的对象（通常为上下文）。 例如，假设这是LDAP URL上下文工厂。 如果obj是“ldap：//ldap.wiz.com/o=wiz,c=us”，则getObjectInstance（）将返回由LDAP服务器ldap上的可分辨名称“o = wiz，c = us”命名的上下文。 wiz.com。 然后，该上下文可用于解析相对于该上下文的LDAP名称（例如“cn = George”）。
3. 如果obj是一个URL字符串数组，那么这个假设是这些URL在它们引用的上下文中是等价的。 验证URL是否需要等同于上下文工厂。 数组中URL的顺序不重要。 getObjectInstance（）返回的对象与单个URL的情况类似。 它是由URL命名的对象。
4. 如果obj是任何其他类型， getObjectInstance()的行为由上下文工厂实现确定。

name和environment参数由呼叫者拥有。 尽管它可能会保留对克隆或副本的引用，但实现不会修改这些对象或保留对它们的引用。

名称和上下文参数。 name和nameCtx参数可以可选地用于指定正在创建的对象的名称。 name是对象的名称，相对于上下文nameCtx 。 如果有几个可能的对象可以被命名的上下文（通常是这样），则由调用者来选择一个。 一个很好的经验法则是选择“最深”的上下文。 如果nameCtx为空，则name是相对于默认的初始上下文。 如果没有指定名称，那么name参数应该为空。 如果工厂使用nameCtx它应该将其使用与并发访问同步，因为上下文实现不能保证是线程安全的。

参数

obj - 可能包含可用于创建对象的位置或引用信息的空对象。

name - 此对象相对于 nameCtx的名称，如果未指定名称，则为null。

nameCtx - 指定 name参数的上下文，如果 name相对于默认初始上下文，则为null。

environment - 用于创建对象的可能的空环境。

结果

创建对象 如果无法创建对象，则为null。

异常

异常 - 如果此对象工厂在尝试创建对象时遇到异常，并且不会尝试其他对象工厂。

另请参见：

NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>), NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)