Java javax.naming.ldap 接口 HasControls（JDK5）

所有类

javax.naming.ldap
接口 HasControls

所有已知子接口：

UnsolicitedNotification

public interface HasControls

此接口用于返回控件，并使对象返回在 NamingEnumeration 中。例如，假定服务器利用搜索操作的结果发送回控件，服务提供程序将返回类型为 SearchResult 并实现 HasControls 的对象所组成的 NamingEnumeration。

   NamingEnumeration elts = ectx.search((Name)name, filter, sctls);
   while (elts.hasMore()) {
        Object entry = elts.next();

        // Get search result 
        SearchResult res = (SearchResult)entry;
        // do something with it 

        // Get entry controls
        if (entry instanceof HasControls) {
            Control[] entryCtls = ((HasControls)entry).getControls();
            // do something with controls
        }
   }

从以下版本开始：

1.3

getControls

Control[] getControls()
                      throws NamingException

从实现此接口的对象中检索 Control 数组。如果不存在任何控件，则为 null。

返回：

Control 对象所组成的数组（可能为 null）。

抛出：

NamingException - 如果因出错而无法返回控件。