#pragma region CPL License
/*
Nuclex Native Framework
Copyright (C) 2002-2013 Nuclex Development Labs

This library is free software; you can redistribute it and/or
modify it under the terms of the IBM Common Public License as
published by the IBM Corporation; either version 1.0 of the
License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
IBM Common Public License for more details.

You should have received a copy of the IBM Common Public
License along with this library
*/
#pragma endregion // CPL License

#ifndef NUCLEX_STORAGE_FILESYSTEM_SEVENZIP_SEVENZIPPEDFILE_H
#define NUCLEX_STORAGE_FILESYSTEM_SEVENZIP_SEVENZIPPEDFILE_H

#include "Nuclex/Storage/Config.h"
#include "../Generic/GenericArchivedFile.h"

namespace Nuclex { namespace Storage { namespace FileSystem { namespace SevenZip {

  // ------------------------------------------------------------------------------------------- //

  class SevenZipArchiveContainer;
  class SevenZipReader;

  // ------------------------------------------------------------------------------------------- //

}}}} // namespace Nuclex::Storage::FileSystem::Zip

namespace Nuclex { namespace Storage { namespace FileSystem { namespace SevenZip {

  // ------------------------------------------------------------------------------------------- //

  /// <summary>File stored in a 7-zip archive</summary>
  class SevenZippedFile : public GenericArchivedFile {

    #pragma region struct MetaData

    /// <summary>Data about the compressed file</summary>
    public: struct MetaData {

      /// <summary>Index of the file within the archive</summary>
      public: std::size_t Index;
      /// <summary>Full path of the file in the native system</summary>
      public: std::string NativePath;
      /// <summary>Name of the file</summary>
      public: std::string Filename;
      /// <summary>Length of the file when it is uncompressed</summary>
      public: std::uint64_t UncompressedSize;
      /// <summary>Time at which the file has been last modified</summary>
      public: std::time_t LastModificationTime;
      
      /// <summary>Index of the solid block containing the file</summary>
      public: std::size_t SolidBlockIndex;
      /// <summary>Offset of the file within the uncompressed solid block</summary>
      public: std::uint64_t SolidBlockOffset;

    };

    #pragma endregion // struct MetaData

    /// <summary>Initializes a new file stored in a 7-zip archive</summary>
    /// <param name="zipReader">Cached reader for the file's contents</param>
    /// <param name="metaData">Data describing the compressed file</param>
    public: SevenZippedFile(
      const std::shared_ptr<SevenZipReader> &sevenZipReader,
      const MetaData &metaData
    );

    /// <summary>Frees all resources owned by the instance</summary>
    public: virtual ~SevenZippedFile();

    /// <summary>Determines the size of the file</summary>
    /// <returns>The size of the file in bytes</returns>
    public: std::uint64_t GetSize() const { return this->metaData.UncompressedSize; }

    /// <summary>Returns the name of the file</summary>
    /// <returns>The file's name</returns>
    public: const std::string &GetName() const { return this->metaData.Filename; }

    /// <summary>Returns the path the file is stored at in the native format</summary>
    /// <returns>The file's absolute path in the native OS format</returns>
    public: const std::string &GetNativePath() const { return this->metaData.NativePath; }

    /// <summary>Retrieves the time at which the file has been last modified</summary>
    /// <returns>The since since the last modification of the file took place</returns>
    public: std::time_t GetLastModificationTime() const {
      return this->metaData.LastModificationTime;
    }

    /// <summary>Reads raw data from the file</summary>
    /// <param name="location">Absolute file position data will be read from</param>
    /// <param name="buffer">Buffer into which data will be read</param>
    /// <param name="count">Number of bytes that will be read</param>
    public: void ReadAt(
      std::uint64_t location, void *buffer, std::size_t count
    ) const;

    /// <summary>Decompresses data from the 7-zip archive</summary>
    private: std::shared_ptr<SevenZipReader> sevenZipReader;
    /// <summary>Describing informations about the compressed file</summary>
    private: MetaData metaData;

  };

  // ------------------------------------------------------------------------------------------- //

}}}} // namespace Nuclex::Storage::FileSystem::SevenZip

#endif // NUCLEX_STORAGE_FILESYSTEM_SEVENZIP_SEVENZIPPEDFILE_H