/*

* Copyright (c) 2006 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:  A service which constains a service plugin and its status.

*

*/

#ifndef C_LOCODSERVICE_H

#define C_LOCODSERVICE_H

#include <e32base.h>

#include <startupdomainpskeys.h>

#include <locodbearerpluginobserver.h>

#include <locodservicepluginobserver.h>

class CLocodServicePlugin;

class TLocodServiceRequest;

/**

 *  Specific service that is managed by locod

 *   Locod creates all service and add it to 

 *   a an array

 *  @ euser.lib

 *  @since S60 3.2

 */        

class CLocodService : public CBase

    {

public:

    /**

     *  Factory function

     * @since S60 3.2

     * @param aPlugin  the sevice plug ins that will be managed (for example DUN, obex)

     * @return an instance of CLocodService

     */

    static CLocodService* NewL(CLocodServicePlugin& aPlugin);

    ~CLocodService();

    CLocodServicePlugin& Plugin();

    /**

     *  Called to manage service when the bearer status has been changed

     * @since S60 3.2

     * @param aBearer  the bearer whose status has been changed

     * @param aStatus  status of the bearer connected, disconnected or on or off

     * @return  TInt

     */

    TInt ManageService(TLocodBearer aBearer, 

        TBool aStatus); 

    /**

     *  Called when the service has been managed by service plug ins

     * @since S60 3.2

     * @param aBearer  the bearer whose service has been managed

     * @param aStatus  status of the bearer connected, disconnected or on or off

     * @param err   error code that may occured during managing the service

     * @return  TInt

     */

    void ManageServiceCompleted(TLocodBearer aBearer, 

        TBool aStatus,

        TInt err); 

    /**

     *  Check if there are any service pending

     * @since S60 3.2

     * @return  TBool if there are service pending

     */

    TBool HasServiceToManage() const;

private:

    CLocodService(CLocodServicePlugin& aPlugin);

    void ConstructL();

private:

    // the service plugin, owned

    CLocodServicePlugin* iPlugin;

    // The latest status of this service plugin

    TInt iServiceStatus;

    // Queue of ManageService request

    RArray<TLocodServiceRequest> iRequests;

    };

/**

 * A ManageService request

 */

class TLocodServiceRequest

    {

public:

    TLocodServiceRequest(TLocodBearer aBearer, TBool aStatus);

    // The bearer whose status has changed

    TLocodBearer iBearer;

    // The new bearer status

    TBool iStatus;

    // The request status

    TBool iRequesting;

    };

#endif // C_LOCODSERVICE_H