xestream.hxx

Go to the documentation of this file.

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you 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 .
 */
 
#pragma once
 
#include <map>
#include <stack>
#include <string_view>
 
#include <rtl/strbuf.hxx>
 
#include <oox/core/xmlfilterbase.hxx>
#include <sax/fshelper.hxx>
#include <tools/stream.hxx>
#include <formula/errorcodes.hxx>
#include "ftools.hxx"
#include <types.hxx>
 
#include <filter/msfilter/mscodec.hxx>
#include <vector>
 
namespace com::sun::star::beans { struct NamedValue; }
 
/* ============================================================================
Output stream class for Excel export
- CONTINUE record handling
============================================================================ */
 
class XclExpString;
class XclExpRoot;
class XclExpBiff8Encrypter;
typedef std::shared_ptr< XclExpBiff8Encrypter > XclExpEncrypterRef;
 
class XclExpStream
{
public:
                        XclExpStream(
                            SvStream& rOutStrm,
                            const XclExpRoot& rRoot,
                            sal_uInt16 nMaxRecSize = 0 );
 
                        ~XclExpStream();
 
    const XclExpRoot& GetRoot() const { return mrRoot; }
 
    void                StartRecord( sal_uInt16 nRecId, std::size_t nRecSize );
    void                EndRecord();
 
    sal_uInt16   GetRawRecPos() const { return mnCurrSize; }
 
    void                SetSliceSize( sal_uInt16 nSize );
 
    XclExpStream& operator<<( sal_Int8 nValue );
    XclExpStream& operator<<( sal_uInt8 nValue );
    XclExpStream& operator<<( sal_Int16 nValue );
    XclExpStream& operator<<( sal_uInt16 nValue );
    XclExpStream& operator<<( sal_Int32 nValue );
    XclExpStream& operator<<( sal_uInt32 nValue );
    XclExpStream& operator<<( float fValue );
    XclExpStream& operator<<( double fValue );
 
    std::size_t         Write( const void* pData, std::size_t nBytes );
    void                WriteZeroBytes( std::size_t nBytes );
 
    void                WriteZeroBytesToRecord( std::size_t nBytes );
 
    void                CopyFromStream( SvStream& rInStrm, sal_uInt64 nBytes = STREAM_SEEK_TO_END );
 
    // *** unicode string export is realized with helper class XclExpString ***
    // (slice length setting has no effect here -> disabled automatically)
 
    void                WriteUnicodeBuffer( const ScfUInt16Vec& rBuffer, sal_uInt8 nFlags );
 
    // *** write 8-bit-strings ***
    // (slice length setting has no effect here -> disabled automatically)
 
    void                WriteByteString( const OString& rString );
 
    void                WriteCharBuffer( const ScfUInt8Vec& rBuffer );
 
    // *** SvStream access ***
 
    void                SetSvStreamPos(sal_uInt64 nPos);
    sal_uInt64   GetSvStreamPos() const { return mrStrm.Tell(); }
 
    void                SetEncrypter( XclExpEncrypterRef const & xEncrypter );
 
    bool                HasValidEncrypter() const;
 
    void                EnableEncryption( bool bEnable = true );
 
    void                DisableEncryption();
 
private:
    void                InitRecord( sal_uInt16 nRecId );
    void                UpdateRecSize();
    void                UpdateSizeVars( std::size_t nSize );
    void                StartContinue();
    void                PrepareWrite( sal_uInt16 nSize );
    sal_uInt16          PrepareWrite();
 
    void                WriteRawZeroBytes( std::size_t nBytes );
 
private:
    SvStream&           mrStrm;         
    const XclExpRoot&   mrRoot;         
 
    bool                mbUseEncrypter;
    XclExpEncrypterRef  mxEncrypter;
 
                        // length data
    sal_uInt16          mnMaxRecSize;   
    sal_uInt16          mnMaxContSize;  
    sal_uInt16          mnCurrMaxSize;  
    sal_uInt16          mnMaxSliceSize; 
    sal_uInt16          mnHeaderSize;   
    sal_uInt16          mnCurrSize;     
    sal_uInt16          mnSliceSize;    
    std::size_t         mnPredictSize;   
 
                        // stream position data
    std::size_t         mnLastSizePos;  
    bool                mbInRec;        
};
 
class XclExpBiff8Encrypter
{
public:
    explicit XclExpBiff8Encrypter( const XclExpRoot& rRoot );
    ~XclExpBiff8Encrypter();
 
    bool IsValid() const { return mbValid; }
 
    void GetSaltDigest( sal_uInt8 pnSaltDigest[16] ) const;
    void GetSalt( sal_uInt8 pnSalt[16] ) const;
    void GetDocId( sal_uInt8 pnDocId[16] ) const;
 
    void Encrypt( SvStream& rStrm, sal_uInt8  nData );
    void Encrypt( SvStream& rStrm, sal_uInt16 nData );
    void Encrypt( SvStream& rStrm, sal_uInt32 nData );
 
    void Encrypt( SvStream& rStrm, sal_Int8  nData );
    void Encrypt( SvStream& rStrm, sal_Int16 nData );
    void Encrypt( SvStream& rStrm, sal_Int32 nData );
 
    void Encrypt( SvStream& rStrm, float fValue );
    void Encrypt( SvStream& rStrm, double fValue );
 
    void EncryptBytes( SvStream& rStrm, ::std::vector<sal_uInt8>& aBytes );
 
private:
    void Init( const css::uno::Sequence< css::beans::NamedValue >& aEncryptionData );
 
    static sal_uInt32 GetBlockPos( std::size_t nStrmPos );
    static sal_uInt16 GetOffsetInBlock( std::size_t nStrmPos );
 
private:
    ::msfilter::MSCodec_Std97 maCodec;      
    sal_uInt8           mpnDocId[16];
    sal_uInt8           mpnSalt[16];
    sal_uInt8           mpnSaltDigest[16];
 
    sal_uInt64          mnOldPos;      
    bool                mbValid;
};
 
// `s.GetChar(0) != 0` needed because some strings on export only contain NULL.
#define XESTRING_TO_PSZ(s) \
    (s.Len() && s.GetChar( 0 ) != 0 ? XclXmlUtils::ToOString( s ).getStr() : nullptr)
 
class ScAddress;
class ScDocShell;
class ScFormulaCell;
class ScRange;
class ScRangeList;
class ScTokenArray;
struct XclAddress;
struct XclFontData;
class XclRangeList;
namespace sc { class CompileFormulaContext; }
 
class XclXmlUtils
{
public:
    XclXmlUtils() = delete;
    ~XclXmlUtils() = delete;
    XclXmlUtils(const XclXmlUtils&) = delete;
    XclXmlUtils& operator=(const XclXmlUtils&) = delete;
 
    static void                     GetFormulaTypeAndValue( ScFormulaCell& rCell, const char*& sType, OUString& rValue);
    static OUString          GetStreamName( const char* sStreamDir, const char* sStream, sal_Int32 nId );
 
    static OString ToOString( const Color& rColor );
    static OString ToOString( const ScfUInt16Vec& rBuffer );
    static OStringBuffer& ToOString( OStringBuffer& s, const ScAddress& rRange );
    static OString ToOString( const ScDocument& rDoc, const ScRange& rRange, bool bFullAddressNotation = false );
    static OString ToOString( const ScDocument& rDoc, const ScRangeList& rRangeList );
    static OStringBuffer& ToOString( OStringBuffer& s, const XclAddress& rAddress );
    static OString ToOString( const XclExpString& s );
    static OString ToOString( const ScDocument& rDoc, const XclRangeList& rRangeList );
 
    static OUString ToOUString( const char* s );
    static OUString ToOUString( const ScfUInt16Vec& rBuffer, sal_Int32 nStart = 0, sal_Int32 nLength = -1 );
    static OUString ToOUString( sc::CompileFormulaContext& rCtx, const ScAddress& rAddress,
            const ScTokenArray* pTokenArray, FormulaError nErrCode = FormulaError::NONE );
    static OUString ToOUString( const XclExpString& s );
 
    template <class T>
    static sax_fastparser::FSHelperPtr WriteElement(sax_fastparser::FSHelperPtr pStream, sal_Int32 nElement, const T& value)
    {
        pStream->startElement(nElement);
        pStream->write(value);
        pStream->endElement(nElement);
 
        return pStream;
    }
    static sax_fastparser::FSHelperPtr  WriteFontData( sax_fastparser::FSHelperPtr pStream, const XclFontData& rFontData, sal_Int32 nNameId );
};
 
class XclExpXmlStream : public oox::core::XmlFilterBase
{
public:
    XclExpXmlStream( const css::uno::Reference< css::uno::XComponentContext >& rCC, bool bExportVBA, bool bExportTemplate );
    virtual ~XclExpXmlStream() override;
 
    const XclExpRoot& GetRoot() const { return *mpRoot; }
 
    sax_fastparser::FSHelperPtr& GetCurrentStream();
    void PushStream( sax_fastparser::FSHelperPtr const & aStream );
    void PopStream();
 
    sax_fastparser::FSHelperPtr     GetStreamForPath( const OUString& rPath );
 
    template <typename Str, typename... Args>
    void WriteAttributes(sal_Int32 nAttribute, Str&& value, Args&&... rest)
    {
        WriteAttribute(nAttribute, std::forward<Str>(value));
        if constexpr(sizeof...(rest) > 0)
        {
            // coverity[stray_semicolon : FALSE] - coverity parse error
            WriteAttributes(std::forward<Args>(rest)...);
        }
    }
 
    sax_fastparser::FSHelperPtr     CreateOutputStream (
                                        const OUString& sFullStream,
                                        std::u16string_view sRelativeStream,
                                        const css::uno::Reference< css::io::XOutputStream >& xParentRelation,
                                        const char* sContentType,
                                        std::u16string_view sRelationshipType,
                                        OUString* pRelationshipId = nullptr );
 
    // ignore
    virtual bool exportDocument() override;
 
    // only needed for import; ignore
    virtual bool importDocument() noexcept override;
    virtual oox::vml::Drawing* getVmlDrawing() override;
    virtual const oox::drawingml::Theme* getCurrentTheme() const override;
    virtual oox::drawingml::table::TableStyleListPtr getTableStyles() override;
    virtual oox::drawingml::chart::ChartConverter* getChartConverter() override;
 
private:
    virtual ::oox::ole::VbaProject* implCreateVbaProject() const override;
    virtual OUString SAL_CALL getImplementationName() override;
    ScDocShell *getDocShell();
    void WriteAttribute(sal_Int32 nAttr, std::u16string_view sVal);
    void WriteAttribute(sal_Int32 nAttr, std::string_view sVal)
    {
        WriteAttribute(nAttr, OStringToOUString(sVal, RTL_TEXTENCODING_UTF8));
    }
    void WriteAttribute(sal_Int32 nAttr, const char* sVal)
    {
        if (sVal)
            WriteAttribute(nAttr, OUString(sVal, strlen(sVal), RTL_TEXTENCODING_UTF8));
    }
 
    void validateTabNames(std::vector<OUString>& aOriginalTabNames);
    void restoreTabNames(const std::vector<OUString>& aOriginalTabNames);
    void renameTab(SCTAB aTab, OUString aNewName);
 
    typedef std::map< OUString,
        std::pair< OUString,
            sax_fastparser::FSHelperPtr > >     XclExpXmlPathToStateMap;
 
    const XclExpRoot*                           mpRoot;
    std::stack< sax_fastparser::FSHelperPtr >   maStreams;
    XclExpXmlPathToStateMap                     maOpenedStreamMap;
 
    bool mbExportVBA;
    bool mbExportTemplate;
};
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */