include/tools/zcodec.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_TOOLS_ZCODEC_HXX
  21 #define INCLUDED_TOOLS_ZCODEC_HXX
  22
  23 #include <tools/toolsdllapi.h>
  24 #include <tools/long.hxx>
  25 #include <memory>
  26 #include <rtl/string.hxx>
  27
  28 #define ZCODEC_NO_COMPRESSION       0
  29 #define ZCODEC_DEFAULT_COMPRESSION  6
  30
  31 class SvStream;
  32
  33 // The overall client call protocol is one of:
  34 // * BeginCompression, Compress, EndCompression
  35 // * BeginCompression, SetCompressionMetadata, Compress, EndCompression (for gz files)
  36 // * BeginCompression, Decompress, EndCompression
  37 // * BeginCompression, Write*, EndCompression
  38 // * BeginCompression, Read*, EndCompression
  39 // * BeginCompression, ReadAsynchron*, EndCompression
  40 class SAL_WARN_UNUSED TOOLS_DLLPUBLIC ZCodec
  41 {
  42     enum State { STATE_INIT, STATE_DECOMPRESS, STATE_COMPRESS };
  43     State           meState;
  44     bool            mbStatus;
  45     bool            mbFinish;
  46     std::unique_ptr<sal_uInt8[]> mpInBuf;
  47     size_t          mnInBufSize;
  48     size_t          mnInToRead;
  49     SvStream*       mpOStm;
  50     std::unique_ptr<sal_uInt8[]> mpOutBuf;
  51     size_t          mnOutBufSize;
  52     sal_uInt32      mnUncompressedSize;
  53     sal_uInt32      mnInBufCRC32;
  54     sal_uInt32      mnLastModifiedTime;
  55     OString         msFilename;
  56
  57     int             mnCompressLevel;
  58     bool            mbGzLib;
  59     void*           mpsC_Stream;
  60
  61     void            InitCompress();
  62     void            InitDecompress(SvStream & inStream);
  63     void            ImplWriteBack();
  64
  65 public:
  66                     ZCodec( size_t nInBufSize = 32768, size_t nOutBufSize = 32768 );
  67                     ~ZCodec();
  68     /**
  69      * @brief Checks whether a stream is Z compressed
  70      *
  71      * @param rIStm the stream to check
  72      */
  73     static bool IsZCompressed( SvStream& rIStm );
  74
  75     void            BeginCompression( int nCompressLevel = ZCODEC_DEFAULT_COMPRESSION, bool gzLib = false );
  76     tools::Long            EndCompression();
  77
  78     /**
  79      * @brief Set metadata for gzlib compression
  80      *
  81      * @param sFilename the uncompressed file filename
  82      * @param nLastModifiedTime the files last modified time in unix format
  83      */
  84     void            SetCompressionMetadata( const OString& sFilename,
  85                             sal_uInt32 nLastModifiedTime, sal_uInt32 nInBufCRC32 );
  86     void            Compress( SvStream& rIStm, SvStream& rOStm );
  87     tools::Long            Decompress( SvStream& rIStm, SvStream& rOStm );
  88     bool            AttemptDecompression( SvStream& rIStm, SvStream& rOStm );
  89
  90     void            Write( SvStream& rOStm, const sal_uInt8* pData, sal_uInt32 nSize );
  91     tools::Long            Read( SvStream& rIStm, sal_uInt8* pData, sal_uInt32 nSize );
  92 };
  93
  94 #endif
  95
  96 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */