/*

* Copyright (c) 2009 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:  Java RemCon Observer

*

*/

#ifndef JAVAREMCONOBSERVABLE_H

#define JAVAREMCONOBSERVABLE_H

#include <e32base.h>

#include <remconcoreapitargetobserver.h>

#include "javaremconobserver.h"

class CRemConInterfaceSelector;

class CRemConCoreApiTarget;

/**

 * Class provides common access to CRemConInterfaceSelector for Java components

 *

 * Java RunTime needs to listen to various events like volume key press,

 * media key press and so on. For this purpose, various modules

 * in Java middleware register with CRemConCoreApiTarget to get events

 * to the observer MRemConCoreApiTargetObserver.

 * For this to happen, a target session has to be opened to RemCon,

 * which is done via CRemConInterfaceSelector::OpenTargetL(). At present,

 * whichever module wants it (say MMAPI, LCDUI etc) goes ahead and registers

 * by calling CRemConInterfaceSelector::OpenTargetL(). However when someother

 * module also calls the same, the OpenTargetL() returns KErrInUse as in

 * Java all modules are in one single process and one process can have

 * only one target session open to RemCon. This means that only one of the

 * required modules will get the events needed.

 *

 * Class provides common access to the target session to RemCon

 * which can be used by any module in Java.

 * The user of CRemConCoreApiTarget will need to use this class for the purpose

 * instead of creating themselves.

 *

 *  @lib javaremconobserver

 *  @since S60 v3.2

 */

class CJavaRemConObservable : public CBase, public MRemConCoreApiTargetObserver

{

public:

    static CJavaRemConObservable* NewL();

    static CJavaRemConObservable* NewLC();

    virtual ~CJavaRemConObservable();

public:

    /**

     * Add Observer

     *

     * @since S60 v3.2

     * @param aObserver Added observer, not owned

     */

    void AddObserverL(CJavaRemConObserver &aObserver);

    /**

     * Remove Observer

     *

     * @since S60 v3.2

     * @param aObserver Removed observer, not owned

     */

    void RemoveObserver(CJavaRemConObserver &aObserver);

    /**

     * Observers count

     *

     * @since S60 3.2

     */

    TInt Count();

public: // From MRemConCoreApiTargetObserver

    void MrccatoCommand(TRemConCoreApiOperationId aOperationId,

                        TRemConCoreApiButtonAction aButtonAct);

    void MrccatoPlay(TRemConCoreApiPlaybackSpeed aSpeed,

                     TRemConCoreApiButtonAction aButtonAct);

    void MrccatoTuneFunction(TBool aTwoPart,

                             TUint aMajorChannel,

                             TUint aMinorChannel,

                             TRemConCoreApiButtonAction aButtonAct);

    void MrccatoSelectDiskFunction(TUint aDisk,

                                   TRemConCoreApiButtonAction aButtonAct);

    void MrccatoSelectAvInputFunction(TUint8 aAvInputSignalNumber,

                                      TRemConCoreApiButtonAction aButtonAct);

    void MrccatoSelectAudioInputFunction(TUint8 aAudioInputSignalNumber,

                                         TRemConCoreApiButtonAction aButtonAct);

private:

    CJavaRemConObservable();

    void ConstructL();

private: // data

    /**

    * Observers

    */

    RPointerArray<CJavaRemConObserver> iObservers;

    /**

    * Owned.

    */

    CRemConInterfaceSelector* iInterfaceSelector;

    /**

    * Owned by iInterfaceSelector.

    */

    CRemConCoreApiTarget* iCoreTarget;

};

#endif // JAVAREMCONOBSERVABLE_H