Inheritance diagram for service:

Collaboration diagram for service:

Public Types
enum	Type { TYPE_STORE = 0, TYPE_TRANSPORT }

Public Member Functions
virtual	~service ()

virtual Type	getType () const =0

virtual const string	getProtocolName () const =0

shared_ptr< const session >	getSession () const

shared_ptr< session >	getSession ()

virtual const serviceInfos &	getInfos () const =0

virtual void	connect ()=0

virtual void	disconnect ()=0

virtual bool	isConnected () const =0

virtual void	noop ()=0

shared_ptr< const security::authenticator >	getAuthenticator () const

shared_ptr < security::authenticator >	getAuthenticator ()

void	setAuthenticator (shared_ptr< security::authenticator > auth)

void	setCertificateVerifier (shared_ptr< security::cert::certificateVerifier > cv)

shared_ptr < security::cert::certificateVerifier >	getCertificateVerifier ()

void	setSocketFactory (shared_ptr< socketFactory > sf)

shared_ptr< socketFactory >	getSocketFactory ()

void	setTimeoutHandlerFactory (shared_ptr< timeoutHandlerFactory > thf)

shared_ptr< timeoutHandlerFactory >	getTimeoutHandlerFactory ()

void	setTracerFactory (shared_ptr< tracerFactory > tf)

shared_ptr< tracerFactory >	getTracerFactory ()

template<typename TYPE >
void	setProperty (const string &name, const TYPE &value)

virtual bool	isSecuredConnection () const =0

virtual shared_ptr < connectionInfos >	getConnectionInfos () const =0

Protected Member Functions
	service (shared_ptr< session > sess, const serviceInfos &infos, shared_ptr< security::authenticator > auth)

Protected Member Functions inherited from object
	object ()

	object (const object &)

object &	operator= (const object &)

virtual	~object ()

Detailed Description

Base class for messaging services.

Member Enumeration Documentation

enum Type

Possible service types.

Enumerator
TYPE_STORE	The service is a message store.
TYPE_TRANSPORT	The service sends messages.

Constructor & Destructor Documentation

service	(	shared_ptr< session >	sess,
		const serviceInfos &	infos,
		shared_ptr< security::authenticator >	auth
	)

protected

References platform::getHandler().

~service ( )

virtual

Member Function Documentation

virtual void connect ( )

pure virtual

Connect to service.

Implemented in IMAPStore, maildirStore, POP3Store, SMTPTransport, and sendmailTransport.

virtual void disconnect ( )

pure virtual

Disconnect from service.

Implemented in IMAPStore, maildirStore, POP3Store, SMTPTransport, and sendmailTransport.

shared_ptr< const security::authenticator > getAuthenticator ( ) const

Return the authenticator object used with this service instance.

Returns: authenticator object

Referenced by SMTPTransport::connect(), POP3Store::connect(), and IMAPStore::connect().

shared_ptr< security::authenticator > getAuthenticator ( )

Return the authenticator object used with this service instance.

Returns: authenticator object

shared_ptr< security::cert::certificateVerifier > getCertificateVerifier ( )

Get the object responsible for verifying certificates when using secured connections (TLS/SSL).

virtual shared_ptr<connectionInfos> getConnectionInfos ( ) const

pure virtual

Get information about the connection.

Returns: information about the connection

Implemented in IMAPStore, maildirStore, SMTPTransport, POP3Store, and sendmailTransport.

virtual const serviceInfos& getInfos ( ) const

pure virtual

Return information about this service.

Returns: information about the service

Implemented in IMAPStore, maildirStore, POP3Store, SMTPTransport, sendmailTransport, IMAPSStore, POP3SStore, and SMTPSTransport.

virtual const string getProtocolName ( ) const

pure virtual

Return the protocol name of this service.

Returns: protocol name

Implemented in IMAPStore, maildirStore, POP3Store, SMTPTransport, sendmailTransport, IMAPSStore, POP3SStore, and SMTPSTransport.

shared_ptr< const session > getSession ( ) const

Return the session object associated with this service instance.

Returns: session object

shared_ptr< session > getSession ( )

Return the session object associated with this service instance.

Returns: session object

shared_ptr< socketFactory > getSocketFactory ( )

Return the factory used to create socket objects for this service.

Returns: socket factory

shared_ptr< timeoutHandlerFactory > getTimeoutHandlerFactory ( )

Return the factory used to create timeoutHandler objects for this service.

Returns: timeoutHandler factory

shared_ptr< tracerFactory > getTracerFactory ( )

virtual Type getType ( ) const

pure virtual

Return the type of service.

Returns: type of service

Implemented in transport, and store.

virtual bool isConnected ( ) const

pure virtual

Test whether this service is connected.

Returns: true if the service is connected, false otherwise

Implemented in IMAPStore, maildirStore, POP3Store, SMTPTransport, and sendmailTransport.

virtual bool isSecuredConnection ( ) const

pure virtual

Check whether the connection is secured.

Returns: true if the connection is secured, false otherwise

Implemented in IMAPStore, maildirStore, SMTPTransport, POP3Store, and sendmailTransport.

virtual void noop ( )

pure virtual

Do nothing but ensure the server do not disconnect (for example, this can reset the auto-logout timer on the server, if one exists).

Implemented in IMAPStore, maildirStore, POP3Store, SMTPTransport, and sendmailTransport.

void setAuthenticator ( shared_ptr< security::authenticator > auth )

Set the authenticator object used with this service instance.

Parameters

auth	authenticator object

void setCertificateVerifier ( shared_ptr< security::cert::certificateVerifier > cv )

Set the object responsible for verifying certificates when using secured connections (TLS/SSL).

void setProperty	(	const string &	name,
		const TYPE &	value
	)

Set a property for this service (service prefix is added automatically).

WARNING: this sets the property on the session object, so all service instances created with the session object will inherit the property.

Parameters

name	property name
value	property value

void setSocketFactory ( shared_ptr< socketFactory > sf )

Set the factory used to create socket objects for this service.

Parameters

sf	socket factory

void setTimeoutHandlerFactory ( shared_ptr< timeoutHandlerFactory > thf )

Set the factory used to create timeoutHandler objects for this service.

By default, the defaultTimeoutHandler class is used. Not all services support timeout handling.

Parameters

thf	timeoutHandler factory

void setTracerFactory ( shared_ptr< tracerFactory > tf )

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation