/// <summary>
/// An alternate method for downloading storage objects from cloudfiles directly to a file name specified in the method
/// </summary>
/// <example>
/// <code>
/// UserCredentials userCredentials = new UserCredentials("username", "api key");
/// IConnection connection = new Connection(userCredentials);
/// Dictionary{RequestHeaderFields, string} requestHeaderFields = Dictionary{RequestHeaderFields, string}();
/// string dummy_etag = "5c66108b7543c6f16145e25df9849f7f";
/// requestHeaderFields.Add(RequestHeaderFields.IfMatch, dummy_etag);
/// requestHeaderFields.Add(RequestHeaderFields.IfNoneMatch, dummy_etag);
/// requestHeaderFields.Add(RequestHeaderFields.IfModifiedSince, DateTime.Now.AddDays(6).ToString());
/// requestHeaderFields.Add(RequestHeaderFields.IfUnmodifiedSince, DateTime.Now.AddDays(-6).ToString());
/// requestHeaderFields.Add(RequestHeaderFields.Range, "0-5");
/// StorageItem storageItem = connection.GetStorageItem("container name", "RemoteFileName.txt", "C:\Local\File\Path\file.txt", requestHeaderFields);
/// </code>
/// </example>
/// <param name="containerName">The name of the container that contains the storage object to retrieve</param>
/// <param name="storageItemName">The name of the storage object to retrieve</param>
/// <param name="localFileName">The file name to save the storage object into on disk</param>
/// <param name="requestHeaderFields">A dictionary containing the special headers and their values</param>
/// <exception cref="ArgumentNullException">Thrown when any of the reference parameters are null</exception>
public void GetStorageItem(string containerName, string storageItemName, string localFileName, Dictionary<RequestHeaderFields, string> requestHeaderFields)
{
if (string.IsNullOrEmpty(containerName) ||
string.IsNullOrEmpty(storageItemName) ||
string.IsNullOrEmpty(localFileName))
throw new ArgumentNullException();
Log.Info(this, "Getting storage item "
+ storageItemName + " with request Header fields in container '"
+ containerName + "' for user "
+ UserCredentials.Username + " and name it "
+ localFileName + " locally");
var getStorageItem = new GetStorageItem(StorageUrl, AuthToken, containerName, storageItemName, requestHeaderFields);
try
{
var getStorageItemResponse = new ResponseFactoryWithContentBody<GetStorageItemResponse>().Create(new CloudFilesRequest(getStorageItem, UserCredentials.ProxyCredentials));
foreach (var callback in callbackFuncs)
{
getStorageItemResponse.Progress += callback;
}
getStorageItemResponse.SaveStreamToDisk(localFileName);
}
catch (WebException we)
{
Log.Error(this, "Error getting storage item "
+ storageItemName + " with request Header fields in container '"
+ containerName + "' for user "
+ UserCredentials.Username, we);
HttpWebResponse response = (HttpWebResponse)we.Response;
response.Close();
if (response.StatusCode == HttpStatusCode.NotFound)
throw new StorageItemNotFoundException("The requested storage object does not exist");
throw;
}
}
