/*

* Copyright (c) 2005-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

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:

* Name        : siprequestelements.h

* Part of     : SIP Client

* Interface   : SDK API, SIP API

* Version     : 1.0

*

*/

#ifndef CSIPREQUESTELEMENTS_H

#define CSIPREQUESTELEMENTS_H

//  INCLUDES

#include <e32base.h>

#include <s32strm.h>

#include <stringpool.h>

#include <uri8.h>

// FORWARD DECLARATIONS

class CSIPMessageElements;

class CSIPFromHeader;

class CSIPToHeader;

class CSIPCSeqHeader;

class CURIContainer;

// CLASS DECLARATION

/**

*  @publishedAll

*  @released

*

*  Class provides functions for creation and manipulation of originator's and

*  recipient's addresses in a SIP request. It also provide functions for

*  manipulation of SIP method for unknown SIP requests.

*  @lib sipclient.lib

*/

class CSIPRequestElements : public CBase

    {

    public:  // Constructors and destructor      

        /**

        * Two-phased constructor.

        * If the URI is SIP URI, no SIP URI headers are allowed.

        * @pre aRemoteURi != 0

        * @param aRemoteUri Remote target URI that identifies a resource that

        *        the request is addressed to. The ownership is transferred.

        */

        IMPORT_C static CSIPRequestElements* NewL(CUri8* aRemoteUri);

        /**

        * Two-phased constructor.

        * If the URI is SIP URI, no SIP URI headers are allowed.

        * @pre aRemoteURi != 0

        * @param aRemoteUri Remote target URI that identifies a resource that

        *        the request is addressed to. The ownership is transferred.

        */

        IMPORT_C static CSIPRequestElements* NewLC(CUri8* aRemoteUri);

        /**

        * Destructor.

        */

        IMPORT_C ~CSIPRequestElements();

    public: // New functions

        /**

        * Sets/resets the recipient's To-header

        * To-header must not contain tag-parameter.

        * @pre aTo != 0

        * @param aTo a To-header to be set, the ownership is transferred.

        */

        IMPORT_C void SetToHeaderL(CSIPToHeader* aTo);

        /**

        * Gets the recipient's To-header 

        * @return To-header or a 0-pointer if not present. Ownership is not

        *   transferred.

        */

        IMPORT_C const CSIPToHeader* ToHeader() const;

        /**

        * Sets/resets the originator's From-header.

        * From-header must not contain tag-parameter.

        * @pre aFrom != 0

         * @param aFrom a From-header to be set, the ownership is transferred.

        * @leave KErrArgument if aFrom == 0 

        */

        IMPORT_C void SetFromHeaderL(CSIPFromHeader* aFrom);

        /**

        * Gets the originator's From-header 

        * @return From-header or a 0-pointer if not present. Ownership is not

        *   transferred.

        */

        IMPORT_C const CSIPFromHeader* FromHeader() const;

        /**

        * Gets CSeq-header. Available for only incoming requests.

        * @return a CSeq-header or a 0-pointer if not present. 

        *         Ownership is not transferred.

        */        

        IMPORT_C const CSIPCSeqHeader* CSeqHeader() const;

        /**

        * Sets the remote URI.

        * If the URI is a SIP URI, no SIP URI headers are allowed.

        * @pre aRemoteUri != 0

         * @param aRemoteUri

        * @leave KErrArgument if aRemoteUri==0

        */

        IMPORT_C void SetRemoteUriL(CUri8* aRemoteUri);

        /**

        * Gets the remote target URI

        * @return remote target URI

        */

        IMPORT_C const CUri8& RemoteUri() const; 

        /**

        * Sets the SIP request method

        * @param aMethod a SIP method name.

        * @leave KErrArgument if method name given is syntactically

        *        incorrect

        */

        IMPORT_C void SetMethodL(RStringF aMethod);

        /**

        * Gets the SIP Method for a request

        * @return a SIP method name or a an empty string if the method

        *         is not defined

        */

        IMPORT_C RStringF Method() const;

        /**

        * Gets message elements (contains all SIP user headers and content)

        * @return message elements

        */

        IMPORT_C const CSIPMessageElements& MessageElements() const;

        /**

        * Gets message elements (contains all SIP user headers and content)

        * The response elements can be populated with SIP user headers

        * and content using returned reference to the message elements.

        * @return message elements

        */

        IMPORT_C CSIPMessageElements& MessageElements();

    public: // New functions, for internal use

        static CSIPRequestElements* InternalizeL (RReadStream& aReadStream);

        void ExternalizeL (RWriteStream& aWriteStream) const;

    private:

        CSIPRequestElements();

        void ConstructL(CUri8* aRemoteUri);

        void DoInternalizeL(RReadStream& aReadStream);

    private: // Data

        RStringF iMethod;

        CURIContainer* iRemoteURI;

        CSIPMessageElements* iMessageElements;

    private: // For testing purposes

    };

#endif