CSARStore Class Reference

#include <gsmustor.h>

Link against: gsmu.lib

class CSARStore : public CBase

Inherits from

CSARStore
- CBase

Protected Attributes
RFs &	iFs
TInt	iMaxmumNumberOfMessagesInSegmentationStore

Public Member Functions
IMPORT_C void	BeginTransactionLC()
IMPORT_C void	Close()
IMPORT_C void	CommitTransactionL()
IMPORT_C void	CompactL()
IMPORT_C void	DeleteEntryL(TInt)
IMPORT_C void	DoOpenL()
IMPORT_C const CArrayFix< TSAREntry > &	Entries()
RFs &	FileSession()
TBool	InTransaction()
IMPORT_C void	OpenL(const TDesC &, const TUid &)
IMPORT_C void	PrivatePath(TDes &)
IMPORT_C void	PurgeL(const TTimeIntervalMinutes &, TBool)
IMPORT_C void	PurgeL(TInt, TBool)
void	Revert()

Protected Member Functions
	CSARStore(RFs &)
	~CSARStore()
IMPORT_C void	AddEntryL(const TSAREntry &)
IMPORT_C void	ChangeEntryL(TInt, const TSAREntry &)
IMPORT_C TStreamId	ExtraStreamId()
IMPORT_C CFileStore &	FileStore()
IMPORT_C const CFileStore &	FileStore()
IMPORT_C void	SetExtraStreamIdL(const TStreamId &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

Controls the segmentation and reassembly (SAR) store, used for SMS segmentation and reassembly, and WAP reassembly.

Member Attribute Documentation

iFs

RFs &

iFs

[protected]

iMaxmumNumberOfMessagesInSegmentationStore

TInt

iMaxmumNumberOfMessagesInSegmentationStore

[protected]

Maximum number of SMS messages that can be stored in segmentation store.

Constructor & Destructor Documentation

CSARStore ( RFs & )

IMPORT_C

CSARStore

(

RFs &

aFs

)

[protected]

Constructor, initialises class members only.

Parameters
aFs	File system handle

Capability
None

~CSARStore ( )

IMPORT_C

~CSARStore

(

)

[protected]

Destructor. Frees resource.

Capability
None

Member Function Documentation

AddEntryL ( const TSAREntry & )

IMPORT_C void

AddEntryL

(

const TSAREntry &

aEntry

)

[protected]

Adds a new entry to the file store.

The function appends the new entry to the internal entry array, and then externalises it.

The file store must be open before calling this function.

Parameters
aEntry	SAR entry to add

Capability
None

BeginTransactionLC ( )

IMPORT_C void

BeginTransactionLC

(

)

Sets the SAR store as in-transaction.

The function checks the validity of the call and leaves KErrAccessDenied if invalid.

Capability
None

ChangeEntryL ( TInt, const TSAREntry & )

IMPORT_C void	ChangeEntryL	(	TInt	aIndex,
			const TSAREntry &	aNewEntry
		)	[protected]

Changes an entry in the file store - changes it first in the internal entry array, and then externalizes it.

The file store must be open before calling this function.

Parameters
aIndex	The index into the SAR store to be changed
aNewEntry	The new SAR store entry

Capability
None

Close ( )

IMPORT_C void

(

)

Closes the file store.

The function deletes the file store object and resets the entry array. It should be called once when the protocol module is closing down.

Capability
None

CommitTransactionL ( )

IMPORT_C void

CommitTransactionL

(

)

Commits a transaction to the filestore.

Capability
None

CompactL ( )

IMPORT_C void

CompactL

(

)

Compacts the file store.

This is done on every reboot and for every eighth SMS message sent, to keep the size of the file as low as possible.

This function opens and closes the file automatically.

Capability
None

DeleteEntryL ( TInt )

IMPORT_C void

DeleteEntryL

(

TInt

aIndex

)

Deletes an entry from the entry array, and externalizes it.

The file store must be open before calling this function.

Parameters
aIndex	Entry in the SAR store to delete

Capability
None

DoOpenL ( )

IMPORT_C void

DoOpenL

(

)

Opens a filestore.

This is called by OpenL(), and does the work of really opening the file. If the file is not there, it creates a new one.

Capability
None

Entries ( )

IMPORT_C const CArrayFix< TSAREntry > &

Entries

(

)

const

Gets a const reference to the entry array.

Return Value: Entry array

Capability
None

ExtraStreamId ( )

IMPORT_C TStreamId

ExtraStreamId

(

)

const [protected]

Gets the extra stream ID.

Return Value: Extra stream ID

Capability
None

FileSession ( )

RFs &

FileSession

(

)

const [inline]

Gets the file server handle.

Return Value: File server handle

FileStore ( )

IMPORT_C CFileStore &

FileStore

(

)

[protected]

Gets a reference to the filestore.

Return Value: The filestore

Capability
None

FileStore ( )

IMPORT_C const CFileStore &

FileStore

(

)

const [protected]

Gets a (const) reference to the filestore.

Return Value: The filestore

Capability
None

InTransaction ( )

TBool

InTransaction

(

)

const [inline]

Return Value: whether it's in transaction

OpenL ( const TDesC &, const TUid & )

IMPORT_C void	OpenL	(	const TDesC &	aFullName,
			const TUid &	aThirdUid
		)

Opens a specified SAR store.

A SAR filestore has has three uids, KPermanentFileStoreLayoutUid, KSARStoreUid (which designates that the file store is a SAR store) and a third UID, that identifies the particular implementation of CSARStore.

Parameters
aFullName	Name for the segmentation and reassembly filestore
aThirdUid	Third UID for the filestore.

Capability
None

PrivatePath ( TDes & )

IMPORT_C void

PrivatePath

(

TDes &

aPath

)

Returns the private path used to open a store.

Parameters
aPath	The private path of a store.

Capability
None

PurgeL ( const TTimeIntervalMinutes &, TBool )

IMPORT_C void	PurgeL	(	const TTimeIntervalMinutes &	aTimeIntervalMinutes,
			TBool	aPurgeIncompleteOnly
		)

Purges the reassembly file store.

After a multipart message, it delete all the old entries.

Entries will be purged when: 1) The complete message is received; 2) After aTimerintervalMinutes, if aPurgeIncompletely is false.

PurgeL() will be called after the booting of the device or when a message has been received.

This function opens and closes the file automatically.

Note: overload function for segmentation store.

Parameters
aTimeIntervalMinutes	Purge time
aPurgeIncompleteOnly	Purge complete messages flag

Capability
None

PurgeL ( TInt, TBool )

IMPORT_C void	PurgeL	(	TInt	aKSegmentationLifetimeMultiplier,
			TBool	aPurgeIncompleteOnly
		)

Purges the segmentation store.

This purges the filestore after a multipart message, deleting all the old entries.

This function opens and closes the file automatically.

Parameters
aKSegmentationLifetimeMultiplier	The coefficient for calculating whether a message should be purged
aPurgeIncompleteOnly	Set to false to purge all entries. Set to true to purge incomplete messages only.

Capability
None

Revert ( )

void

Revert

(

)

SetExtraStreamIdL ( const TStreamId & )

IMPORT_C void

SetExtraStreamIdL

(

const TStreamId &

aExtraStreamId

)

[protected]

Sets the extra stream ID - changes it first in the internal entry array, and then externalizes it.

You must call Close() when the function returns.

Parameters
aExtraStreamId	Extra stream ID

Capability
None