Reordered files in all libs - now all includes are in "libname/include" dir - logical, isn't it? This should break compilation however.
This commit is contained in:
165
project/jni/xerces/include/xercesc/sax/EntityResolver.hpp
Normal file
165
project/jni/xerces/include/xercesc/sax/EntityResolver.hpp
Normal file
@@ -0,0 +1,165 @@
|
||||
/*
|
||||
* 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
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
/*
|
||||
* $Id: EntityResolver.hpp 527149 2007-04-10 14:56:39Z amassari $
|
||||
*/
|
||||
|
||||
#if !defined(XERCESC_INCLUDE_GUARD_ENTITYRESOLVER_HPP)
|
||||
#define XERCESC_INCLUDE_GUARD_ENTITYRESOLVER_HPP
|
||||
|
||||
#include <xercesc/util/XercesDefs.hpp>
|
||||
|
||||
XERCES_CPP_NAMESPACE_BEGIN
|
||||
|
||||
class InputSource;
|
||||
|
||||
/**
|
||||
* Basic interface for resolving entities.
|
||||
*
|
||||
* <p>If a SAX application needs to implement customized handling
|
||||
* for external entities, it must implement this interface and
|
||||
* register an instance with the SAX parser using the parser's
|
||||
* setEntityResolver method.</p>
|
||||
*
|
||||
* <p>The parser will then allow the application to intercept any
|
||||
* external entities (including the external DTD subset and external
|
||||
* parameter entities, if any) before including them.</p>
|
||||
*
|
||||
* <p>Many SAX applications will not need to implement this interface,
|
||||
* but it will be especially useful for applications that build
|
||||
* XML documents from databases or other specialised input sources,
|
||||
* or for applications that use URI types other than URLs.</p>
|
||||
*
|
||||
* <p>The following resolver would provide the application
|
||||
* with a special character stream for the entity with the system
|
||||
* identifier "http://www.myhost.com/today":</p>
|
||||
*
|
||||
*<code>
|
||||
*\#include <xercesc/sax/EntityResolver.hpp><br>
|
||||
*\#include <xercesc/sax/InputSource.hpp><br>
|
||||
*<br>
|
||||
*class MyResolver : public EntityResolver {<br>
|
||||
* public:<br>
|
||||
* InputSource resolveEntity (const XMLCh* const publicId, const XMLCh* const systemId);<br>
|
||||
* <br>
|
||||
* ...<br>
|
||||
* };<br>
|
||||
*<br>
|
||||
* MyResolver::resolveEntity {<br>
|
||||
* if (XMLString::compareString(systemId, "http://www.myhost.com/today")) {<br>
|
||||
* MyReader* reader = new MyReader();<br>
|
||||
* return new InputSource(reader);<br>
|
||||
* } else {<br>
|
||||
* return null;<br>
|
||||
* }<br>
|
||||
* }<br>
|
||||
*<br>
|
||||
*</code>
|
||||
*
|
||||
* <p>The application can also use this interface to redirect system
|
||||
* identifiers to local URIs or to look up replacements in a catalog
|
||||
* (possibly by using the public identifier).</p>
|
||||
*
|
||||
* <p>The HandlerBase class implements the default behaviour for
|
||||
* this interface, which is simply always to return null (to request
|
||||
* that the parser use the default system identifier).</p>
|
||||
*
|
||||
* @see Parser#setEntityResolver
|
||||
* @see InputSource#InputSource
|
||||
* @see HandlerBase#HandlerBase
|
||||
*/
|
||||
class SAX_EXPORT EntityResolver
|
||||
{
|
||||
public:
|
||||
/** @name Constructors and Destructor */
|
||||
//@{
|
||||
|
||||
/** Default Constructor */
|
||||
EntityResolver()
|
||||
{
|
||||
}
|
||||
|
||||
/** Destructor */
|
||||
virtual ~EntityResolver()
|
||||
{
|
||||
}
|
||||
|
||||
//@}
|
||||
|
||||
/** @name The EntityResolver interface */
|
||||
//@{
|
||||
|
||||
/**
|
||||
* Allow the application to resolve external entities.
|
||||
*
|
||||
* <p>The Parser will call this method before opening any external
|
||||
* entity except the top-level document entity (including the
|
||||
* external DTD subset, external entities referenced within the
|
||||
* DTD, and external entities referenced within the document
|
||||
* element): the application may request that the parser resolve
|
||||
* the entity itself, that it use an alternative URI, or that it
|
||||
* use an entirely different input source.</p>
|
||||
*
|
||||
* <p>Application writers can use this method to redirect external
|
||||
* system identifiers to secure and/or local URIs, to look up
|
||||
* public identifiers in a catalogue, or to read an entity from a
|
||||
* database or other input source (including, for example, a dialog
|
||||
* box).</p>
|
||||
*
|
||||
* <p>If the system identifier is a URL, the SAX parser must
|
||||
* resolve it fully before reporting it to the application.</p>
|
||||
*
|
||||
* @param publicId The public identifier of the external entity
|
||||
* being referenced, or null if none was supplied.
|
||||
* @param systemId The system identifier of the external entity
|
||||
* being referenced.
|
||||
* @return An InputSource object describing the new input source,
|
||||
* or null to request that the parser open a regular
|
||||
* URI connection to the system identifier.
|
||||
* The returned InputSource is owned by the parser which is
|
||||
* responsible to clean up the memory.
|
||||
* @exception SAXException Any SAX exception, possibly
|
||||
* wrapping another exception.
|
||||
* @exception IOException An IO exception,
|
||||
* possibly the result of creating a new InputStream
|
||||
* or Reader for the InputSource.
|
||||
* @see InputSource#InputSource
|
||||
*/
|
||||
virtual InputSource* resolveEntity
|
||||
(
|
||||
const XMLCh* const publicId
|
||||
, const XMLCh* const systemId
|
||||
) = 0;
|
||||
|
||||
//@}
|
||||
|
||||
private :
|
||||
/* Unimplemented constructors and operators */
|
||||
|
||||
|
||||
/* Copy constructor */
|
||||
EntityResolver(const EntityResolver&);
|
||||
|
||||
/* Assignment operator */
|
||||
EntityResolver& operator=(const EntityResolver&);
|
||||
|
||||
};
|
||||
|
||||
XERCES_CPP_NAMESPACE_END
|
||||
|
||||
#endif
|
||||
Reference in New Issue
Block a user