Package com.azure.core.http

Class RequestConditions

java.lang.Object
com.azure.core.http.MatchConditions
com.azure.core.http.RequestConditions
public class RequestConditions extends MatchConditions

Specifies HTTP options for conditional requests based on modification time and ETag matching.

This class extends MatchConditions and adds conditions based on the modification time of the resource. It encapsulates conditions such as If-Modified-Since and If-Unmodified-Since, in addition to If-Match and If-None-Match from MatchConditions.

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

See Also:

  • Constructor Details

    • RequestConditions

      public RequestConditions()
      Creates a new instance of RequestConditions.

  • Method Details

    • setIfMatch

      public RequestConditions setIfMatch(String ifMatch)
      Optionally limit requests to resources that match the passed ETag.
      Overrides:
      setIfMatch in class MatchConditions
      Parameters:
      ifMatch - ETag that resources must match.
      Returns:
      The updated ResourceConditions object.

    • setIfNoneMatch

      public RequestConditions setIfNoneMatch(String ifNoneMatch)
      Optionally limit requests to resources that do not match the passed ETag.
      Overrides:
      setIfNoneMatch in class MatchConditions
      Parameters:
      ifNoneMatch - ETag that resources must not match.
      Returns:
      The updated ResourceConditions object.

    • getIfModifiedSince

      public OffsetDateTime getIfModifiedSince()
      Gets the datetime that resources must have been modified since.
      Returns:
      The datetime that resources must have been modified since.

    • setIfModifiedSince

      public RequestConditions setIfModifiedSince(OffsetDateTime ifModifiedSince)
      Optionally limit requests to resources that have only been modified since the passed datetime.
      Parameters:
      ifModifiedSince - The datetime that resources must have been modified since.
      Returns:
      The updated ResourceConditions object.

    • getIfUnmodifiedSince

      public OffsetDateTime getIfUnmodifiedSince()
      Gets the datetime that resources must have remained unmodified since.
      Returns:
      The datetime that resources must have remained unmodified since.

    • setIfUnmodifiedSince

      public RequestConditions setIfUnmodifiedSince(OffsetDateTime ifUnmodifiedSince)
      Optionally limit requests to resources that have remained unmodified since the passed datetime.
      Parameters:
      ifUnmodifiedSince - The datetime that resources must have remained unmodified since.
      Returns:
      The updated ResourceConditions object.