2 * Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).

     2 * Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies).

    22 #include <downloadmgrclient.h>

    22 #include <f32file.h> // RFs

    23 #include <AknProgressDialog.h>

    23 #include <RoapObserver.h> // Roap::MRoapObserver

    24 #include <eikprogi.h>

    24 #include <AknProgressDialog.h> // MAknProgressDialogCallback CAknProgressDialog

    25 

    26 // download apis

    27 #include <downloadmanager.h>

    28 #include <download.h>

    29 #include <downloadevent.h>

    30 

    31 namespace Roap

    32     {

    33     class CRoapEng;

    34     }

    35 

    36 namespace DRM

    37     {

    38     class CDrmUtilityConnection;

    39     }

    40 class CDRMRights;

    41 class CEikProgressInfo;

    42 class DrmUtilityEventHandler;

    43 class QDrmUtilityDmgrEventHandler;

    53 class CDrmUtilityDmgrWrapper : CBase,

    72 class CDrmUtilityDmgrWrapper :

    54     public MHttpDownloadMgrObserver,

    73     public CActive,

    74     public Roap::MRoapObserver,

    58 

    78 private:

    79 

    80     enum TDownloadState

    81         {

    82         EInit,

    83         EGetMeteringTrigger,

    84         ESaveMeteringTrigger,

    85         EMeteringReportSubmit,

    86         EGetPrUrlTrigger,

    87         ESavePrUrlTrigger,

    88         EPrRoapRequest,

    89         EComplete

    90         };

    79 

   111 // From Roap::MRoapObserver

    80     // from base class MHttpDownloadMgrObserver

   112     /**

    81 

   113     * ConnectionConfL

    82     /**

   114     * @return ETrue: the network can be establish

    83     * From MHttpDownloadMgrObserver.

   115     *         EFalse: the ROAP transaction is canceled

    84     * Handle download manager events

   116     *

    85     *

   117     * @leave  System wide error code */

    86     * @param aDownload the download

   118     TBool ConnectionConfL();

    87     * @param aEvent the event

   119 

    88     */

   120     /**

    89     void HandleDMgrEventL( RHttpDownload& aDownload, THttpDownloadEvent aEvent );

   121     * ContactRiConfL

   122     * @return ETrue: the user consent is achieved

   123     *         EFalse: the user consent is not achieved

   124     *

   125     * @leave  System wide error code */

   126     TBool ContactRiConfL();

   127 

   128     /**

   129     * TransIdConfL

   130     * @return ETrue: the user consent is achieved

   131     *         EFalse: the user consent is not achieved

   132     *

   133     * @leave  System wide error code */

   134 

   135     TBool TransIdConfL();

   136 

   137     /**

   138     * RightsObjectDetailsL

   139     *

   140     * The function is called after successful completion of RO acquisition

   141     * protocol. The passes information about stored rights objects to the

   142     * observer.

   143     *

   144     * @since  3.0

   145     * @param aRightsList: A list of pointers to rights objects.

   146     *                     Contents of aRightsList are owend by ROAP engine

   147     *

   148     * @leave  System wide error code */

   149     void RightsObjectDetailsL( const RPointerArray<CDRMRights>& aRightsList );

   150 

   151     /**

   152     * ContentDownloadInfoL

   153     *

   154     * The function is called when the ROAP engine notices that it is about to

   155     * receive a multipart content as a ROAP response. The method must return via

   156     * out-parameter the path to a temp folder where the content is saved during

   157     * download. The name that is used as filename when saving the content to

   158     * the appropriate palce and the maximum size of the content (a safety upper limit)

   159     * must also be provided via out-parameters.

   160     *

   161     * @since 3.0

   162     * @param aTempFolder: (out-param) The path of the temp folder, or KNullDesC

   163     * @param aContentName: (out-param) The name of the content, or KNullDesC (defaut name is used)

   164     * @param aMaxSize: (out-param) The maximum size of the content, or -1 if not known

   165     *

   166     * @leave System wide error code */

   167 

   168     void ContentDownloadInfoL( TPath& aTempFolder,

   169             TFileName& aContentName,

   170             TInt& aMaxSize );

   171 

   172     /**

   173     * ContentDetailsL

   174     *

   175     * The function is called when the ROAP engine has received a DCF content (together

   176     * with a ROAP response) The ROAP engine saves the DCF to the appropriate location

   177     * and gives out the information about the saved DCF file by calling this method

   178     *

   179     * @since 3.0

   180     * @param aPath: The path andf the filename of the saved DCF file

   181     * @param aType: The plain MIME type of the saved DCF file

   182     * @param aAppUid: The handler app UID of the saved DCF file

   183     *

   184     * @leave System wide error code */

   185 

   186     void ContentDetailsL( const TDesC& aPath,

   187             const TDesC8& aType,

   188             const TUid& aAppUid );

   189 

   190     /**

   191     * RoapProgressInfoL

   192     *

   193     * The function provides progress information about ROAP processing to the

   194     * observer

   195     *

   196     * @since  3.0

   197     * @param aProgressInfo: An integer value representing the state of

   198     *                       ROAP processing, counting in bytes

   199     *

   200     * @leave  System wide error code */

   201 

   202     void RoapProgressInfoL( const TInt aProgressInfo );

   203 

   204     /**

   205     * ErrorUrlL

   206     *

   207     * The function is called in ROAP error case and it provides an error URL

   208     * for the caller. The calling entity should send an HTTP GET request to

   209     * the URL which should then return an HTML page.

   210     *

   211     * @since  3.0

   212     * @param aErrorUrl: The error URL

   213     *

   214     *

   215     * @leave  System wide error code */

   216 

   217     void ErrorUrlL( const TDesC8& aErrorUrl );

   218 

   219     /**

   220     * PostResponseUrlL

   221     *

   222     * The function is called if handled ROAP metering report response

   223     * contains PostResponseURL extension. The calling entity should send

   224     * an HTTP GET request to the URL, which should return ROAP trigger,

   225     * download descriptor or multipart message containing both

   226     * download descriptor and ROAP trigger.

   227     *

   228     * @since  3.2

   229     * @param aPostResponseUrl: The URL to be fetched

   230     *                          after handling ROAP metering response

   231     *                          with PostResponseURL extension.

   232     *

   233     *

   234     * @leave  System wide error code */

   235     void PostResponseUrlL( const TDesC8& aPostResponseUrl );

   102 

   256     //from Cactive

   257     virtual void DoCancel();

   258 

   259     virtual void RunL();

   260 

   261     virtual TInt RunError( TInt aError );

   115     void SetDefaultAccessPointL();

   274 

   116 

   117     void DoDownloadAndHandleRoapTriggerL( const HBufC8* aUrl );

   123     void HandlePostResponseUrlL();

   280     void DoConnectL( TDownloadState aNextState );

   124 

   281 

   282     void DoDownloadRoapTriggerL( TDownloadState aNextState );

   283 

   284     void DoSaveRoapTriggerL( TDownloadState aNextState );

   285 

   286     void DoHandleRoapTriggerL( TDownloadState aNextState );

   287 

   288     void CompleteToState( TDownloadState aNextState, TInt aError );

   289     

   290     void ProcessDownloadEventL( WRT::Download& aDownload, WRT::DownloadEvent& aEvent );

   131     RHttpDownloadMgr iDlMgr;

   297     WRT::DownloadManager* iDlMgr;

   132 

   298 

   299     /**

   300      * Download instance needs to be stored for handling signal slot mechanism

   301      */

   302     WRT::Download* iDownload;

   303