zZzzZ. — /home2/zrzvbdry/public_html/wp-content/plugins/updraftplus/includes/WindowsAzure/Blob/Models

Editing: AccessCondition.php

<?php

/**
 * LICENSE: Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 * 
 * PHP version 5
 *
 * @category Microsoft
 * @package WindowsAzure\Blob\Models
 * @author Azure PHP SDK <azurephpsdk@microsoft.com>
 * @copyright 2012 Microsoft Corporation
 * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
 * @link https://github.com/windowsazure/azure-sdk-for-php
 */
 
namespace WindowsAzure\Blob\Models;
use WindowsAzure\Common\Internal\Resources;
use WindowsAzure\Common\Internal\Validate;
use WindowsAzure\Common\Internal\WindowsAzureUtilities;

/**
 * Represents a set of access conditions to be used for operations against the 
 * storage services.
 *
 * @category Microsoft
 * @package WindowsAzure\Blob\Models
 * @author Azure PHP SDK <azurephpsdk@microsoft.com>
 * @copyright 2012 Microsoft Corporation
 * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
 * @version Release: 0.4.1_2015-03
 * @link https://github.com/windowsazure/azure-sdk-for-php
 */
class AccessCondition
{
 /**
 * Represents the header type.
 * 
 * @var string
 */
 private $_header = Resources::EMPTY_STRING;
 
 /**
 * Represents the header value.
 * 
 * @var string
 */
 private $_value;

/**
 * Constructor
 * 
 * @param string $headerType header name
 * @param string $value header value
 */
 protected function __construct($headerType, $value)
 {
 $this->setHeader($headerType);
 $this->setValue($value);
 }
 
 /**
 * Specifies that no access condition is set.
 * 
 * @return \WindowsAzure\Blob\Models\AccessCondition 
 */
 public static function none()
 {
 return new AccessCondition(Resources::EMPTY_STRING, null);
 }
 
 /**
 * Returns an access condition such that an operation will be performed only if 
 * the resource's ETag value matches the specified ETag value.
 * 
 * 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 
 * <a href= 'http://go.microsoft.com/fwlink/?LinkID=224642&clcid=0x409'>
 * Specifying Conditional Headers for Blob Service Operations</a>.
 *
 * @param string $etag a string that represents the ETag value to check.
 *
 * @return \WindowsAzure\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 
 * <a href= 'http://go.microsoft.com/fwlink/?LinkID=224642&clcid=0x409'>
 * Specifying Conditional Headers for Blob Service Operations</a>.
 *
 * @param \DateTime $lastModified date that represents the last-modified
 * time to check for the resource.
 *
 * @return \WindowsAzure\Blob\Models\AccessCondition
 */
 public static function ifModifiedSince($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 <a href= 'http://go.microsoft.com/fwlink/?LinkID=224642&clcid=0x409'>
 * Specifying Conditional Headers for Blob Service Operations</a>.
 *
 * @param string $etag string that represents the ETag value to check.
 *
 * @return \WindowsAzure\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
 * <a href= 'http://go.microsoft.com/fwlink/?LinkID=224642&clcid=0x409'>
 * Specifying Conditional Headers for Blob Service Operations</a>.
 *
 * @param \DateTime $lastModified date that represents the last-modified
 * time to check for the resource.
 *
 * @return \WindowsAzure\Blob\Models\AccessCondition
 */
 public static function ifNotModifiedSince($lastModified)
 {
 Validate::isDate($lastModified);
 return new AccessCondition(
 Resources::IF_UNMODIFIED_SINCE,
 $lastModified
 );
 }
 
 /**
 * Sets header type
 * 
 * @param string $headerType can be one of Resources
 * 
 * @return none.
 */
 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 none
 */
 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
 * 
 * @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
 ) {
 return true;
 } else {
 return false;
 }
 }
}