Interface HasControls
- All Known Subinterfaces:
UnsolicitedNotification
public interface HasControls
This interface is for returning controls with objects returned in NamingEnumerations. For example, suppose a server sends back controls with the results of a search operation, the service provider would return a NamingEnumeration of objects that are both SearchResult and implement HasControls.
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
}
} - Since:
- 1.3
Method Summary
| Modifier and Type | Method | Description |
|---|---|---|
Control[] | getControls() | Retrieves an array of |
Method Detail
getControls
Control[] getControls()
throws NamingException Retrieves an array of Controls from the object that implements this interface. It is null if there are no controls.
- Returns:
- A possibly null array of
Controlobjects. - Throws:
-
NamingException- If cannot return controls due to an error.