JavaTM 2 Platform
Standard Ed. 5.0

javax.naming.directory
类 SearchResult

java.lang.Object
  继承者 javax.naming.NameClassPair
      继承者 javax.naming.Binding
          继承者 javax.naming.directory.SearchResult
所有已实现的接口:
Serializable

public class SearchResult
extends Binding

此类表示作为 DirContext.search() 方法的结果返回的 NamingEnumeration 中的一项。

SearchResult 实例与并发多线程访问不同步。试图访问和修改单个 SearchResult 实例的多个线程应该锁定对象。

从以下版本开始:
1.3
另请参见:
DirContext.search(javax.naming.Name, javax.naming.directory.Attributes, java.lang.String[]), 序列化表格

构造方法摘要
SearchResult(String name, Object obj, Attributes attrs)
          使用结果的名称、绑定对象及其属性构造一个搜索结果。
SearchResult(String name, Object obj, Attributes attrs, boolean isRelative)
          使用结果的名称、绑定对象、属性以及该名称是否是相对的构造一个搜索结果。
SearchResult(String name, String className, Object obj, Attributes attrs)
          使用结果的名称、类名称、绑定对象及其属性构造一个搜索结果。
SearchResult(String name, String className, Object obj, Attributes attrs, boolean isRelative)
          使用结果的名称、类名称、绑定对象、属性以及该名称是否是相对的构造一个搜索结果。
 
方法摘要
 Attributes getAttributes()
          检索此搜索结果中的属性。
 void setAttributes(Attributes attrs)
          将此搜索结果的属性设置为 attrs
 String toString()
          生成此 SearchResult 的字符串表示形式。
 
从类 javax.naming.Binding 继承的方法
getClassName, getObject, setObject
 
从类 javax.naming.NameClassPair 继承的方法
getName, getNameInNamespace, isRelative, setClassName, setName, setNameInNamespace, setRelative
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

SearchResult

public SearchResult(String name,
                    Object obj,
                    Attributes attrs)
使用结果的名称、绑定对象及其属性构造一个搜索结果。

如果还没有使用 setClassName() 显式设置类名称,则 getClassName() 将返回 obj 的类名称(或者 null,如果 obj 为 null)。

参数:
name - 搜索项的非 null 名称。它是相对于搜索的目标上下文(由 search() 方法的第一个参数指定)的名称
obj - 绑定到名称的对象。可以为 null。
attrs - 请求与此搜索项一起返回的属性。不能为 null。
另请参见:
NameClassPair.setClassName(java.lang.String), NameClassPair.getClassName()

SearchResult

public SearchResult(String name,
                    Object obj,
                    Attributes attrs,
                    boolean isRelative)
使用结果的名称、绑定对象、属性以及该名称是否是相对的构造一个搜索结果。

如果还没有使用 setClassName() 显式设置类名称,则 getClassName() 将返回 obj 的类名称(或者 null,如果 obj 为 null)

参数:
name - 搜索项的非 null 名称。
obj - 绑定到名称的对象。可以为 null。
attrs - 请求与此搜索项一起返回的属性。不能为 null。
isRelative - 如果 name 是一个相对于搜索的目标上下文(由 search() 方法的第一个参数命名)的名称,则该参数为 true;如果 name 是一个 URL 字符串,则该参数为 false。
另请参见:
NameClassPair.setClassName(java.lang.String), NameClassPair.getClassName()

SearchResult

public SearchResult(String name,
                    String className,
                    Object obj,
                    Attributes attrs)
使用结果的名称、类名称、绑定对象及其属性构造一个搜索结果。

参数:
name - 搜索项的非 null 名称。它是相对于搜索的目标上下文(由 search() 方法的第一个参数命名)的名称
className - 绑定到 name 的对象的类名称(可能为 null)。如果为 null,则 obj 的类名称由 getClassName() 返回。如果 obj 也为 null,则 getClassName() 将返回 null。
obj - 绑定到名称的对象。可以为 null。
attrs - 请求与此搜索项一起返回的属性。不能为 null。
另请参见:
NameClassPair.setClassName(java.lang.String), NameClassPair.getClassName()

SearchResult

public SearchResult(String name,
                    String className,
                    Object obj,
                    Attributes attrs,
                    boolean isRelative)
使用结果的名称、类名称、绑定对象、属性以及该名称是否是相对的构造一个搜索结果。

参数:
name - 搜索项的非 null 名称。
className - 绑定到 name 的对象的类名称(可能为 null)。如果为 null,则 obj 的类名称由 getClassName() 返回。如果 obj 也为 null,则 getClassName() 将返回 null。
obj - 绑定到名称的对象。可以为 null。
attrs - 请求与此搜索项一起返回的属性。不能为 null。
isRelative - 如果 name 是一个相对于搜索的目标上下文(由 search() 方法的第一个参数命名)的名称,则该参数为 true;如果 name 是一个 URL 字符串,则该参数为 false。
另请参见:
NameClassPair.setClassName(java.lang.String), NameClassPair.getClassName()
方法详细信息

getAttributes

public Attributes getAttributes()
检索此搜索结果中的属性。

返回:
此搜索结果中的非 null 属性。可以为空。
另请参见:
setAttributes(javax.naming.directory.Attributes)

setAttributes

public void setAttributes(Attributes attrs)
将此搜索结果的属性设置为 attrs

参数:
attrs - 要使用的非 null 属性。可以为空。
另请参见:
getAttributes()

toString

public String toString()
生成此 SearchResult 的字符串表示形式。该字符串表示形式由绑定的字符串表示形式和此搜索结果属性的字符串表示形式组成,两个表示形式之间用 ':' 分隔。此字符串的内容用于调试目的,不以编程方式对其进行解释。

覆盖:
Binding 中的 toString
返回:
此 SearchResult 的字符串表示形式。不能为 null。

JavaTM 2 Platform
Standard Ed. 5.0

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

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