HttpServerRequest (Brave Instrumentation: Http Adapters 5.16.0 API)

java.lang.Object
- brave.Request
- - brave.http.HttpRequest
  - - brave.http.HttpServerRequest

```
public abstract class HttpServerRequest
extends HttpRequest
```
Marks an interface for use in HttpServerHandler.handleReceive(HttpServerRequest). This gives a standard type to consider when parsing an incoming context.

Since:

5.7

See Also:

HttpServerResponse

Constructor Summary

Constructors
Constructor Description

HttpServerRequest()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`boolean`	`parseClientIpAndPort(Span span)`	Used by `HttpServerHandler.handleReceive(HttpServerRequest)` to add remote socket information about the client from the delegate.
`protected boolean`	`parseClientIpFromXForwardedFor(Span span)`	Uses the first value in the "X-Forwarded-For" header, or returns false if not present.
`Span.Kind`	`spanKind()`

Methods inherited from class brave.http.HttpRequest
header, method, path, route, startTimestamp, url

Methods inherited from class brave.Request
toString, unwrap

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - HttpServerRequest
```
public HttpServerRequest()
```
- Method Detail
  - spanKind
```
public final Span.Kind spanKind()
```
    Specified by:
    
    spanKind in class Request
  - parseClientIpAndPort
```
public boolean parseClientIpAndPort(Span span)
```
    Used by HttpServerHandler.handleReceive(HttpServerRequest) to add remote socket information about the client from the delegate.
    By default, this tries to parse the forwarded IP. Override to add client socket information when forwarded info is not available.
    Aside: It is more likely a server request object will be able to parse socket information as opposed to a client object. This is because client requests are often parsed before a network route is chosen, whereas server requests are parsed after the network layer.
    
    Returns:
    
    true if parsing was successful.
    
    Since:
    
    5.7
  - parseClientIpFromXForwardedFor
```
protected boolean parseClientIpFromXForwardedFor(Span span)
```
    Uses the first value in the "X-Forwarded-For" header, or returns false if not present.
    
    Since:
    
    5.10