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

MatchConditions Class

  • java.lang.Object
    • com.azure.core.http.MatchConditions

public class MatchConditions

Specifies HTTP options for conditional requests based on ETag matching.

This class encapsulates the ETag conditions that can be used in a request, such as If-Match and If-None-Match.

This class is useful when you want to create an HTTP request with conditional headers based on ETag matching. For example, you can use it to create a GET request that only retrieves the resource if it has not been modified (based on the ETag), or a PUT request that only updates the resource if it has not been modified by another client (based on the ETag).

Constructor Summary

Constructor Description
MatchConditions()

Creates a new instance of MatchConditions.

Method Summary

Modifier and Type Method and Description
String getIfMatch()

Gets the ETag that resources must match.

String getIfNoneMatch()

Gets the ETag that resources must not match.

MatchConditions setIfMatch(String ifMatch)

Optionally limit requests to resources that match the passed ETag.

MatchConditions setIfNoneMatch(String ifNoneMatch)

Optionally limit requests to resources that do not match the passed ETag.

Methods inherited from java.lang.Object

Constructor Details

MatchConditions

public MatchConditions()

Creates a new instance of MatchConditions.

Method Details

getIfMatch

public String getIfMatch()

Gets the ETag that resources must match.

Returns:

The ETag that resources must match.

getIfNoneMatch

public String getIfNoneMatch()

Gets the ETag that resources must not match.

Returns:

The ETag that resources must not match.

setIfMatch

public MatchConditions setIfMatch(String ifMatch)

Optionally limit requests to resources that match the passed ETag.

Parameters:

ifMatch - ETag that resources must match.

Returns:

The updated MatchConditions object.

setIfNoneMatch

public MatchConditions setIfNoneMatch(String ifNoneMatch)

Optionally limit requests to resources that do not match the passed ETag.

Parameters:

ifNoneMatch - ETag that resources must not match.

Returns:

The updated MatchConditions object.

Applies to