Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.

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

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.