compact3

javax.naming.ldap

Interface HasControls

All Known Subinterfaces:

UnsolicitedNotification

public interface HasControls

此接口用于使用NamingEnumerations返回的对象返回控件。 例如，假设服务器发回带有搜索操作结果的控件，则服务提供者将返回两个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

方法摘要

Modifier and Type	Method and Description
Control[]	getControls() 检索的 Control期从实现该接口的对象的阵列。

方法详细信息

getControls

Control[] getControls()
               throws NamingException

检索的Control期从实现该接口的对象的阵列。 如果没有控件，则为null。

结果

Control对象可能为空数组。

异常

NamingException - If cannot return controls due to an error.