satengine/satserver/Commands/SendUSSDCmd/inc/CSendUssdHandler.h
author hgs
Fri, 17 Sep 2010 17:09:13 +0300
changeset 48 78df25012fda
parent 33 8d5d7fcf9b59
permissions -rw-r--r--
201037
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
33
hgs
parents:
diff changeset
     1
/*
48
hgs
parents: 33
diff changeset
     2
* Copyright (c) 2002-2010 Nokia Corporation and/or its subsidiary(-ies). 
33
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:  SendUssd command handler
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
hgs
parents:
diff changeset
    19
#ifndef CSENDUSSDHANDLER_H
hgs
parents:
diff changeset
    20
#define CSENDUSSDHANDLER_H
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
#include <etelsat.h>
hgs
parents:
diff changeset
    23
hgs
parents:
diff changeset
    24
#include "CSatCommandHandler.h"
hgs
parents:
diff changeset
    25
#include "SatSTypes.h"
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
class MSatUtils;
hgs
parents:
diff changeset
    28
class CPhCltUssdSatClient;
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
/**
hgs
parents:
diff changeset
    31
*  Command handler for SendUssd command.
hgs
parents:
diff changeset
    32
*
hgs
parents:
diff changeset
    33
*  @lib SendUssd.lib
hgs
parents:
diff changeset
    34
*  @since S60 v3.0
hgs
parents:
diff changeset
    35
*/
hgs
parents:
diff changeset
    36
class CSendUssdHandler : public CSatCommandHandler
hgs
parents:
diff changeset
    37
    {
hgs
parents:
diff changeset
    38
    
hgs
parents:
diff changeset
    39
public:
hgs
parents:
diff changeset
    40
hgs
parents:
diff changeset
    41
    static CSendUssdHandler* NewL( MSatUtils* aUtils );
hgs
parents:
diff changeset
    42
hgs
parents:
diff changeset
    43
    virtual ~CSendUssdHandler();
hgs
parents:
diff changeset
    44
hgs
parents:
diff changeset
    45
// from base class MSatCommand
hgs
parents:
diff changeset
    46
hgs
parents:
diff changeset
    47
    /**
hgs
parents:
diff changeset
    48
     * From MSatCommand.
hgs
parents:
diff changeset
    49
     * Response from the client
hgs
parents:
diff changeset
    50
     *
hgs
parents:
diff changeset
    51
     */
hgs
parents:
diff changeset
    52
    void ClientResponse();
hgs
parents:
diff changeset
    53
hgs
parents:
diff changeset
    54
// from base class CSatCommandHandler
hgs
parents:
diff changeset
    55
hgs
parents:
diff changeset
    56
    /**
hgs
parents:
diff changeset
    57
     * From CSatCommandHandler
hgs
parents:
diff changeset
    58
     * Overrides the default implementation.
hgs
parents:
diff changeset
    59
     *
hgs
parents:
diff changeset
    60
     * @param aEvent Identifies the event.
hgs
parents:
diff changeset
    61
     */
hgs
parents:
diff changeset
    62
    void Event( TInt aEvent );
hgs
parents:
diff changeset
    63
hgs
parents:
diff changeset
    64
protected:
hgs
parents:
diff changeset
    65
hgs
parents:
diff changeset
    66
// from base class CActive
hgs
parents:
diff changeset
    67
hgs
parents:
diff changeset
    68
    /**
hgs
parents:
diff changeset
    69
     * From CActive
hgs
parents:
diff changeset
    70
     * Cancels the usat request.
hgs
parents:
diff changeset
    71
     *
hgs
parents:
diff changeset
    72
     */
hgs
parents:
diff changeset
    73
    void DoCancel();
hgs
parents:
diff changeset
    74
    
hgs
parents:
diff changeset
    75
// from base class CSatCommandHandler
hgs
parents:
diff changeset
    76
hgs
parents:
diff changeset
    77
    /**
hgs
parents:
diff changeset
    78
     * From CSatCommandHandler
hgs
parents:
diff changeset
    79
     * Requests the command notification.
hgs
parents:
diff changeset
    80
     *
hgs
parents:
diff changeset
    81
     * @param aStatus Request status
hgs
parents:
diff changeset
    82
     */
hgs
parents:
diff changeset
    83
    void IssueUSATRequest( TRequestStatus& aStatus );
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
    /**
hgs
parents:
diff changeset
    86
     * From CSatCommandHandler
hgs
parents:
diff changeset
    87
     * Precheck before executing the command.
hgs
parents:
diff changeset
    88
     *
hgs
parents:
diff changeset
    89
     * @return TBool indicating command is currently allowed.
hgs
parents:
diff changeset
    90
     */
hgs
parents:
diff changeset
    91
    TBool CommandAllowed();
hgs
parents:
diff changeset
    92
hgs
parents:
diff changeset
    93
    /**
hgs
parents:
diff changeset
    94
     * From CSatCommandHandler
hgs
parents:
diff changeset
    95
     * Need for ui session.
hgs
parents:
diff changeset
    96
     *
hgs
parents:
diff changeset
    97
     * @return TBool indicating need of ui session.
hgs
parents:
diff changeset
    98
     */
hgs
parents:
diff changeset
    99
    TBool NeedUiSession();
hgs
parents:
diff changeset
   100
hgs
parents:
diff changeset
   101
    /**
hgs
parents:
diff changeset
   102
     * From CSatCommandHandler
hgs
parents:
diff changeset
   103
     * Called when USAT API notifies that command.
hgs
parents:
diff changeset
   104
     *
hgs
parents:
diff changeset
   105
     */
hgs
parents:
diff changeset
   106
    void HandleCommand();
hgs
parents:
diff changeset
   107
hgs
parents:
diff changeset
   108
    /**
hgs
parents:
diff changeset
   109
     * From CSatCommandHandler.
hgs
parents:
diff changeset
   110
     * Indicates the failure of launching ui client
hgs
parents:
diff changeset
   111
     *
hgs
parents:
diff changeset
   112
     */
hgs
parents:
diff changeset
   113
    void UiLaunchFailed();
hgs
parents:
diff changeset
   114
hgs
parents:
diff changeset
   115
private:
hgs
parents:
diff changeset
   116
hgs
parents:
diff changeset
   117
    CSendUssdHandler();
hgs
parents:
diff changeset
   118
hgs
parents:
diff changeset
   119
    /**
hgs
parents:
diff changeset
   120
     * Handles the Ussd string sending
hgs
parents:
diff changeset
   121
     *
hgs
parents:
diff changeset
   122
     */
hgs
parents:
diff changeset
   123
    void SendUssdString();
hgs
parents:
diff changeset
   124
hgs
parents:
diff changeset
   125
    /**
hgs
parents:
diff changeset
   126
     * Handles the Ussd string sending
hgs
parents:
diff changeset
   127
     *
hgs
parents:
diff changeset
   128
     * @param aSendMessage The USSD string to be sent
hgs
parents:
diff changeset
   129
     * @param aSendDcs Data coding scheme of the USSD string
hgs
parents:
diff changeset
   130
     * @param aReceiveMessage Response message from NW
hgs
parents:
diff changeset
   131
     * @param aSendCompletedFirst Indicates is this function completed
hgs
parents:
diff changeset
   132
     *        before response
hgs
parents:
diff changeset
   133
     * @param aReceivedDcs Data coding scheme of the received USSD string
hgs
parents:
diff changeset
   134
     */
hgs
parents:
diff changeset
   135
    void SendUssdStringL(
hgs
parents:
diff changeset
   136
        const TDesC& aSendMessage,
hgs
parents:
diff changeset
   137
        const TUint8 aSendDcs,
hgs
parents:
diff changeset
   138
        TDes& aReceiveMessage,
hgs
parents:
diff changeset
   139
        TBool& aSendCompletedFirst,
hgs
parents:
diff changeset
   140
        TUint8& aReceivedDcs );
hgs
parents:
diff changeset
   141
hgs
parents:
diff changeset
   142
    /**
48
hgs
parents: 33
diff changeset
   143
     * Show the ussd response note.
hgs
parents: 33
diff changeset
   144
     *
hgs
parents: 33
diff changeset
   145
     * @param aText The USSD response string to be shown.
hgs
parents: 33
diff changeset
   146
     */
hgs
parents: 33
diff changeset
   147
     void ShowUssdResponseNoteL( const TDesC& aText );
hgs
parents: 33
diff changeset
   148
hgs
parents: 33
diff changeset
   149
    /**
33
hgs
parents:
diff changeset
   150
     * Handles the result of Ussd sending
hgs
parents:
diff changeset
   151
     *
hgs
parents:
diff changeset
   152
     * @param aError Result of Ussd sending
hgs
parents:
diff changeset
   153
     */
hgs
parents:
diff changeset
   154
    void HandleSendUssdResult( TInt aError );
hgs
parents:
diff changeset
   155
hgs
parents:
diff changeset
   156
    /**
hgs
parents:
diff changeset
   157
     * Converts reveived Dcs to correct format
hgs
parents:
diff changeset
   158
     *
hgs
parents:
diff changeset
   159
     * @param aReceivedDcs Received Dcs to convert
hgs
parents:
diff changeset
   160
     */
hgs
parents:
diff changeset
   161
    void ConvertReceivedDcs( TUint8& aReceivedDcs ) const;
hgs
parents:
diff changeset
   162
hgs
parents:
diff changeset
   163
    /**
hgs
parents:
diff changeset
   164
     * Sends terminal response. Makes sure that terminal response
hgs
parents:
diff changeset
   165
     * is not send more that once / command.
hgs
parents:
diff changeset
   166
     *
hgs
parents:
diff changeset
   167
     */
hgs
parents:
diff changeset
   168
    void SendTerminalResponse();
hgs
parents:
diff changeset
   169
hgs
parents:
diff changeset
   170
    /**
hgs
parents:
diff changeset
   171
     * Checks is the command transparent or not
hgs
parents:
diff changeset
   172
     *
hgs
parents:
diff changeset
   173
     */
hgs
parents:
diff changeset
   174
    TBool TransparentUssdSending();
48
hgs
parents: 33
diff changeset
   175
    
hgs
parents: 33
diff changeset
   176
    /**
hgs
parents: 33
diff changeset
   177
     * Check whether the ussd sending result is displayed
hgs
parents: 33
diff changeset
   178
     * @return 1 indicating the result is displayed
hgs
parents: 33
diff changeset
   179
     */
hgs
parents: 33
diff changeset
   180
    TInt SatDisplayUssdResultL();
33
hgs
parents:
diff changeset
   181
hgs
parents:
diff changeset
   182
private: // data
hgs
parents:
diff changeset
   183
hgs
parents:
diff changeset
   184
    /**
hgs
parents:
diff changeset
   185
     * SendUssd command data.
hgs
parents:
diff changeset
   186
     */
hgs
parents:
diff changeset
   187
    RSat::TSendUssdV1 iSendUssdData;
hgs
parents:
diff changeset
   188
hgs
parents:
diff changeset
   189
    /**
hgs
parents:
diff changeset
   190
     * SendUssd command package.
hgs
parents:
diff changeset
   191
     */
hgs
parents:
diff changeset
   192
    RSat::TSendUssdV1Pckg iSendUssdPckg;
hgs
parents:
diff changeset
   193
hgs
parents:
diff changeset
   194
    /**
hgs
parents:
diff changeset
   195
     * Response from client
hgs
parents:
diff changeset
   196
     */
hgs
parents:
diff changeset
   197
    RSat::TSendUssdRspV1 iSendUssdRsp;
hgs
parents:
diff changeset
   198
hgs
parents:
diff changeset
   199
    /**
hgs
parents:
diff changeset
   200
     * Response package.
hgs
parents:
diff changeset
   201
     */
hgs
parents:
diff changeset
   202
    RSat::TSendUssdRspV1Pckg iSendUssdRspPckg;
hgs
parents:
diff changeset
   203
hgs
parents:
diff changeset
   204
    /**
hgs
parents:
diff changeset
   205
     * UI query and notification data:
hgs
parents:
diff changeset
   206
     */
hgs
parents:
diff changeset
   207
    TBool iNeedUiSession;
hgs
parents:
diff changeset
   208
hgs
parents:
diff changeset
   209
    /**
hgs
parents:
diff changeset
   210
     * Indicates the query status
hgs
parents:
diff changeset
   211
     */
hgs
parents:
diff changeset
   212
    TBool iQueryOn;
hgs
parents:
diff changeset
   213
hgs
parents:
diff changeset
   214
    /**
hgs
parents:
diff changeset
   215
     * Indicates is AlphaId present
hgs
parents:
diff changeset
   216
     */
hgs
parents:
diff changeset
   217
    TBool iAlphaIdPresent;
hgs
parents:
diff changeset
   218
hgs
parents:
diff changeset
   219
    /**
hgs
parents:
diff changeset
   220
     * Query command data.
hgs
parents:
diff changeset
   221
     */
hgs
parents:
diff changeset
   222
    TSatQueryV1 iQueryData;
hgs
parents:
diff changeset
   223
hgs
parents:
diff changeset
   224
    /**
hgs
parents:
diff changeset
   225
     * Query package.
hgs
parents:
diff changeset
   226
     */
hgs
parents:
diff changeset
   227
    TSatQueryV1Pckg iQueryPckg;
hgs
parents:
diff changeset
   228
hgs
parents:
diff changeset
   229
    /**
hgs
parents:
diff changeset
   230
     * Query response.
hgs
parents:
diff changeset
   231
     */
hgs
parents:
diff changeset
   232
    TSatQueryRspV1 iQueryRsp;
hgs
parents:
diff changeset
   233
hgs
parents:
diff changeset
   234
    /**
hgs
parents:
diff changeset
   235
     * Query rsp package.
hgs
parents:
diff changeset
   236
     */
hgs
parents:
diff changeset
   237
    TSatQueryRspV1Pckg iQueryRspPckg;
hgs
parents:
diff changeset
   238
hgs
parents:
diff changeset
   239
    /**
hgs
parents:
diff changeset
   240
     * Notification send data
hgs
parents:
diff changeset
   241
     */
hgs
parents:
diff changeset
   242
    TSatNotificationV1 iNotificationData;
hgs
parents:
diff changeset
   243
hgs
parents:
diff changeset
   244
    /**
hgs
parents:
diff changeset
   245
     * Notification package
hgs
parents:
diff changeset
   246
     */
hgs
parents:
diff changeset
   247
    TSatNotificationV1Pckg iNotificationDataPckg;
hgs
parents:
diff changeset
   248
hgs
parents:
diff changeset
   249
    /**
hgs
parents:
diff changeset
   250
     * Notification Response data
hgs
parents:
diff changeset
   251
     */
hgs
parents:
diff changeset
   252
    TSatNotificationRspV1 iNotificationRsp;
hgs
parents:
diff changeset
   253
hgs
parents:
diff changeset
   254
    /**
hgs
parents:
diff changeset
   255
     * Notification Response package
hgs
parents:
diff changeset
   256
     */
hgs
parents:
diff changeset
   257
    TSatNotificationRspV1Pckg iNotificationRspPckg;
hgs
parents:
diff changeset
   258
hgs
parents:
diff changeset
   259
    /**
hgs
parents:
diff changeset
   260
     * Indicates is notification sent
hgs
parents:
diff changeset
   261
     */
hgs
parents:
diff changeset
   262
    TBool iNotificationSent;
hgs
parents:
diff changeset
   263
hgs
parents:
diff changeset
   264
    /**
hgs
parents:
diff changeset
   265
     * Indicates is terminal response sent
hgs
parents:
diff changeset
   266
     */
hgs
parents:
diff changeset
   267
    TBool iTerminalRespSent;
hgs
parents:
diff changeset
   268
hgs
parents:
diff changeset
   269
    /**
hgs
parents:
diff changeset
   270
     * Ussd sender
hgs
parents:
diff changeset
   271
     */
hgs
parents:
diff changeset
   272
    CPhCltUssdSatClient* iUssdClient;
hgs
parents:
diff changeset
   273
hgs
parents:
diff changeset
   274
    /**
hgs
parents:
diff changeset
   275
     * Blocks the USSD send until user has respond
hgs
parents:
diff changeset
   276
     */
hgs
parents:
diff changeset
   277
    CActiveSchedulerWait iWait;
hgs
parents:
diff changeset
   278
hgs
parents:
diff changeset
   279
    /**
hgs
parents:
diff changeset
   280
     * Indicates wether user accepted or rejected
hgs
parents:
diff changeset
   281
     */
hgs
parents:
diff changeset
   282
    TBool iUserAccepted;
hgs
parents:
diff changeset
   283
    
hgs
parents:
diff changeset
   284
    /**
hgs
parents:
diff changeset
   285
     * Flag to signal that command has icon data
hgs
parents:
diff changeset
   286
     * To be removed when icons are allowed in this command
hgs
parents:
diff changeset
   287
     */
hgs
parents:
diff changeset
   288
    TBool iIconCommand;
hgs
parents:
diff changeset
   289
48
hgs
parents: 33
diff changeset
   290
    /**
hgs
parents: 33
diff changeset
   291
     * Indicates whether the result of sending USSD is displayed
hgs
parents: 33
diff changeset
   292
     */
hgs
parents: 33
diff changeset
   293
    TBool iIsSatDisplayUssdResult;
33
hgs
parents:
diff changeset
   294
    };
hgs
parents:
diff changeset
   295
hgs
parents:
diff changeset
   296
#endif      // CSENDUSSDHANDLER_H
hgs
parents:
diff changeset
   297