1 /*

     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description: 

    15 *

    16 */

    17 #ifndef DOMImplementationSource_HEADER_GUARD_

    18 #define DOMImplementationSource_HEADER_GUARD_

    19 

    20 /*

    21  * Licensed to the Apache Software Foundation (ASF) under one or more

    22  * contributor license agreements.  See the NOTICE file distributed with

    23  * this work for additional information regarding copyright ownership.

    24  * The ASF licenses this file to You under the Apache License, Version 2.0

    25  * (the "License"); you may not use this file except in compliance with

    26  * the License.  You may obtain a copy of the License at

    27  * 

    28  *      http://www.apache.org/licenses/LICENSE-2.0

    29  * 

    30  * Unless required by applicable law or agreed to in writing, software

    31  * distributed under the License is distributed on an "AS IS" BASIS,

    32  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    33  * See the License for the specific language governing permissions and

    34  * limitations under the License.

    35  */

    36 

    37 /*

    38  * $Id: DOMImplementationSource.hpp 568078 2007-08-21 11:43:25Z amassari $

    39  */

    40 

    41 /**

    42   * This interface permits a DOM implementer to supply one or more

    43   * implementations, based upon requested features. Each implemented

    44   * <code>DOMImplementationSource</code> object is listed in the

    45   * binding-specific list of available sources so that its

    46   * <code>DOMImplementation</code> objects are made available.

    47   * <p>See also the <a href='http://www.w3.org/TR/2002/WD-DOM-Level-3-Core-20020409'>Document Object Model (DOM) Level 3 Core Specification</a>.

    48   *

    49   * @since DOM Level 3

    50   */

    51 #include <xercesc/util/XercesDefs.hpp>

    52 

    53 XERCES_CPP_NAMESPACE_BEGIN

    54 

    55 

    56 class DOMImplementation;

    57 

    58 class CDOM_EXPORT DOMImplementationSource

    59 {

    60 protected :

    61     // -----------------------------------------------------------------------

    62     //  Hidden constructors

    63     // -----------------------------------------------------------------------

    64     /** @name Hidden constructors */

    65     //@{    

    66     DOMImplementationSource() {};

    67     //@}

    68 

    69 private:

    70     // -----------------------------------------------------------------------

    71     // Unimplemented constructors and operators

    72     // -----------------------------------------------------------------------

    73     /** @name Unimplemented constructors and operators */

    74     //@{

    75     DOMImplementationSource(const DOMImplementationSource &);

    76     DOMImplementationSource & operator = (const DOMImplementationSource &);

    77     //@}

    78 

    79 

    80 public:

    81     // -----------------------------------------------------------------------

    82     //  All constructors are hidden, just the destructor is available

    83     // -----------------------------------------------------------------------

    84     /** @name Destructor */

    85     //@{

    86     /**

    87      * Destructor

    88      *

    89      */

    90     virtual ~DOMImplementationSource() {};

    91     //@}

    92 

    93     // -----------------------------------------------------------------------

    94     //  Virtual DOMImplementationSource interface

    95     // -----------------------------------------------------------------------

    96     /** @name Functions introduced in DOM Level 3 */

    97     //@{

    98     /**

    99      * A method to request a DOM implementation.

   100      *

   101      * <p><b>"Experimental - subject to change"</b></p>

   102      *

   103      * @param features A string that specifies which features are required.

   104      *   This is a space separated list in which each feature is specified

   105      *   by its name optionally followed by a space and a version number.

   106      *   This is something like: "XML 1.0 Traversal 2.0"

   107      * @return An implementation that has the desired features, or

   108      *   <code>null</code> if this source has none.

   109      * @since DOM Level 3

   110      */

   111     virtual DOMImplementation* getDOMImplementation(const XMLCh* features) const = 0;

   112     //@}

   113 

   114 };

   115 

   116 XERCES_CPP_NAMESPACE_END

   117 

   118 #endif