* Setting this access condition modifies the request to include the HTTP * If-Match conditional header. If this access condition is set, the * operation is performed only if the ETag of the resource matches the specified * ETag. *

* For more information, see * * Specifying Conditional Headers for Blob Service Operations. * * @param string $etag a string that represents the ETag value to check. * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function ifMatch($etag) { return new AccessCondition(Resources::IF_MATCH, $etag); } /** * Returns an access condition such that an operation will be performed only if * the resource has been modified since the specified time. *

* Setting this access condition modifies the request to include the HTTP * If-Modified-Since conditional header. If this access condition is set, * the operation is performed only if the resource has been modified since the * specified time. *

* For more information, see * * Specifying Conditional Headers for Blob Service Operations. * * @param \DateTime $lastModified date that represents the last-modified * time to check for the resource. * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function ifModifiedSince(\DateTime $lastModified) { Validate::isDate($lastModified); return new AccessCondition( Resources::IF_MODIFIED_SINCE, $lastModified ); } /** * Returns an access condition such that an operation will be performed only if * the resource's ETag value does not match the specified ETag value. *

* Setting this access condition modifies the request to include the HTTP * If-None-Match conditional header. If this access condition is set, the * operation is performed only if the ETag of the resource does not match the * specified ETag. *

* For more information, * see * Specifying Conditional Headers for Blob Service Operations. * * @param string $etag string that represents the ETag value to check. * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function ifNoneMatch($etag) { return new AccessCondition(Resources::IF_NONE_MATCH, $etag); } /** * Returns an access condition such that an operation will be performed only if * the resource has not been modified since the specified time. *

* Setting this access condition modifies the request to include the HTTP * If-Unmodified-Since conditional header. If this access condition is * set, the operation is performed only if the resource has not been modified * since the specified time. *

* For more information, see * * Specifying Conditional Headers for Blob Service Operations. * * @param \DateTime $lastModified date that represents the last-modified * time to check for the resource. * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function ifNotModifiedSince(\DateTime $lastModified) { Validate::isDate($lastModified); return new AccessCondition( Resources::IF_UNMODIFIED_SINCE, $lastModified ); } /** * Returns an access condition such that an operation will be performed only if * the operation would cause the blob to exceed that limit or if the append * position is equal to this number. *

* Setting this access condition modifies the request to include the HTTP * x-ms-blob-condition-appendpos conditional header. If this access condition * is set, the operation is performed only if the append position is equal to this number *

* For more information, * see * Specifying Conditional Headers for Blob Service Operations. * * @param int $appendPosition int that represents the append position * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function appendPosition($appendPosition) { return new AccessCondition(Resources::MAX_APPEND_POSITION, $appendPosition); } /** * Returns an access condition such that an operation will be performed only if * the operation would cause the blob to exceed that limit or if the blob size * is already greater than the value specified in this header. *

* Setting this access condition modifies the request to include the HTTP * x-ms-blob-condition-maxsize conditional header. If this access condition * is set, the operation is performed only if the operation would cause the blob * to exceed that limit or if the blob size is already greater than the value * specified in this header. *

* For more information, * see * Specifying Conditional Headers for Blob Service Operations. * * @param int $maxBlobSize int that represents the max blob size * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function maxBlobSize($maxBlobSize) { return new AccessCondition(Resources::MAX_BLOB_SIZE, $maxBlobSize); } /** * Returns an access condition such that an operation will be performed only if * the blob’s sequence number is less than the specified value. *

* Setting this access condition modifies the request to include the HTTP * x-ms-if-sequence-number-lt conditional header. If this access condition * is set, the operation is performed only if the blob’s sequence number is less * than the specified value. *

* For more information, * see * Specifying Conditional Headers for Blob Service Operations. * * @param int $sequenceNumber int that represents the sequence number value to check. * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function ifSequenceNumberLessThan($sequenceNumber) { return new AccessCondition(Resources::SEQUENCE_NUMBER_LESS_THAN, $sequenceNumber); } /** * Returns an access condition such that an operation will be performed only if * the blob’s sequence number is equal to the specified value. *

* Setting this access condition modifies the request to include the HTTP * x-ms-if-sequence-number-eq conditional header. If this access condition * is set, the operation is performed only if the blob’s sequence number is equal to * the specified value. *

* For more information, * see * Specifying Conditional Headers for Blob Service Operations. * * @param int $sequenceNumber int that represents the sequence number value to check. * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function ifSequenceNumberEqual($sequenceNumber) { return new AccessCondition(Resources::SEQUENCE_NUMBER_EQUAL, $sequenceNumber); } /** * Returns an access condition such that an operation will be performed only if * the blob’s sequence number is less than or equal to the specified value. *

* Setting this access condition modifies the request to include the HTTP * x-ms-if-sequence-number-le conditional header. If this access condition * is set, the operation is performed only if the blob’s sequence number is less * than or equal to the specified value. *

* For more information, * see * Specifying Conditional Headers for Blob Service Operations. * * @param int $sequenceNumber int that represents the sequence number value to check. * * @return \MicrosoftAzure\Storage\Blob\Models\AccessCondition */ public static function ifSequenceNumberLessThanOrEqual($sequenceNumber) { return new AccessCondition(Resources::SEQUENCE_NUMBER_LESS_THAN_OR_EQUAL, $sequenceNumber); } /** * Sets header type * * @param string $headerType can be one of Resources * * @return void */ public function setHeader($headerType) { $valid = AccessCondition::isValid($headerType); Validate::isTrue($valid, Resources::INVALID_HT_MSG); $this->_header = $headerType; } /** * Gets header type * * @return string */ public function getHeader() { return $this->_header; } /** * Sets the header value * * @param string $value the value to use * * @return void */ public function setValue($value) { $this->_value = $value; } /** * Gets the header value * * @return string */ public function getValue() { return $this->_value; } /** * Check if the $headerType belongs to valid header types * * @param string $headerType candidate header type * * @internal * * @return boolean */ public static function isValid($headerType) { if ($headerType == Resources::EMPTY_STRING || $headerType == Resources::IF_UNMODIFIED_SINCE || $headerType == Resources::IF_MATCH || $headerType == Resources::IF_MODIFIED_SINCE || $headerType == Resources::IF_NONE_MATCH || $headerType == Resources::MAX_BLOB_SIZE || $headerType == Resources::MAX_APPEND_POSITION || $headerType == Resources::SEQUENCE_NUMBER_LESS_THAN_OR_EQUAL || $headerType == Resources::SEQUENCE_NUMBER_LESS_THAN || $headerType == Resources::SEQUENCE_NUMBER_EQUAL ) { return true; } else { return false; } } }