include/sax/fastattribs.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_SAX_FASTATTRIBS_HXX
  21 #define INCLUDED_SAX_FASTATTRIBS_HXX
  22
  23 #include <com/sun/star/xml/sax/XFastAttributeList.hpp>
  24
  25 #include <cppuhelper/implbase.hxx>
  26 #include <sax/saxdllapi.h>
  27
  28 #include <vector>
  29
  30 namespace com { namespace sun { namespace star { namespace xml { namespace sax { class XFastTokenHandler; } } } } }
  31 namespace com { namespace sun { namespace star { namespace xml { struct Attribute; } } } }
  32 namespace com { namespace sun { namespace star { namespace xml { struct FastAttribute; } } } }
  33
  34 namespace sax_fastparser
  35 {
  36
  37 struct UnknownAttribute
  38 {
  39     OUString const maNamespaceURL;
  40     OString const maName;
  41     OString const maValue;
  42
  43     UnknownAttribute( const OUString& rNamespaceURL, const OString& rName, const OString& value );
  44     UnknownAttribute( const OString& rName, const OString& value );
  45
  46     void FillAttribute( css::xml::Attribute* pAttrib ) const;
  47 };
  48
  49 typedef std::vector< UnknownAttribute > UnknownAttributeList;
  50
  51 /// A native C++ interface to tokenisation
  52 class SAX_DLLPUBLIC FastTokenHandlerBase
  53 {
  54  public:
  55     virtual ~FastTokenHandlerBase();
  56     virtual sal_Int32 getTokenDirect( const char *pToken, sal_Int32 nLength ) const = 0;
  57
  58     /**
  59      * Client method to attempt the use of this interface if possible.
  60      * @xTokenHandler - the UNO handle for the token lookup interface
  61      * @pTokenHandler - a dynamic_cast version of @xTokenHandler to this interface
  62      * @pStr - string buffer to lookup
  63      * @nLength - optional length of chars in that buffer
  64      *
  65      * @return Tokenized form of pStr
  66      */
  67     static sal_Int32 getTokenFromChars(
  68                          const css::uno::Reference<css::xml::sax::XFastTokenHandler > &xTokenHandler,
  69                          const FastTokenHandlerBase *pTokenHandler /* can be NULL */,
  70                          const char *pStr, size_t nLength );
  71 };
  72
  73 class SAX_DLLPUBLIC FastAttributeList : public cppu::WeakImplHelper< css::xml::sax::XFastAttributeList >
  74 {
  75 public:
  76     FastAttributeList( const css::uno::Reference< css::xml::sax::XFastTokenHandler >& xTokenHandler,
  77                        FastTokenHandlerBase *pOptHandlerBase = nullptr );
  78     virtual ~FastAttributeList() override;
  79
  80     void clear();
  81     void add( sal_Int32 nToken, const sal_Char* pValue );
  82     void add( sal_Int32 nToken, const sal_Char* pValue, size_t nValueLength );
  83     void add( sal_Int32 nToken, const OString& rValue );
  84     void addNS( sal_Int32 nNamespaceToken, sal_Int32 nToken, const OString& rValue );
  85     // note: rQName is *namespace-prefixed*
  86     void addUnknown( const OUString& rNamespaceURL, const OString& rQName, const OString& value );
  87     void addUnknown( const OString& rName, const OString& value );
  88     const std::vector< sal_Int32 >&  getFastAttributeTokens() const { return maAttributeTokens; }
  89     const char* getFastAttributeValue(size_t nIndex) const { return mpChunk + maAttributeValues[nIndex]; }
  90     sal_Int32 AttributeValueLength(size_t i) const { return maAttributeValues[i + 1] - maAttributeValues[i] - 1; }
  91
  92     // performance sensitive shortcuts to avoid allocation ...
  93     bool getAsInteger( sal_Int32 nToken, sal_Int32 &rInt) const;
  94     bool getAsDouble( sal_Int32 nToken, double &rDouble) const;
  95     bool getAsChar( sal_Int32 nToken, const char*& rPos ) const;
  96     sal_Int32 getAsIntegerByIndex( sal_Int32 nTokenIndex ) const;
  97     const char* getAsCharByIndex( sal_Int32 nTokenIndex ) const;
  98     OUString getValueByIndex( sal_Int32 nTokenIndex ) const;
  99
 100     // XFastAttributeList
 101     virtual sal_Bool SAL_CALL hasAttribute( ::sal_Int32 Token ) override;
 102     virtual ::sal_Int32 SAL_CALL getValueToken( ::sal_Int32 Token ) override;
 103     virtual ::sal_Int32 SAL_CALL getOptionalValueToken( ::sal_Int32 Token, ::sal_Int32 Default ) override;
 104     virtual OUString SAL_CALL getValue( ::sal_Int32 Token ) override;
 105     virtual OUString SAL_CALL getOptionalValue( ::sal_Int32 Token ) override;
 106     virtual css::uno::Sequence< css::xml::Attribute > SAL_CALL getUnknownAttributes(  ) override;
 107     virtual css::uno::Sequence< css::xml::FastAttribute > SAL_CALL getFastAttributes() override;
 108
 109     sal_Int32 getAttributeIndex( ::sal_Int32 Token )
 110     {
 111         for (size_t i=0; i<maAttributeTokens.size(); ++i)
 112             if (maAttributeTokens[i] == Token)
 113                 return i;
 114         return -1;
 115     }
 116
 117     static FastAttributeList* castToFastAttributeList(
 118                         const css::uno::Reference< css::xml::sax::XFastAttributeList >& xAttrList )
 119     {
 120         assert( dynamic_cast <FastAttributeList *> ( xAttrList.get() ) != nullptr );
 121         return static_cast <FastAttributeList *> ( xAttrList.get() );
 122     }
 123
 124     /// Use for fast iteration and conversion of attributes
 125     class FastAttributeIter {
 126         const FastAttributeList &mrList;
 127         size_t mnIdx;
 128
 129     public:
 130         FastAttributeIter(const FastAttributeList &rList, size_t nIdx)
 131             : mrList(rList), mnIdx(nIdx)
 132         {
 133         }
 134
 135         FastAttributeIter& operator++ ()
 136         {
 137             mnIdx++;
 138             return *this;
 139         }
 140         bool operator!=( const FastAttributeIter& rhs ) const
 141         {
 142             return mnIdx != rhs.mnIdx;
 143         }
 144
 145         const FastAttributeIter& operator*() const
 146         {
 147             return *this;
 148         }
 149
 150         sal_Int32 getToken() const
 151         {
 152             assert(mnIdx < mrList.maAttributeTokens.size());
 153             return mrList.maAttributeTokens[mnIdx];
 154         }
 155         bool isEmpty() const
 156         {
 157             assert(mnIdx < mrList.maAttributeTokens.size());
 158             return mrList.AttributeValueLength(mnIdx) < 1;
 159         }
 160         sal_Int32 toInt32() const
 161         {
 162             assert(mnIdx < mrList.maAttributeTokens.size());
 163             return rtl_str_toInt32(mrList.getFastAttributeValue(mnIdx), 10);
 164         }
 165         double toDouble() const
 166         {
 167             assert(mnIdx < mrList.maAttributeTokens.size());
 168             return rtl_str_toDouble(mrList.getFastAttributeValue(mnIdx));
 169         }
 170         OUString toString() const
 171         {
 172             assert(mnIdx < mrList.maAttributeTokens.size());
 173             return OUString(mrList.getFastAttributeValue(mnIdx),
 174                             mrList.AttributeValueLength(mnIdx),
 175                             RTL_TEXTENCODING_UTF8);
 176         }
 177         const char* toCString() const
 178         {
 179             assert(mnIdx < mrList.maAttributeTokens.size());
 180             return mrList.getFastAttributeValue(mnIdx);
 181         }
 182         sal_Int32 getLength() const
 183         {
 184             assert(mnIdx < mrList.maAttributeTokens.size());
 185             return mrList.AttributeValueLength(mnIdx);
 186         }
 187         bool isString(const char *str) const
 188         {
 189             assert(mnIdx < mrList.maAttributeTokens.size());
 190             return !strcmp(str, mrList.getFastAttributeValue(mnIdx));
 191         }
 192     };
 193     const FastAttributeIter begin() const { return FastAttributeIter(*this, 0); }
 194     const FastAttributeIter end() const { return FastAttributeIter(*this, maAttributeTokens.size()); }
 195     const FastAttributeIter find( sal_Int32 nToken ) const;
 196
 197 private:
 198     sal_Char *mpChunk; ///< buffer to store all attribute values - null terminated strings
 199     sal_Int32 mnChunkLength; ///< size of allocated memory for mpChunk
 200     // maAttributeValues stores pointers, relative to mpChunk, for each attribute value string
 201     // length of the string is maAttributeValues[n+1] - maAttributeValues[n] - 1
 202     // maAttributeValues[0] == 0
 203     std::vector< sal_Int32 > maAttributeValues;
 204     std::vector< sal_Int32 > maAttributeTokens;
 205     UnknownAttributeList maUnknownAttributes;
 206     css::uno::Reference< css::xml::sax::XFastTokenHandler > mxTokenHandler;
 207     FastTokenHandlerBase * const mpTokenHandler;
 208 };
 209
 210 }
 211
 212 #endif
 213
 214 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */