你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

OperationContext 类

  • java.lang.Object
    • com.microsoft.azure.storage.OperationContext

public class OperationContext

表示当前逻辑操作。 逻辑操作可能与多个单独的物理请求具有一对多关系。

字段摘要

修饰符和类型 字段和描述
final String defaultLoggerName

org.slf4j.Logger如果启用日志记录并且org.slf4j.Logger尚未指定 ,则默认创建的 的名称。

构造函数摘要

构造函数 说明
OperationContext()

创建 类的实例。

方法摘要

修饰符和类型 方法和描述
synchronized void appendRequestResult(RequestResult requestResult)

保留以供内部使用。 以 RequestResult 同步方式将 对象追加到内部集合。

String getClientRequestID()

获取客户端跟踪 ID。

long getClientTimeInMs()

从客户端的角度获取操作延迟(以毫秒为单位)。 这可能包括任何可能的重试。

Proxy getDefaultProxy()

获取客户端库使用的默认代理(如果已启用)。 可以重写默认值,以便使用 setProxy(Proxy proxy)为单个操作上下文实例启用代理。

String getDefaultProxyPassword()

获取经过身份验证的代理的默认密码,该密码将在发出请求时使用。 默认值为 。 设置要使用的密码 setProxyPassword(final String password)

String getDefaultProxyUsername()

获取经过身份验证的代理的默认用户名,该用户名将在发出请求时使用。 默认值为 。 若要设置用户名,请使用 setDefaultProxyUsername(final String username)

StorageEventMultiCaster<ErrorReceivingResponseEvent, StorageEvent<ErrorReceivingResponseEvent>> getErrorReceivingResponseEventHandler()

获取在收到 HTTP 响应状态和标头之前发生网络错误时触发的事件多强制转换程序。 它允许动态添加和删除事件侦听器。

StorageEventMultiCaster<ErrorReceivingResponseEvent, StorageEvent<ErrorReceivingResponseEvent>> getGlobalErrorReceivingResponseEventHandler()

获取在收到 HTTP 响应状态和标头之前发生网络错误时触发的全局事件多强制转换程序。 它允许动态添加和删除事件侦听器。

StorageEventMultiCaster<RequestCompletedEvent, StorageEvent<RequestCompletedEvent>> getGlobalRequestCompletedEventHandler()

获取请求完成时触发的全局事件多强制转换器。 它允许动态添加和删除事件侦听器。

StorageEventMultiCaster<ResponseReceivedEvent, StorageEvent<ResponseReceivedEvent>> getGlobalResponseReceivedEventHandler()

获取在收到响应时触发的全局事件多强制转换器。 它允许动态添加和删除事件侦听器。

StorageEventMultiCaster<RetryingEvent, StorageEvent<RetryingEvent>> getGlobalRetryingEventHandler()

获取重试请求时触发的全局事件多强制转换程序。 它允许动态添加和删除事件侦听器。

StorageEventMultiCaster<SendingRequestEvent, StorageEvent<SendingRequestEvent>> getGlobalSendingRequestEventHandler()

获取发送请求之前触发的全局事件多强制转换器。 它允许动态添加和删除事件侦听器。

synchronized RequestResult getLastResult()

获取操作上次遇到的请求结果。

org.slf4j.Logger getLogger()

获取与 org.slf4j.Logger 此操作关联的 。 如果与 org.slf4j.Logger 此操作关联的对象为 null,则返回类的默认 org.slf4j.Logger 对象。

Proxy getProxy()

获取将在发出请求时使用的代理。 默认值为 。 若要将代理设置为默认使用,请使用 setDefaultProxy(Proxy defaultProxy)

String getProxyPassword()

获取经过身份验证的代理的密码,该密码将在发出请求时使用。 默认值为 。 设置要使用的密码 setProxyPassword(final String password)

String getProxyUsername()

获取经过身份验证的代理的用户名,该用户名将在发出请求时使用。 默认值为 。 若要设置用户名,请使用 setProxyUsername(final String username)

StorageEventMultiCaster<RequestCompletedEvent, StorageEvent<RequestCompletedEvent>> getRequestCompletedEventHandler()

获取在请求完成时触发的事件多强制转换器。 它允许动态添加和删除事件侦听器。

ArrayList<RequestResult> getRequestResults()

返回当前操作已创建的请求结果集。

StorageEventMultiCaster<ResponseReceivedEvent, StorageEvent<ResponseReceivedEvent>> getResponseReceivedEventHandler()

获取在收到响应时触发的事件多强制转换程序。 它允许动态添加和删除事件侦听器。

StorageEventMultiCaster<RetryingEvent, StorageEvent<RetryingEvent>> getRetryingEventHandler()

获取重试请求时触发的事件多强制转换程序。 它允许动态添加和删除事件侦听器。

StorageEventMultiCaster<SendingRequestEvent, StorageEvent<SendingRequestEvent>> getSendingRequestEventHandler()

获取发送请求之前触发的事件多强制转换器。 它允许动态添加和删除事件侦听器。

HashMap<String, String> getUserHeaders()

获取请求的任何其他标头,例如代理或日志记录信息。

void initialize()

保留以供内部使用。 初始化 以开始处理新操作。 将擦除所有特定于操作的信息。

boolean isLoggingEnabled()

指示是否为此请求生成日志条目。

boolean isLoggingEnabledByDefault()

指示客户端库默认情况下是否应生成日志条目。 可以重写默认值,以便使用 setLoggingEnabled(boolean loggingEnabled)为单个操作上下文实例启用日志记录。

void setClientRequestID(final String clientRequestID)

设置客户端请求 ID。

void setClientTimeInMs(final long clientTimeInMs)

保留以供内部使用。 从客户端的角度表示操作延迟(以毫秒为单位)。 这可能包括任何可能的重试。

void setDefaultProxy(Proxy defaultProxy)

指定客户端库默认应使用的代理。 可以重写默认值,以便通过使用 setProxy(Proxy proxy)为单个操作上下文实例打开代理。

void setDefaultProxyPassword(final String password)

设置经过身份验证的代理的默认密码,该密码将在发出请求时使用。 默认值为 。

void setDefaultProxyUsername(final String username)

设置经过身份验证的代理的默认用户名,该用户名将在发出请求时使用。 默认值为 。

void setErrorReceivingResponseEventHandler(final StorageEventMultiCaster<ErrorReceivingResponseEvent, StorageEvent<ErrorReceivingResponseEvent>> errorReceivingResponseEventHandler)

设置在收到 HTTP 响应状态和标头之前发生网络错误时触发的事件多强制转换程序。

void setGlobalErrorReceivingResponseEventHandler(final StorageEventMultiCaster<ErrorReceivingResponseEvent, StorageEvent<ErrorReceivingResponseEvent>> globalErrorReceivingResponseEventHandler)

设置在收到 HTTP 响应状态和标头之前发生网络错误时触发的全局事件多强制转换程序。

void setGlobalRequestCompletedEventHandler(final StorageEventMultiCaster<RequestCompletedEvent, StorageEvent<RequestCompletedEvent>> globalRequestCompletedEventHandler)

设置请求完成时触发的全局事件多强制转换程序。

void setGlobalResponseReceivedEventHandler(final StorageEventMultiCaster<ResponseReceivedEvent, StorageEvent<ResponseReceivedEvent>> globalResponseReceivedEventHandler)

设置在收到响应时触发的全局事件多强制转换程序。

void setGlobalRetryingEventHandler(final StorageEventMultiCaster<RetryingEvent, StorageEvent<RetryingEvent>> globalRetryingEventHandler)

设置重试请求时触发的全局事件多强制转换程序。

void setGlobalSendingRequestEventHandler(final StorageEventMultiCaster<SendingRequestEvent, StorageEvent<SendingRequestEvent>> globalSendingRequestEventHandler)

设置发送请求之前触发的全局事件多强制转换器。

void setLogger(final org.slf4j.Logger logger)

org.slf4j.Logger设置此操作的 。

void setLoggingEnabled(boolean loggingEnabled)

指定是否为此请求生成日志条目。

void setLoggingEnabledByDefault(boolean enableLoggingByDefault)

指定默认情况下客户端库是否应生成日志条目。 可以重写默认值,以使用 setLoggingEnabled(boolean loggingEnabled)为单个操作上下文实例启用日志记录。

void setProxy(Proxy proxy)

设置在发出请求时将使用的代理。 默认值为 。 若要将代理设置为默认使用,请使用 setDefaultProxy(Proxy defaultProxy)

void setProxyPassword(final String password)

设置经过身份验证的代理的密码,该密码将在发出请求时使用。 默认值为 。

void setProxyUsername(final String username)

设置经过身份验证的代理的用户名,该用户名将在发出请求时使用。 默认值为 。

void setRequestCompletedEventHandler(final StorageEventMultiCaster<RequestCompletedEvent, StorageEvent<RequestCompletedEvent>> requestCompletedEventHandler)

设置在请求完成时触发的事件多强制转换程序。

void setResponseReceivedEventHandler(final StorageEventMultiCaster<ResponseReceivedEvent, StorageEvent<ResponseReceivedEvent>> responseReceivedEventHandler)

设置在收到响应时触发的事件多强制转换程序。

void setRetryingEventHandler(final StorageEventMultiCaster<RetryingEvent, StorageEvent<RetryingEvent>> retryingEventHandler)

设置重试请求时触发的事件多强制转换程序。

void setSendingRequestEventHandler(final StorageEventMultiCaster<SendingRequestEvent, StorageEvent<SendingRequestEvent>> sendingRequestEventHandler)

设置发送请求之前触发的事件多强制转换程序。

void setUserHeaders(final HashMap<String, String> userHeaders)

设置请求的任何其他标头,例如代理或日志记录信息。

字段详细信息

defaultLoggerName

public static final String defaultLoggerName= Logger.ROOT_LOGGER_NAME

org.slf4j.Logger如果启用日志记录并且org.slf4j.Logger尚未指定 ,则默认创建的 的名称。

构造函数详细信息

OperationContext

public OperationContext()

创建 类的实例。

方法详细信息

appendRequestResult

public synchronized void appendRequestResult(RequestResult requestResult)

保留以供内部使用。 以 RequestResult 同步方式将 对象追加到内部集合。

Parameters:

requestResult - 要 RequestResult 追加的 。

getClientRequestID

public String getClientRequestID()

获取客户端跟踪 ID。

Returns:

一个 String ,它表示客户端请求 ID。

getClientTimeInMs

public long getClientTimeInMs()

从客户端的角度获取操作延迟(以毫秒为单位)。 这可能包括任何可能的重试。

Returns:

一个 , long 它包含客户端延迟时间(以毫秒为单位)。

getDefaultProxy

public static Proxy getDefaultProxy()

获取客户端库使用的默认代理(如果已启用)。 可以重写默认值,以便使用 setProxy(Proxy proxy)为单个操作上下文实例启用代理。

Returns:

如果已设置,则为默认值 java.net.Proxy ;否则为 null

getDefaultProxyPassword

public static String getDefaultProxyPassword()

获取经过身份验证的代理的默认密码,该密码将在发出请求时使用。 默认值为 。 设置要使用的密码 setProxyPassword(final String password)

Returns:

发出 String 请求时要使用的 。

getDefaultProxyUsername

public static String getDefaultProxyUsername()

获取经过身份验证的代理的默认用户名,该用户名将在发出请求时使用。 默认值为 。 若要设置用户名,请使用 setDefaultProxyUsername(final String username)

Returns:

发出 String 请求时要使用的 。

getErrorReceivingResponseEventHandler

public StorageEventMultiCaster> getErrorReceivingResponseEventHandler()

获取在收到 HTTP 响应状态和标头之前发生网络错误时触发的事件多强制转换程序。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>errorReceivingResponseEventHandler 对象。

getGlobalErrorReceivingResponseEventHandler

public static StorageEventMultiCaster> getGlobalErrorReceivingResponseEventHandler()

获取在收到 HTTP 响应状态和标头之前发生网络错误时触发的全局事件多强制转换程序。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>globabErrorReceivingResponseEventHandler 对象。

getGlobalRequestCompletedEventHandler

public static StorageEventMultiCaster> getGlobalRequestCompletedEventHandler()

获取请求完成时触发的全局事件多强制转换器。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>globalRequestCompletedEventHandler 对象。

getGlobalResponseReceivedEventHandler

public static StorageEventMultiCaster> getGlobalResponseReceivedEventHandler()

获取在收到响应时触发的全局事件多强制转换器。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>globalResponseReceivedEventHandler 对象。

getGlobalRetryingEventHandler

public static StorageEventMultiCaster> getGlobalRetryingEventHandler()

获取重试请求时触发的全局事件多强制转换程序。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>globalRetryingEventHandler 对象。

getGlobalSendingRequestEventHandler

public static StorageEventMultiCaster> getGlobalSendingRequestEventHandler()

获取发送请求之前触发的全局事件多强制转换器。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>globalSendingRequestEventHandler 对象。

getLastResult

public synchronized RequestResult getLastResult()

获取操作上次遇到的请求结果。

Returns:

一个 表示最后一个 RequestResult 请求结果的 对象。

getLogger

public org.slf4j.Logger getLogger()

获取与 org.slf4j.Logger 此操作关联的 。 如果与 org.slf4j.Logger 此操作关联的对象为 null,则返回类的默认 org.slf4j.Logger 对象。

Returns:

org.slf4j.Logger 此操作关联的对象;如果为 null,则为类的默认值 org.slf4j.Logger

getProxy

public Proxy getProxy()

获取将在发出请求时使用的代理。 默认值为 。 若要将代理设置为默认使用,请使用 setDefaultProxy(Proxy defaultProxy)

Returns:

发出 java.net.Proxy 请求时要使用的 。

getProxyPassword

public String getProxyPassword()

获取经过身份验证的代理的密码,该密码将在发出请求时使用。 默认值为 。 设置要使用的密码 setProxyPassword(final String password)

Returns:

发出 String 请求时要使用的 。

getProxyUsername

public String getProxyUsername()

获取经过身份验证的代理的用户名,该用户名将在发出请求时使用。 默认值为 。 若要设置用户名,请使用 setProxyUsername(final String username)

Returns:

发出 String 请求时要使用的 。

getRequestCompletedEventHandler

public StorageEventMultiCaster> getRequestCompletedEventHandler()

获取在请求完成时触发的事件多强制转换器。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>requestCompletedEventHandler 对象。

getRequestResults

public ArrayList getRequestResults()

返回当前操作已创建的请求结果集。

Returns:

一个 ArrayList 对象,它包含表示当前操作创建的请求结果的 RequestResult 对象。

getResponseReceivedEventHandler

public StorageEventMultiCaster> getResponseReceivedEventHandler()

获取在收到响应时触发的事件多强制转换程序。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>responseReceivedEventHandler 对象。

getRetryingEventHandler

public StorageEventMultiCaster> getRetryingEventHandler()

获取重试请求时触发的事件多强制转换程序。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>retryingEventHandler 对象。

getSendingRequestEventHandler

public StorageEventMultiCaster> getSendingRequestEventHandler()

获取发送请求之前触发的事件多强制转换器。 它允许动态添加和删除事件侦听器。

Returns:

用于 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE>sendingRequestEventHandler 对象。

getUserHeaders

public HashMap getUserHeaders()

获取请求的任何其他标头,例如代理或日志记录信息。

Returns:

一个 java.util.HashMap ,其中包含请求的用户标头。

initialize

public void initialize()

保留以供内部使用。 初始化 以开始处理新操作。 将擦除所有特定于操作的信息。

isLoggingEnabled

public boolean isLoggingEnabled()

指示是否为此请求生成日志条目。

Returns:

true 如果启用日志记录,则为 ;否则为 false

isLoggingEnabledByDefault

public static boolean isLoggingEnabledByDefault()

指示客户端库默认情况下是否应生成日志条目。 可以重写默认值,以便使用 setLoggingEnabled(boolean loggingEnabled)为单个操作上下文实例启用日志记录。

Returns:

true 如果默认启用日志记录,则为 ;否则为 false

setClientRequestID

public void setClientRequestID(final String clientRequestID)

设置客户端请求 ID。

Parameters:

clientRequestID - 一个 String ,其中包含要设置的客户端请求 ID。

setClientTimeInMs

public void setClientTimeInMs(final long clientTimeInMs)

保留以供内部使用。 从客户端的角度表示操作延迟(以毫秒为单位)。 这可能包括任何可能的重试。

Parameters:

clientTimeInMs - 一个 , long 它包含客户端操作延迟(以毫秒为单位)。

setDefaultProxy

public static void setDefaultProxy(Proxy defaultProxy)

指定客户端库默认应使用的代理。 可以重写默认值,以便通过使用 setProxy(Proxy proxy)为单个操作上下文实例打开代理。

Parameters:

defaultProxy - 默认 java.net.Proxy 使用的 ,或者 null 不使用代理的 。

setDefaultProxyPassword

public static void setDefaultProxyPassword(final String password)

设置经过身份验证的代理的默认密码,该密码将在发出请求时使用。 默认值为 。

Parameters:

password - 发出 java.lang.String 请求时要使用的 。

setDefaultProxyUsername

public static void setDefaultProxyUsername(final String username)

设置经过身份验证的代理的默认用户名,该用户名将在发出请求时使用。 默认值为 。

Parameters:

username - 发出 java.lang.String 请求时要使用的 。

setErrorReceivingResponseEventHandler

public void setErrorReceivingResponseEventHandler(final StorageEventMultiCaster> errorReceivingResponseEventHandler)

设置在收到 HTTP 响应状态和标头之前发生网络错误时触发的事件多强制转换程序。

Parameters:

errorReceivingResponseEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 errorReceivingResponseEventHandler

setGlobalErrorReceivingResponseEventHandler

public static void setGlobalErrorReceivingResponseEventHandler(final StorageEventMultiCaster> globalErrorReceivingResponseEventHandler)

设置在收到 HTTP 响应状态和标头之前发生网络错误时触发的全局事件多强制转换程序。

Parameters:

globalErrorReceivingResponseEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 globalErrorReceivingResponseEventHandler

setGlobalRequestCompletedEventHandler

public static void setGlobalRequestCompletedEventHandler(final StorageEventMultiCaster> globalRequestCompletedEventHandler)

设置请求完成时触发的全局事件多强制转换程序。

Parameters:

globalRequestCompletedEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 globalRequestCompletedEventHandler

setGlobalResponseReceivedEventHandler

public static void setGlobalResponseReceivedEventHandler(final StorageEventMultiCaster> globalResponseReceivedEventHandler)

设置在收到响应时触发的全局事件多强制转换程序。

Parameters:

globalResponseReceivedEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 globalResponseReceivedEventHandler

setGlobalRetryingEventHandler

public static void setGlobalRetryingEventHandler(final StorageEventMultiCaster> globalRetryingEventHandler)

设置重试请求时触发的全局事件多强制转换程序。

Parameters:

globalRetryingEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 globalRetryingEventHandler

setGlobalSendingRequestEventHandler

public static void setGlobalSendingRequestEventHandler(final StorageEventMultiCaster> globalSendingRequestEventHandler)

设置发送请求之前触发的全局事件多强制转换器。

Parameters:

globalSendingRequestEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 globalSendingRequestEventHandler

setLogger

public void setLogger(final org.slf4j.Logger logger)

org.slf4j.Logger设置此操作的 。

Parameters:

logger - 要 org.slf4j.Logger 用于此操作的 。

setLoggingEnabled

public void setLoggingEnabled(boolean loggingEnabled)

指定是否为此请求生成日志条目。

Parameters:

loggingEnabled -

true 启用日志记录;否则 false 禁用日志记录。

setLoggingEnabledByDefault

public static void setLoggingEnabledByDefault(boolean enableLoggingByDefault)

指定默认情况下客户端库是否应生成日志条目。 可以重写默认值,以使用 setLoggingEnabled(boolean loggingEnabled)为单个操作上下文实例启用日志记录。

Parameters:

enableLoggingByDefault -

true 如果默认应启用日志记录,则为 ;否则 false ,如果默认情况下应禁用日志记录,则为 。

setProxy

public void setProxy(Proxy proxy)

设置在发出请求时将使用的代理。 默认值为 。 若要将代理设置为默认使用,请使用 setDefaultProxy(Proxy defaultProxy)

Parameters:

proxy - 发出 java.net.Proxy 请求时要使用的 。

setProxyPassword

public void setProxyPassword(final String password)

设置经过身份验证的代理的密码,该密码将在发出请求时使用。 默认值为 。

Parameters:

password - 发出 java.lang.String 请求时要使用的 。

setProxyUsername

public void setProxyUsername(final String username)

设置经过身份验证的代理的用户名,该用户名将在发出请求时使用。 默认值为 。

Parameters:

username - 发出 java.lang.String 请求时要使用的 。

setRequestCompletedEventHandler

public void setRequestCompletedEventHandler(final StorageEventMultiCaster> requestCompletedEventHandler)

设置在请求完成时触发的事件多强制转换程序。

Parameters:

requestCompletedEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 requestCompletedEventHandler

setResponseReceivedEventHandler

public void setResponseReceivedEventHandler(final StorageEventMultiCaster> responseReceivedEventHandler)

设置在收到响应时触发的事件多强制转换程序。

Parameters:

responseReceivedEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 responseReceivedEventHandler

setRetryingEventHandler

public void setRetryingEventHandler(final StorageEventMultiCaster> retryingEventHandler)

设置重试请求时触发的事件多强制转换程序。

Parameters:

retryingEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 retryingEventHandler

setSendingRequestEventHandler

public void setSendingRequestEventHandler(final StorageEventMultiCaster> sendingRequestEventHandler)

设置发送请求之前触发的事件多强制转换程序。

Parameters:

sendingRequestEventHandler - 要 StorageEventMultiCaster<EVENT_TYPE,EVENT_LISTENER_TYPE> 为 设置的对象 sendingRequestEventHandler

setUserHeaders

public void setUserHeaders(final HashMap userHeaders)

设置请求的任何其他标头,例如代理或日志记录信息。

Parameters:

userHeaders - 一个 java.util.HashMap ,其中包含要设置的任何其他标头。

适用于