The Marklogic.Xcc.Exceptions namespace defines the hierarchy of exceptions classes that may be thrown by XCC.
| Class | Description |
|---|---|
| ContentInsertEntityException | This is a specialization of ContentInsertException that indicates the insertion faled because an XML entity embedded in the document could not be resolved. Entity resolution is not done by default, is must be enabled in the options (ContentCreateOptions) associated with the insertion request. Entity resolution failures are not retryable. |
| ContentInsertException | This exception indicates a failed attempt to insert a Content object. Such failures are automatically retried up the the number of times allowed by the request's options (RequestOptions.setMaxAutoRetry(int)). If this execption ocurrs, either all retries have been exhausted, no retries were configured, or the specific Content instance was not retryable (Content.isRewindable()). |
| RequestException | The base class for exceptions related to submitting requests to the server. |
| RequestPermissionException | This exception indicates missing or incorrect permissions for a server request. |
| RequestServerException | This is the base class for for exceptions originating in the server (XQuery syntax errors, etc) as opposed exceptions related to communicating with the server. |
| RetryableXQueryException | A specialization of XQueryException which is always retryable, to define a distinct exception type that can be caught separately. Note that in most cases, retryable exceptions will be retried automatically. |
| ServerConnectionException | This exception indicates a problem with the connection to the server. It most often is a wrapper for an IOException. |
| ServerResponseException | This exception indicates that an unrecognized response was received from the server. This may indicate a misconfiguration such that XCC is connecting to something other than a Mark Logic XDBC server port. |
| StreamingResultException | This unchecked (runtime) exception may be thrown by some methods of streaming ResultSequence objects if an IOException occurs while processing the streaming data. |
| UnimplementedFeatureException | This exception indicates either that some planned feature is not yet implemented in the current version of XCC, or that the server to which it is connecting does not support the operation. |
| XccConfigException | This exception indicates a configuration problem. |
| XccException | Superclass of all exceptions specific to XCC. This is an abstract class and will never be thrown directly. Only subclasses will be ever be thrown. You can name this class in a try/catch clause to catch all checked XCC exceptions. |
| XQueryException | A server exception resulting from an error encountered while evaluating XQuery. Note that some such exceptions are retryable. |
| XQueryStackFrame | An XQuery evaluator stack frame. |