/** @file
* Copyright (c) 2005-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:  Declares the CUpnpSilentDeviceImplementation class
*
*/


#ifndef C_CUPNPSILENTDEVICEIMPLEMENTATION_H
#define C_CUPNPSILENTDEVICEIMPLEMENTATION_H


// INCLUDES
#include <e32std.h>
#include <badesca.h>
#include "upnpdeviceimplementationbase.h"


//FORWARD DECLARATIONS
class MUpnpDeviceDescriptionProvider;

/**
 *  CUpnpSilentDeviceImplementation
 *
 *  Prior using the CUpnpDevice class, client application has to create the network
 *  connection. If connection is not up and running, the
 *  CUpnpDispatcherEngine class construction will fail.
 *  See UPnP Interface Design document for instuctions.
 *
 *  @since Series60 3.2
 */
class CUpnpSilentDeviceImplementation : public CUpnpDeviceImplementationBase
    {
public:

    /**
     * Two-phased constructor.
     * The most important operations invoked inside this method:
     * 1. Start Upnp Stack (if not started yet)
     * 2. Parse device description to DOM for further updating purpose.
     *
     * @since Series60 3.2
     * @param aFilename File to create device from, name include full path.
     * @return A new CUpnpDevice instance.
     */
    IMPORT_C static CUpnpSilentDeviceImplementation* NewL( 
            const TDesC8& aUri, 
            CUpnpDeviceDescriptionStore& aDescriptionStore,
            MUpnpDeviceDescriptionProvider& aProvider );

    /**
     * Called after the device is constructed.
     * The most important operations invoked inside this method:
     * 1. Start the HTTP server.
     * 2. Generate the UUID (if missing in the device description)
     * 3. Save the device description to the file.
     * 
     * @since Series60 3.2
     * @return none
     */
    IMPORT_C virtual void StartL( const TInt aPort = KRandomPort );

    /**
     * Stops the device.
     * @since Series60 3.2
     */
    IMPORT_C virtual void StopL();

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

    /**
     * Destructor.
     */
    IMPORT_C virtual ~CUpnpSilentDeviceImplementation();

private:

    /**
     * Symbian 2nd phase constructor can leave
     * @since Series60 3.2
     * @param aFilename File to create device from
     */
    void ConstructL( const TDesC8& aUri, 
                     CUpnpDeviceDescriptionStore& aDescriptionStore,
                     MUpnpDeviceDescriptionProvider& aProvider );

    /**
     * Internal: Stops device and HTTP server
     * @since Series60 3.2
     */
    void StopDeviceL();

    };

#endif  // C_CUPNPSILENTDEVICEIMPLEMENTATION_H

// End of File