io.nats.client.support

Class HttpRequest

java.lang.Object

io.nats.client.support.HttpRequest

public class HttpRequest
extends java.lang.Object

Encapsulate an HttpRequest, in Java 11 we could use this class: https://docs.oracle.com/en/java/javase/11/docs/api/java.net.http/java/net/http/HttpRequest.html ...but we want to support older JVMs.

Constructor Summary

Constructors

Constructor and Description
HttpRequest()

Method Summary

Modifier and Type	Method and Description
io.nats.client.impl.Headers	getHeaders()
java.lang.String	getMethod()
java.lang.String	getURI() This is the RAW URI, you may need to perform URL decoding the result.
java.lang.String	getVersion()
HttpRequest	method(java.lang.String method) Note that no validation is performed, but the method is trimmed of whitespace and converted to all upper case.
java.lang.String	toString()
HttpRequest	uri(java.lang.String uri) This sets the RAW URI, you may need to perform URL encoding before passing into this method.
HttpRequest	version(java.lang.String version) Note that no validation is performed on the version.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpRequest

public HttpRequest()

Method Detail

getHeaders

public io.nats.client.impl.Headers getHeaders()

Returns:

the attached http headers, defaults to GET

getMethod

public java.lang.String getMethod()

Returns:

the request method (GET, POST, etc)

method

public HttpRequest method(java.lang.String method)

Note that no validation is performed, but the method is trimmed of whitespace and converted to all upper case.

Parameters:

method - is the new request method to use.

Returns:

this for method chaining.

getURI

public java.lang.String getURI()

This is the RAW URI, you may need to perform URL decoding the result.

Returns:

the "path" of the URI (in the RFC this is the request-URI)

uri

public HttpRequest uri(java.lang.String uri)

This sets the RAW URI, you may need to perform URL encoding before passing into this method.

Parameters:

uri - is the new "path" of the URI to use.

Returns:

this for method chaining.

getVersion

public java.lang.String getVersion()

Returns:

the HTTP version to use for this request. Defaults to "1.1"

version

public HttpRequest version(java.lang.String version)

Note that no validation is performed on the version. Probably only makes sense to use "0.9", "1.0", "1.1", or "2".

Parameters:

version - is the new HTTP version to use.

Returns:

this for method chaining.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

Returns:

the textual representation of the HTTP request line + headers (no body)