javax.naming.ldap

接口
异常
所有已知子接口:
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

方法摘要
 Control[] getControls()
          从实现此接口的对象中检索 Control 数组。
 

方法详细信息

getControls

Control[] getControls()
                      throws NamingException
从实现此接口的对象中检索 Control 数组。如果不存在任何控件,则为 null。

返回:
Control 对象所组成的数组(可能为 null)。
抛出:
NamingException - 如果因出错而无法返回控件。