Class UserAgentConstant

java.lang.Object

software.amazon.awssdk.core.internal.useragent.UserAgentConstant

@SdkProtectedApi
public final class UserAgentConstant
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final String	API_METADATA
static final String	APP_ID
static final String	AUTH_SOURCE
static final String	BUSINESS_METADATA
static final String	COMMA
static final String	CONFIG_METADATA
static final String	ENV_METADATA
static final String	FEATURE_METADATA
static final String	FRAMEWORK_METADATA
static final String	HASH
static final String	HTTP
static final String	INTERNAL_METADATA_MARKER
static final String	IO
static final String	JAVA_SDK_METADATA
static final String	LANG_METADATA
static final String	METADATA
static final String	OS_METADATA
static final String	RETRY_MODE
static final String	SLASH
static final String	SPACE
static final String	UA_METADATA
static final String	UA_VERSION

Method Summary

Modifier and Type	Method	Description
static void	appendFieldAndSpace(StringBuilder builder, String name, String value)	Add a metadata field to the string builder, followed by space.
static void	appendNonEmptyField(StringBuilder builder, String name, String value)	Add a metadata field to the string builder only if 'value' is non-empty.
static void	appendSpaceAndField(StringBuilder builder, String name, String value)	Add a metadata field to the string builder, preceded by space.
static String	concat(String prefix, String suffix, String separator)	Concatenates two values with the specified separator, if the second value is not null/empty, otherwise returns the first value.
static String	field(String name, String value)	According to specifications, the SDK user agent consists of metadata fields separated by RWS characters - in this implementation, space.
static String	sanitizeInput(String input)	Replace any spaces, parentheses in the input with underscores.
static String	uaPair(String name, String value)	According to specifications, an SDK user agent pair is a name, value pair concatenated with a '#' (HASH).
static String	uaPairOrNull(String name, String value)	According to specifications, an SDK user agent pair is a name, value pair concatenated with a '#' (HASH).

Methods inherited from class java.lang.Object

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

Field Details

API_METADATA

public static final String API_METADATA

See Also:

• Constant Field Values

OS_METADATA

public static final String OS_METADATA

See Also:

• Constant Field Values

LANG_METADATA

public static final String LANG_METADATA

See Also:

• Constant Field Values

UA_METADATA

public static final String UA_METADATA

See Also:

• Constant Field Values

ENV_METADATA

public static final String ENV_METADATA

See Also:

• Constant Field Values

JAVA_SDK_METADATA

public static final String JAVA_SDK_METADATA

See Also:

• Constant Field Values

FEATURE_METADATA

public static final String FEATURE_METADATA

See Also:

• Constant Field Values

CONFIG_METADATA

public static final String CONFIG_METADATA

See Also:

• Constant Field Values

FRAMEWORK_METADATA

public static final String FRAMEWORK_METADATA

See Also:

• Constant Field Values

METADATA

public static final String METADATA

See Also:

• Constant Field Values

BUSINESS_METADATA

public static final String BUSINESS_METADATA

See Also:

• Constant Field Values

INTERNAL_METADATA_MARKER

public static final String INTERNAL_METADATA_MARKER

See Also:

• Constant Field Values

APP_ID

public static final String APP_ID

See Also:

• Constant Field Values

UA_VERSION

public static final String UA_VERSION

See Also:

• Constant Field Values

SLASH

public static final String SLASH

See Also:

• Constant Field Values

HASH

public static final String HASH

See Also:

• Constant Field Values

SPACE

public static final String SPACE

See Also:

• Constant Field Values

COMMA

public static final String COMMA

See Also:

• Constant Field Values

IO

public static final String IO

See Also:

• Constant Field Values

HTTP

public static final String HTTP

See Also:

• Constant Field Values

RETRY_MODE

public static final String RETRY_MODE

See Also:

• Constant Field Values

AUTH_SOURCE

public static final String AUTH_SOURCE

See Also:

• Constant Field Values

Method Details

field

public static String field(String name,
 String value)

According to specifications, the SDK user agent consists of metadata fields separated by RWS characters - in this implementation, space. Each field is represented by the name of the field, as specified and the contents of the field, separated with a '/' (SLASH). Contents can be a single token, a specified value or a uaPair.

uaPair

public static String uaPair(String name,
 String value)

According to specifications, an SDK user agent pair is a name, value pair concatenated with a '#' (HASH).

uaPairOrNull

public static String uaPairOrNull(String name,
 String value)

According to specifications, an SDK user agent pair is a name, value pair concatenated with a '#' (HASH).

appendFieldAndSpace

public static void appendFieldAndSpace(StringBuilder builder,
 String name,
 String value)

Add a metadata field to the string builder, followed by space. If 'value' can be empty, use appendNonEmptyField(StringBuilder, String, String) instead.

appendSpaceAndField

public static void appendSpaceAndField(StringBuilder builder,
 String name,
 String value)

Add a metadata field to the string builder, preceded by space. If 'value' can be empty, use appendNonEmptyField(StringBuilder, String, String) instead.

appendNonEmptyField

public static void appendNonEmptyField(StringBuilder builder,
 String name,
 String value)

Add a metadata field to the string builder only if 'value' is non-empty. Also see appendFieldAndSpace(StringBuilder, String, String)

sanitizeInput

public static String sanitizeInput(String input)

Replace any spaces, parentheses in the input with underscores.

concat

public static String concat(String prefix,
 String suffix,
 String separator)

Concatenates two values with the specified separator, if the second value is not null/empty, otherwise returns the first value.