/*
* Copyright (c) 2002 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:  Declaration of class TCookiePacker
*
*
*/


#ifndef __COOKIE_IPC_H__
#define __COOKIE_IPC_H__

// INCLUDE FILES
	// System includes
#include <cookie.h>
#include <e32base.h>
#include <http.h>

// CLASS DECLARATIONS

/** 
* TCookiePackedCookie
* Packs a CCookie's content into a buffer for sending across IPC.
* Also unpacks the data into a CCookie
*
*/
class TCookiePacker
	{
	public :	// construction
		/**
		*
		*/
		TCookiePacker( RStringPool aStringPool );  // DONE

	public :	// common methods
		/**
		*
		*/
		TInt CliPackCookie( TDes8& aBuffer, const CCookie& aCookie ) const;

        /**
		*
		*/
		TInt SrvPackCookie( TDes8& aBuffer, const CCookie& aCookie ) const;

		/**
		* This method unpacks a cookie from a flat buffer to a cookie object.
		* It is used from both client and server side.
		*/
		void UnpackCookieL( const TDesC8& aPtr, CCookie& aCookie ) const;

		/**
		* Processes the buffer and inserts cookies into the array.
		* @param aBuffer Buffer to be processed. It contains the cookies in a
		* form that makes it possible to transfer the cookies over client-
		* server boundary,
		* @param aCookies The array that is supposed to contain the cookies.
		*/
		void UnpackCookiesFromBufferL( const TDesC8& aBuffer,
									RPointerArray<CCookie>& aCookies ) const;

	private :
		/**
		* Add a named (string type) attribute from cookie to the string buffer.
		*/
		TInt AddStringF( const CCookie::TCookieAttributeName aAttrib, 
						 const CCookie& aCookie,
						 TDes8& aBuffer,
                         TBool aNoDefaulted = EFalse ) const;
		/**
		* Add Date attribute from cookie to the string buffer.
		*/
        TInt AddDateL( const CCookie& aCookie,
                        TDes8& aBuffer,
                        TBool aNoDefaulted = EFalse ) const;

		/**
		*
		*/
		void AppendAttributeLength( TInt aLength, TDes8& aBuffer ) const;

		/**
		* Unpack a named (string type) attribute from the buffer to the cookie.
		*/
		void GetPackedAttributeL( const CCookie::TCookieAttributeName aAttrib, 
								 CCookie& aCookie, 
								 const TUint8*& aPtrStart ) const;

		/**
		* Unpack the Date attribute from the buffer to the cookie.
		*/
        void GetPackedDateAttributeL( CCookie& aCookie,
                                        const TUint8*& aPtrStart ) const;

		/**
		* This method unpacks a cookie from a flat buffer to a cookie object.
		* It is used from both client and server side.
		*/
		void UnpackCookieL( const TUint8*& aPtr, CCookie& aCookie ) const;

        /**
		*
		*/
		TInt DoPackCookie( TDes8& aBuffer, 
                           const CCookie& aCookie, TBool aSevrer ) const;

        /**
		* Decrease a numeric value in a numeric formatted buffer.
        * (underflow is handled)
        * @param aBuffer contains numeric value
        * @param aIndex position where to decrease
        * @return KErrNone if no error occurs, otherwise KErrGeneral
        * Leave code: KErrNoMemory
		*/
		TInt DecreaseNumericValueL( TDes& aBuffer, const TInt aIndex ) const;
		
		/**
		* Trim cookie's name and value if their size is bigger than 4K.
		* @param aCookie identifies the cookie
		*/
		void TrimNameAndValueL( CCookie& aCookie ) const;

	private :	// data members
		RStringPool iStringPool;
	};

#endif // __COOKIE_IPC_H__