Xerces-C++ 3.2.0

InputSource.hpp
Go to the documentation of this file.
1 /*
2 * Licensed to the Apache Software Foundation (ASF) under one or more
3 * contributor license agreements. See the NOTICE file distributed with
4 * this work for additional information regarding copyright ownership.
5 * The ASF licenses this file to You under the Apache License, Version 2.0
6 * (the "License"); you may not use this file except in compliance with
7 * the License. You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18 /*
19 * $Id: InputSource.hpp 932889 2010-04-11 13:10:10Z borisk $
20 */
21
22 #if !defined(XERCESC_INCLUDE_GUARD_INPUTSOURCE_HPP)
23 #define XERCESC_INCLUDE_GUARD_INPUTSOURCE_HPP
24
25 #include <xercesc/util/PlatformUtils.hpp>
26
27 XERCES_CPP_NAMESPACE_BEGIN
28
29 class BinInputStream;
30
31
62 class SAX_EXPORT InputSource : public XMemory
63 {
64 public:
65 // -----------------------------------------------------------------------
66 // All constructors are hidden, just the destructor is available
67 // -----------------------------------------------------------------------
74 virtual ~InputSource();
76
77
78 // -----------------------------------------------------------------------
91 virtual BinInputStream* makeStream() const = 0;
92
94
95
96 // -----------------------------------------------------------------------
108 virtual const XMLCh* getEncoding() const;
109
110
117 virtual const XMLCh* getPublicId() const;
118
119
128 virtual const XMLCh* getSystemId() const;
129
138 virtual bool getIssueFatalErrorIfNotFound() const;
139
140 MemoryManager* getMemoryManager() const;
141
143
144
145 // -----------------------------------------------------------------------
148
160 virtual void setEncoding(const XMLCh* const encodingStr);
161
162
174 virtual void setPublicId(const XMLCh* const publicId);
175
192 virtual void setSystemId(const XMLCh* const systemId);
193
203 virtual void setIssueFatalErrorIfNotFound(const bool flag);
204
206
207
208 protected :
209 // -----------------------------------------------------------------------
210 // Hidden constructors
211 // -----------------------------------------------------------------------
215 InputSource(MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
216
222 InputSource(const XMLCh* const systemId,
223 MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
224
231 InputSource
232 (
233 const XMLCh* const systemId
234 , const XMLCh* const publicId
235 , MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager
236 );
237
243 InputSource(const char* const systemId,
244 MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
245
252 InputSource
253 (
254 const char* const systemId
255 , const char* const publicId
256 , MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager
257 );
258
260
261
262
263
264
265 private:
266 // -----------------------------------------------------------------------
267 // Unimplemented constructors and operators
268 // -----------------------------------------------------------------------
269 InputSource(const InputSource&);
270 InputSource& operator=(const InputSource&);
271
272
273 // -----------------------------------------------------------------------
274 // Private data members
275 //
276 // fEncoding
277 // This is the encoding to use. Usually this is null, which means
278 // to use the information found in the file itself. But, if set,
279 // this encoding will be used without question.
280 //
281 // fPublicId
282 // This is the optional public id for the input source. It can be
283 // null if none is desired.
284 //
285 // fSystemId
286 // This is the system id for the input source. This is what is
287 // actually used to open the source.
288 //
289 // fFatalErrorIfNotFound
290 // -----------------------------------------------------------------------
291 MemoryManager* const fMemoryManager;
292 XMLCh* fEncoding;
293 XMLCh* fPublicId;
294 XMLCh* fSystemId;
295 bool fFatalErrorIfNotFound;
296 };
297
298
299 // ---------------------------------------------------------------------------
300 // InputSource: Getter methods
301 // ---------------------------------------------------------------------------
302 inline const XMLCh* InputSource::getEncoding() const
303 {
304 return fEncoding;
305 }
306
307 inline const XMLCh* InputSource::getPublicId() const
308 {
309 return fPublicId;
310 }
311
312 inline const XMLCh* InputSource::getSystemId() const
313 {
314 return fSystemId;
315 }
316
317 inline bool InputSource::getIssueFatalErrorIfNotFound() const
318 {
319 return fFatalErrorIfNotFound;
320 }
321
322 inline MemoryManager* InputSource::getMemoryManager() const
323 {
324 return fMemoryManager;
325 }
326
327 // ---------------------------------------------------------------------------
328 // InputSource: Setter methods
329 // ---------------------------------------------------------------------------
330 inline void InputSource::setIssueFatalErrorIfNotFound(const bool flag)
331 {
332 fFatalErrorIfNotFound = flag;
333 }
334
335 XERCES_CPP_NAMESPACE_END
336
337 #endif
XMemory
This class makes it possible to override the C++ memory management by adding new/delete operators to ...
Definition: XMemory.hpp:40
XMLPlatformUtils::fgMemoryManager
static MemoryManager * fgMemoryManager
The configurable memory manager.
Definition: PlatformUtils.hpp:121
SAX_EXPORT
#define SAX_EXPORT
Definition: XercesDefs.hpp:164
InputSource::getIssueFatalErrorIfNotFound
virtual bool getIssueFatalErrorIfNotFound() const
Get the flag that indicates if the parser should issue fatal error if this input source is not found...
Definition: InputSource.hpp:317
InputSource::getPublicId
virtual const XMLCh * getPublicId() const
Get the public identifier for this input source.
Definition: InputSource.hpp:307
PlatformUtils.hpp
MemoryManager
Configurable memory manager.
Definition: MemoryManager.hpp:39
InputSource::getEncoding
virtual const XMLCh * getEncoding() const
An input source can be set to force the parser to assume a particular encoding for the data that inpu...
Definition: InputSource.hpp:302
XMLCh
uint16_t XMLCh
Definition: Xerces_autoconf_config.hpp:118
XERCES_CPP_NAMESPACE_BEGIN
#define XERCES_CPP_NAMESPACE_BEGIN
Definition: XercesDefs.hpp:112
XERCES_CPP_NAMESPACE_END
#define XERCES_CPP_NAMESPACE_END
Definition: XercesDefs.hpp:113
BinInputStream
Definition: BinInputStream.hpp:29
InputSource::setIssueFatalErrorIfNotFound
virtual void setIssueFatalErrorIfNotFound(const bool flag)
Indicates if the parser should issue fatal error if this input source is not found.
Definition: InputSource.hpp:330
InputSource::getSystemId
virtual const XMLCh * getSystemId() const
Get the system identifier for this input source.
Definition: InputSource.hpp:312
InputSource::getMemoryManager
MemoryManager * getMemoryManager() const
Definition: InputSource.hpp:322
InputSource
A single input source for an XML entity.
Definition: InputSource.hpp:62