/*

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

 * All rights reserved.

 * This component and the accompanying materials are made available

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

 * 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:        This utility class represents SOAP fault element according to

 *                SOAP fault specification. 

 *

 */

 #ifndef SEN_SOAP_FAULT_H

 #define SEN_SOAP_FAULT_H

 //  INCLUDES

 #include <SenBaseElement.h>

 #include <SenSoapConstants.h>

 // CLASS DECLARATION

 /**

 * This utility class represents SOAP fault element according to SOAP fault 

 * specification. 

 * SOAP fault element has following child elements: 

 *  faultcode, 

 *  faultstring, 

 *  faultactor 

 *  detail

 *

 *  @lib SenUtils.lib

 *  @since Series60 3.0

 */

 class CSenSoapFault : public CSenBaseElement

     {

     public:  // Constructors and destructor

         /**

         * Copy constructor, making a copy of the original source element.

         * @since Series60 3.0

         * @param aCopiedSource  Element where source will be copied.

         */

         IMPORT_C static CSenSoapFault* NewL(CSenElement& aCopiedSource);

         /**

         * Basic constructor.

         * @since Series60 3.0

         * @param aNsUri is the XML namespace of this SOAP fault

         * @param aLocalName is the localname for this SOAP fault

         * @param aQName is the qualifiedname for this SOAP fault

         * @param aAttributes are the XML attributes for this SOAP fault

         * Parameters are used to construct the soap fault.

         */

         IMPORT_C static CSenSoapFault* NewL(const TDesC8& aNsUri,

                                             const TDesC8& aLocalName,

                                             const TDesC8& aQName,

                                             const RAttributeArray& aAttributes);

         /**

         * Destructor.

         */

         IMPORT_C virtual ~CSenSoapFault();

         // New functions

         /**

         * @since Series60 3.0

         * @return the content of <faultcode> element as UTF-8 form string

         * or KNullDesC8, if element is not available

         */

         IMPORT_C TPtrC8 FaultCode();

 		/**

 		* @since Series60 4.0

 		* @return the content of <Subcode> element as UTF-8 form string

 		* or KNullDesC8, if element is not available

 		*/

 		IMPORT_C TPtrC8 FaultSubcode();

 		/**

         * @since Series60 3.0

         * @return the content of <faultstring> element as UTF-8 form string

         * or KNullDesC8, if element is not available

         */

         IMPORT_C TPtrC8 FaultString();

         /**

         * @since Series60 3.0

         * @return the content of <faultactor> element as UTF-8 form string

         * or KNullDesC8, if element is not available

         */

         IMPORT_C TPtrC8 FaultActor();

         /**

         * @since Series60 3.0

         * @return the content of <detail> element as UTF-8 form string

         * or KNullDesC8, if element is not available

         */

         IMPORT_C TPtrC8 Detail();

     protected:  

         /**

         * C++ default constructor

         */

         IMPORT_C CSenSoapFault();

         /**

         * Basic ConstructL function

         * @since Series60 3.0

         * @param aCopiedSource is the CSenElement from which data to this

         *        SOAP fault object is to be copied.

         */

         IMPORT_C void ConstructL(CSenElement& aCopiedSource);

         /**

         * Basic ConstructL function

         * @since Series60 3.0

         * @param aNsUri is the XML namespace URI of this SOAP fault

         * @param aLocalName is the XML localname URI of this SOAP fault

         * @param aQName is the XML qualifiedname URI of this SOAP fault

         * @param aAttributes are the XML attributes for this SOAP fault

         */

         IMPORT_C void ConstructL(const TDesC8& aNsUri,

                                  const TDesC8& aLocalName,

                                  const TDesC8& aQName,

                                  const RAttributeArray& aAttributes);

     };

 #endif // SEN_SOAP_ENVELOPE_H

 // End of File