Persistentdata for beginners: Event Logger

Event Logger stores events that are created by a number of operating system clients (e.g. events for incoming text messages generated by the SMS stack). These events are later retrieved by applications so the user can see a history of the events that have occurred on their device.

The Symbian/S60 Log application uses Event Logger to show a list of recent calls, packet data and other chargeable connections.

Event Logger has a client-server architecture and uses a DBMS database to manage the event log. The Event Logger API has been supported since S60 2nd Edition. It was previously known as log engine (logeng).

Event Logger API

Event Logger clients should link to logwrap.lib and logcli.lib.

API Purpose
CLogActive
(logwrap.h)
Abstract base class that defines common active object behaviour for event logger classes such as CLogViewRecent
CLogBase
(logwrap.h)
Used by client code to perform simple actions on the log database like adding a new event
CLogClient
(logcli.h)
The API to retrieve events from the log and administer the log database
CLogCntModel
(logcntmodel.h)
Base class for ECom plugin to resolve contact information from a phone number
CLogEvent
(logwrap.h)
Encapsulates the details of an event
CLogEventType
(logcli.h)
Event type, e.g. call, packet data, SMS, LBS transmit location etc.
CLogFilter
(logcli.h)
Specifies the conditions that events must satisfy to appear in a view
CLogFilterList
(logcli.h)
A collection of event view filters
CLogView
(logview.h)
Base class for log database views
CLogViewDuplicate
(logview.h)
A view of events that are duplicates of a specific event
CLogViewEvent
(logview.h)
A view of the event log
CLogViewRecent
(logview.h)
A view of recent events
CLogWrapper
(logwrap.h)
Wrapper around the event logger provided for compatibility reasons
MLogClientChangeObserver
(logclientchangeobserver.h)
Allows a client to observe specific change events (event log cleared, view refresh required)
MLogCntModel
(logcntmodel.h)
An interface to decouple Event Logger from the Contacts implementation
MLogViewChangeObserver
(logviewchangeobserver.h)
Allows a client to observe specific change events (event added/changed/deleted) within a given view
TLogConfig
(logcli.h)
Encapsulates Log Engine configuration data, such as the maximum number of events the event log holds
TLogSmsPduData
(logsmspdudata.h)
Used to store SMS PDU (protocol description unit) info in event data

Further resources

Coming up next…

File Logger is the next component in the Persistentdata for beginners series. It provides a logging API for debugging and other purposes.

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s


%d bloggers like this: