com.atlassian.bitbucket.request

Interface RequestManager

public interface RequestManager

Sets up and tears down all logic for processing requests, such as logging, access logging, profiling and publishing RequestStartedEvent and RequestEndedEvent.

Method Summary

Modifier and Type	Method and Description
<T,E extends Exception> T	doAsRequest(RequestCallback<T,E> callback, RequestInfoProvider requestInfoProvider) Sets up and tears down all logic for processing requests.
RequestContext	getRequestContext()
String	getRequestId()
RequestMetadata	getRequestMetadata()

Method Detail

doAsRequest

@Nullable
<T,E extends Exception> T doAsRequest(@Nonnull
                                                RequestCallback<T,E> callback,
                                                @Nonnull
                                                RequestInfoProvider requestInfoProvider)
                                         throws E extends Exception

Sets up and tears down all logic for processing requests.

Type Parameters:

T - type of the request

E - type of exception

Parameters:

callback - called after the RequestStartedEvent has been published.

requestInfoProvider - provides request details such as sessionId, remoteAddress that are used to set up logging.

Returns:

the return value of the callback

Throws:

E - when RequestCallback.withRequest(RequestContext) throws an exception.

E extends Exception

getRequestContext

@Nullable
RequestContext getRequestContext()

Returns:

the context of the current request. Returns null if there is no current request, for instance when running a task in a background thread.

getRequestId

@Nullable
String getRequestId()

Returns:

a highly unique (though not guaranteeably unique) request ID. Returns null if there is no current request, for instance when running a task in a background thread.

Since:

5.0

See Also:

RequestContext.getId()

getRequestMetadata

@Nullable
RequestMetadata getRequestMetadata()

Returns:

the metadata of the current request. Returns null if there is no current request.