Spec-Zone .ru спецификации, руководства, описания, API

Please note that the specifications and other information contained herein are not final and are subject to change. The information is being made available to you solely for purpose of evaluation.

javax.naming.ldap
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 and Description
Control[]	getControls() Retrieves an array of Controls from the object that implements this interface.

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 Control objects.

Throws:

NamingException - If cannot return controls due to an error.