/* Copyright (c) Cloud Software Group, Inc.
*
* Redistribution and use in source and binary forms,
* with or without modification, are permitted provided
* that the following conditions are met:
*
* * Redistributions of source code must retain the above
* copyright notice, this list of conditions and the
* following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the
* following disclaimer in the documentation and/or other
* materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
using System;
using System.IO;
namespace XenCenterLib.Archive
{
///
/// A base abstract class to iterate over an archived file type
///
public abstract class ArchiveIterator : IDisposable
{
///
/// Helper function to extract all contents of this iterating class to a path
///
/// The path to extract the archive to
///
/// If null path is passed in
/// If while combining path and current file name a null arises
public void ExtractAllContents(string pathToExtractTo, Action cancellingDelegate = null)
{
if (string.IsNullOrEmpty(pathToExtractTo))
throw new ArgumentNullException();
while (HasNext())
{
//make the path Windows friendly
var fileName = CurrentFileName();
var isDirectory = IsDirectory();
var sanitizedName = fileName.Replace('/', Path.DirectorySeparatorChar);
var conflatedPath = Path.Combine(pathToExtractTo, sanitizedName);
var dir = isDirectory ? conflatedPath : Path.GetDirectoryName(conflatedPath);
dir = StringUtility.ToLongWindowsPath(dir, true);
//Create directory - empty one will be made too
Directory.CreateDirectory(dir);
//If we have a file extract the contents
if (!isDirectory)
{
conflatedPath = StringUtility.ToLongWindowsPath(conflatedPath, false);
using (var fs = File.Create(conflatedPath))
ExtractCurrentFile(fs, cancellingDelegate);
}
}
}
///
/// Hook to allow the base stream to be wrapped by this class's archive mechanism
///
/// base stream
public virtual void SetBaseStream(Stream stream)
{
throw new NotImplementedException();
}
public virtual bool VerifyCurrentFileAgainstDigest(string algorithmName, byte[] digest)
{
throw new NotImplementedException();
}
public abstract bool HasNext();
public abstract void ExtractCurrentFile(Stream extractedFileContents, Action cancellingDelegate);
public abstract string CurrentFileName();
public abstract long CurrentFileSize();
public abstract DateTime CurrentFileModificationTime();
public abstract bool IsDirectory();
///
/// Dispose hook - overload and clean up IO
///
///
protected virtual void Dispose(bool disposing)
{
}
public void Dispose()
{
Dispose(true);
GC.SuppressFinalize(this);
}
}
}