Package | Description |
---|---|
org.xins.client |
XINS client framework.
|
org.xins.common.http |
HTTP-related utility classes.
|
org.xins.common.service |
Service calling classes, supporting load-balancing and failover.
|
Modifier and Type | Class and Description |
---|---|
class |
AbstractCAPIErrorCodeException
Abstract base class for generated CAPI exceptions that map to an
API-specific error code.
|
class |
DisabledFunctionException
Exception thrown to indicate that the called function has been disabled
at the server-side.
|
class |
InternalErrorException
Exception thrown to indicate a standard error code was received that
indicates a server-side internal error.
|
class |
InvalidRequestException
Exception thrown to indicate a standard error code was received that
indicates the request from the client-side is considered invalid by the
server-side.
|
class |
InvalidResultXINSCallException
Exception thrown to indicate that the result from a XINS API call was
invalid according to the XINS rules for a XINS call result.
|
class |
NotModifiedException |
class |
StandardErrorCodeException
Abstract base class for exceptions that indicate that a standard error code
was returned from the server-side.
|
class |
UnacceptableErrorCodeXINSCallException
Exception that indicates an error code was received from the server-side
that is not expected at the client-side.
|
class |
UnacceptableMessageException
Exception that indicates that a request for an API call is considered
unacceptable on the application-level.
|
class |
UnacceptableRequestException
Exception that indicates that a request for an API call is considered
unacceptable on the application-level.
|
class |
UnacceptableResultXINSCallException
Exception that indicates that an API call returned a result that was
considered unacceptable by the application layer.
|
class |
UnsuccessfulXINSCallException
Exception that indicates that a result code was returned by the API call.
|
class |
XINSCallException
XINS-specific call exception.
|
Modifier and Type | Method and Description |
---|---|
List<CallException> |
AbstractCAPICallResult.exceptions()
Returns the list of
CallException s. |
Modifier and Type | Method and Description |
---|---|
protected CallResult |
XINSServiceCaller.createCallResult(CallRequest request,
TargetDescriptor succeededTarget,
long duration,
List<CallException> exceptions,
Object result)
Constructs an appropriate
CallResult object for a
successful call attempt. |
protected boolean |
XINSServiceCaller.shouldFailOver(CallRequest request,
CallConfig callConfig,
List<CallException> exceptions)
Determines whether a call should fail-over to the next selected target
based on a request, call configuration and exception list.
|
Modifier and Type | Class and Description |
---|---|
class |
HTTPCallException
HTTP-specific call exception.
|
class |
StatusCodeHTTPCallException
Exception that indicates that an HTTP call failed because the returned HTTP
status code was considered invalid.
|
Modifier and Type | Method and Description |
---|---|
protected CallResult |
HTTPServiceCaller.createCallResult(CallRequest request,
TargetDescriptor succeededTarget,
long duration,
List<CallException> exceptions,
Object result)
Constructs an appropriate
CallResult object for a
successful call attempt. |
protected boolean |
HTTPServiceCaller.shouldFailOver(CallRequest request,
CallConfig callConfig,
List<CallException> exceptions)
Determines whether a call should fail-over to the next selected target
based on a request, call configuration and exception list.
|
Modifier and Type | Method and Description |
---|---|
Object |
HTTPServiceCaller.doCallImpl(CallRequest request,
CallConfig callConfig,
TargetDescriptor target)
Executes a request towards the specified target.
|
Constructor and Description |
---|
HTTPCallResult(HTTPCallRequest request,
TargetDescriptor succeededTarget,
long duration,
List<CallException> exceptions,
HTTPCallResultData data)
Constructs a new
HTTPCallResult object. |
Modifier and Type | Class and Description |
---|---|
class |
ConnectionCallException
Exception that indicates that a connection to a service could not be
established.
|
class |
ConnectionRefusedCallException
Exception that indicates that a connection to a service could not be
established since it was refused.
|
class |
ConnectionTimeOutCallException
Exception that indicates that a connection to a service could not be
established due to a connection time-out.
|
class |
GenericCallException
Generic call exception, not related to any particular kind of service.
|
class |
IOCallException
Exception that indicates that an I/O error interrupted a service call.
|
class |
NoRouteToHostCallException
Exception that indicates that a connection to a service could not be
established because no network route could be found to the host.
|
class |
SocketTimeOutCallException
Exception that indicates that data was not received on a socket within a
designated time-out period.
|
class |
TotalTimeOutCallException
Exception that indicates the total time-out for a request was reached, so
the request was aborted.
|
class |
UnexpectedExceptionCallException
Exception that indicates an unexpected exception was caught while
performing a call.
|
class |
UnknownHostCallException
Exception that indicates that a connection to a service could not be
established since the indicated host is unknown.
|
Modifier and Type | Method and Description |
---|---|
CallException |
CallExceptionList.get(int index)
Deprecated.
Retrieves a
CallException by index. |
CallException |
CallException.getNext()
Gets the next linked
CallException , if there is any. |
CallException |
CallExceptionList.last()
Deprecated.
Retrieves the last (most recent)
CallException . |
Modifier and Type | Method and Description |
---|---|
List<CallException> |
CallResult.getExceptions()
Returns the list of
CallException s. |
Modifier and Type | Method and Description |
---|---|
protected abstract CallResult |
ServiceCaller.createCallResult(CallRequest request,
TargetDescriptor succeededTarget,
long duration,
List<CallException> exceptions,
Object result)
Constructs an appropriate
CallResult object for a
successful call attempt. |
protected boolean |
ServiceCaller.shouldFailOver(CallRequest request,
CallConfig callConfig,
List<CallException> exceptions)
Determines whether a call should fail-over to the next selected target
based on a request, call configuration and exception list.
|
Modifier and Type | Method and Description |
---|---|
protected CallResult |
ServiceCaller.doCall(CallRequest request,
CallConfig callConfig)
Attempts to execute the specified call request on one of the target
services, with the specified call configuration.
|
abstract Object |
ServiceCaller.doCallImpl(CallRequest request,
CallConfig callConfig,
TargetDescriptor target)
Calls the specified target using the specified subject.
|
Constructor and Description |
---|
CallResult(CallRequest request,
TargetDescriptor succeededTarget,
long duration,
List<CallException> exceptions)
Constructs a new
CallResult object. |
See http://www.xins.org/.