W3cubDocs

/OpenJDK 8

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

Methods

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 Control objects.
Throws:
NamingException - If cannot return controls due to an error.

© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.