Package software.amazon.awssdk

Class RequestClientOptions

java.lang.Object

software.amazon.awssdk.RequestClientOptions

@NotThreadSafe
public final class RequestClientOptions
extends Object

Client request options such as client markers for individual AmazonWebServiceRequests.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RequestClientOptions.Marker

Field Summary

Fields

Modifier and Type	Field	Description
static int	DEFAULT_STREAM_BUFFER_SIZE	Used to enable mark-and-reset for non-mark-and-resettable non-file input stream for up to 128K memory buffering by default.

Constructor Summary

Constructors

Constructor	Description
RequestClientOptions()

Method Summary

Modifier and Type	Method	Description
void	appendUserAgent(String userAgent)	Appends a user agent to the USER_AGENT client marker.
String	getClientMarker(RequestClientOptions.Marker marker)	Returns the value of the specified marker; or null if there is no such value.
int	getReadLimit()	Returns the mark-and-reset read limit; defaults to .
void	putClientMarker(RequestClientOptions.Marker marker, String value)	Associates the given value with the given marker.
void	setReadLimit(int readLimit)	Sets the optional mark-and-reset read limit used for signing and retry purposes.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_STREAM_BUFFER_SIZE

public static final int DEFAULT_STREAM_BUFFER_SIZE

Used to enable mark-and-reset for non-mark-and-resettable non-file input stream for up to 128K memory buffering by default. Add 1 to get around an implementation quirk of BufferedInputStream. Retries after reading DEFAULT_STREAM_BUFFER_SIZE bytes would fail to reset the underlying input stream as the mark position would have been invalidated.

See Also:

Constant Field Values

Constructor Detail

RequestClientOptions

public RequestClientOptions()

Method Detail

getClientMarker

public String getClientMarker(RequestClientOptions.Marker marker)

Returns the value of the specified marker; or null if there is no such value.

putClientMarker

public void putClientMarker(RequestClientOptions.Marker marker,
                            String value)

Associates the given value with the given marker. Note the RequestClientOptions.Marker.USER_AGENT is only intended for internal use by the AWS SDK.

appendUserAgent

public void appendUserAgent(String userAgent)

Appends a user agent to the USER_AGENT client marker. This method is intended only for internal use by the AWS SDK.

getReadLimit

public final int getReadLimit()

Returns the mark-and-reset read limit; defaults to .

See Also:

InputStream.mark(int)

setReadLimit

public final void setReadLimit(int readLimit)

Sets the optional mark-and-reset read limit used for signing and retry purposes.

See Also:

InputStream.mark(int)