multimediacommsengine/tsrc/MCETestUI/MCETestUIPlugin/inc/MCETestUIPlugin.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 19 Mar 2010 09:37:25 +0200
changeset 12 966b25fd74b5
parent 0 1bce908db942
permissions -rw-r--r--
Revision: 201005 Kit: 201011

/*
* Copyright (c) 2002-2004 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:    MCETestUIPlugin interface
*
*/




#ifndef CMCETestUIPLUGIN_H
#define CMCETestUIPLUGIN_H

//  INCLUDES
#include <apgcli.h>
#include <e32base.h>
#include <ECom/ImplementationProxy.h>
#include "SIPResolvedClient.h"
#include "SIPContentTypeHeader.h"

/**
*  Implementation API for SIP Client Resolver.
*  Routes incoming MCETestUI calls to MMCE
*
*  @lib
*  @since Series
*/
class CMCETestUIPlugin : CSIPResolvedClient
    {
    public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        */
        static CMCETestUIPlugin* NewL();
        
        /**
        * Destructor.
        */
        virtual ~CMCETestUIPlugin();

    public: // Functions from base classes

       	/**
		* Returns the SIP client's channel UID that indicates client's
		* channel UID for connection with SIP e.g. CSIP::NewL()
		* @param aMethod the method of the SIP request
        * @param aRequestUri the request-URI of the SIP request
        * @param aHeaders all the headers in the SIP request
        * @param aContent SIP request body; zero-length descriptor if not present
        * @param aContentType the content-type of the SIP request. 
        *        Zero-pointer if body is not present.
		* @return SIP client's communication channel's UID
		*/
		virtual TUid ChannelL(RStringF aMethod,
                              const TDesC8& aRequestUri,
                              const RPointerArray<CSIPHeaderBase>& aHeaders,
                              const TDesC8& aContent,
                              const CSIPContentTypeHeader* aContentType=0);

		/**
		* Requests the client to connect to SIP with resolved
		* UID in case there's no connection with resolved channel UID.
		* @param aUid previously resolved channel UID
		* @leave KErrNoMemory if out of memory
		* @leave KErrNotFound in case non-existing channel UID was provided
		*/
		virtual void ConnectL(TUid aUid);

		/**
		* Requests the implementation to provide capabilities in XML format
		* in case they were not defined in the ECOM resource file. The cabablities
		* to be returned must be defined according to the same DTD.
		* This function will be invoked only if the capabilities are not
		* defined in the ECOM resource file.
		*/
		virtual const TDesC8& Capabilities();


    private:

        /**
        * C++ default constructor.
        */
        CMCETestUIPlugin();

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();
        
		// Needed for cleanup of a RImplInfoPtrArray:
		static void ResetAndDestroy( TAny* anArray );

		void RefreshCapabilitiesL();

    private:    // Data

	    // MCETestUIPlugin's application UID        
    	TUid iApplicationUID;
    	
    	HBufC8* iCapabilitiesFromFile;
    };

#endif      // CMCETestUIPlugin_H   
            
// End of File