satengine/satserver/SatInternalClient/src/CSatCDisplayTextHandler.cpp
author hgs
Fri, 03 Sep 2010 13:59:20 +0300
changeset 46 2fa1fa551b0b
parent 33 8d5d7fcf9b59
permissions -rw-r--r--
201035
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
33
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2002-2008 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:  This is the handler for the SIM Application Toolkit
hgs
parents:
diff changeset
    15
*                Display Text proactive command.
hgs
parents:
diff changeset
    16
*
hgs
parents:
diff changeset
    17
*/
hgs
parents:
diff changeset
    18
hgs
parents:
diff changeset
    19
hgs
parents:
diff changeset
    20
#include    <e32svr.h>
hgs
parents:
diff changeset
    21
#include    "RSatUiSession.h"
hgs
parents:
diff changeset
    22
#include    "MSatUiObserver.h"
hgs
parents:
diff changeset
    23
#include    "CSatCDisplayTextHandler.h"
hgs
parents:
diff changeset
    24
#include    "SatSOpcodes.h"
hgs
parents:
diff changeset
    25
#include    "SatLog.h"
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
// ======== MEMBER FUNCTIONS ========
hgs
parents:
diff changeset
    28
hgs
parents:
diff changeset
    29
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
    30
// CSatCDisplayTextHandler::CSatCDisplayTextHandler
hgs
parents:
diff changeset
    31
// C++ default constructor can NOT contain any code, that
hgs
parents:
diff changeset
    32
// might leave.
hgs
parents:
diff changeset
    33
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
    34
//
hgs
parents:
diff changeset
    35
CSatCDisplayTextHandler::CSatCDisplayTextHandler(
hgs
parents:
diff changeset
    36
    TInt aPriority,
hgs
parents:
diff changeset
    37
    RSatUiSession* aSession ) :
hgs
parents:
diff changeset
    38
    CActive( aPriority ), iSession( aSession ),
hgs
parents:
diff changeset
    39
    iDisplayTextData(),
hgs
parents:
diff changeset
    40
    iDisplayTextPckg( iDisplayTextData ),
hgs
parents:
diff changeset
    41
    iDisplayTextRsp(),
hgs
parents:
diff changeset
    42
    iDisplayTextRspPckg( iDisplayTextRsp )
hgs
parents:
diff changeset
    43
    {
hgs
parents:
diff changeset
    44
    LOG( SIMPLE,
hgs
parents:
diff changeset
    45
        "SATINTERNALCLIENT: CSatCDisplayTextHandler::CSatCDisplayTextHandler calling" )
hgs
parents:
diff changeset
    46
hgs
parents:
diff changeset
    47
    CActiveScheduler::Add( this ); // add to active scheduler
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
    LOG( SIMPLE,
hgs
parents:
diff changeset
    50
        "SATINTERNALCLIENT: CSatCDisplayTextHandler::CSatCDisplayTextHandler exiting" )
hgs
parents:
diff changeset
    51
    }
hgs
parents:
diff changeset
    52
hgs
parents:
diff changeset
    53
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
    54
// CSatCDisplayTextHandler::NewL
hgs
parents:
diff changeset
    55
// Two-phased constructor.
hgs
parents:
diff changeset
    56
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
    57
//
hgs
parents:
diff changeset
    58
CSatCDisplayTextHandler* CSatCDisplayTextHandler::NewL(
hgs
parents:
diff changeset
    59
    RSatUiSession* aSat )
hgs
parents:
diff changeset
    60
    {
hgs
parents:
diff changeset
    61
    LOG( SIMPLE, "SATINTERNALCLIENT: CSatCDisplayTextHandler::NewL calling" )
hgs
parents:
diff changeset
    62
hgs
parents:
diff changeset
    63
    // Perform construction.
hgs
parents:
diff changeset
    64
    CSatCDisplayTextHandler* self =
hgs
parents:
diff changeset
    65
        new ( ELeave ) CSatCDisplayTextHandler( EPriorityLow, aSat );
hgs
parents:
diff changeset
    66
hgs
parents:
diff changeset
    67
    LOG( SIMPLE, "SATINTERNALCLIENT: CSatCDisplayTextHandler::NewL exiting" )
hgs
parents:
diff changeset
    68
    return self;
hgs
parents:
diff changeset
    69
    }
hgs
parents:
diff changeset
    70
hgs
parents:
diff changeset
    71
// Destructor
hgs
parents:
diff changeset
    72
CSatCDisplayTextHandler::~CSatCDisplayTextHandler()
hgs
parents:
diff changeset
    73
    {
hgs
parents:
diff changeset
    74
    LOG( SIMPLE,
hgs
parents:
diff changeset
    75
        "SATINTERNALCLIENT: CSatCDisplayTextHandler::~CSatCDisplayTextHandler calling" )
hgs
parents:
diff changeset
    76
hgs
parents:
diff changeset
    77
    // Cancel any outstanding requests.
hgs
parents:
diff changeset
    78
    Cancel();
hgs
parents:
diff changeset
    79
    iSession = NULL;
hgs
parents:
diff changeset
    80
hgs
parents:
diff changeset
    81
    LOG( SIMPLE,
hgs
parents:
diff changeset
    82
        "SATINTERNALCLIENT: CSatCDisplayTextHandler::~CSatCDisplayTextHandler exiting" )
hgs
parents:
diff changeset
    83
    }
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
    86
// CSatCDisplayTextHandler::Start
hgs
parents:
diff changeset
    87
// Starts the handler.
hgs
parents:
diff changeset
    88
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
    89
//
hgs
parents:
diff changeset
    90
void CSatCDisplayTextHandler::Start()
hgs
parents:
diff changeset
    91
    {
hgs
parents:
diff changeset
    92
    LOG( SIMPLE, "SATINTERNALCLIENT: CSatCDisplayTextHandler::Start calling" )
hgs
parents:
diff changeset
    93
hgs
parents:
diff changeset
    94
    // Empty the IPC data
hgs
parents:
diff changeset
    95
    TSatDisplayTextV1 temp;
hgs
parents:
diff changeset
    96
    iDisplayTextData = temp;
hgs
parents:
diff changeset
    97
    RSat::TDisplayTextRspV1 temp2;
hgs
parents:
diff changeset
    98
    iDisplayTextRsp = temp2;
hgs
parents:
diff changeset
    99
hgs
parents:
diff changeset
   100
    // Request Display Text notifications.
hgs
parents:
diff changeset
   101
    TIpcArgs arguments( &iDisplayTextPckg );
hgs
parents:
diff changeset
   102
hgs
parents:
diff changeset
   103
    // Pass the Display Text IPC package
hgs
parents:
diff changeset
   104
    iSession->CreateRequest( ESatSProactiveDisplayText, arguments, iStatus );
hgs
parents:
diff changeset
   105
hgs
parents:
diff changeset
   106
    // Set this handler to active so that it can receive requests.
hgs
parents:
diff changeset
   107
    SetActive();
hgs
parents:
diff changeset
   108
hgs
parents:
diff changeset
   109
    LOG( SIMPLE, "SATINTERNALCLIENT: CSatCDisplayTextHandler::Start exiting" )
hgs
parents:
diff changeset
   110
    }
hgs
parents:
diff changeset
   111
hgs
parents:
diff changeset
   112
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
   113
// CSatCDisplayTextHandler::RunL
hgs
parents:
diff changeset
   114
// Handles the command.
hgs
parents:
diff changeset
   115
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
   116
//
hgs
parents:
diff changeset
   117
void CSatCDisplayTextHandler::RunL()
hgs
parents:
diff changeset
   118
    {
hgs
parents:
diff changeset
   119
    LOG( SIMPLE, "SATINTERNALCLIENT: CSatCDisplayTextHandler::RunL calling" )
hgs
parents:
diff changeset
   120
hgs
parents:
diff changeset
   121
    // Check the status of the asnychronous operation
hgs
parents:
diff changeset
   122
    if ( KErrNone != iStatus.Int() )
hgs
parents:
diff changeset
   123
        {
hgs
parents:
diff changeset
   124
        LOG2(
hgs
parents:
diff changeset
   125
            SIMPLE,
hgs
parents:
diff changeset
   126
            "SATINTERNALCLIENT: CSatCDisplayTextHandler::RunL exiting, error: %d",
hgs
parents:
diff changeset
   127
            iStatus.Int() )
hgs
parents:
diff changeset
   128
hgs
parents:
diff changeset
   129
        // Renew the request
hgs
parents:
diff changeset
   130
        Start();
hgs
parents:
diff changeset
   131
        }
hgs
parents:
diff changeset
   132
    else
hgs
parents:
diff changeset
   133
        {
hgs
parents:
diff changeset
   134
        // Has to be casted to TInt before casting to TSatIconQualifier, because
hgs
parents:
diff changeset
   135
        // gcc warns about the direct cast.
hgs
parents:
diff changeset
   136
        const struct TSatIconId iconId = { iDisplayTextData.iIconId.iIdentifier,
hgs
parents:
diff changeset
   137
            static_cast<TSatIconQualifier>(
hgs
parents:
diff changeset
   138
                static_cast<TInt>( iDisplayTextData.iIconId.iQualifier ) ) };
hgs
parents:
diff changeset
   139
hgs
parents:
diff changeset
   140
        // This will contain EFalse if requested icon is not displayed.
hgs
parents:
diff changeset
   141
        TBool requestedIconDisplayed( ETrue );
hgs
parents:
diff changeset
   142
hgs
parents:
diff changeset
   143
        // Indicator if user is expected to clear the message
hgs
parents:
diff changeset
   144
        TBool waitUserToClear( ETrue );
hgs
parents:
diff changeset
   145
hgs
parents:
diff changeset
   146
        if ( RSat::EClearAfterDelay == iDisplayTextData.iClearScreen )
hgs
parents:
diff changeset
   147
            {
hgs
parents:
diff changeset
   148
            LOG( SIMPLE, 
hgs
parents:
diff changeset
   149
            "SATINTERNALCLIENT: CSatCDisplayTextHandler::RunL EClearAfterDelay" )
hgs
parents:
diff changeset
   150
            waitUserToClear = EFalse;
hgs
parents:
diff changeset
   151
            }
hgs
parents:
diff changeset
   152
hgs
parents:
diff changeset
   153
        // Notify the registered client and save the response.
hgs
parents:
diff changeset
   154
        TSatUiResponse response;
hgs
parents:
diff changeset
   155
        response = iSession->SatUiObserver()->DisplayTextL(
hgs
parents:
diff changeset
   156
            iDisplayTextData.iText,
hgs
parents:
diff changeset
   157
            iDisplayTextData.iSimApplicationName,
hgs
parents:
diff changeset
   158
            iconId,
hgs
parents:
diff changeset
   159
            requestedIconDisplayed,
hgs
parents:
diff changeset
   160
            iDisplayTextData.iSustainedText,
hgs
parents:
diff changeset
   161
            iDisplayTextData.iDuration,
hgs
parents:
diff changeset
   162
            waitUserToClear );
hgs
parents:
diff changeset
   163
hgs
parents:
diff changeset
   164
        // This command never has any additional information.
hgs
parents:
diff changeset
   165
        iDisplayTextRsp.iInfoType = RSat::KNoAdditionalInfo;
hgs
parents:
diff changeset
   166
        iDisplayTextRsp.iAdditionalInfo.Zero();
hgs
parents:
diff changeset
   167
hgs
parents:
diff changeset
   168
        iDisplayTextRsp.SetPCmdNumber( iDisplayTextData.iPCmdNumber );
hgs
parents:
diff changeset
   169
hgs
parents:
diff changeset
   170
        // Examine the client response.
hgs
parents:
diff changeset
   171
        ExamineClientResponse(
hgs
parents:
diff changeset
   172
            response, requestedIconDisplayed );
hgs
parents:
diff changeset
   173
hgs
parents:
diff changeset
   174
        // Pass the Display Text response IPC package.
hgs
parents:
diff changeset
   175
        TIpcArgs arguments( &iDisplayTextRspPckg );
hgs
parents:
diff changeset
   176
hgs
parents:
diff changeset
   177
        // Perform the IPC data transfer.
hgs
parents:
diff changeset
   178
        iSession->CreateRequest( ESatSProactiveDisplayTextResponse, arguments );
hgs
parents:
diff changeset
   179
hgs
parents:
diff changeset
   180
        // Renew the service request.
hgs
parents:
diff changeset
   181
        Start();        
hgs
parents:
diff changeset
   182
        }
hgs
parents:
diff changeset
   183
    LOG( SIMPLE, "SATINTERNALCLIENT: CSatCDisplayTextHandler::RunL exiting" )
hgs
parents:
diff changeset
   184
    }
hgs
parents:
diff changeset
   185
hgs
parents:
diff changeset
   186
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
   187
// CSatCDisplayTextHandler::ExamineClientResponse
hgs
parents:
diff changeset
   188
// Examine the client response.
hgs
parents:
diff changeset
   189
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
   190
//
hgs
parents:
diff changeset
   191
void CSatCDisplayTextHandler::ExamineClientResponse(
hgs
parents:
diff changeset
   192
    TSatUiResponse aResponse,
hgs
parents:
diff changeset
   193
    TBool aRequestedIconDisplayed )
hgs
parents:
diff changeset
   194
    {
hgs
parents:
diff changeset
   195
    LOG2( SIMPLE,
hgs
parents:
diff changeset
   196
    "SATINTERNALCLIENT: CSatCDisplayTextHandler::ExamineClientResponse calling,\
hgs
parents:
diff changeset
   197
    aResponse: %x", aResponse )
hgs
parents:
diff changeset
   198
hgs
parents:
diff changeset
   199
    switch ( aResponse )
hgs
parents:
diff changeset
   200
        {
hgs
parents:
diff changeset
   201
        case ESatSuccess:
hgs
parents:
diff changeset
   202
            {
hgs
parents:
diff changeset
   203
            // Convert terminal rsp if icon used
hgs
parents:
diff changeset
   204
            RSat::TPCmdResult result( RSat::KSuccess );
hgs
parents:
diff changeset
   205
            RSat::TIconQualifier iconQualifier(
hgs
parents:
diff changeset
   206
                    iDisplayTextData.iIconId.iQualifier );
hgs
parents:
diff changeset
   207
hgs
parents:
diff changeset
   208
            if ( !aRequestedIconDisplayed )
hgs
parents:
diff changeset
   209
                {
hgs
parents:
diff changeset
   210
                LOG( SIMPLE,
hgs
parents:
diff changeset
   211
                "SATINTERNALCLIENT: CSatCDisplayTextHandler::ExamineClientResponse \
hgs
parents:
diff changeset
   212
                aRequestedIconDisplayed false" )
hgs
parents:
diff changeset
   213
                if ( iconQualifier == RSat::ESelfExplanatory ||
hgs
parents:
diff changeset
   214
                     iconQualifier == RSat::ENotSelfExplanatory )
hgs
parents:
diff changeset
   215
                    {
hgs
parents:
diff changeset
   216
                    LOG( SIMPLE,
hgs
parents:
diff changeset
   217
                    "SATINTERNALCLIENT: CSatCDisplayTextHandler::ExamineClientResponse \
hgs
parents:
diff changeset
   218
                    IconNotDisplayed" )
hgs
parents:
diff changeset
   219
                    result = RSat::KSuccessRequestedIconNotDisplayed;
hgs
parents:
diff changeset
   220
                    }
hgs
parents:
diff changeset
   221
                }
hgs
parents:
diff changeset
   222
hgs
parents:
diff changeset
   223
            iDisplayTextRsp.iGeneralResult = result;
hgs
parents:
diff changeset
   224
            break;
hgs
parents:
diff changeset
   225
            }
hgs
parents:
diff changeset
   226
hgs
parents:
diff changeset
   227
        case ESatFailure:
hgs
parents:
diff changeset
   228
            {
hgs
parents:
diff changeset
   229
            iDisplayTextRsp.iInfoType = RSat::KMeProblem;
hgs
parents:
diff changeset
   230
            iDisplayTextRsp.iGeneralResult = RSat::KMeUnableToProcessCmd;
hgs
parents:
diff changeset
   231
            iDisplayTextRsp.iAdditionalInfo.SetLength( 1 );
hgs
parents:
diff changeset
   232
            iDisplayTextRsp.iAdditionalInfo[0] = RSat::KNoSpecificMeProblem;
hgs
parents:
diff changeset
   233
            break;
hgs
parents:
diff changeset
   234
            }
hgs
parents:
diff changeset
   235
hgs
parents:
diff changeset
   236
        case ESatSessionTerminatedByUser:
hgs
parents:
diff changeset
   237
            {
hgs
parents:
diff changeset
   238
            iDisplayTextRsp.iGeneralResult = RSat::KPSessionTerminatedByUser;
hgs
parents:
diff changeset
   239
            break;
hgs
parents:
diff changeset
   240
            }
hgs
parents:
diff changeset
   241
hgs
parents:
diff changeset
   242
        case ESatBackwardModeRequestedByUser:
hgs
parents:
diff changeset
   243
            {
hgs
parents:
diff changeset
   244
            iDisplayTextRsp.iGeneralResult =
hgs
parents:
diff changeset
   245
                RSat::KBackwardModeRequestedByUser;
hgs
parents:
diff changeset
   246
            break;
hgs
parents:
diff changeset
   247
            }
hgs
parents:
diff changeset
   248
hgs
parents:
diff changeset
   249
        case ESatNoResponseFromUser:
hgs
parents:
diff changeset
   250
            {
hgs
parents:
diff changeset
   251
            iDisplayTextRsp.iGeneralResult = RSat::KNoResponseFromUser;
hgs
parents:
diff changeset
   252
            break;
hgs
parents:
diff changeset
   253
            }
hgs
parents:
diff changeset
   254
hgs
parents:
diff changeset
   255
        // No help is ever supplied with this command
hgs
parents:
diff changeset
   256
        case EHelpRequestedByUser:
hgs
parents:
diff changeset
   257
        case EPCmdNotAcceptedByUser:
hgs
parents:
diff changeset
   258
        case ESatCmdDataNotUnderstood:
hgs
parents:
diff changeset
   259
        default:
hgs
parents:
diff changeset
   260
            {
hgs
parents:
diff changeset
   261
            iSession->Panic( ESatInvalidResponse );
hgs
parents:
diff changeset
   262
            break;
hgs
parents:
diff changeset
   263
            }
hgs
parents:
diff changeset
   264
        }
hgs
parents:
diff changeset
   265
hgs
parents:
diff changeset
   266
    LOG( SIMPLE,
hgs
parents:
diff changeset
   267
        "SATINTERNALCLIENT: CSatCDisplayTextHandler::ExamineClientResponse exiting" )
hgs
parents:
diff changeset
   268
    }
hgs
parents:
diff changeset
   269
hgs
parents:
diff changeset
   270
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
   271
// CSatCDisplayTextHandler::DoCancel
hgs
parents:
diff changeset
   272
// Cancels the pending request.
hgs
parents:
diff changeset
   273
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
   274
//
hgs
parents:
diff changeset
   275
void CSatCDisplayTextHandler::DoCancel()
hgs
parents:
diff changeset
   276
    {
hgs
parents:
diff changeset
   277
    LOG( SIMPLE, "SATINTERNALCLIENT: CSatCDisplayTextHandler::DoCancel calling" )
hgs
parents:
diff changeset
   278
hgs
parents:
diff changeset
   279
    // Complete the request with cancel code.
hgs
parents:
diff changeset
   280
    TRequestStatus* requestStatus = &iStatus;
hgs
parents:
diff changeset
   281
    User::RequestComplete( requestStatus, KErrCancel );
hgs
parents:
diff changeset
   282
hgs
parents:
diff changeset
   283
    LOG( SIMPLE, "SATINTERNALCLIENT: CSatCDisplayTextHandler::DoCancel exiting" )
hgs
parents:
diff changeset
   284
    }