Class Request
A base class for the requests classes that represent information about
operations issued by NoSQLClient APIs.
Inheritance
Request
Namespace: Oracle.NoSQL.SDK
Assembly: Oracle.NoSQL.SDK.dll
Syntax
public abstract class Request : Object
Remarks
The subclasses of this class describe operations issued by methods of NoSQLClient. From an application perspective, these classes are only used to provide information about an operation such as the type of operation (as indicated by the particular subclass), arguments passed, number of retry attempts, etc.
In general, the Request classes are for advanced usage and most applications don't need to use them. They could be used in the following cases:
- When a NoSQLException (or its subclass) is thrown, Request provides additional information about an operation that caused the exception.
- If you create your own retry handler by implementing IRetryHandler interface, ShouldRetry(Request) and GetRetryDelay(Request) take a Request object describing the operation as an argument that allows you to customize the retry behavior based on the operation.
- If you create your own authorization provider by implementing IAuthorizationProvider or extending AuthorizationStringProvider, ApplyAuthorizationAsync(Request, HttpRequestMessage, CancellationToken) and GetAuthorizationStringAsync(Request, CancellationToken) take a Request object describing the operation as an argument that allows you to customize authorization implementation based on the operation if needed.
Properties
Name | Description |
---|---|
Exceptions | Gets the list of exceptions that occurred while retrying the operation. |
LastException | Gets the last exception that occurred while retrying the operation or during its original invocation. |
PriorException | Gets the prior to last exception that occurred while retrying the operation. |
RetryCount | Gets the number of times the operation has been retried. |