Package burp.api.montoya.http.message.requests

Interface HttpRequest

All Superinterfaces:

HttpMessage

All Known Subinterfaces:

HttpRequestToBeSent, InterceptedRequest

public interface HttpRequest
extends HttpMessage

Burp HTTP request able to retrieve and modify details of an HTTP request.

Method Summary

Modifier and Type	Method	Description
ByteArray	body()	Body of a message as a byte array.
int	bodyOffset()	Offset within the message where the message body begins.
String	bodyToString()	Body of a message as a String.
boolean	contains(String searchTerm, boolean caseSensitive)	Searches the data in the HTTP message for the specified search term.
boolean	contains(Pattern pattern)	Searches the data in the HTTP message for the specified regular expression.
ContentType	contentType()
HttpRequest	copyToTempFile()	Create a copy of the HttpRequest in temporary file. This method is used to save the HttpRequest object to a temporary file, so that it is no longer held in memory.
String	fileExtension()	The file extension for the request.
boolean	hasHeader(HttpHeader header)
boolean	hasHeader(String name)
boolean	hasHeader(String name, String value)
boolean	hasParameter(HttpParameter parameter)
boolean	hasParameter(String name, HttpParameterType type)
boolean	hasParameters()
boolean	hasParameters(HttpParameterType type)
HttpHeader	header(String name)
List<HttpHeader>	headers()	HTTP headers contained in the message.
String	headerValue(String name)
static HttpRequest	http2Request(HttpService service, List<HttpHeader> headers, ByteArray body)	Create a new instance of HttpRequest containing HTTP 2 headers and body.
static HttpRequest	http2Request(HttpService service, List<HttpHeader> headers, String body)	Create a new instance of HttpRequest containing HTTP 2 headers and body.
static HttpRequest	httpRequest()	Create a new empty instance of HttpRequest.
static HttpRequest	httpRequest(ByteArray request)	Create a new instance of HttpRequest.
static HttpRequest	httpRequest(HttpService service, ByteArray request)	Create a new instance of HttpRequest.
static HttpRequest	httpRequest(HttpService service, String request)	Create a new instance of HttpRequest.
static HttpRequest	httpRequest(String request)	Create a new instance of HttpRequest.
static HttpRequest	httpRequestFromUrl(String url)	Create a new instance of HttpRequest.
HttpService	httpService()	HTTP service for the request.
String	httpVersion()	HTTP Version text parsed from the request or response line for HTTP 1 messages.
boolean	isInScope()
List<Marker>	markers()	Markers for the message.
String	method()	HTTP method for the request.
ParsedHttpParameter	parameter(String name, HttpParameterType type)
List<ParsedHttpParameter>	parameters()
List<ParsedHttpParameter>	parameters(HttpParameterType type)
String	parameterValue(String name, HttpParameterType type)
String	path()	Request path including the query parameters.
String	pathWithoutQuery()	Request path excluding the query parameters.
String	query()	The query for the request.
ByteArray	toByteArray()	Message as a byte array.
String	toString()	Message as a String.
String	url()	URL for the request.
HttpRequest	withAddedHeader(HttpHeader header)	Create a copy of the HttpRequest with the added header.
HttpRequest	withAddedHeader(String name, String value)	Create a copy of the HttpRequest with the added header.
HttpRequest	withAddedHeaders(HttpHeader... headers)	Create a copy of the HttpRequest with the added HTTP headers.
HttpRequest	withAddedHeaders(List<? extends HttpHeader> headers)	Create a copy of the HttpRequest with the added HTTP headers.
HttpRequest	withAddedParameters(HttpParameter... parameters)	Create a copy of the HttpRequest with the added HTTP parameters.
HttpRequest	withAddedParameters(List<? extends HttpParameter> parameters)	Create a copy of the HttpRequest with the added HTTP parameters.
HttpRequest	withBody(ByteArray body)	Create a copy of the HttpRequest with the updated body. Updates Content-Length header.
HttpRequest	withBody(String body)	Create a copy of the HttpRequest with the updated body. Updates Content-Length header.
HttpRequest	withDefaultHeaders()	Create a copy of the HttpRequest with added default headers.
HttpRequest	withHeader(HttpHeader header)	Create a copy of the HttpRequest with the added or updated header. If the header exists in the request, it is updated. If the header doesn't exist in the request, it is added.
HttpRequest	withHeader(String name, String value)	Create a copy of the HttpRequest with the added or updated header. If the header exists in the request, it is updated. If the header doesn't exist in the request, it is added.
HttpRequest	withMarkers(Marker... markers)	Create a copy of the HttpRequest with the added markers.
HttpRequest	withMarkers(List<Marker> markers)	Create a copy of the HttpRequest with the added markers.
HttpRequest	withMethod(String method)	Create a copy of the HttpRequest with the new method.
HttpRequest	withParameter(HttpParameter parameters)	Create a copy of the HttpRequest with the HTTP parameter. If the parameter exists in the request, it is updated. If the parameter doesn't exist in the request, it is added.
HttpRequest	withPath(String path)	Create a copy of the HttpRequest with the new path.
HttpRequest	withRemovedHeader(HttpHeader header)	Removes an existing HTTP header from the current request.
HttpRequest	withRemovedHeader(String name)	Removes an existing HTTP header from the current request.
HttpRequest	withRemovedHeaders(HttpHeader... headers)	Create a copy of the HttpRequest with the removed HTTP headers.
HttpRequest	withRemovedHeaders(List<? extends HttpHeader> headers)	Create a copy of the HttpRequest with the removed HTTP headers.
HttpRequest	withRemovedParameters(HttpParameter... parameters)	Create a copy of the HttpRequest with the removed HTTP parameters.
HttpRequest	withRemovedParameters(List<? extends HttpParameter> parameters)	Create a copy of the HttpRequest with the removed HTTP parameters.
HttpRequest	withService(HttpService service)	Create a copy of the HttpRequest with the new service.
HttpRequest	withTransformationApplied(HttpTransformation transformation)	Create a copy of the HttpRequest with the transformation applied.
HttpRequest	withUpdatedHeader(HttpHeader header)	Create a copy of the HttpRequest with the updated header.
HttpRequest	withUpdatedHeader(String name, String value)	Create a copy of the HttpRequest with the updated header.
HttpRequest	withUpdatedHeaders(HttpHeader... headers)	Create a copy of the HttpRequest with the updated HTTP headers.
HttpRequest	withUpdatedHeaders(List<? extends HttpHeader> headers)	Create a copy of the HttpRequest with the updated HTTP headers.
HttpRequest	withUpdatedParameters(HttpParameter... parameters)	Create a copy of the HttpRequest with the updated HTTP parameters.
HttpRequest	withUpdatedParameters(List<? extends HttpParameter> parameters)	Create a copy of the HttpRequest with the updated HTTP parameters.

Method Details

isInScope

boolean isInScope()

Returns:

True if the request is in-scope.

httpService

HttpService httpService()

HTTP service for the request.

Returns:

An HttpService object containing details of the HTTP service.

url

String url()

URL for the request. If the request is malformed, then a MalformedRequestException is thrown.

Returns:

The URL in the request.

Throws:

MalformedRequestException - if request is malformed.

method

String method()

HTTP method for the request. If the request is malformed, then a MalformedRequestException is thrown.

Returns:

The HTTP method used in the request.

Throws:

MalformedRequestException - if request is malformed.

path

String path()

Request path including the query parameters. If the request is malformed, then a MalformedRequestException is thrown.

Returns:

the path and query parameters.

Throws:

MalformedRequestException - if request is malformed.

query

String query()

The query for the request. If the request is malformed, then a MalformedRequestException is thrown.

Returns:

the query, or an empty string if there is none.

Throws:

MalformedRequestException - if request is malformed.

pathWithoutQuery

String pathWithoutQuery()

Request path excluding the query parameters. If the request is malformed, then a MalformedRequestException is thrown.

Returns:

the path excluding query parameters.

Throws:

MalformedRequestException - if request is malformed.

fileExtension

String fileExtension()

The file extension for the request. If the request is malformed, then a MalformedRequestException is thrown.

Returns:

the file extension, or an empty string if there is none.

Throws:

MalformedRequestException - if request is malformed.

contentType

ContentType contentType()

Returns:

The detected content type of the request.

parameters

List<ParsedHttpParameter> parameters()

Returns:

The parameters contained in the request.

parameters

List<ParsedHttpParameter> parameters(HttpParameterType type)

Parameters:

type - The type of parameter that will be returned in the filtered list.

Returns:

A filtered list of ParsedHttpParameter containing only the provided type.

hasParameters

boolean hasParameters()

Returns:

True if the request has parameters.

hasParameters

boolean hasParameters(HttpParameterType type)

Returns:

True if the request has parameters of type HttpParameterType

parameter

ParsedHttpParameter parameter(String name,
 HttpParameterType type)

Parameters:

name - The name of the parameter to find.

type - The type of the parameter to find.

Returns:

An instance of ParsedHttpParameter that matches the type and name specified. null if not found.

parameterValue

String parameterValue(String name,
 HttpParameterType type)

Parameters:

name - The name of the parameter to get the value from.

type - The type of the parameter to get the value from.

Returns:

The value of the parameter that matches the name and type specified. null if not found.

hasParameter

boolean hasParameter(String name,
 HttpParameterType type)

Parameters:

name - The name of the parameter to find.

type - The type of the parameter to find.

Returns:

true if a parameter exists that matches the name and type specified. false if not found.

hasParameter

boolean hasParameter(HttpParameter parameter)

Parameters:

parameter - An instance of HttpParameter to match to an existing parameter.

Returns:

true if a parameter exists that matches the data within the provided HttpParameter. false if not found.

hasHeader

boolean hasHeader(HttpHeader header)

Specified by:

hasHeader in interface HttpMessage

Parameters:

header - The header to check if it exists in the request.

Returns:

True if the header exists in the request.

hasHeader

boolean hasHeader(String name)

Specified by:

hasHeader in interface HttpMessage

Parameters:

name - The name of the header to query within the request.

Returns:

True if a header exists in the request with the supplied name.

hasHeader

boolean hasHeader(String name,
 String value)

Specified by:

hasHeader in interface HttpMessage

Parameters:

name - The name of the header to check.

value - The value of the header to check.

Returns:

True if a header exists in the request that matches the name and value supplied.

header

HttpHeader header(String name)

Specified by:

header in interface HttpMessage

Parameters:

name - The name of the header to retrieve.

Returns:

An instance of HttpHeader that matches the name supplied, null if no match found.

headerValue

String headerValue(String name)

Specified by:

headerValue in interface HttpMessage

Parameters:

name - The name of the header to retrieve.

Returns:

The String value of the header that matches the name supplied, null if no match found.

headers

List<HttpHeader> headers()

HTTP headers contained in the message.

Specified by:

headers in interface HttpMessage

Returns:

A list of HTTP headers.

httpVersion

String httpVersion()

HTTP Version text parsed from the request or response line for HTTP 1 messages. HTTP 2 messages will return "HTTP/2"

Specified by:

httpVersion in interface HttpMessage

Returns:

Version string

bodyOffset

int bodyOffset()

Offset within the message where the message body begins.

Specified by:

bodyOffset in interface HttpMessage

Returns:

The message body offset.

body

ByteArray body()

Body of a message as a byte array.

Specified by:

body in interface HttpMessage

Returns:

The body of a message as a byte array.

bodyToString

String bodyToString()

Body of a message as a String.

Specified by:

bodyToString in interface HttpMessage

Returns:

The body of a message as a String.

markers

List<Marker> markers()

Markers for the message.

Specified by:

markers in interface HttpMessage

Returns:

A list of markers.

contains

boolean contains(String searchTerm,
 boolean caseSensitive)

Searches the data in the HTTP message for the specified search term.

Specified by:

contains in interface HttpMessage

Parameters:

searchTerm - The value to be searched for.

caseSensitive - Flags whether the search is case-sensitive.

Returns:

True if the search term is found.

contains

boolean contains(Pattern pattern)

Searches the data in the HTTP message for the specified regular expression.

Specified by:

contains in interface HttpMessage

Parameters:

pattern - The regular expression to be searched for.

Returns:

True if the pattern is matched.

toByteArray

ByteArray toByteArray()

Message as a byte array.

Specified by:

toByteArray in interface HttpMessage

Returns:

The message as a byte array.

toString

String toString()

Message as a String.

Specified by:

toString in interface HttpMessage

Overrides:

toString in class Object

Returns:

The message as a String.

copyToTempFile

HttpRequest copyToTempFile()

Create a copy of the HttpRequest in temporary file.
This method is used to save the HttpRequest object to a temporary file, so that it is no longer held in memory. Extensions can use this method to convert HttpRequest objects into a form suitable for long-term usage.

Returns:

A new HttpRequest instance stored in temporary file.

withService

HttpRequest withService(HttpService service)

Create a copy of the HttpRequest with the new service.

Parameters:

service - An HttpService reference to add.

Returns:

A new HttpRequest instance.

withPath

HttpRequest withPath(String path)

Create a copy of the HttpRequest with the new path.

Parameters:

path - The path to use.

Returns:

A new HttpRequest instance with updated path.

withMethod

HttpRequest withMethod(String method)

Create a copy of the HttpRequest with the new method.

Parameters:

method - the method to use

Returns:

a new HttpRequest instance with updated method.

withHeader

HttpRequest withHeader(HttpHeader header)

Create a copy of the HttpRequest with the added or updated header.
If the header exists in the request, it is updated.
If the header doesn't exist in the request, it is added.

Parameters:

header - HTTP header to add or update.

Returns:

A new HttpRequest with the added or updated header.

withHeader

HttpRequest withHeader(String name,
 String value)

Create a copy of the HttpRequest with the added or updated header.
If the header exists in the request, it is updated.
If the header doesn't exist in the request, it is added.

Parameters:

name - The name of the header.

value - The value of the header.

Returns:

A new HttpRequest with the added or updated header.

withParameter

HttpRequest withParameter(HttpParameter parameters)

Create a copy of the HttpRequest with the HTTP parameter.
If the parameter exists in the request, it is updated.
If the parameter doesn't exist in the request, it is added.

Parameters:

parameters - HTTP parameter to add or update.

Returns:

A new HttpRequest with the added or updated parameter.

withAddedParameters

HttpRequest withAddedParameters(List<? extends HttpParameter> parameters)

Create a copy of the HttpRequest with the added HTTP parameters.

Parameters:

parameters - HTTP parameters to add.

Returns:

A new HttpRequest instance.

withAddedParameters

HttpRequest withAddedParameters(HttpParameter... parameters)

Create a copy of the HttpRequest with the added HTTP parameters.

Parameters:

parameters - HTTP parameters to add.

Returns:

A new HttpRequest instance.

withRemovedParameters

HttpRequest withRemovedParameters(List<? extends HttpParameter> parameters)

Create a copy of the HttpRequest with the removed HTTP parameters.

Parameters:

parameters - HTTP parameters to remove.

Returns:

A new HttpRequest instance.

withRemovedParameters

HttpRequest withRemovedParameters(HttpParameter... parameters)

Create a copy of the HttpRequest with the removed HTTP parameters.

Parameters:

parameters - HTTP parameters to remove.

Returns:

A new HttpRequest instance.

withUpdatedParameters

HttpRequest withUpdatedParameters(List<? extends HttpParameter> parameters)

Create a copy of the HttpRequest with the updated HTTP parameters.

Parameters:

parameters - HTTP parameters to update.

Returns:

A new HttpRequest instance.

withUpdatedParameters

HttpRequest withUpdatedParameters(HttpParameter... parameters)

Create a copy of the HttpRequest with the updated HTTP parameters.

Parameters:

parameters - HTTP parameters to update.

Returns:

A new HttpRequest instance.

withTransformationApplied

HttpRequest withTransformationApplied(HttpTransformation transformation)

Create a copy of the HttpRequest with the transformation applied.

Parameters:

transformation - Transformation to apply.

Returns:

A new HttpRequest instance.

withBody

HttpRequest withBody(String body)

Create a copy of the HttpRequest with the updated body.
Updates Content-Length header.

Parameters:

body - the new body for the request

Returns:

A new HttpRequest instance.

withBody

HttpRequest withBody(ByteArray body)

Create a copy of the HttpRequest with the updated body.
Updates Content-Length header.

Parameters:

body - the new body for the request

Returns:

A new HttpRequest instance.

withAddedHeader

HttpRequest withAddedHeader(String name,
 String value)

Create a copy of the HttpRequest with the added header.

Parameters:

name - The name of the header.

value - The value of the header.

Returns:

The updated HTTP request with the added header.

withAddedHeader

HttpRequest withAddedHeader(HttpHeader header)

Create a copy of the HttpRequest with the added header.

Parameters:

header - The HttpHeader to add to the HTTP request.

Returns:

The updated HTTP request with the added header.

withAddedHeaders

HttpRequest withAddedHeaders(List<? extends HttpHeader> headers)

Create a copy of the HttpRequest with the added HTTP headers.

Parameters:

headers - HTTP headers to add.

Returns:

A new HttpRequest instance.

withAddedHeaders

HttpRequest withAddedHeaders(HttpHeader... headers)

Create a copy of the HttpRequest with the added HTTP headers.

Parameters:

headers - HTTP headers to add.

Returns:

A new HttpRequest instance.

withUpdatedHeader

HttpRequest withUpdatedHeader(String name,
 String value)

Create a copy of the HttpRequest with the updated header.

Parameters:

name - The name of the header to update the value of.

value - The new value of the specified HTTP header.

Returns:

The updated request containing the updated header.

withUpdatedHeader

HttpRequest withUpdatedHeader(HttpHeader header)

Create a copy of the HttpRequest with the updated header.

Parameters:

header - The HttpHeader to update containing the new value.

Returns:

The updated request containing the updated header.

withUpdatedHeaders

HttpRequest withUpdatedHeaders(List<? extends HttpHeader> headers)

Create a copy of the HttpRequest with the updated HTTP headers.

Parameters:

headers - HTTP headers to update.

Returns:

A new HttpRequest instance.

withUpdatedHeaders

HttpRequest withUpdatedHeaders(HttpHeader... headers)

Create a copy of the HttpRequest with the updated HTTP headers.

Parameters:

headers - HTTP headers to update.

Returns:

A new HttpRequest instance.

withRemovedHeader

HttpRequest withRemovedHeader(String name)

Removes an existing HTTP header from the current request.

Parameters:

name - The name of the HTTP header to remove from the request.

Returns:

The updated request containing the removed header.

withRemovedHeader

HttpRequest withRemovedHeader(HttpHeader header)

Removes an existing HTTP header from the current request.

Parameters:

header - The HttpHeader to remove from the request.

Returns:

The updated request containing the removed header.

withRemovedHeaders

HttpRequest withRemovedHeaders(List<? extends HttpHeader> headers)

Create a copy of the HttpRequest with the removed HTTP headers.

Parameters:

headers - HTTP headers to remove.

Returns:

A new HttpRequest instance.

withRemovedHeaders

HttpRequest withRemovedHeaders(HttpHeader... headers)

Create a copy of the HttpRequest with the removed HTTP headers.

Parameters:

headers - HTTP headers to remove.

Returns:

A new HttpRequest instance.

withMarkers

HttpRequest withMarkers(List<Marker> markers)

Create a copy of the HttpRequest with the added markers.

Parameters:

markers - Request markers to add.

Returns:

A new HttpRequest instance.

withMarkers

HttpRequest withMarkers(Marker... markers)

Create a copy of the HttpRequest with the added markers.

Parameters:

markers - Request markers to add.

Returns:

A new HttpRequest instance.

withDefaultHeaders

HttpRequest withDefaultHeaders()

Create a copy of the HttpRequest with added default headers.

Returns:

a new HttpRequest with added default headers

httpRequest

static HttpRequest httpRequest()

Create a new empty instance of HttpRequest.

Returns:

A new HttpRequest instance.

httpRequest

static HttpRequest httpRequest(ByteArray request)

Create a new instance of HttpRequest.

Parameters:

request - The HTTP request

Returns:

A new HttpRequest instance.

httpRequest

static HttpRequest httpRequest(String request)

Create a new instance of HttpRequest.

Parameters:

request - The HTTP request.

Returns:

A new HttpRequest instance.

httpRequest

static HttpRequest httpRequest(HttpService service,
 ByteArray request)

Create a new instance of HttpRequest.

Parameters:

service - An HTTP service for the request.

request - The HTTP request.

Returns:

A new HttpRequest instance.

httpRequest

static HttpRequest httpRequest(HttpService service,
 String request)

Create a new instance of HttpRequest.

Parameters:

service - An HTTP service for the request.

request - The HTTP request.

Returns:

A new HttpRequest instance.

httpRequestFromUrl

static HttpRequest httpRequestFromUrl(String url)

Create a new instance of HttpRequest.

Parameters:

url - A URL for the request.

Returns:

A new HttpRequest instance.

http2Request

static HttpRequest http2Request(HttpService service,
 List<HttpHeader> headers,
 ByteArray body)

Create a new instance of HttpRequest containing HTTP 2 headers and body.

Parameters:

service - An HTTP service for the request.

headers - A list of HTTP 2 headers.

body - A body of the HTTP 2 request.

Returns:

A new HttpRequest instance.

http2Request

static HttpRequest http2Request(HttpService service,
 List<HttpHeader> headers,
 String body)

Create a new instance of HttpRequest containing HTTP 2 headers and body.

Parameters:

service - An HTTP service for the request.

headers - A list of HTTP 2 headers.

body - A body of the HTTP 2 request.

Returns:

A new HttpRequest instance.