/*

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

* All rights reserved.

* This component and the accompanying materials are made available

* which accompanies this distribution, and is available

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

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description: 

*

*/

/*

 * 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: PSVIHandler.hpp 568078 2007-08-21 11:43:25Z amassari $

 */

#if !defined(PSVIHANDLER_HPP)

#define PSVIHANDLER_HPP

#include <xercesc/framework/psvi/PSVIElement.hpp>

#include <xercesc/framework/psvi/PSVIAttributeList.hpp>

XERCES_CPP_NAMESPACE_BEGIN

/**

  * This abstract class provides the interface for the scanner to return

  * PSVI information to the application.

  *

  */

class XMLPARSER_EXPORT PSVIHandler

{

public:

    // -----------------------------------------------------------------------

    //  Constructors are hidden, just the virtual destructor is exposed

    // -----------------------------------------------------------------------

    /** @name Destructor */

    //@{

    virtual ~PSVIHandler()

    {

    }

    //@}

    /** @name The PSVI handler interface */

    //@{

    /** Receive notification of the PSVI properties of an element.

      * The scanner will issue this call after the XMLDocumentHandler

      * endElement call.  Since the scanner will issue the psviAttributes

      * call immediately after reading the start tag of an element, all element

      * content will be effectively bracketed by these two calls.

      * @param  localName The name of the element whose end tag was just

      *                     parsed.

      * @param  uri       The namespace to which the element is bound

      * @param  elementInfo    Object containing the element's PSVI properties

      */

    virtual void handleElementPSVI

    (

        const   XMLCh* const            localName 

        , const XMLCh* const            uri

        ,       PSVIElement *           elementInfo

    ) = 0;

    /** 

      * Receive notification of partial PSVI properties of an element.

      * This callback is made right after the psviAttributes

      * call for non-empty element. 

      *

      *  The PSVIElement passed in has all fields properly set and it

      *  can be safely accessed the same way as the one passed in handleElementPSVI.

      *  However, fields listed below always have default values.

      *

      *  getValidity()	              PSVIItem::VALIDITY_NOTKNOWN

      *  getValidationAttemped()      PSVIItem::VALIDATION_NONE

      *  getMemberTypeDefinition()    0

      *  getSchemaNormalizedValue()   0

      *  getCanonicalRepresentation() 0

      *  getNotationDeclaration()     0

      *

      *

      * @param  localName    The name of the element upon which start tag 

      *                      these attributes were encountered.

      * @param  uri          The namespace to which the element is bound

      * @param  elementInfo  Object containing the element's partial PSVI properties

      */

    virtual void handlePartialElementPSVI

    (

          const XMLCh*        const localName 

        , const XMLCh*        const uri

        ,       PSVIElement *       elementInfo

    );

    /**

      * Enables PSVI information about attributes to be passed back to the

      * application.  This callback will be made on *all*

      * elements; on elements with no attributes, the final parameter will

      * be null.

      * @param  localName The name of the element upon which start tag 

      *          these attributes were encountered.

      * @param  uri       The namespace to which the element is bound

      * @param  psviAttributes   Object containing the attributes' PSVI properties

      *          with information to identify them.

      */

    virtual void handleAttributesPSVI

    (

        const   XMLCh* const            localName 

        , const XMLCh* const            uri

        ,       PSVIAttributeList *     psviAttributes

    ) = 0;

    //@}

protected :

    // -----------------------------------------------------------------------

    //  Hidden Constructors

    // -----------------------------------------------------------------------

    PSVIHandler()

    {

    }

private:

    // -----------------------------------------------------------------------

    //  Unimplemented constructors and operators

    // -----------------------------------------------------------------------

    PSVIHandler(const PSVIHandler&);

    PSVIHandler& operator=(const PSVIHandler&);

};

inline void PSVIHandler::handlePartialElementPSVI(const XMLCh*        const /*localName*/

                                                , const XMLCh*        const /*uri*/

                                                ,       PSVIElement *       /*elementInfo*/

                                                 )

{

}

XERCES_CPP_NAMESPACE_END

#endif