/* -*- 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 . */ #ifndef INCLUDED_XMLOFF_XMLEXP_HXX #define INCLUDED_XMLOFF_XMLEXP_HXX #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include class SvXMLNamespaceMap; class SvXMLAttributeList; class SvXMLExport_Impl; class SvXMLUnitConverter; class ProgressBarHelper; class XMLEventExport; class XMLSettingsExportHelper; class XMLImageMapExport; class XMLErrors; class LanguageTag; enum class SvXMLErrorFlags; // Shapes in Writer cannot be named via context menu (#i51726#) #include namespace com { namespace sun { namespace star { namespace frame { class XModel; } namespace container { class XIndexContainer; } namespace lang { struct Locale; } } } } namespace comphelper { class UnoInterfaceToUniqueIdentifierMapper; } enum class SvXMLExportFlags { NONE = 0, META = 0x0001, STYLES = 0x0002, MASTERSTYLES = 0x0004, AUTOSTYLES = 0x0008, CONTENT = 0x0010, SCRIPTS = 0x0020, SETTINGS = 0x0040, FONTDECLS = 0x0080, EMBEDDED = 0x0100, NODOCTYPE = 0x0200, PRETTY = 0x0400, SAVEBACKWARDCOMPATIBLE = 0x0800, OASIS = 0x8000, ALL = 0x0fff }; namespace o3tl { template<> struct typed_flags : is_typed_flags {}; } class XMLOFF_DLLPUBLIC SvXMLExport : public ::cppu::WeakImplHelper6< css::document::XFilter, css::lang::XServiceInfo, css::document::XExporter, css::lang::XInitialization, css::container::XNamed, css::lang::XUnoTunnel> { std::unique_ptr mpImpl; // dummy css::uno::Reference< css::uno::XComponentContext > m_xContext; OUString m_implementationName; css::uno::Reference< css::frame::XModel > mxModel; css::uno::Reference< css::xml::sax::XDocumentHandler > mxHandler; // the handlers css::uno::Reference< css::xml::sax::XExtendedDocumentHandler > mxExtHandler; css::uno::Reference< css::util::XNumberFormatsSupplier > mxNumberFormatsSupplier; css::uno::Reference< css::document::XGraphicObjectResolver > mxGraphicResolver; css::uno::Reference< css::document::XEmbeddedObjectResolver > mxEmbeddedResolver; css::uno::Reference< css::task::XStatusIndicator > mxStatusIndicator; css::uno::Reference< css::beans::XPropertySet > mxExportInfo; css::uno::Reference< css::lang::XEventListener > mxEventListener; SvXMLAttributeList *mpAttrList; // a common attribute list css::uno::Reference< css::xml::sax::XAttributeList > mxAttrList; // and an interface of it OUString msOrigFileName; // the original URL OUString msGraphicObjectProtocol; OUString msEmbeddedObjectProtocol; OUString msFilterName; SvXMLNamespaceMap *mpNamespaceMap; // the namepspace map SvXMLUnitConverter *mpUnitConv; // the unit converter SvXMLNumFmtExport *mpNumExport; ProgressBarHelper *mpProgressBarHelper; rtl::Reference< XMLTextParagraphExport > mxTextParagraphExport; rtl::Reference< XMLShapeExport > mxShapeExport; rtl::Reference< SvXMLAutoStylePoolP > mxAutoStylePool; rtl::Reference< SchXMLExportHelper > mxChartExport; rtl::Reference< XMLPageExport > mxPageExport; rtl::Reference< XMLFontAutoStylePool > mxFontAutoStylePool; rtl::Reference< xmloff::OFormLayerXMLExport > mxFormExport; XMLEventExport* mpEventExport; XMLImageMapExport* mpImageMapExport; XMLErrors* mpXMLErrors; const enum ::xmloff::token::XMLTokenEnum meClass; SAL_DLLPRIVATE void _InitCtor(); SvXMLExportFlags mnExportFlags; SvXMLErrorFlags mnErrorFlags; public: const OUString msWS; // " " private: // Shapes in Writer cannot be named via context menu (#i51726#) SvtModuleOptions::EFactory meModelType; SAL_DLLPRIVATE void _DetermineModelType(); SAL_DLLPRIVATE void ImplExportMeta(); // SAL_DLLPRIVATE void ImplExportSettings(); // SAL_DLLPRIVATE void ImplExportStyles( bool bUsed ); // SAL_DLLPRIVATE void ImplExportAutoStyles( bool bUsed ); // SAL_DLLPRIVATE void ImplExportMasterStyles( bool bUsed ); // SAL_DLLPRIVATE void ImplExportContent(); // virtual void SetBodyAttributes(); void GetViewSettingsAndViews(css::uno::Sequence& rProps); protected: void setExportFlags( SvXMLExportFlags nExportFlags ) { mnExportFlags = nExportFlags; } // Get (modifyable) namespace map SvXMLNamespaceMap& _GetNamespaceMap() { return *mpNamespaceMap; } // get a new namespave map (used in starmath to have a default namespace) void ResetNamespaceMap(); /// Override this method to export the content of . /// There is a default implementation. virtual void _ExportMeta(); /// Override this method to export the content of . /// There is a default implementation. virtual void _ExportScripts(); /// Override this method to export the font declarations /// The default implementation will export the contents of the /// XMLFontAutoStylePool if it has been created. virtual void _ExportFontDecls(); /// Override this method to export the content of . /// If bUsed is set, used styles should be exported only. /// Overriding Methods must call this method ! virtual void _ExportStyles( bool bUsed ); /// Override this method to export the contents of . virtual void _ExportAutoStyles() = 0; /// Override this method to export the contents of . virtual void _ExportMasterStyles() = 0; /// Override this method to export the content of . virtual void _ExportContent() = 0; OUString GetSourceShellID() const; OUString GetDestinationShellID() const; // save linked sections? (may be false in global documents) bool mbSaveLinkedSections; virtual XMLTextParagraphExport* CreateTextParagraphExport(); virtual XMLShapeExport* CreateShapeExport(); virtual SvXMLAutoStylePoolP* CreateAutoStylePool(); SchXMLExportHelper* CreateChartExport(); virtual XMLPageExport* CreatePageExport(); virtual XMLFontAutoStylePool* CreateFontAutoStylePool(); xmloff::OFormLayerXMLExport* CreateFormExport(); virtual void GetViewSettings(css::uno::Sequence& aProps); virtual void GetConfigurationSettings(css::uno::Sequence& aProps); struct SettingsGroup { ::xmloff::token::XMLTokenEnum eGroupName; css::uno::Sequence< css::beans::PropertyValue > aSettings; SettingsGroup() :eGroupName( ::xmloff::token::XML_TOKEN_INVALID ) ,aSettings() { } SettingsGroup( const ::xmloff::token::XMLTokenEnum _eGroupName, const css::uno::Sequence< css::beans::PropertyValue >& _rSettings ) :eGroupName( _eGroupName ) ,aSettings( _rSettings ) { } }; /** returns the current document settings The default implementation will obtain the view settings by calling GetViewSettingsAndViews, and the configuration settings by calling GetConfigurationSettings, and return them together with the proper XML token. @return the accumulated count of all settings in all groups */ virtual sal_Int32 GetDocumentSpecificSettings( ::std::list< SettingsGroup >& _out_rSettings ); const css::uno::Reference< css::document::XEmbeddedObjectResolver >& GetEmbeddedResolver() const { return mxEmbeddedResolver; } inline void SetEmbeddedResolver( css::uno::Reference< css::document::XEmbeddedObjectResolver >& _xEmbeddedResolver ); const css::uno::Reference< css::document::XGraphicObjectResolver >& GetGraphicResolver() const { return mxGraphicResolver; } void SetGraphicResolver( css::uno::Reference< css::document::XGraphicObjectResolver >& _xGraphicResolver ); void SetDocHandler( const css::uno::Reference< css::xml::sax::XDocumentHandler > &rHandler ); public: SvXMLExport( sal_Int16 const eDefaultMeasureUnit /*css::util::MeasureUnit*/, const css::uno::Reference< css::uno::XComponentContext >& xContext, OUString const & implementationName, const enum ::xmloff::token::XMLTokenEnum eClass = xmloff::token::XML_TOKEN_INVALID, SvXMLExportFlags nExportFlag = SvXMLExportFlags::ALL ); SvXMLExport( const css::uno::Reference< css::uno::XComponentContext >& xContext, OUString const & implementationName, const OUString& rFileName, sal_Int16 const eDefaultMeasureUnit /*css::util::MeasureUnit*/, const css::uno::Reference< css::xml::sax::XDocumentHandler > & rHandler); SvXMLExport( const css::uno::Reference< css::uno::XComponentContext >& xContext, OUString const & implementationName, const OUString& rFileName, const css::uno::Reference< css::xml::sax::XDocumentHandler > & rHandler, const css::uno::Reference< css::frame::XModel > &, FieldUnit const eDefaultFieldUnit ); virtual ~SvXMLExport(); static const css::uno::Sequence< sal_Int8 > & getUnoTunnelId() throw(); static SvXMLExport* getImplementation( css::uno::Reference< css::uno::XInterface > ) throw(); // XExporter virtual void SAL_CALL setSourceDocument( const css::uno::Reference< css::lang::XComponent >& xDoc ) throw(css::lang::IllegalArgumentException, css::uno::RuntimeException, std::exception) override; // XFilter virtual sal_Bool SAL_CALL filter( const css::uno::Sequence< css::beans::PropertyValue >& aDescriptor ) throw(css::uno::RuntimeException, std::exception) override; virtual void SAL_CALL cancel() throw(css::uno::RuntimeException, std::exception) override; // XInitialization virtual void SAL_CALL initialize( const css::uno::Sequence< css::uno::Any >& aArguments ) throw(css::uno::Exception, css::uno::RuntimeException, std::exception) override; // XNamed virtual OUString SAL_CALL getName( ) throw (css::uno::RuntimeException, std::exception) override; virtual void SAL_CALL setName( const OUString& aName ) throw (css::uno::RuntimeException, std::exception) override; // XServiceInfo virtual OUString SAL_CALL getImplementationName( ) throw(css::uno::RuntimeException, std::exception) final override; virtual sal_Bool SAL_CALL supportsService( const OUString& ServiceName ) throw(css::uno::RuntimeException, std::exception) final override; virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames( ) throw(css::uno::RuntimeException, std::exception) final override; // XUnoTunnel virtual sal_Int64 SAL_CALL getSomething( const css::uno::Sequence< sal_Int8 >& aIdentifier ) throw(css::uno::RuntimeException, std::exception) override; /** ensures that the given namespace is in scope at the next started element.

If the namespace is not yet declared, the necessary attribute will be added, as well.

@param i_rNamespace the namespace to be declared @param i_rPreferredPrefix (opt.) preferred prefix for the namespace @returns the actual prefix that the namespace is associated with */ OUString EnsureNamespace(OUString const & i_rNamespace, OUString const & i_rPreferredPrefix = OUString("gen") ); // Check if common attribute list is empty. #ifndef DBG_UTIL void CheckAttrList() { (void) this; /* avoid loplugin:staticmethods */ } #else void CheckAttrList(); #endif // Clear common attribute list. void ClearAttrList(); // Add an attribute to the common attribute list. void AddAttributeASCII( sal_uInt16 nPrefix, const sal_Char *pName, const sal_Char *pValue ); void AddAttribute( sal_uInt16 nPrefix, const sal_Char *pName, const OUString& rValue ); void AddAttribute( sal_uInt16 nPrefix, const OUString& rName, const OUString& rValue ); void AddAttribute( sal_uInt16 nPrefix, enum ::xmloff::token::XMLTokenEnum eName, const OUString& rValue ); void AddAttribute( sal_uInt16 nPrefix, enum ::xmloff::token::XMLTokenEnum eName, enum ::xmloff::token::XMLTokenEnum eValue ); void AddAttribute( const OUString& rQName, const OUString& rValue ); void AddAttribute( const OUString& rQName, enum ::xmloff::token::XMLTokenEnum eValue ); /** Add language tag attributes, deciding which are necessary. @param nPrefix Namespace prefix for *:language, *:script and *:country @param nPrefixRfc Namespace prefix for *:rfc-language-tag @param bWriteEmpty Whether to write empty *:language and *:country attribute values in case of an empty locale (denoting system). @param eClass default, XML_LANGUAGE: XML_SCRIPT, XML_COUNTRY, XML_RFC_LANGUAGE_TAG XML_LANGUAGE_ASIAN: XML_SCRIPT_ASIAN, XML_COUNTRY_ASIAN, XML_RFC_LANGUAGE_TAG_ASIAN also switches nPrefix XML_NAMESPACE_FO to XML_NAMESPACE_STYLE XML_LANGUAGE_COMPLEX: XML_SCRIPT_COMPLEX, XML_COUNTRY_COMPLEX, XML_RFC_LANGUAGE_TAG_COMPLEX also switches nPrefix XML_NAMESPACE_FO to XML_NAMESPACE_STYLE */ void AddLanguageTagAttributes( sal_uInt16 nPrefix, sal_uInt16 nPrefixRfc, const css::lang::Locale& rLocale, bool bWriteEmpty, enum ::xmloff::token::XMLTokenEnum eClass = ::xmloff::token::XML_LANGUAGE ); /** Same as AddLanguageTagAttributes() but with LanguageTag parameter instead of Locale. */ void AddLanguageTagAttributes( sal_uInt16 nPrefix, sal_uInt16 nPrefixRfc, const LanguageTag& rLanguageTag, bool bWriteEmpty, enum ::xmloff::token::XMLTokenEnum eClass = ::xmloff::token::XML_LANGUAGE ); // add several attributes to the common attribute list void AddAttributeList( const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList ); // Get common attribute list as implementation or interface. SvXMLAttributeList &GetAttrList() { return *mpAttrList; } const css::uno::Reference< css::xml::sax::XAttributeList > & GetXAttrList() { return mxAttrList; } // Get document handler. This methods are not const, because the // reference allowes modifications through the handler. const css::uno::Reference< css::xml::sax::XDocumentHandler > & GetDocHandler() { return mxHandler; } // Get original URL. const OUString& GetOrigFileName() const { return msOrigFileName; } // Get (const) namespace map. const SvXMLNamespaceMap& GetNamespaceMap() const { return *mpNamespaceMap; } // Get unit converter const SvXMLUnitConverter& GetMM100UnitConverter() const { return *mpUnitConv; } SvXMLUnitConverter& GetMM100UnitConverter() { return *mpUnitConv; } void addChaffWhenEncryptedStorage(); // Export the document. virtual sal_uInt32 exportDoc( enum ::xmloff::token::XMLTokenEnum eClass = ::xmloff::token::XML_TOKEN_INVALID ); virtual void addDataStyle(const sal_Int32 nNumberFormat, bool bTimeFormat = false ); virtual void exportDataStyles(); virtual void exportAutoDataStyles(); virtual OUString getDataStyleName(const sal_Int32 nNumberFormat, bool bTimeFormat = false ) const; sal_Int32 dataStyleForceSystemLanguage(sal_Int32 nFormat) const; virtual void exportAnnotationMeta( const css::uno::Reference < css::drawing::XShape >& xShape); // Get XModel const css::uno::Reference< css::frame::XModel > & GetModel() const { return mxModel; } // Get XNumberFormatsSupplier css::uno::Reference< css::util::XNumberFormatsSupplier > & GetNumberFormatsSupplier() { return mxNumberFormatsSupplier; } inline void SetNumberFormatsSupplier(const css::uno::Reference< css::util::XNumberFormatsSupplier >& _xNumberFormatSupplier) { mxNumberFormatsSupplier = _xNumberFormatSupplier; if ( mxNumberFormatsSupplier.is() && mxHandler.is() ) mpNumExport = new SvXMLNumFmtExport(*this, mxNumberFormatsSupplier); } // get export helper for text inline rtl::Reference< XMLTextParagraphExport > GetTextParagraphExport(); // get export helper for shapes inline rtl::Reference< XMLShapeExport > GetShapeExport(); // get auto style pool inline rtl::Reference< SvXMLAutoStylePoolP > GetAutoStylePool(); // get Page Export inline rtl::Reference< XMLPageExport > GetPageExport(); // get chart export helper inline rtl::Reference< SchXMLExportHelper > GetChartExport(); // get font auto style pool inline rtl::Reference< XMLFontAutoStylePool > GetFontAutoStylePool(); ProgressBarHelper* GetProgressBarHelper(); // get Formlayer Export inline rtl::Reference< xmloff::OFormLayerXMLExport > GetFormExport(); inline bool HasFormExport(); // get XPropertySet with export information inline css::uno::Reference< css::beans::XPropertySet > getExportInfo() const { return mxExportInfo; } css::uno::Reference< css::task::XStatusIndicator > GetStatusIndicator() { return mxStatusIndicator; } /// get Event export, with handlers for script types "None" and /// "StarBasic" already registered; other handlers may be registered, too. XMLEventExport& GetEventExport(); /// get the export for image maps XMLImageMapExport& GetImageMapExport(); OUString AddEmbeddedGraphicObject( const OUString& rGraphicObjectURL ); bool AddEmbeddedGraphicObjectAsBase64( const OUString& rGraphicObjectURL ); OUString AddEmbeddedObject( const OUString& rEmbeddedObjectURL ); bool AddEmbeddedObjectAsBase64( const OUString& rEmbeddedObjectURL ); OUString EncodeStyleName( const OUString& rName, bool *pEncoded=nullptr ) const; // save linked sections? inline bool IsSaveLinkedSections() { return mbSaveLinkedSections; } // get export flags SvXMLExportFlags getExportFlags() const { return mnExportFlags; } void ExportEmbeddedOwnObject( css::uno::Reference& rComp ); OUString GetRelativeReference(const OUString& rValue); // methods for accessing the document handler and handling SAX errors void StartElement(sal_uInt16 nPrefix, enum ::xmloff::token::XMLTokenEnum eName, bool bIgnWSOutside ); void StartElement(const OUString& rName, bool bIgnWSOutside ); void Characters(const OUString& rChars); void EndElement(sal_uInt16 nPrefix, enum ::xmloff::token::XMLTokenEnum eName, bool bIgnWSInside ); void EndElement(const OUString& rName, bool bIgnWSInside ); void IgnorableWhitespace(); /** * Record an error condition that occurred during export. The * behavior of SetError can be modified using the error flag * constants. */ void SetError( /// error ID, may contain an error flag sal_Int32 nId, /// string parameters for the error message const css::uno::Sequence< OUString> & rMsgParams, /// original exception message (if applicable) const OUString& rExceptionMessage, /// error location (if applicable) const css::uno::Reference & rLocator ); void SetError( sal_Int32 nId, const css::uno::Sequence< OUString> & rMsgParams); /** return current error flags (logical 'or' of all error flags so far) */ SvXMLErrorFlags GetErrorFlags() { return mnErrorFlags; } virtual void DisposingModel(); ::comphelper::UnoInterfaceToUniqueIdentifierMapper& getInterfaceToIdentifierMapper(); css::uno::Reference< css::uno::XComponentContext > getComponentContext() { return m_xContext;} // Shapes in Writer cannot be named via context menu (#i51726#) SvtModuleOptions::EFactory GetModelType() const { return meModelType; } // Written OpenDocument file format doesn't fit to the created text document (#i69627#) bool writeOutlineStyleAsNormalListStyle() const; css::uno::Reference< css::embed::XStorage > GetTargetStorage(); /// returns the currently configured default version for odf export SvtSaveOptions::ODFDefaultVersion getDefaultVersion() const; /// returns the deterministic version for odf export SvtSaveOptions::ODFSaneDefaultVersion getSaneDefaultVersion() const; /// name of stream in package, e.g., "content.xml" OUString GetStreamName() const; // FIXME: this is only for legacy stuff that has not yet been adapted // to implement XMetadatable; this can write duplicate IDs! /// add xml:id and legacy namespace id void SAL_DLLPRIVATE AddAttributeIdLegacy( sal_uInt16 const nLegacyPrefix, OUString const& rValue); /// add xml:id attribute (for RDF metadata) void AddAttributeXmlId(css::uno::Reference const & i_xIfc); /// add RDFa attributes for a metadatable text content void AddAttributesRDFa( css::uno::Reference const & i_xTextContent); bool exportTextNumberElement() const; /// set null date from model to unit converter, if not already done bool SetNullDateOnUnitConverter(); }; inline rtl::Reference< XMLTextParagraphExport > SvXMLExport::GetTextParagraphExport() { if( !mxTextParagraphExport.is() ) mxTextParagraphExport = CreateTextParagraphExport(); return mxTextParagraphExport; } inline rtl::Reference< XMLShapeExport > SvXMLExport::GetShapeExport() { if( !mxShapeExport.is() ) mxShapeExport = CreateShapeExport(); return mxShapeExport; } inline rtl::Reference< SvXMLAutoStylePoolP > SvXMLExport::GetAutoStylePool() { if( !mxAutoStylePool.is() ) mxAutoStylePool = CreateAutoStylePool(); return mxAutoStylePool; } inline rtl::Reference< SchXMLExportHelper > SvXMLExport::GetChartExport() { if( !mxChartExport.is() ) mxChartExport = CreateChartExport(); return mxChartExport; } inline rtl::Reference< XMLPageExport > SvXMLExport::GetPageExport() { if( !mxPageExport.is() ) mxPageExport = CreatePageExport(); return mxPageExport; } inline rtl::Reference< XMLFontAutoStylePool > SvXMLExport::GetFontAutoStylePool() { if( !mxFontAutoStylePool.is() ) mxFontAutoStylePool = CreateFontAutoStylePool(); return mxFontAutoStylePool; } inline rtl::Reference< xmloff::OFormLayerXMLExport > SvXMLExport::GetFormExport() { if( !mxFormExport.is() ) mxFormExport = CreateFormExport(); return mxFormExport; } inline bool SvXMLExport::HasFormExport() { return mxFormExport.is(); } inline void SvXMLExport::SetEmbeddedResolver( css::uno::Reference< css::document::XEmbeddedObjectResolver >& _xEmbeddedResolver ) { mxEmbeddedResolver = _xEmbeddedResolver; } inline void SvXMLExport::SetGraphicResolver( css::uno::Reference< css::document::XGraphicObjectResolver >& _xGraphicResolver ) { mxGraphicResolver = _xGraphicResolver; } // Helper class to export an element. class XMLOFF_DLLPUBLIC SvXMLElementExport { SvXMLExport& mrExport; OUString maElementName; const bool mbIgnoreWhitespaceInside :1; const bool mbDoSomething :1; SAL_DLLPRIVATE void StartElement( const sal_uInt16 nPrefix, const OUString& rName, const bool bIgnoreWhitespaceOutside ); public: // The constructor prints a start tag that has the common attributes // of the XMLExport instance attached. SvXMLElementExport( SvXMLExport& rExp, sal_uInt16 nPrefix, const sal_Char *pName, bool bIgnWSOutside, bool bIgnWSInside ); SvXMLElementExport( SvXMLExport& rExp, sal_uInt16 nPrefix, const OUString& rName, bool bIgnWSOutside, bool bIgnWSInside ); SvXMLElementExport( SvXMLExport& rExp, sal_uInt16 nPrefix, enum ::xmloff::token::XMLTokenEnum eName, bool bIgnWSOutside, bool bIgnWSInside ); SvXMLElementExport( SvXMLExport& rExp, const OUString& rQName, bool bIgnWSOutside, bool bIgnWSInside ); // Thes constructors do nothing if bDoSomething is not set SvXMLElementExport( SvXMLExport& rExp, bool bDoSomething, sal_uInt16 nPrefix, enum ::xmloff::token::XMLTokenEnum eName, bool bIgnWSOutside, bool bIgnWSInside ); // The destructor prints an end tag. ~SvXMLElementExport(); }; #endif // _XMLOFF_SVXMLEXP_HXX /* vim:set shiftwidth=4 softtabstop=4 expandtab: */