com.azure.core.http.policy

Class HttpLogOptions

java.lang.Object

com.azure.core.http.policy.HttpLogOptions

public class HttpLogOptions
extends Object

The log configurations for HTTP messages.

Constructor Summary

Constructors

Constructor and Description
HttpLogOptions() Creates a new instance that does not log any information about HTTP requests or responses.

Method Summary

Modifier and Type	Method and Description
HttpLogOptions	addAllowedHeaderName(String allowedHeaderName) Sets the given whitelisted header to the default header set that should be logged.
HttpLogOptions	addAllowedQueryParamName(String allowedQueryParamName) Sets the given whitelisted query param that should be logged.
Set<String>	getAllowedHeaderNames() Gets the whitelisted headers that should be logged.
Set<String>	getAllowedQueryParamNames() Gets the whitelisted query parameters.
HttpLogDetailLevel	getLogLevel() Gets the level of detail to log on HTTP messages.
HttpLogOptions	setAllowedHeaderNames(Set<String> allowedHeaderNames) Sets the given whitelisted headers that should be logged.
HttpLogOptions	setAllowedQueryParamNames(Set<String> allowedQueryParamNames) Sets the given whitelisted query params to be displayed in the logging info.
HttpLogOptions	setLogLevel(HttpLogDetailLevel logLevel) Sets the level of detail to log on Http messages.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpLogOptions

public HttpLogOptions()

Creates a new instance that does not log any information about HTTP requests or responses.

Method Detail

getLogLevel

public HttpLogDetailLevel getLogLevel()

Gets the level of detail to log on HTTP messages.

Returns:

The HttpLogDetailLevel.

setLogLevel

public HttpLogOptions setLogLevel(HttpLogDetailLevel logLevel)

Sets the level of detail to log on Http messages.

If logLevel is not provided, default value of HttpLogDetailLevel.NONE is set.

Parameters:

logLevel - The HttpLogDetailLevel.

Returns:

The updated HttpLogOptions object.

getAllowedHeaderNames

public Set<String> getAllowedHeaderNames()

Gets the whitelisted headers that should be logged.

Returns:

The list of whitelisted headers.

setAllowedHeaderNames

public HttpLogOptions setAllowedHeaderNames(Set<String> allowedHeaderNames)

Sets the given whitelisted headers that should be logged.

This method sets the provided header names to be the whitelisted header names which will be logged for all HTTP requests and responses, overwriting any previously configured headers, including the default set. Additionally, users can use HttpLogOptions.addAllowedHeaderName(String) or HttpLogOptions.getAllowedHeaderNames() to add or remove more headers names to the existing set of allowed header names.

Parameters:

allowedHeaderNames - The list of whitelisted header names from the user.

Returns:

The updated HttpLogOptions object.

addAllowedHeaderName

public HttpLogOptions addAllowedHeaderName(String allowedHeaderName)

Sets the given whitelisted header to the default header set that should be logged.

Parameters:

allowedHeaderName - The whitelisted header name from the user.

Returns:

The updated HttpLogOptions object.

Throws:

NullPointerException - If allowedHeaderName is null.

getAllowedQueryParamNames

public Set<String> getAllowedQueryParamNames()

Gets the whitelisted query parameters.

Returns:

The list of whitelisted query parameters.

setAllowedQueryParamNames

public HttpLogOptions setAllowedQueryParamNames(Set<String> allowedQueryParamNames)

Sets the given whitelisted query params to be displayed in the logging info.

Parameters:

allowedQueryParamNames - The list of whitelisted query params from the user.

Returns:

The updated HttpLogOptions object.

addAllowedQueryParamName

public HttpLogOptions addAllowedQueryParamName(String allowedQueryParamName)

Sets the given whitelisted query param that should be logged.

Parameters:

allowedQueryParamName - The whitelisted query param name from the user.

Returns:

The updated HttpLogOptions object.

Throws:

NullPointerException - If allowedQueryParamName is null.