satengine/satserver/Commands/SendSSCmd/inc/CSendSsHandler.h
author hgs
Tue, 10 Aug 2010 13:19:41 +0300
changeset 38 bc103bfb69cf
parent 33 8d5d7fcf9b59
permissions -rw-r--r--
201031_02
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
33
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies). 
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:  Proactive SendSs 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 CSENDSSHANDLER_H
hgs
parents:
diff changeset
    20
#define CSENDSSHANDLER_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 CSatSendSsRequestCompleteHandler;
hgs
parents:
diff changeset
    29
class CSatSendSsAdditionalInfoHandler;
hgs
parents:
diff changeset
    30
class CPhoneGsmHandlerBase;
hgs
parents:
diff changeset
    31
class CPhoneGsmParserBase;
hgs
parents:
diff changeset
    32
class CPhoneGsmParserResult;
hgs
parents:
diff changeset
    33
class CPhoneGsmOptionContainerBase;
hgs
parents:
diff changeset
    34
hgs
parents:
diff changeset
    35
/**
hgs
parents:
diff changeset
    36
*  Command handler for SendSS command.
hgs
parents:
diff changeset
    37
*
hgs
parents:
diff changeset
    38
*  @lib SendSSCmd.lib
hgs
parents:
diff changeset
    39
*  @since S60 v3.0
hgs
parents:
diff changeset
    40
*/
hgs
parents:
diff changeset
    41
class CSendSSHandler : public CSatCommandHandler
hgs
parents:
diff changeset
    42
    {
hgs
parents:
diff changeset
    43
    
hgs
parents:
diff changeset
    44
public:
hgs
parents:
diff changeset
    45
hgs
parents:
diff changeset
    46
    static CSendSSHandler* NewL( MSatUtils* aUtils );
hgs
parents:
diff changeset
    47
hgs
parents:
diff changeset
    48
    virtual ~CSendSSHandler();
hgs
parents:
diff changeset
    49
    
hgs
parents:
diff changeset
    50
    /**
hgs
parents:
diff changeset
    51
     * Processes the SS Request Complete.
hgs
parents:
diff changeset
    52
     *
hgs
parents:
diff changeset
    53
     * @param aErrCode Result of Ss sending
hgs
parents:
diff changeset
    54
     */
hgs
parents:
diff changeset
    55
    void DispatchSsRequestComplete( const TInt aErrCode );
hgs
parents:
diff changeset
    56
hgs
parents:
diff changeset
    57
    /**
hgs
parents:
diff changeset
    58
     * Processes the SS aditional info.
hgs
parents:
diff changeset
    59
     *
hgs
parents:
diff changeset
    60
     * @param Addtional info.
hgs
parents:
diff changeset
    61
     */
hgs
parents:
diff changeset
    62
    void DispatchSsAdditionalInfo( const TDesC& aAdditionalInfo );
hgs
parents:
diff changeset
    63
hgs
parents:
diff changeset
    64
// from base class MSatCommand
hgs
parents:
diff changeset
    65
hgs
parents:
diff changeset
    66
    /**
hgs
parents:
diff changeset
    67
     * From MSatCommand.
hgs
parents:
diff changeset
    68
     * Response from the client
hgs
parents:
diff changeset
    69
     *
hgs
parents:
diff changeset
    70
     */
hgs
parents:
diff changeset
    71
    void ClientResponse();
hgs
parents:
diff changeset
    72
    
hgs
parents:
diff changeset
    73
// from base class CSatCommandHandler
hgs
parents:
diff changeset
    74
hgs
parents:
diff changeset
    75
    /**
hgs
parents:
diff changeset
    76
     * From CSatCommandHandler
hgs
parents:
diff changeset
    77
     * Overrides the default implementation.
hgs
parents:
diff changeset
    78
     *
hgs
parents:
diff changeset
    79
     * @param aEvent Identifies the event.
hgs
parents:
diff changeset
    80
     */
hgs
parents:
diff changeset
    81
    void Event( TInt aEvent );
hgs
parents:
diff changeset
    82
hgs
parents:
diff changeset
    83
protected:
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
// from base class CActive
hgs
parents:
diff changeset
    86
hgs
parents:
diff changeset
    87
    /**
hgs
parents:
diff changeset
    88
     * From CActive
hgs
parents:
diff changeset
    89
     * Cancels the usat request.
hgs
parents:
diff changeset
    90
     *
hgs
parents:
diff changeset
    91
     */
hgs
parents:
diff changeset
    92
    void DoCancel();
hgs
parents:
diff changeset
    93
    
hgs
parents:
diff changeset
    94
// from base class CSatCommandHandler
hgs
parents:
diff changeset
    95
hgs
parents:
diff changeset
    96
    /**
hgs
parents:
diff changeset
    97
     * From CSatCommandHandler
hgs
parents:
diff changeset
    98
     * Requests the command notification.
hgs
parents:
diff changeset
    99
     *
hgs
parents:
diff changeset
   100
     * @param aStatus Request status
hgs
parents:
diff changeset
   101
     */
hgs
parents:
diff changeset
   102
    void IssueUSATRequest( TRequestStatus& aStatus );
hgs
parents:
diff changeset
   103
hgs
parents:
diff changeset
   104
    /**
hgs
parents:
diff changeset
   105
     * From CSatCommandHandler
hgs
parents:
diff changeset
   106
     * Precheck before executing the command.
hgs
parents:
diff changeset
   107
     *
hgs
parents:
diff changeset
   108
     * @return TBool indicating command is currently allowed.
hgs
parents:
diff changeset
   109
     */
hgs
parents:
diff changeset
   110
    TBool CommandAllowed();
hgs
parents:
diff changeset
   111
hgs
parents:
diff changeset
   112
    /**
hgs
parents:
diff changeset
   113
     * From CSatCommandHandler
hgs
parents:
diff changeset
   114
     * Need for ui session.
hgs
parents:
diff changeset
   115
     *
hgs
parents:
diff changeset
   116
     * @return TBool indicating need of ui session.
hgs
parents:
diff changeset
   117
     */
hgs
parents:
diff changeset
   118
    TBool NeedUiSession();
hgs
parents:
diff changeset
   119
hgs
parents:
diff changeset
   120
    /**
hgs
parents:
diff changeset
   121
     * From CSatCommandHandler
hgs
parents:
diff changeset
   122
     * Called when USAT API notifies that command.
hgs
parents:
diff changeset
   123
     *
hgs
parents:
diff changeset
   124
     */
hgs
parents:
diff changeset
   125
    void HandleCommand();
hgs
parents:
diff changeset
   126
hgs
parents:
diff changeset
   127
    /**
hgs
parents:
diff changeset
   128
     * From CSatCommandHandler.
hgs
parents:
diff changeset
   129
     * Indicates the failure of launching ui client
hgs
parents:
diff changeset
   130
     *
hgs
parents:
diff changeset
   131
     */
hgs
parents:
diff changeset
   132
    void UiLaunchFailed();
hgs
parents:
diff changeset
   133
hgs
parents:
diff changeset
   134
private:
hgs
parents:
diff changeset
   135
hgs
parents:
diff changeset
   136
    CSendSSHandler();
hgs
parents:
diff changeset
   137
hgs
parents:
diff changeset
   138
    void ConstructL();
hgs
parents:
diff changeset
   139
hgs
parents:
diff changeset
   140
    /**
hgs
parents:
diff changeset
   141
     * Handles the Ss string sending
hgs
parents:
diff changeset
   142
     *
hgs
parents:
diff changeset
   143
     */
hgs
parents:
diff changeset
   144
    void SendSsStringL();
hgs
parents:
diff changeset
   145
hgs
parents:
diff changeset
   146
    /**
hgs
parents:
diff changeset
   147
     * Handles the result of Ss sending
hgs
parents:
diff changeset
   148
     *
hgs
parents:
diff changeset
   149
     */
hgs
parents:
diff changeset
   150
    void HandleSendSsResult();
hgs
parents:
diff changeset
   151
hgs
parents:
diff changeset
   152
    /**
hgs
parents:
diff changeset
   153
     * Checks is the command transparent or not
hgs
parents:
diff changeset
   154
     *
hgs
parents:
diff changeset
   155
     * @return Boolean indicating is current command transparent to user
hgs
parents:
diff changeset
   156
     */
hgs
parents:
diff changeset
   157
    TBool TransparentSsSending();
hgs
parents:
diff changeset
   158
hgs
parents:
diff changeset
   159
    /**
hgs
parents:
diff changeset
   160
     * Sends terminal response, if not yet sent
hgs
parents:
diff changeset
   161
     *
hgs
parents:
diff changeset
   162
     */
hgs
parents:
diff changeset
   163
    void SendTerminalResponse();
hgs
parents:
diff changeset
   164
hgs
parents:
diff changeset
   165
    /**
hgs
parents:
diff changeset
   166
     * Delay callback function. Called when predefined time
hgs
parents:
diff changeset
   167
     * has passed. Used to wait SendSS AdditionalInfoNotification
hgs
parents:
diff changeset
   168
     *
hgs
parents:
diff changeset
   169
     * @param aPtr Pointer to creator
hgs
parents:
diff changeset
   170
     * @return whether to call function again after an interval
hgs
parents:
diff changeset
   171
     */
hgs
parents:
diff changeset
   172
    static TInt SSRequestCallback( TAny* aPtr );
hgs
parents:
diff changeset
   173
hgs
parents:
diff changeset
   174
private: // data
hgs
parents:
diff changeset
   175
hgs
parents:
diff changeset
   176
    /**
hgs
parents:
diff changeset
   177
     * SendSSCall command data.
hgs
parents:
diff changeset
   178
     */
hgs
parents:
diff changeset
   179
    RSat::TSendSsV1 iSendSsData;
hgs
parents:
diff changeset
   180
hgs
parents:
diff changeset
   181
    /**
hgs
parents:
diff changeset
   182
     * SendSSCall command package.
hgs
parents:
diff changeset
   183
     */
hgs
parents:
diff changeset
   184
    RSat::TSendSsV1Pckg iSendSsPckg;
hgs
parents:
diff changeset
   185
hgs
parents:
diff changeset
   186
    /**
hgs
parents:
diff changeset
   187
     * Response from client
hgs
parents:
diff changeset
   188
     */
hgs
parents:
diff changeset
   189
    RSat::TSendSsRspV2 iSendSsRsp;
hgs
parents:
diff changeset
   190
hgs
parents:
diff changeset
   191
    /**
hgs
parents:
diff changeset
   192
     * Response package.
hgs
parents:
diff changeset
   193
     */
hgs
parents:
diff changeset
   194
    RSat::TSendSsRspV2Pckg iSendSsRspPckg;
hgs
parents:
diff changeset
   195
hgs
parents:
diff changeset
   196
    /**
hgs
parents:
diff changeset
   197
     * UI Queries and notifications:
hgs
parents:
diff changeset
   198
     * Query command data.
hgs
parents:
diff changeset
   199
     */
hgs
parents:
diff changeset
   200
    TSatQueryV1 iQueryData;
hgs
parents:
diff changeset
   201
hgs
parents:
diff changeset
   202
    /**
hgs
parents:
diff changeset
   203
     * Query package.
hgs
parents:
diff changeset
   204
     */
hgs
parents:
diff changeset
   205
    TSatQueryV1Pckg iQueryPckg;
hgs
parents:
diff changeset
   206
hgs
parents:
diff changeset
   207
    /**
hgs
parents:
diff changeset
   208
     * Query response.
hgs
parents:
diff changeset
   209
     */
hgs
parents:
diff changeset
   210
    TSatQueryRspV1 iQueryRsp;
hgs
parents:
diff changeset
   211
hgs
parents:
diff changeset
   212
    /**
hgs
parents:
diff changeset
   213
     * Query rsp package.
hgs
parents:
diff changeset
   214
     */
hgs
parents:
diff changeset
   215
    TSatQueryRspV1Pckg iQueryRspPckg;
hgs
parents:
diff changeset
   216
hgs
parents:
diff changeset
   217
    /**
hgs
parents:
diff changeset
   218
     * Notification send data
hgs
parents:
diff changeset
   219
     */
hgs
parents:
diff changeset
   220
    TSatNotificationV1 iNotificationData;
hgs
parents:
diff changeset
   221
hgs
parents:
diff changeset
   222
    /**
hgs
parents:
diff changeset
   223
     * Notification package
hgs
parents:
diff changeset
   224
     */
hgs
parents:
diff changeset
   225
    TSatNotificationV1Pckg iNotificationDataPckg;
hgs
parents:
diff changeset
   226
hgs
parents:
diff changeset
   227
    /**
hgs
parents:
diff changeset
   228
     * Notification Response data
hgs
parents:
diff changeset
   229
     */
hgs
parents:
diff changeset
   230
    TSatNotificationRspV1 iNotificationRsp;
hgs
parents:
diff changeset
   231
hgs
parents:
diff changeset
   232
    /**
hgs
parents:
diff changeset
   233
     * Notification Response package
hgs
parents:
diff changeset
   234
     */
hgs
parents:
diff changeset
   235
    TSatNotificationRspV1Pckg iNotificationRspPckg;
hgs
parents:
diff changeset
   236
hgs
parents:
diff changeset
   237
    /**
hgs
parents:
diff changeset
   238
     * Indicates is notification sent
hgs
parents:
diff changeset
   239
     */
hgs
parents:
diff changeset
   240
    TBool iNotificationSent;
hgs
parents:
diff changeset
   241
hgs
parents:
diff changeset
   242
    /**
hgs
parents:
diff changeset
   243
     * Ss specific
hgs
parents:
diff changeset
   244
     */
hgs
parents:
diff changeset
   245
    TInt iSsResult;
hgs
parents:
diff changeset
   246
hgs
parents:
diff changeset
   247
    /**
hgs
parents:
diff changeset
   248
     * Indicates is the result arrived
hgs
parents:
diff changeset
   249
     */
hgs
parents:
diff changeset
   250
    TBool iRequestCompleteArrived;
hgs
parents:
diff changeset
   251
hgs
parents:
diff changeset
   252
    /**
hgs
parents:
diff changeset
   253
     * Indicates is additional info arrived
hgs
parents:
diff changeset
   254
     */
hgs
parents:
diff changeset
   255
    TBool iAdditionalInfoArrived;
hgs
parents:
diff changeset
   256
hgs
parents:
diff changeset
   257
    /**
hgs
parents:
diff changeset
   258
     * Additional info of SS message
hgs
parents:
diff changeset
   259
     */
hgs
parents:
diff changeset
   260
    TBuf<RSat::KAlphaIdMaxSize> iAdditionalInfo;
hgs
parents:
diff changeset
   261
hgs
parents:
diff changeset
   262
    /**
hgs
parents:
diff changeset
   263
     * Ss additional info handler
hgs
parents:
diff changeset
   264
     * Own.
hgs
parents:
diff changeset
   265
     */
hgs
parents:
diff changeset
   266
    CSatSendSsAdditionalInfoHandler* iAdditionalInfoHandler;
hgs
parents:
diff changeset
   267
hgs
parents:
diff changeset
   268
    /**
hgs
parents:
diff changeset
   269
     * Ss request complete handler
hgs
parents:
diff changeset
   270
     * Own.
hgs
parents:
diff changeset
   271
     */
hgs
parents:
diff changeset
   272
    CSatSendSsRequestCompleteHandler* iRequestCompleteHandler;
hgs
parents:
diff changeset
   273
hgs
parents:
diff changeset
   274
    /**
hgs
parents:
diff changeset
   275
     * SS Parser used to process  parser result.
hgs
parents:
diff changeset
   276
     * Own.
hgs
parents:
diff changeset
   277
     */
hgs
parents:
diff changeset
   278
    CPhoneGsmHandlerBase* iPhoneGsmHandlerBase;
hgs
parents:
diff changeset
   279
hgs
parents:
diff changeset
   280
    /**
hgs
parents:
diff changeset
   281
     * Ss string parsers
hgs
parents:
diff changeset
   282
     * Own.
hgs
parents:
diff changeset
   283
     */
hgs
parents:
diff changeset
   284
    CPhoneGsmParserBase* iParser;
hgs
parents:
diff changeset
   285
hgs
parents:
diff changeset
   286
    /**
hgs
parents:
diff changeset
   287
     * Ss result
hgs
parents:
diff changeset
   288
     * Own.
hgs
parents:
diff changeset
   289
     */
hgs
parents:
diff changeset
   290
    CPhoneGsmParserResult* iResult;
hgs
parents:
diff changeset
   291
hgs
parents:
diff changeset
   292
    /**
hgs
parents:
diff changeset
   293
     * SS options used to update options.
hgs
parents:
diff changeset
   294
     * Own.
hgs
parents:
diff changeset
   295
     */
hgs
parents:
diff changeset
   296
    CPhoneGsmOptionContainerBase* iPhoneGsmOptionContainerBase;
hgs
parents:
diff changeset
   297
hgs
parents:
diff changeset
   298
    /**
hgs
parents:
diff changeset
   299
     * Indicates is terminal response sent
hgs
parents:
diff changeset
   300
     */
hgs
parents:
diff changeset
   301
    TBool iTerminalRespSent;
hgs
parents:
diff changeset
   302
hgs
parents:
diff changeset
   303
    /**
hgs
parents:
diff changeset
   304
     * Indicates is UI needed
hgs
parents:
diff changeset
   305
     */
hgs
parents:
diff changeset
   306
    TBool iNeedUiSession;
hgs
parents:
diff changeset
   307
hgs
parents:
diff changeset
   308
    /**
hgs
parents:
diff changeset
   309
     * Indicates is Confirm SAT Operations on
hgs
parents:
diff changeset
   310
     */
hgs
parents:
diff changeset
   311
    TBool iQueryOn;
hgs
parents:
diff changeset
   312
hgs
parents:
diff changeset
   313
    /**
hgs
parents:
diff changeset
   314
     * delay timer
hgs
parents:
diff changeset
   315
     * Own.
hgs
parents:
diff changeset
   316
     */
hgs
parents:
diff changeset
   317
    CPeriodic* iTimer;
hgs
parents:
diff changeset
   318
hgs
parents:
diff changeset
   319
    /**
hgs
parents:
diff changeset
   320
     * Indicates wether user accepted or rejected
hgs
parents:
diff changeset
   321
     */
hgs
parents:
diff changeset
   322
   TBool iUserAccepted;
hgs
parents:
diff changeset
   323
hgs
parents:
diff changeset
   324
    /**
hgs
parents:
diff changeset
   325
     * For delayed Ss sendinf
hgs
parents:
diff changeset
   326
     */
hgs
parents:
diff changeset
   327
    CActiveSchedulerWait iSendWait;
hgs
parents:
diff changeset
   328
        
hgs
parents:
diff changeset
   329
    /**
hgs
parents:
diff changeset
   330
     * Flag to signal that command has icon data
hgs
parents:
diff changeset
   331
     * To be removed when icons are allowed in this command
hgs
parents:
diff changeset
   332
     */
hgs
parents:
diff changeset
   333
    TBool iIconCommand;
hgs
parents:
diff changeset
   334
    };
hgs
parents:
diff changeset
   335
hgs
parents:
diff changeset
   336
#endif      // CSENDSSHANDLER_H
hgs
parents:
diff changeset
   337