include/xmloff/xmlictxt.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_XMLOFF_XMLICTXT_HXX
  21 #define INCLUDED_XMLOFF_XMLICTXT_HXX
  22
  23 #include <sal/config.h>
  24 #include <xmloff/dllapi.h>
  25 #include <sal/types.h>
  26 #include <com/sun/star/xml/sax/XAttributeList.hpp>
  27 #include <com/sun/star/xml/sax/XFastContextHandler.hpp>
  28 #include <tools/ref.hxx>
  29 #include <rtl/ustring.hxx>
  30 #include <cppuhelper/implbase.hxx>
  31 #include <xmloff/nmspmap.hxx>
  32 #include <memory>
  33
  34 class SvXMLNamespaceMap;
  35 class SvXMLImport;
  36
  37 class XMLOFF_DLLPUBLIC SvXMLImportContext : public cppu::WeakImplHelper< css::xml::sax::XFastContextHandler >
  38 {
  39     friend class SvXMLImport;
  40
  41     SvXMLImport& mrImport;
  42
  43     sal_uInt16       mnPrefix;
  44     OUString maLocalName;
  45
  46     std::unique_ptr<SvXMLNamespaceMap> m_pRewindMap;
  47
  48     SAL_DLLPRIVATE std::unique_ptr<SvXMLNamespaceMap> TakeRewindMap() { return std::move(m_pRewindMap); }
  49     SAL_DLLPRIVATE void PutRewindMap(std::unique_ptr<SvXMLNamespaceMap> p) { m_pRewindMap = std::move(p); }
  50
  51 protected:
  52
  53     SvXMLImport& GetImport() { return mrImport; }
  54     const SvXMLImport& GetImport() const { return mrImport; }
  55
  56 public:
  57
  58     sal_uInt16 GetPrefix() const { return mnPrefix; }
  59     const OUString& GetLocalName() const { return maLocalName; }
  60
  61     /** A contexts constructor does anything that is required if an element
  62      * starts. Namespace processing has been done already.
  63      * Note that virtual methods cannot be used inside constructors. Use
  64      * StartElement instead if this is required. */
  65     SvXMLImportContext( SvXMLImport& rImport, sal_uInt16 nPrfx,
  66                         const OUString& rLName );
  67
  68     SvXMLImportContext( SvXMLImport& rImport );
  69
  70     /** A contexts destructor does anything that is required if an element
  71      * ends. By default, nothing is done.
  72      * Note that virtual methods cannot be used inside destructors. Use
  73      * EndElement instead if this is required. */
  74     virtual ~SvXMLImportContext() override;
  75
  76     /** Create a children element context. By default, the import's
  77      * CreateContext method is called to create a new default context. */
  78     virtual SvXMLImportContext *CreateChildContext( sal_uInt16 nPrefix,
  79                                    const OUString& rLocalName,
  80                                    const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList );
  81
  82     /** StartElement is called after a context has been constructed and
  83      * before a elements context is parsed. It may be used for actions that
  84      * require virtual methods. The default is to do nothing. */
  85     virtual void StartElement( const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList );
  86
  87     /** EndElement is called before a context will be destructed, but
  88      * after a elements context has been parsed. It may be used for actions
  89      * that require virtual methods. The default is to do nothing. */
  90     virtual void EndElement();
  91
  92     /** This method is called for all characters that are contained in the
  93      * current element. The default is to ignore them. */
  94     virtual void Characters( const OUString& rChars );
  95
  96     // css::xml::sax::XFastContextHandler:
  97     virtual void SAL_CALL startFastElement (sal_Int32 Element,
  98         const css::uno::Reference< css::xml::sax::XFastAttributeList >& Attribs) override;
  99
 100     virtual void SAL_CALL startUnknownElement(const OUString & Namespace, const OUString & Name,
 101         const css::uno::Reference< css::xml::sax::XFastAttributeList > & Attribs) override;
 102
 103     virtual void SAL_CALL endFastElement(sal_Int32 Element) override;
 104
 105     virtual void SAL_CALL endUnknownElement(const OUString & Namespace, const OUString & Name) override;
 106
 107     virtual css::uno::Reference< XFastContextHandler >  SAL_CALL createFastChildContext(sal_Int32 Element,
 108         const css::uno::Reference<css::xml::sax::XFastAttributeList>& Attribs) override;
 109
 110     virtual css::uno::Reference< css::xml::sax::XFastContextHandler > SAL_CALL createUnknownChildContext(
 111         const OUString & Namespace, const OUString & Name,
 112         const css::uno::Reference< css::xml::sax::XFastAttributeList > & Attribs) override;
 113
 114     virtual void SAL_CALL characters(const OUString & aChars) override;
 115
 116     void AddFirstRef();
 117     void AddNextRef();
 118     void ReleaseRef();
 119 };
 120
 121 typedef rtl::Reference<SvXMLImportContext> SvXMLImportContextRef;
 122
 123 #endif // INCLUDED_XMLOFF_XMLICTXT_HXX
 124
 125 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */