Asks this retriever to get the LDAP class structures used by a given
LdapStructure
instance.
Note: This call may kick off a background thread and return immediately. The outcome of the request is communicated back to the caller through the provided GetLdapStructuresCallback
.
If an error occurs during the request, this class will provide error feedback to the user. In other words, the submitted callback does not have to provide any feedback to the user from its implementation of caught()
.
Likewise, the local cache is updated automatically if new data is downloaded from a Jitterbit server, so the submitted callback does not have to provide this functionality in its implementation of structuresRetrieved()
.
@param source the LdapStructure
for which to retrieve the class structure information
@param callback a GetLdapStructuresCallback
that will be notified on the outcome of the request
@param checkCacheFirst if true
this call will check the local cache for the requested information, and go to the LDAP server only if one or more of the requested structures are not availeble in the cache. If false
the call will skip the cache check, and download the requested structures directly from the LDAP server.
@param waitSvc a WaitService
that provides wait-feedback to the user while this call is in progress.