rename SequenceNumberCondition to IfSequenceNumber (per #951) (#954)

Author: bmc-msft

sdk/core/src/request_options/if_sequence_number.rs

@@ -0,0 +1,39 @@
+use crate::{headers, Header};
+
+/// Conditional request header based on the value of the object's sequence number
+///
+/// Ref: <https://docs.microsoft.com/en-us/rest/api/storageservices/put-page-from-url>
+#[derive(Debug, Clone, Copy, PartialEq)]
+pub enum IfSequenceNumber {
+    /// If the object's sequence number is less than the specified value, the
+    /// request proceeds; otherwise it fails with SequenceNumberConditionNotMet
+    /// error (HTTP status code 412 – Precondition Failed).
+    LessThan(u64),
+    /// If the object's sequence number is less than or equal to the specified
+    /// value, the request proceeds; otherwise it fails with the
+    /// SequenceNumberConditionNotMet error (HTTP status code 412 – Precondition
+    /// Failed).
+    LessOrEqual(u64),
+    /// If the object’s sequence number is equal to the specified value, the
+    /// request proceeds; otherwise it fails with SequenceNumberConditionNotMet
+    /// error (HTTP status code 412 – Precondition Failed).
+    Equal(u64),
+}
+
+impl Header for IfSequenceNumber {
+    fn name(&self) -> headers::HeaderName {
+        match self {
+            IfSequenceNumber::Equal(_) => headers::IF_SEQUENCE_NUMBER_EQ,
+            IfSequenceNumber::LessOrEqual(_) => headers::IF_SEQUENCE_NUMBER_LE,
+            IfSequenceNumber::LessThan(_) => headers::IF_SEQUENCE_NUMBER_LT,
+        }
+    }
+
+    fn value(&self) -> headers::HeaderValue {
+        match self {
+            IfSequenceNumber::Equal(val)
+            | IfSequenceNumber::LessOrEqual(val)
+            | IfSequenceNumber::LessThan(val) => val.to_string().into(),
+        }
+    }
+}

sdk/core/src/request_options/mod.rs

@@ -15,6 +15,7 @@ mod delimiter;
 mod if_match_condition;
 mod if_modified_since;
 mod if_modified_since_condition;
+mod if_sequence_number;
 mod if_source_match_condition;
 mod if_source_modified_since_condition;
 mod lease;
@@ -28,7 +29,6 @@ mod prefix;
 mod proposed_lease_id;
 mod range;
 mod sequence_number;
-mod sequence_number_condition;
 mod source_lease_id;
 mod timeout;
 mod user;
@@ -52,6 +52,7 @@ pub use delimiter::Delimiter;
 pub use if_match_condition::IfMatchCondition;
 pub use if_modified_since::IfModifiedSince;
 pub use if_modified_since_condition::IfModifiedSinceCondition;
+pub use if_sequence_number::IfSequenceNumber;
 pub use if_source_match_condition::IfSourceMatchCondition;
 pub use if_source_modified_since_condition::IfSourceModifiedSinceCondition;
 pub use lease::LeaseId;
@@ -65,7 +66,6 @@ pub use prefix::Prefix;
 pub use proposed_lease_id::ProposedLeaseId;
 pub use range::Range;
 pub use sequence_number::SequenceNumber;
-pub use sequence_number_condition::SequenceNumberCondition;
 pub use source_lease_id::SourceLeaseId;
 pub use timeout::Timeout;
 pub use user::User;

sdk/core/src/request_options/sequence_number_condition.rs

@@ -74,7 +74,7 @@ async fn main() -> azure_core::Result<()> {
     let res = blob_client
         .put_page(BA512Range::new(512, 1023)?, slice)
         .hash(digest)
-        .if_sequence_number(SequenceNumberCondition::Equal(100))
+        .if_sequence_number(IfSequenceNumber::Equal(100))
         .into_future()
         .await?;
     println!("update sequence number condition == {:?}", res);

sdk/storage_blobs/examples/put_page_blob_00.rs

@@ -10,7 +10,7 @@ operation! {
     ClearPage,
     client: BlobClient,
     ba512_range: BA512Range,
-    ?if_sequence_number: SequenceNumberCondition,
+    ?if_sequence_number: IfSequenceNumber,
     ?if_modified_since: IfModifiedSinceCondition,
     ?if_match: IfMatchCondition,
     ?lease_id: LeaseId

sdk/storage_blobs/src/blob/operations/clear_page.rs

@@ -13,7 +13,7 @@ operation! {
     client: BlobClient,
     source_url: Url,
     ?metadata: Metadata,
-    ?if_sequence_number: SequenceNumberCondition,
+    ?if_sequence_number: IfSequenceNumber,
     ?if_modified_since: IfModifiedSinceCondition,
     ?if_match: IfMatchCondition,
     ?if_tags: IfTagsCondition,

sdk/storage_blobs/src/blob/operations/copy_blob.rs

@@ -9,7 +9,7 @@ operation! {
     ba512_range: BA512Range,
     content: Body,
     ?hash: Hash,
-    ?if_sequence_number: SequenceNumberCondition,
+    ?if_sequence_number: IfSequenceNumber,
     ?if_modified_since: IfModifiedSinceCondition,
     ?if_match: IfMatchCondition,
     ?if_tags: IfTagsCondition,