Package javax.xml.registry

Interface BulkResponse

All Superinterfaces:

JAXRResponse

public interface BulkResponse
extends JAXRResponse

Contains the response of a method in the API that performs a bulk operation and returns a bulk response. Partial commits are allowed on a bulk operation.

In the event of a partial success where only a subset of objects were processed successfully, the getStatus method of the BulkResponse must return JAXRResponse.STATUS_WARNING. In this case, a Collection of JAXRException instances is included in the BulkResponse instance. The JAXRExceptions provide information on each error that prevented some objects in the request to not be processed successfully.

Author:

Farrukh S. Najmi

See Also:

• QueryManager
• LifeCycleManager

Field Summary

Fields inherited from interface javax.xml.registry.JAXRResponse

STATUS_FAILURE, STATUS_SUCCESS, STATUS_UNAVAILABLE, STATUS_WARNING

Method Summary

Modifier and Type	Method	Description
Collection	getCollection()	Get the Collection of objects returned as a response of a bulk operation.
Collection	getExceptions()	Get the Collection of RegistryException instances in case of partial commit.
boolean	isPartialResponse()	Determines whether the response is a partial response due to large result set.

Methods inherited from interface javax.xml.registry.JAXRResponse

getRequestId, getStatus, isAvailable

Method Details

getCollection

Collection getCollection()
                  throws JAXRException

Get the Collection of objects returned as a response of a bulk operation. Caller thread will block here if result is not yet available.

Capability Level: 0

Returns:

Collection of RegistryObject instances. The Collection may be empty but not null.

Throws:

JAXRException - If the Jakarta XML Registries provider encounters an internal error

See Also:

• RegistryObject

getExceptions

Collection getExceptions()
                  throws JAXRException

Get the Collection of RegistryException instances in case of partial commit. Caller thread will block here if result is not yet available.

Capability Level: 0

Returns:

Collection of RegistryException instances. Return null if result is available and there is no RegistryException.

Throws:

JAXRException - If the Jakarta XML Registries provider encounters an internal error

See Also:

• RegistryException

isPartialResponse

boolean isPartialResponse()
                   throws JAXRException

Determines whether the response is a partial response due to large result set.

Capability Level: 0

Returns:

true if the response is partial; false otherwise

Throws:

JAXRException - If the Jakarta XML Registries provider encounters an internal error