mmsengine/mmsserver/src/mmssendoperation.cpp
author hgs
Fri, 06 Aug 2010 23:19:50 +0530
changeset 51 3507212d340e
parent 23 238255e8b033
permissions -rw-r--r--
201031_02

/*
* Copyright (c) 2005-2007 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:  
*     State machine for sending messages
*
*/



// INCLUDE FILES
#include    <apparc.h>
#include    <msventry.h>
#include    <msvids.h>
#include    <logcli.h>
#include    <commdb.h>
#include    <in_sock.h>
#include    <commdbconnpref.h>

// LOCAL INCLUDE FILES
#include    "mmsconst.h"
#include    "mmssendoperation.h"
#include    "mmssession.h"
#include    "mmssettings.h"
#include    "mmsservercommon.h"
#include    "mmsheaders.h"
#include    "mmsencode.h"
#include    "mmsdecode.h"
#include    "mmsscheduledentry.h"
#include    "mmsgenutils.h"
#include    "mmslog.h"
#include    "mmserrors.h"
#include    "mmsserverentry.h"
#include    "mmsconninit.h"
#include    "MmsServerDebugLogging.h"

// EXTERNAL DATA STRUCTURES

// EXTERNAL FUNCTION PROTOTYPES  
extern void gPanic( TMmsPanic aPanic );

// CONSTANTS

// MACROS
// LOCAL CONSTANTS AND MACROS
// MODULE DATA STRUCTURES
// LOCAL FUNCTION PROTOTYPES
// ==================== LOCAL FUNCTIONS ====================
// ================= MEMBER FUNCTIONS =======================

// ---------------------------------------------------------
// CMmsSendOperation
// ---------------------------------------------------------
//
CMmsSendOperation::CMmsSendOperation( RFs& aFs ): CMmsBaseOperation( aFs )
    // members that get initial value 0, need not be initialized here
    {
    }

// ---------------------------------------------------------
// ConstructL
// ---------------------------------------------------------
//
void CMmsSendOperation::ConstructL( CMmsSettings* aMmsSettings )
    {
    CMmsBaseOperation::ConstructL( aMmsSettings );
    iMmsHeaders = CMmsHeaders::NewL( iMmsSettings->MmsVersion() );
    // iSent is just a copy to retain old name for the time being.
    iSent = iSuccessful;
    User::LeaveIfError( iShareProtectedFileSession.Connect() );
    iShareProtectedFileSessionOpened = ETrue;
    User::LeaveIfError( iShareProtectedFileSession.ShareProtected() ); 
    CActiveScheduler::Add( this );
    }

// ---------------------------------------------------------
// NewL
// ---------------------------------------------------------
//
CMmsSendOperation* CMmsSendOperation::NewL( RFs& aFs, CMmsSettings* aMmsSettings )
    {
    CMmsSendOperation* self = new ( ELeave ) CMmsSendOperation( aFs );
    CleanupStack::PushL( self );
    self->ConstructL( aMmsSettings );
    CleanupStack::Pop( self );
    return self;
    }
    
// ---------------------------------------------------------
// ~CMmsSendOperation
// ---------------------------------------------------------
//
CMmsSendOperation::~CMmsSendOperation()
    {
    Cancel();
    
    if ( iShareProtectedFileSessionOpened )
        {
        iShareProtectedFileSession.Close();
        }
    
    // iSelection, iServerEntry, and iMmsSettings
    // are not deleted, because they belong to caller

    // iSent is not deleted because it is just a copy of iSuccessful

    delete iMmsHeaders;
    }

// ---------------------------------------------------------
// StartL
// ---------------------------------------------------------
//
void CMmsSendOperation::StartL(
    CMsvEntrySelection& aSelection,
    CMsvServerEntry& aServerEntry,
    TMsvId aService,
    TRequestStatus& aStatus )
    {
    LOG(_L("CMmsSendOperation::StartL") );
    
    __ASSERT_DEBUG( iState==EMmsOperationIdle, gPanic( EMmsAlreadyBusy ) );
    CMmsBaseOperation::StartL( aSelection, aServerEntry, aService, aStatus );
    iMmsHeaders->Reset();
    }

// ---------------------------------------------------------
// EncodePDUL
// ---------------------------------------------------------
//
void CMmsSendOperation::EncodePDUL()
    {
    LOG( _L("CMmsSendOperation::EncodePDUL") );
    
    CMsvStore* store = NULL;
    // In case of multiple entries, iError is reset here on every round
    // (because EncodePDUL starts the round)
    iError = iServerEntry->SetEntry( iSelection->At( iCurrentMessageNo - 1 ) );

    // If user tries to delete the entry before it has been sent,
    // it is first put to suspended state, and then deleted.
    // If entry is suspended -> message will not be sent
    if( iError == KErrNone )
        {
        if( iServerEntry->Entry().SendingState() == KMsvSendStateSuspended ||
            iServerEntry->Entry().Deleted() )
            {
            // All activity stopped with this entry
            iError = KErrNotFound;
#ifndef _NO_MMSS_LOGGING_
            if( iServerEntry->Entry().SendingState() == KMsvSendStateSuspended )
                {
                LOG( _L("- message in suspended state") );
                }
            if( iServerEntry->Entry().Deleted() )
                {
                LOG( _L("- message in deleted state") );
                }
#endif
            }
        }    
#ifndef _NO_MMSS_LOGGING_
    else
        {
        LOG2( _L("- ERROR in SetEntry(): %d"), iError );
        }
#endif

    // Check if message contains closed content that should not be sent
    // ContainsClosedContentL leaves only if memory runs out
    
    if ( iError == KErrNone )
        {
        iError = CheckClosedContentL( *iServerEntry, iShareProtectedFileSession );
        }

    // Attempt to delete the message after this point will come too late,
    // and the message will be sent
    if( iError == KErrNone )
        {
        TRAP( iError, store = iServerEntry->EditStoreL(); )
        }
    if( iError == KErrNone )
        {
        CleanupStack::PushL( store ); // ***
        }
        
    // If error encountered quit here.
    if( iError != KErrNone )
        {
        FallThrough();
        return;
        }
        
    // Restore the message in order to encode it into binary
    // if RestoreL leaves -> serious OOM condition -> cannot continue.
    iMmsHeaders->RestoreL( *store );

    // Adding TID. If found already (retrying..), using it.
    if ( iMmsHeaders->Tid().Length() == 0 )
        {
        TBufC8<KMMSMAXTIDLENGTH> tid;
        tid.Des().NumUC( AllocateTID(), EHex );
        iMmsHeaders->SetTidL( tid );
        }
        
    // Clear old response text in case the message has failed before
    iMmsHeaders->SetResponseTextL( TPtrC() );

    // Message type
    iMmsHeaders->SetMessageType( KMmsMessageTypeMSendReq );

    // MMS version that is used
    // Make sure we specify our current version even if the message
    // has been created elsewhere and brought in by sychronization etc.
    iMmsHeaders->SetMmsVersion( iMmsSettings->MmsVersion() );

    // Store the changed headers. 
    // No check for critical disk space level here, because only a 16-byte TID
    // was added.
    iMmsHeaders->StoreL( *store );
    store->CommitL();

    // Close the store now (otherwise attachments can not be read..)
    CleanupStack::PopAndDestroy( store );

#ifndef _NO_MMSS_LOGGING_
    // calculate space needed and resize buffer
    const TMsvEntry& entry = iServerEntry->Entry();
    TInt size = entry.iSize;
    LOG2( _L("- message size about %d"), size );
#endif
    
    // ... instead using entry wrapper class
    iError = iEntryWrapper->SetCurrentEntry( iSelection->At( iCurrentMessageNo - 1 ) );
    if( iError != KErrNone )
        {
        iServerEntry->SetEntry( KMsvNullIndexEntryId ); // not needed any more..
        FallThrough();
        }
    else
        {
        // The actual encoding is executed by mmsencode class
        iEncoder->StartChunkedL( *iEntryWrapper, *iMmsHeaders, *iEncodeBuffer, iStatus );
        // release the service entry to allow cancelling while conncetion is being opened
        iServerEntry->SetEntry( KMsvNullIndexEntryId );
        SetActive();
        }
    }

// ---------------------------------------------------------
// SubmitTransactionL
// ---------------------------------------------------------
//
void CMmsSendOperation::SubmitTransactionL()
    {
    LOG( _L("CMmsSendOperation::SubmitTransactionL") );
    
    if ( iError != KErrNone )
        {
        FallThrough();
        return;
        }

    // "Sending" is either local or global.
    // Global is normal case, local is only for test purposes.
    if ( !iMmsSettings->LocalMode() )
        {
        LOG( _L("- global mode") );
        // The base class does HTTP POST to home page URI
        CMmsBaseOperation::SubmitTransactionL();
        }
    else
        {
        // No disk space checking here, because this is test code
        LOG( _L("- local mode") );
        TInt error = iServerEntry->SetEntry( iSelection->At( iCurrentMessageNo - 1 ) );
        if( error == KErrNone )
            {
            TMsvEntry entry = iServerEntry->Entry();
            if( iConnected )
                {
                entry.SetConnected( ETrue );
                }
            entry.SetSendingState( KMsvSendStateSending );
            iServerEntry->ChangeEntry( entry );
            }
        iServerEntry->SetEntry( KMsvNullIndexEntryId );

        // sending uses the localmode OUT directory
        TFileName* fileName = new( ELeave ) TFileName;
        CleanupStack::PushL( fileName );
        fileName->Copy( iMmsSettings->LocalModeOut() );
        _LIT( KRelated, "m.mms");
        iParse.Set( *fileName, &KRelated, NULL );
        fileName->Copy( iParse.FullName() );
        User::LeaveIfError( CApaApplication::GenerateFileName( iFs, *fileName ) );

        RFile file;
        iError = file.Create( iFs, *fileName, EFileWrite | EFileShareExclusive );
        // for message id generation
        iParse.Set( *fileName, NULL, NULL );
        LOG2( _L("- local mode, file create status %d "), iError );
        TPtrC8 ptr /*= iEncodeBuffer->Ptr( 0 )*/;
        TBool isLastChunk = EFalse; 
        while ( iError == KErrNone && !isLastChunk )
            {
            MMmsCodecDataSupplier* dataSupplier = iEncoder;
            iError = dataSupplier->GetNextDataPart( ptr, isLastChunk );
            file.Write( ptr );
            file.Flush();
            iError = dataSupplier->ReleaseData();
            }
        
        // discard the contents
        iEncodeBuffer->Reset();
            
        // done - close files
        file.Close();
        CleanupStack::PopAndDestroy( fileName );
        fileName = NULL;
        FallThrough();
        }
    }

// ---------------------------------------------------------
// StoreResponseL()
// ---------------------------------------------------------
//
void CMmsSendOperation::StoreResponseL()
    {
    LOG( _L("CMmsSendOperation::StoreResponseL") );

    // First we must analyze the response message to see if sending
    // was successful. In case we want to retry, we probably keep
    // our encoded message until we are either satisfied with the
    // result, or decide that it is hopeless.

    // The response from MMSC has been decoded earlier by the base class. 
    // Now the result must be saved - either the error code and text
    // or the message id depending if the sending was successful

    // The possible response message from MMSC is in iEncodeBuffer.
    // When we called the send transaction, the buffer contained
    // the encoded message. If the sending was successful, the
    // buffer contains the return message from MMSC

    // The transaction will not complete until a response has been
    // received from MMSC

    // 'error' tries to keep track of failures to access the entry
    // because of backup/restore or media unavailable
    TInt error = KErrNone; 
                           
    LOG2( _L("- iEncodeBuffer size %d "), iEncodeBuffer->Size() );

#ifndef _NO_MMSS_LOGGING_
    // In logging version, unsuccessful attempts' responses are dumped into file
    if( iError != KErrNone && iEncodeBuffer->Size() > 0 )
        {
        TFileName fileName;
        fileName.Copy( KMmsDefaultLogDirectory );
        TUint att;
        if ( iFs.Att( fileName, att ) == KErrNone )
            {
            _LIT( KRelated, "SendResp.mms");
            // don't mess up iParse - it may contain local mode filename
            TParse parse;
            parse.Set( fileName, &KRelated, NULL );
            fileName = parse.FullName();
            error = CApaApplication::GenerateFileName( iFs, fileName );
            if ( error == KErrNone )
                {
                RFile file;
                error = file.Create( iFs, fileName, EFileWrite | EFileShareExclusive );
                // for message id generation
                parse.Set( fileName, NULL, NULL );

                if ( error == KErrNone )
                    {
                    // the data is supposed to be in the encode buffer
                    TPtr8 ptr = iEncodeBuffer->Ptr( 0 );
                    file.Write( ptr );
                    file.Flush();
                    }

                // done - close files
                file.Close();
                }
            }
        error = KErrNone;
        }
#endif

    // We must check the result, and mark the entry as failed
    // if the sending fails. Failed entries may be retried later.

    // The error should stay in iError
    // Above error was set if we failed to set iEntryWrapper to point to NULL entry
    // that should never fail, so our error should still be KErrNone

    error = iServerEntry->SetEntry( iSelection->At( iCurrentMessageNo - 1 ) );
    // if we could not access the entry we want, we are in really bad trouble.
    // We might be running backup/restore or the MMC might have been removed

    if( error == KErrNone )
        {
        // The actual send transaction should return a message ID
        // we should save its value
        CMsvStore* store = NULL;
        TRAP( error, {store = iServerEntry->EditStoreL();} )
#ifndef _NO_MMSS_LOGGING_
        if ( error != KErrNone )
            {
            LOG2( _L("-ERROR getting edit store: %d"), error );
            }
#endif
        // We add a couple of strings.
        // In any case, if we were successful, we are going to remove
        // the scheduling soon. That will free more disk space that
        // we take here. So we don't check here.
        // Besides, we need to update our entry, and if we cannot do it
        // we are in trouble.
        if( error == KErrNone )
            {
            LOG( _L("- update recipient scheduling data") );
            // Get the recipient scheduling info to be updated later.
            CleanupStack::PushL( store ); // ***
            CMmsScheduledEntry* mmsScheduledEntry =
                CMmsScheduledEntry::NewL( iServerEntry->Entry() );
            CleanupStack::PushL( mmsScheduledEntry ); // ***
            mmsScheduledEntry->RestoreL( *store );
            UpdateRecipient( iError, *mmsScheduledEntry );
            if( iError == KErrNone || iResponse->ResponseText().Length() > 0 )
                {
                // We must add the message ID for delivery reports
                // in local mode we use the generated filename
                if ( iResponse->MessageId().Length() == 0 && iMmsSettings->LocalMode() )
                    {
                    HBufC8* id = HBufC8::NewL( KMaxFileName );
                    CleanupStack::PushL( id );
                    id->Des().Copy( iParse.NameAndExt() );
                    iResponse->SetMessageIdL( id->Des() );
                    CleanupStack::PopAndDestroy( id );
                    id = NULL;
                    }

                iMmsHeaders->RestoreL( *store );
                if( iError == KErrNone )
                    {
                    // message was successfully sent, store ID
                    iMmsHeaders->SetMessageIdL( iResponse->MessageId() );
                    // clear TID to prevent same TID from being used for two different messages.
                    // If a sent message is copied elsewhere and then resent, it is considered
                    // a different message.
                    iMmsHeaders->SetTidL( TPtrC8() );
                    }
                if( iError != KErrNone )
                    {
                    iMmsHeaders->SetResponseTextL( iResponse->ResponseText() );
                    }
                iMmsHeaders->StoreL( *store );
                }
            // update entry fields to match scheduled entry
            // mainly this updates the recipient info (possible error)
            mmsScheduledEntry->StoreL( *store );
            store->CommitL();
            CleanupStack::PopAndDestroy( mmsScheduledEntry );
            CleanupStack::PopAndDestroy( store );
            }

        TMsvEntry entry = iServerEntry->Entry();
        entry.SetConnected( EFalse );
        entry.iError = iError;

        if( iError == KErrNone )
            {
            entry.SetReadOnly( EFalse );
            entry.SetFailed( EFalse );
            entry.SetSendingState( KMsvSendStateSent );
            }
        else
            {
            // We have a hopelessly failed message.
            // We mark it failed later, not yet
            entry.SetReadOnly( EFalse );
            }

        // We cannot set the entry to read only state here,
        // because we must still update the schedule.
        TInt tempError;
        tempError = iServerEntry->ChangeEntry( entry );
#ifndef _NO_MMSS_LOGGING_
        if( tempError != KErrNone )
            {
            LOG2( _L("- ERROR in ChangeEntry: %d"), tempError );            
            }
#endif
        // don't override error if already set
        if( error == KErrNone )
            {
            error = tempError;
            }
        }

    iServerEntry->SetEntry( KMsvNullIndexEntryId );

    // If the error is no longer KErrNone, there has been problems in updating
    // the message entry. Reason might be backup/restore or removal of MMC.
    // If the failure is due to backup/restore, we should try to wait for the
    // end of the operation and then retry from the start of this state.

    if( error <= (TInt) KMsvMediaUnavailable && error >= (TInt) KMsvIndexRestore )
        {
        LOG( _L("- must wait for backup end ") );
        TRequestStatus* status = &iStatus;
        iStatus = KRequestPending;
        SetActive();
        User::RequestComplete( status, error );
        return;
        }
    else if ( iError == KErrNone )
        {
        // The following will not fail
        iSuccessful->AppendL( ( *iFailed )[iCurrentMessageNo - 1] );
        iFailed->Delete( iCurrentMessageNo - 1 );
        LOG( _L("- Successful case: entry moved from iFailed to iSent selection") );
        }
    else
        {
        // keep LINT happy
        }

    // If we have updated our entry, the buffer can go
    iEncodeBuffer->Reset();

    FallThrough();        
    }

// ---------------------------------------------------------
// LogL
// ---------------------------------------------------------
//
void CMmsSendOperation::LogL()
    {
    LOG( _L("CMmsSendOperation::LogL") );
    
    TInt error = iServerEntry->SetEntry( iSelection->At( iCurrentMessageNo - 1 ) );
    if ( error != KErrNone || iError != KErrNone ||
        ( iMmsHeaders->DeliveryReport() != EMmsYes  && iMmsHeaders->ReadReply() != EMmsYes ) )
        {
        // Can't access the entry or do not want logging, can't update log
        FallThrough();
        return;
        }
        
    TBool isActive = EFalse;    
    TRAP( error,
        {
        InitializeLoggingL();
    
        TMsvEntry entry = iServerEntry->Entry();
        // set event type and recipients to log event
        CommonLogEventInitializationL( *iMmsHeaders, entry );
        iServerEntry->SetEntry( KMsvNullIndexEntryId );
   
        iLogEvent->SetDataL( iMmsHeaders->MessageId() );
    
        // CMmsLog will set our status to KRequestPending
        iMmsLog->StartL( *iLogEvent, *iRemoteParties, iStatus );
        SetActive();
        isActive = ETrue;
        });

    // If logging has been successfully initialized, iMmsLog will complete us.
    // If something has gone wrong, we complete ourselves because we want to
    // continue finalization of the sending. We free our entry in any case
    
    iServerEntry->SetEntry( KMsvNullIndexEntryId );
    if ( !isActive )
        {
        FallThrough();
        return;
        }
    }

// ---------------------------------------------------------
// MoveEntryL
// ---------------------------------------------------------
//
void CMmsSendOperation::MoveEntryL()
    {
    // Moving entry into Sent folder or deleting it depending on settings
    LOG( _L("CMmsSendOperation::MoveEntryL") );
    
    TInt error;
    error = iServerEntry->SetEntry( iSelection->At( iCurrentMessageNo - 1 ) );
    if( iError == KErrNone && error == KErrNone )
        {
        TMsvEntry entry = iServerEntry->Entry();

        if( iMmsSettings->MoveToSent() )
            {

            if ( iMmsHeaders->DeliveryReport() == KMmsYes)
                {
                LOG( _L("CMmsSendOperation: Delivery reports wanted") );
                TInt recipientCount(0);
            	//Reset flags in mtmdata2
                entry.iMtmData2 |= KMmsDeliveryStatusPending;
                entry.iMtmData2 &= ~KMmsDeliveryStatusPartial;
                entry.iMtmData2 &= ~KMmsDeliveryStatysFailed; 
                entry.iMtmData2 &= ~KMmsDeliveryStatysDelivered; 
         
         
                recipientCount = ( iMmsHeaders -> ToRecipients()).MdcaCount()
                    + (iMmsHeaders -> CcRecipients()).MdcaCount()
                    + (iMmsHeaders -> BccRecipients()).MdcaCount();
         
            
               entry.iMtmData3 |= recipientCount << KMmsSentItemTotalRecipientsShift;
               entry.iMtmData3 &= ~KMmsSentItemSuccessfullyDeliveredMask;
               entry.iMtmData3 &= ~KMmsSentItemFailedDeliveryMask; 
                }
            else  //Reports not wanted
                {
            	//Reset delivery status flags in mtmdata2
                LOG( _L("CMmsSendOperation: Delivery reports not wanted") );
                entry.iMtmData2 &= ~KMmsDeliveryStatusMask;
                }
                
            iServerEntry->ChangeEntry(entry);
                
            // Move entry from Outbox to Sent Folder
            iError = iServerEntry->SetEntry( entry.Parent() );
            if ( iError == KErrNone )
                {
                iServerEntry->MoveEntryWithinService( entry.Id(), KMsvSentEntryIdValue );
                LOG( _L("CMmsSendOperation::Moved to SENT") );           
                }
            }
        else
            {
            // Move entry to Message Heaven
            iError = iServerEntry->SetEntry( entry.Parent() );
            if ( iError == KErrNone )
                {
                iServerEntry->DeleteEntry( entry.Id() );
                }
            }
        }
    iServerEntry->SetEntry( KMsvNullIndexEntryId );
    FallThrough();
    }

// ================= OTHER EXPORTED FUNCTIONS ==============

//  End of File