Java™ Platform
Standard Ed. 6

Interface HasControls

All Known Subinterfaces:

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 =, filter, sctls);
   while (elts.hasMore()) {
        Object entry =;

        // 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


Method Summary
 Control[] getControls()
          Retrieves an array of Controls from the object that implements this interface.

Method Detail


Control[] getControls()
                      throws NamingException
Retrieves an array of Controls from the object that implements this interface. It is null if there are no controls.

A possibly null array of Control objects.
NamingException - If cannot return controls due to an error.

Java™ Platform
Standard Ed. 6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.