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

AccessCondition 类

  • 参考
包:
com.microsoft.azure.storage
  • java.lang.Object
    • com.microsoft.azure.storage.AccessCondition

public class AccessCondition

表示要用于对存储服务执行的操作的访问条件集。

构造函数摘要

构造函数 说明
AccessCondition()

创建 类的实例。

方法摘要

修饰符和类型 方法和描述
void applyAppendConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将访问条件应用于请求。
void applyConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将访问条件应用于请求。
void applyLeaseConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将租约访问条件应用于请求。
void applySequenceConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将序列号访问条件应用于请求。
void applySourceConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将源访问条件应用于请求。
AccessCondition generateEmptyCondition()

生成新的空 AccessCondition。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。
AccessCondition generateIfExistsCondition()

返回一个访问条件，以便仅在服务上存在资源时才执行操作。

设置此访问条件会将请求修改为包含 HTTP If-Match 条件标头。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。
AccessCondition generateIfMatchCondition(final String etag)

返回一个访问条件，以便仅在资源的 ETag 值与指定的 ETag 值匹配时执行操作。

设置此访问条件会将请求修改为包含 HTTP If-Match 条件标头。 如果设置了此访问条件，则仅当资源的 ETag 与指定的 ETag 匹配时，才会执行该操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。
AccessCondition generateIfModifiedSinceCondition(final Date lastMotified)

返回一个访问条件，以便仅当资源自指定时间以来已修改时才执行操作。

设置此访问条件会将请求修改为包含 HTTP If-Modified-Since 条件标头。 如果设置了此访问条件，则仅当自指定时间以来修改了资源时才执行该操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。
AccessCondition generateIfNoneMatchCondition(final String etag)

返回一个访问条件，以便仅在资源的 ETag 值与指定的 ETag 值不匹配时执行操作。

设置此访问条件会将请求修改为包含 HTTP If-None-Match 条件标头。 如果设置了此访问条件，则仅当资源的 ETag 与指定的 ETag 不匹配时，才会执行该操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。
AccessCondition generateIfNotExistsCondition()

返回一个访问条件，以便仅在服务上不存在资源时执行操作。

设置此访问条件会将请求修改为包含 HTTP If-None-Match 条件标头。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。
AccessCondition generateIfNotModifiedSinceCondition(final Date lastMotified)

返回一个访问条件，以便仅当自指定时间以来未修改资源时才执行操作。

设置此访问条件会将请求修改为包含 HTTP If-Unmodified-Since 条件标头。 如果设置了此访问条件，则仅当自指定时间以来未修改资源时才执行该操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。
AccessCondition generateIfSequenceNumberEqualCondition(long sequenceNumber)

返回一个访问条件，以便仅在资源的当前序列号等于指定值时执行操作。 此条件仅适用于页 Blob。
AccessCondition generateIfSequenceNumberLessThanCondition(long sequenceNumber)

返回一个访问条件，以便仅在资源的当前序列号小于指定值时执行操作。 此条件仅适用于页 Blob。
AccessCondition generateIfSequenceNumberLessThanOrEqualCondition(long sequenceNumber)

返回一个访问条件，以便仅在资源的当前序列号小于或等于指定值时执行操作。 此条件仅适用于页 Blob。
AccessCondition generateLeaseCondition(final String leaseID)

返回一个访问条件，以便仅当资源在指定的租约 ID 下可访问时才执行操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。
Long getIfAppendPositionEqual()

获取仅用于追加操作的条件标头的值。 一个数字，指示要为其检查字节偏移量。 仅当结束位置等于此数字时，追加才会成功。
String getIfMatch()

获取设置 If-Match 条件时的 ETag。
Long getIfMaxSizeLessThanOrEqual()

获取仅用于追加操作的条件标头的值。 一个数字，指示提交块时要限制 Blob 的最大长度（以字节为单位）。
Date getIfModifiedSinceDate()

获取 If-Modified-Since 日期。
String getIfNoneMatch()

设置 If-None-Match 条件时获取 ETag。
Long getIfSequenceNumberEqual()

设置序列号相等条件时获取序列号。 此条件仅适用于页 Blob。
Long getIfSequenceNumberLessThan()

获取序列号小于条件设置时的序列号。 此条件仅适用于页 Blob。
Long getIfSequenceNumberLessThanOrEqual()

获取序列号小于或等于条件设置时的序列号。 此条件仅适用于页 Blob。
Date getIfUnmodifiedSinceDate()

获取 If-Unmodified-Since 日期。
String getLeaseID()

获取租约 ID。
void setIfAppendPositionEqual(Long ifAppendPositionEqual)

设置仅用于追加操作的条件标头的值。 一个数字，指示要为其检查字节偏移量。 仅当结束位置等于此数字时，追加才会成功。
void setIfMatch(String etag)

设置 If-Match 条件的 ETag。
void setIfMaxSizeLessThanOrEqual(Long ifMaxSizeLessThanOrEqual)

设置仅用于追加操作的条件标头的值。 一个数字，指示提交块时要限制 Blob 的最大长度（以字节为单位）。
void setIfModifiedSinceDate(Date ifModifiedSinceDate)

设置 If-Modified-Since 日期。
void setIfNoneMatch(String etag)

设置 If-None-Match 条件的 ETag。
void setIfSequenceNumberEqual(Long sequenceNumber)

设置序列号等于条件的序列号。 此条件仅适用于页 Blob。
void setIfSequenceNumberLessThan(Long sequenceNumber)

设置序列号小于条件的序列号。 此条件仅适用于页 Blob。
void setIfSequenceNumberLessThanOrEqual(Long sequenceNumber)

设置序列号小于或等于条件的序列号。 此条件仅适用于页 Blob。
void setIfUnmodifiedSinceDate(Date ifUnmodifiedSinceDate)

设置 If-Unmodified-Since 日期。
void setLeaseID(String leaseID)

获取租约 ID。
boolean verifyConditional(final String etag, final Date lastModified)

保留供内部使用。 验证条件是否满足。

构造函数详细信息

AccessCondition

public AccessCondition()

创建 类的实例。

方法详细信息

applyAppendConditionToRequest

public void applyAppendConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将访问条件应用于请求。

Parameters:

request - 一个 java.net.HttpURLConnection 对象，表示要对其应用条件的请求。

applyConditionToRequest

public void applyConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将访问条件应用于请求。

Parameters:

request - 一个 java.net.HttpURLConnection 对象，表示要对其应用条件的请求。

applyLeaseConditionToRequest

public void applyLeaseConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将租约访问条件应用于请求。

Parameters:

request - 一个 java.net.HttpURLConnection 对象，表示要对其应用条件的请求。

applySequenceConditionToRequest

public void applySequenceConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将序列号访问条件应用于请求。

Parameters:

request - 一个 java.net.HttpURLConnection 对象，表示要对其应用条件的请求。

applySourceConditionToRequest

public void applySourceConditionToRequest(final HttpURLConnection request)

保留供内部使用。 将源访问条件应用于请求。

Parameters:

request - 一个 java.net.HttpURLConnection 对象，表示要对其应用条件的请求。

generateEmptyCondition

public static AccessCondition generateEmptyCondition()

生成新的空 AccessCondition。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。

Returns:

一个 AccessCondition 未设置条件的对象。

generateIfExistsCondition

public static AccessCondition generateIfExistsCondition()

返回一个访问条件，以便仅在服务上存在资源时才执行操作。

设置此访问条件会将请求修改为包含 HTTP If-Match 条件标头。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。

Returns:

一个 AccessCondition 对象，该对象表示如果存在条件。

generateIfMatchCondition

public static AccessCondition generateIfMatchCondition(final String etag)

返回一个访问条件，以便仅在资源的 ETag 值与指定的 ETag 值匹配时执行操作。

设置此访问条件会将请求修改为包含 HTTP If-Match 条件标头。 如果设置了此访问条件，则仅当资源的 ETag 与指定的 ETag 匹配时，才会执行该操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。

Parameters:

etag - 一个 String ，表示要检查的 ETag 值。

Returns:

一个 AccessCondition 表示 If-Match 条件的 对象。

generateIfModifiedSinceCondition

public static AccessCondition generateIfModifiedSinceCondition(final Date lastMotified)

返回一个访问条件，以便仅当资源自指定时间以来已修改时才执行操作。

设置此访问条件会将请求修改为包含 HTTP If-Modified-Since 条件标头。 如果设置了此访问条件，则仅当自指定时间以来修改了资源时才执行该操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。

Parameters:

lastMotified - 一个 java.util.Date 对象，表示上次修改后的资源检查时间。

Returns:

一个 AccessCondition 表示 If-Modified-Since 条件的对象。

generateIfNoneMatchCondition

public static AccessCondition generateIfNoneMatchCondition(final String etag)

返回一个访问条件，以便仅在资源的 ETag 值与指定的 ETag 值不匹配时执行操作。

设置此访问条件会将请求修改为包含 HTTP If-None-Match 条件标头。 如果设置了此访问条件，则仅当资源的 ETag 与指定的 ETag 不匹配时，才会执行该操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。

Parameters:

etag - 一个 String ，表示要检查的 ETag 值。

Returns:

一个 AccessCondition 表示 If-None-Match 条件的 对象。

generateIfNotExistsCondition

public static AccessCondition generateIfNotExistsCondition()

返回一个访问条件，以便仅在服务上不存在资源时执行操作。

设置此访问条件会将请求修改为包含 HTTP If-None-Match 条件标头。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。

Returns:

一个 AccessCondition 对象，该对象表示如果不存在条件。

generateIfNotModifiedSinceCondition

public static AccessCondition generateIfNotModifiedSinceCondition(final Date lastMotified)

返回一个访问条件，以便仅当自指定时间以来未修改资源时才执行操作。

设置此访问条件会将请求修改为包含 HTTP If-Unmodified-Since 条件标头。 如果设置了此访问条件，则仅当自指定时间以来未修改资源时才执行该操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。

Parameters:

lastMotified - 一个 java.util.Date 对象，表示上次修改后的资源检查时间。

Returns:

一个 AccessCondition 表示 If-Unmodified-Since 条件的 对象。

generateIfSequenceNumberEqualCondition

public static AccessCondition generateIfSequenceNumberEqualCondition(long sequenceNumber)

返回一个访问条件，以便仅在资源的当前序列号等于指定值时执行操作。 此条件仅适用于页 Blob。

Parameters:

sequenceNumber - 要与当前序列号比较的值。

Returns:

一个 AccessCondition 表示 If-Sequence-Number-EQ 条件的对象。

generateIfSequenceNumberLessThanCondition

public static AccessCondition generateIfSequenceNumberLessThanCondition(long sequenceNumber)

返回一个访问条件，以便仅在资源的当前序列号小于指定值时执行操作。 此条件仅适用于页 Blob。

Parameters:

sequenceNumber - 要与当前序列号比较的值。

Returns:

一个 AccessCondition 表示 If-Sequence-Number-LT 条件的 对象。

generateIfSequenceNumberLessThanOrEqualCondition

public static AccessCondition generateIfSequenceNumberLessThanOrEqualCondition(long sequenceNumber)

返回一个访问条件，以便仅在资源的当前序列号小于或等于指定值时执行操作。 此条件仅适用于页 Blob。

Parameters:

sequenceNumber - 要与当前序列号比较的值。

Returns:

一个 AccessCondition 表示 If-Sequence-Number-LE 条件的 对象。

generateLeaseCondition

public static AccessCondition generateLeaseCondition(final String leaseID)

返回一个访问条件，以便仅当资源在指定的租约 ID 下可访问时才执行操作。

有关详细信息，请参阅为 Blob 服务操作指定条件标头。

Parameters:

leaseID - 要指定的租约 ID。

Returns:

一个 AccessCondition表示租约条件的对象。

getIfAppendPositionEqual

public Long getIfAppendPositionEqual()

获取仅用于追加操作的条件标头的值。 一个数字，指示要为其检查字节偏移量。 仅当结束位置等于此数字时，追加才会成功。

Returns:

追加位置编号;如果不存在条件， null 则为 。

getIfMatch

public String getIfMatch()

获取设置 If-Match 条件时的 ETag。

Returns:

设置 If-Match 条件时的 ETag;否则为 null。

getIfMaxSizeLessThanOrEqual

public Long getIfMaxSizeLessThanOrEqual()

获取仅用于追加操作的条件标头的值。 一个数字，指示提交块时要限制 Blob 的最大长度（以字节为单位）。

Returns:

最大大小; null 如果没有条件，则为 。

getIfModifiedSinceDate

public Date getIfModifiedSinceDate()

获取 If-Modified-Since 日期。

Returns:

一个 java.util.Date 表示 If-Modified-Since 日期的 对象。

getIfNoneMatch

public String getIfNoneMatch()

设置 If-None-Match 条件时获取 ETag。

Returns:

设置 If-None-Match 条件时的 ETag;否则为 null。

getIfSequenceNumberEqual

public Long getIfSequenceNumberEqual()

设置序列号相等条件时获取序列号。 此条件仅适用于页 Blob。

Returns:

设置 ifSequenceNumberEqual 条件时的序列号;否则 null

getIfSequenceNumberLessThan

public Long getIfSequenceNumberLessThan()

获取序列号小于条件设置时的序列号。 此条件仅适用于页 Blob。

Returns:

设置 ifSequenceNumberLessThan 条件时的序列号;否则 null

getIfSequenceNumberLessThanOrEqual

public Long getIfSequenceNumberLessThanOrEqual()

获取序列号小于或等于条件设置时的序列号。 此条件仅适用于页 Blob。

Returns:

设置 ifSequenceNumberLessThanOrEqual 条件时的序列号;否则 null

getIfUnmodifiedSinceDate

public Date getIfUnmodifiedSinceDate()

获取 If-Unmodified-Since 日期。

Returns:

一个 java.util.Date 表示 If-Unmodified-Since 日期的 对象。

getLeaseID

public String getLeaseID()

获取租约 ID。

Returns:

租约 ID。

setIfAppendPositionEqual

public void setIfAppendPositionEqual(Long ifAppendPositionEqual)

设置仅用于追加操作的条件标头的值。 一个数字，指示要为其检查字节偏移量。 仅当结束位置等于此数字时，追加才会成功。

Parameters:

ifAppendPositionEqual - 追加位置编号;如果不存在条件， null 则为 。

setIfMatch

public void setIfMatch(String etag)

设置 If-Match 条件的 ETag。

Parameters:

etag - 要为 If-Match 条件设置的 ETag。

setIfMaxSizeLessThanOrEqual

public void setIfMaxSizeLessThanOrEqual(Long ifMaxSizeLessThanOrEqual)

设置仅用于追加操作的条件标头的值。 一个数字，指示提交块时要限制 Blob 的最大长度（以字节为单位）。

Parameters:

ifMaxSizeLessThanOrEqual - 最大大小; null 如果没有条件，则为 。

setIfModifiedSinceDate

public void setIfModifiedSinceDate(Date ifModifiedSinceDate)

设置 If-Modified-Since 日期。

Parameters:

ifModifiedSinceDate - 一个 java.util.Date 对象，表示要设置的 If-Modified-Since 。

setIfNoneMatch

public void setIfNoneMatch(String etag)

设置 If-None-Match 条件的 ETag。

Parameters:

etag - 要为 If-None-Match 条件设置的 ETag。

setIfSequenceNumberEqual

public void setIfSequenceNumberEqual(Long sequenceNumber)

设置序列号等于条件的序列号。 此条件仅适用于页 Blob。

Parameters:

sequenceNumber - 要设置 if 序列号等于条件的序列号。

setIfSequenceNumberLessThan

public void setIfSequenceNumberLessThan(Long sequenceNumber)

设置序列号小于条件的序列号。 此条件仅适用于页 Blob。

Parameters:

sequenceNumber - 要设置 if 序列号小于条件的序列号。

setIfSequenceNumberLessThanOrEqual

public void setIfSequenceNumberLessThanOrEqual(Long sequenceNumber)

设置序列号小于或等于条件的序列号。 此条件仅适用于页 Blob。

Parameters:

sequenceNumber - 要设置 if 序列号小于或等于条件的序列号。

setIfUnmodifiedSinceDate

public void setIfUnmodifiedSinceDate(Date ifUnmodifiedSinceDate)

设置 If-Unmodified-Since 日期。

Parameters:

ifUnmodifiedSinceDate - 一个 java.util.Date 对象，表示要设置的 If-Unmodified-Since 。

setLeaseID

public void setLeaseID(String leaseID)

获取租约 ID。

Parameters:

leaseID - 要设置的租约 ID。

verifyConditional

public boolean verifyConditional(final String etag, final Date lastModified)

保留供内部使用。 验证条件是否满足。

Parameters:

etag - 一个 String ，表示要检查的 ETag。
lastModified - 一个 java.util.Date 表示上次修改日期/时间的 对象。

Returns:

true 如果满足条件，则为 ;否则为 false。

适用于