com.launchdarkly.sdk.internal.http

Class HttpHelpers

java.lang.Object

com.launchdarkly.sdk.internal.http.HttpHelpers

public abstract class HttpHelpers
extends java.lang.Object

Helper methods related to HTTP.

This class is for internal use only and should not be documented in the SDK API. It is not supported for any use outside of the LaunchDarkly SDKs, and is subject to change without notice.

Method Summary

Modifier and Type	Method and Description
static java.net.URI	addQueryParam(java.net.URI uri, java.lang.String name, java.lang.String value) Adds the query param to the URI.
static java.net.URI	concatenateUriPath(java.net.URI uri, java.lang.String path) Safely concatenates a path, ensuring that there is exactly one slash between segments.
static boolean	isAsciiHeaderValue(java.lang.String value) Tests whether a string contains only characters that are safe to use in an HTTP header value.

Methods inherited from class java.lang.Object

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

Method Detail

concatenateUriPath

public static java.net.URI concatenateUriPath(java.net.URI uri,
                                              java.lang.String path)

Safely concatenates a path, ensuring that there is exactly one slash between segments.

Parameters:

uri - the URI

path - the path to add

Returns:

a new URI

addQueryParam

public static java.net.URI addQueryParam(java.net.URI uri,
                                         java.lang.String name,
                                         java.lang.String value)

Adds the query param to the URI.

Parameters:

uri - the URI

name - the name of the parameter

value - the value of the parameter

Returns:

the modified URI

isAsciiHeaderValue

public static boolean isAsciiHeaderValue(java.lang.String value)

Tests whether a string contains only characters that are safe to use in an HTTP header value.

This is specifically testing whether the string would be considered a valid HTTP header value by the OkHttp client. The actual HTTP spec does not prohibit characters 127 and higher; OkHttp's check is overly strict, as was pointed out in https://github.com/square/okhttp/issues/2016. But all OkHttp 3.x and 4.x versions so far have continued to enforce that check. Control characters other than a tab are always illegal. The value we're mainly concerned with is the SDK key (Authorization header). If an SDK key accidentally has (for instance) a newline added to it, we don't want to end up having OkHttp throw an exception mentioning the value, which might get logged (https://github.com/square/okhttp/issues/6738).

Parameters:

value - a string

Returns:

true if valid