Package brave.http

Class HttpParser

java.lang.Object

brave.http.HttpParser

Direct Known Subclasses:

HttpClientParser, HttpServerParser

@Deprecated
public class HttpParser
extends Object

Deprecated.

Since 5.10, use HttpRequestParser and HttpResponseParser

Constructor Summary

Constructors

Constructor	Description
HttpParser()	Deprecated.

Method Summary

Modifier and Type	Method	Description
protected void	error(Integer httpStatus, Throwable error, SpanCustomizer customizer)	Deprecated. Override to change what data from the http error are parsed into the span modeling it.
protected ErrorParser	errorParser()	Deprecated. This is only used in Zipkin reporting.
<Req> void	request(HttpAdapter<Req,?> adapter, Req req, SpanCustomizer customizer)	Deprecated. Override to change what data from the http request are parsed into the span representing it.
<Resp> void	response(HttpAdapter<?,Resp> adapter, Resp res, Throwable error, SpanCustomizer customizer)	Deprecated. Override to change what data from the http response or error are parsed into the span modeling it.
protected <Req> String	spanName(HttpAdapter<Req,?> adapter, Req req)	Deprecated. Returns the span name of the request or null if the data needed is unavailable.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpParser

public HttpParser()

Deprecated.

Method Detail

errorParser

protected ErrorParser errorParser()

Deprecated.

This is only used in Zipkin reporting. Since 5.12, use ZipkinSpanHandler.Builder.errorTag(Tag)

request

public <Req> void request(HttpAdapter<Req,?> adapter,
                          Req req,
                          SpanCustomizer customizer)

Deprecated.

Override to change what data from the http request are parsed into the span representing it. By default, this sets the span name to the http method and tags "http.method" and "http.path".

If you only want to change the span name, you can override spanName(HttpAdapter, Object) instead.

See Also:

spanName(HttpAdapter, Object)

spanName

@Nullable
protected <Req> String spanName(HttpAdapter<Req,?> adapter,
                                Req req)

Deprecated.

Returns the span name of the request or null if the data needed is unavailable. Defaults to the http method.

response

public <Resp> void response(HttpAdapter<?,Resp> adapter,
                            @Nullable
                            Resp res,
                            @Nullable
                            Throwable error,
                            SpanCustomizer customizer)

Deprecated.

Override to change what data from the http response or error are parsed into the span modeling it.

By default, this tags "http.status_code" when it is not 2xx. If there's an exception or the status code is neither 2xx nor 3xx, it tags "error". This also overrides the span name based on the HttpAdapter.methodFromResponse(Object) and HttpAdapter.route(Object) where possible (ex "get /users/:userId").

If routing is supported, and a GET didn't match due to 404, the span name will be "get not_found". If it didn't match due to redirect, the span name will be "get redirected". If routing is not supported, the span name is left alone.

If you only want to change how exceptions are parsed, override error(Integer, Throwable, SpanCustomizer) instead.

Note: Either the response or error parameters may be null, but not both.

See Also:

error(Integer, Throwable, SpanCustomizer)

error

protected void error(@Nullable
                     Integer httpStatus,
                     @Nullable
                     Throwable error,
                     SpanCustomizer customizer)

Deprecated.

Override to change what data from the http error are parsed into the span modeling it. By default, this tags "error" as the exception or the status code if it is below 1xx or above 3xx.

Note: Either the httpStatus or error parameters may be null, but not both

Conventionally associated with the tag key "error"