Class AbstractHttpHandler<Q,P>

java.lang.Object

io.opencensus.contrib.http.AbstractHttpHandler<Q,P>

Direct Known Subclasses:

HttpClientHandler, HttpServerHandler

abstract class AbstractHttpHandler<Q,P>
extends Object

Base class for handling request on http client and server.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final HttpExtractor<Q,P>	extractor	The HttpExtractor used to extract information from request/response.

Constructor Summary

Constructors

Constructor	Description
AbstractHttpHandler(HttpExtractor<Q,P> extractor)	Constructor to allow access from same package subclasses only.

Method Summary

Modifier and Type	Method	Description
(package private) final void	addSpanRequestAttributes(Span span, Q request, HttpExtractor<Q,P> extractor)
(package private) HttpRequestContext	getNewContext(Span span, TagContext tagContext)
Span	getSpanFromContext(HttpRequestContext context)	Retrieves Span from the HttpRequestContext.
(package private) final String	getSpanName(Q request, HttpExtractor<Q,P> extractor)
final void	handleMessageReceived(HttpRequestContext context, long bytes)	Instrument an HTTP span after a message is received.
final void	handleMessageSent(HttpRequestContext context, long bytes)	Instrument an HTTP span after a message is sent.
private static void	putAttributeIfNotEmptyOrNull(Span span, String key, String value)
(package private) static void	recordMessageEvent(Span span, long id, MessageEvent.Type type, long uncompressedMessageSize, long compressedMessageSize)	A convenience to record a MessageEvent with given parameters.
(package private) void	spanEnd(Span span, int httpStatus, Throwable error)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

extractor

final HttpExtractor<Q,P> extractor

The HttpExtractor used to extract information from request/response.

Constructor Details

AbstractHttpHandler

AbstractHttpHandler(HttpExtractor<Q,P> extractor)

Constructor to allow access from same package subclasses only.

Method Details

recordMessageEvent

static void recordMessageEvent(Span span,
 long id,
 MessageEvent.Type type,
 long uncompressedMessageSize,
 long compressedMessageSize)

A convenience to record a MessageEvent with given parameters.

Parameters:

span - the span which this MessageEvent will be added to.

id - the id of the event.

type - the MessageEvent.Type of the event.

uncompressedMessageSize - size of the message before compressed (optional).

compressedMessageSize - size of the message after compressed (optional).

Since:

0.19

putAttributeIfNotEmptyOrNull

private static void putAttributeIfNotEmptyOrNull(Span span,
 String key,
 @Nullable
 String value)

handleMessageSent

public final void handleMessageSent(HttpRequestContext context,
 long bytes)

Instrument an HTTP span after a message is sent. Typically called for every chunk of request or response is sent.

Parameters:

context - request specific HttpRequestContext

bytes - bytes sent.

Since:

0.19

handleMessageReceived

public final void handleMessageReceived(HttpRequestContext context,
 long bytes)

Instrument an HTTP span after a message is received. Typically called for every chunk of request or response is received.

Parameters:

context - request specific HttpRequestContext

bytes - bytes received.

Since:

0.19

spanEnd

void spanEnd(Span span,
 int httpStatus,
 @Nullable
 Throwable error)

getSpanName

final String getSpanName(Q request,
 HttpExtractor<Q,P> extractor)

addSpanRequestAttributes

final void addSpanRequestAttributes(Span span,
 Q request,
 HttpExtractor<Q,P> extractor)

getSpanFromContext

public Span getSpanFromContext(HttpRequestContext context)

Retrieves Span from the HttpRequestContext.

Parameters:

context - request specific HttpRequestContext

Returns:

Span associated with the request.

Since:

0.19

getNewContext

HttpRequestContext getNewContext(Span span,
 TagContext tagContext)