/*

* Copyright (c) 2007-2008 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:  

*

*/

#ifndef C_HNMDSERVICE_H

#define C_HNMDSERVICE_H

//#include <mnaiwservices.h>

#include <liwcommon.h>

#include <e32base.h>

#include <e32hashtab.h>

#include <xmlengelement.h> 

class CLiwServiceHandler;

class CHnMdQuery;

class CLiwGenericParamList;

class MLiwInterface;

class CLiwDefaultMap;

class CHnMdBaseKey;

class CHnMdServiceCommand;

class CHnServiceHandler;

/**

 * Service.

 * 

 * This class is desinged to facilitate dealing with services. 	

 *

 * @lib hnmetadatamodel

 * @since S60 5.0 *** for example, S60 v3.0

 * @ingroup group_hnmetadatamodel

 */

NONSHARABLE_CLASS(CHnMdService) : public CBase

    {

public:

    /**

     * Two-phase constructor.

     *

     * @since S60 5.0

     * @param aElement Xml element.

     * @return Fully cosntructed object.

     */

    static CHnMdService* NewL( TXmlEngElement aElement );

    /**

     * Two-phase constructor.

     *

     * @since S60 5.0

     * @param aElement Xml element.

     * @return Fully cosntructed object.

     */

    static CHnMdService* NewLC( TXmlEngElement aElement );

    /**

     * Standard C++ virtual destructor.

     *

     * @since S60 5.0

     */

    virtual ~CHnMdService();

    /**

     * Gets service.

     *

     * @since S60 5.0

     * @return Service name.

     */

    const TDesC8& GetServiceName() const;

    /**

     * Gets interface.

     *

     * @since S60 5.0

     * @return Interface name.

     */

    const TDesC8& GetInterfaceName() const;

    /**

     * Gets command.

     *

     * @since S60 5.0

     * @return Service command.

     */

    const CHnMdServiceCommand& GetCommand() const;   

    /**

     * returns query results

     *

     * since S60 v5.0

     * @return Result of the query to the service.

     */

    const CLiwGenericParamList& Output() const;

    /**

     * Returns service query constructor.

     *

     * since S60 v5.0

     * @return A structure of the key objects.

     */

    CHnMdBaseKey* GetConstructor() const;

    /**

     * Reads the consturctor into the model

     *

     * since S60 v5.0

     * @param aElement Xml element.

     * @return A structure of the key objects.

     */

    void CHnMdService::SetConstructorL( TXmlEngElement aElement );

    /**

     * Evaluates constructor.

     * 

     * @param aList Evaluation parameter.

     * @param aPos Position of the record in the parameter's list.

     * @return Evaluated generic parameters list.

     */

    CLiwGenericParamList* EvaluateConstructorL( const CLiwGenericParamList& aList,

            TInt aPos = 0);

    /**

     * Evaluates constructor as key.

     * 

     * @param aList Evaluation parameter.

     * @param aPos Position of the record in the parameter's list.

     * @return Evaluated key.

     */

    CHnMdBaseKey* EvaluateConstructorAsKeyL( const CLiwGenericParamList& aList,

            TInt aPos = 0);

    /**

     * Evaluates command.

     * 

     * @param aList Evaluation parameter.

     * @param aPos Position of the record in the parameter's list.

     * @return Evaluated generic parameters list.

     */

    CLiwGenericParamList* EvaluateCommandL( const CLiwGenericParamList& aList, 

            TInt aPos = 0);

    /**

     * Evaluates command as key.

     * 

     * @param aList Evaluation parameter.

     * @param aPos Position of the record in the parameter's list.

     * @return Evaluated key.

     */

    CHnMdBaseKey* EvaluateCommandAsKeyL( const CLiwGenericParamList& aList, 

            TInt aPos = 0);

private:

    /**

     * Sets interface.

     * 

     * @param aAttr Xml attribute.

     */

    void SetInterfaceL( TXmlEngAttr aAttr );

    /**

     * Sets service.

     * 

     * @param aAttr Xml attribute.

     */

    void SetServiceL( TXmlEngAttr aAttr );

    /**

     * Standard C++ constructor.

     *

     * @since S60 5.0

     */

    CHnMdService(); 

    /**

     * Standard symbian 2nd phase contructor.

     *

     * @since S60 5.0

     * @param aElement Xml element.

     */

    void ConstructL( TXmlEngElement aElement );

private: // data

    /**

     * Own - Service.

     */

    RBuf8 iServiceName;

    /**

     * Own - Interface.

     */

    RBuf8 iInterfaceName;

    /**

     * Own - Service command.

     */

    CHnMdServiceCommand* iServiceCommand;

    /**

     * Stores input parameters (not data) of the service search method

     * (ExecuteServiceCmdL).

     * Own.

     */

    CHnMdBaseKey* iConstructor;

    };

#endif // C_HNMDSERVICEHANDLER_H