Java Web Services in a Nutshell

Name

BulkResponse

Synopsis

public interface BulkResponse extends JAXRResponse {
// Public Instance Methods
       public abstract Collection getCollection( ) throws JAXRException;
               // L0
       public abstract Collection getExceptions( ) throws JAXRException;
               // L0
    public abstract boolean isPartialResponse(  ) throws JAXRException;
               // L0
}

BulkResponse is an interface derived from JAXRResponse that is returned by the JAXR API methods that perform registry queries and by some of the registry update methods. A BulkResponse contains a set of RegistryObjects that represent the results of a search or of an update operation such as a delete, where the objects that were deleted are returned. These objects can be obtained by calling the getCollection( ) method. If any errors are encountered while the operation is in progress, one or more RegistryExceptions may also be included in the response. These exceptions can be retrieved using the getExceptions( ) method. It is possible for an operation to succeed in respect to some objects, but fail for others. In this case, both the getCollection( ) and getExceptions( ) methods return nonempty collections. The isPartialResponse( ) method returns true if the registry did not return all possible responses.

If a request is made on a synchronous connection, the caller is blocked until the JAXR provider receives a reply, at which point the content of the BulkResponse is valid. In the case of an asynchronous response, the getCollection( ) and getExceptions( ) methods block ...