source: NonGTP/Xerces/xercesc/dom/DOMImplementationRegistry.hpp @ 188

Revision 188, 5.0 KB checked in by mattausch, 19 years ago (diff)

added xercesc to support

Line 
1#ifndef DOMImplementationRegistry_HEADER_GUARD_
2#define DOMImplementationRegistry_HEADER_GUARD_
3
4/*
5 * The Apache Software License, Version 1.1
6 *
7 * Copyright (c) 2002-2003 The Apache Software Foundation.  All rights
8 * reserved.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 *
14 * 1. Redistributions of source code must retain the above copyright
15 *    notice, this list of conditions and the following disclaimer.
16 *
17 * 2. Redistributions in binary form must reproduce the above copyright
18 *    notice, this list of conditions and the following disclaimer in
19 *    the documentation and/or other materials provided with the
20 *    distribution.
21 *
22 * 3. The end-user documentation included with the redistribution,
23 *    if any, must include the following acknowledgment:
24 *       "This product includes software developed by the
25 *        Apache Software Foundation (http://www.apache.org/)."
26 *    Alternately, this acknowledgment may appear in the software itself,
27 *    if and wherever such third-party acknowledgments normally appear.
28 *
29 * 4. The names "Xerces" and "Apache Software Foundation" must
30 *    not be used to endorse or promote products derived from this
31 *    software without prior written permission. For written
32 *    permission, please contact apache\@apache.org.
33 *
34 * 5. Products derived from this software may not be called "Apache",
35 *    nor may "Apache" appear in their name, without prior written
36 *    permission of the Apache Software Foundation.
37 *
38 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
39 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
40 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
41 * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
42 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
43 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
44 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
45 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
46 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
47 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
48 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
49 * SUCH DAMAGE.
50 * ====================================================================
51 *
52 * This software consists of voluntary contributions made by many
53 * individuals on behalf of the Apache Software Foundation, and was
54 * originally based on software copyright (c) 2002, International
55 * Business Machines, Inc., http://www.ibm.com .  For more information
56 * on the Apache Software Foundation, please see
57 * <http://www.apache.org/>.
58 */
59
60/*
61 * $Id: DOMImplementationRegistry.hpp,v 1.5 2004/01/29 11:44:26 cargilld Exp $
62 */
63
64/**
65  * This class holds the list of registered DOMImplementations.  Implementation
66  * or application can register DOMImplementationSource to the registry, and
67  * then can query DOMImplementation based on a list of requested features.
68  *
69  * <p>This provides an application with an implementation independent starting
70  * point.
71  *
72  * @see DOMImplementation
73  * @see DOMImplementationSource
74  * @since DOM Level 3
75  */
76
77#include <xercesc/util/XercesDefs.hpp>
78
79XERCES_CPP_NAMESPACE_BEGIN
80
81
82class DOMImplementation;
83class DOMImplementationSource;
84
85class CDOM_EXPORT DOMImplementationRegistry
86{
87public:
88    // -----------------------------------------------------------------------
89    //  Static DOMImplementationRegistry interface
90    // -----------------------------------------------------------------------
91    /** @name Functions introduced in DOM Level 3 */
92    //@{
93    /**
94     * Return the first registered implementation that has the desired features,
95     * or null if none is found.
96     *
97     * <p><b>"Experimental - subject to change"</b></p>
98     *
99     * @param features A string that specifies which features are required.
100     *                 This is a space separated list in which each feature is
101     *                 specified by its name optionally followed by a space
102     *                 and a version number.
103     *                 This is something like: "XML 1.0 Traversal 2.0"
104     * @return An implementation that has the desired features, or
105     *   <code>null</code> if this source has none.
106     * @since DOM Level 3
107     */
108    static DOMImplementation* getDOMImplementation(const XMLCh* features);
109
110    /**
111     * Register an implementation.
112     *
113     * <p><b>"Experimental - subject to change"</b></p>
114     *
115     * @param source   A DOMImplementation Source object to be added to the registry.
116     *                 The registry does NOT adopt the source object.  Users still own it.
117     * @since DOM Level 3
118     */
119    static void addSource(DOMImplementationSource* source);
120    //@}
121
122private:
123    DOMImplementationRegistry();
124};
125
126XERCES_CPP_NAMESPACE_END
127
128#endif
Note: See TracBrowser for help on using the repository browser.