An SMTP mail client. More...

#include <Wt/Mail/Client.h>

Public Member Functions
	Client (const std::string &selfHost=std::string())
	Constructor. More...

	~Client ()
	Destructor. More...

void	enableAuthentication (const std::string &username, const std::string &password, AuthenticationMethod method=AuthenticationMethod::Plain)
	Enables authentication. More...

AuthenticationMethod	authenticationMethod () const
	Returns the authentication method. More...

bool	authenticationEnabled () const
	Returns whether authentication is enabled. More...

void	setSslCertificateVerificationEnabled (bool enabled)
	Sets whether SSL certificate verification is enabled. More...

bool	isSslCertificateVerificationEnabled () const
	Gets whether SSL certificate verification is enabled. More...

void	setTransportEncryption (TransportEncryption method)
	Sets the transport encryption method. More...

TransportEncryption	transportEncryption () const
	Get the encryption method. More...

bool	connect ()
	Connects to the default SMTP server. More...

bool	connect (const std::string &smtpHost, int smtpPort=25)
	Connects to a given STMP server and port. More...

void	disconnect ()
	Disconnects the client from the SMTP server.

bool	send (const Message &message)
	Sends a message. More...

Detailed Description

An SMTP mail client.

The SMTP client can send one or more mail messages to an SMTP host.

#include <Wt/Mail/Client>
#include <Wt/Mail/Message>
 
Mail::Message message;
message.setFrom(Mail::Mailbox("kudos@corp.org", "Kudos Dukos");
message.addRecipient(Mail::RecipientType::To, Mail::Mailbox("koen@emweb.be", "Koen Deforche");
message.setSubject("Hey there, koen!");
message.setBody("That mail client seems to be working.");
message.addHtmlBody ("<p>"
     "<a href=\"http://www.webtoolkit.eu/wt\">That mail client</a>"
     " seems to be working just great!</p>");
 
Mail::Client client;
client.connect("localhost");
client.send(message);

Only the bare essentials of the SMTP protocol are current implemented, although the Message itself supports proper unicode handling.

Note: Currently the client sends an email synchronously, and thus a slow connection to the SMTP server may block the current thread. We plan to change this in the future. It is thus beneficial to connect to a local SMTP daemon to minimize this deficiency.

Constructor & Destructor Documentation

◆ Client()

Wt::Mail::Client::Client ( const std::string & selfHost = std::string() )

Constructor.

The selfHost is how the mail client will identify itself to the mail server, in the EHLO command.

If not defined, the "smtp-self-host" configuration property is used, and if that property is not defined, it defaults to "localhost".

◆ ~Client()

Wt::Mail::Client::~Client ( )

Destructor.

If the client is still connected, this disconnects the client.

Member Function Documentation

◆ authenticationEnabled()

bool Wt::Mail::Client::authenticationEnabled ( ) const

Returns whether authentication is enabled.

See also: enableAuthentication

◆ authenticationMethod()

AuthenticationMethod Wt::Mail::Client::authenticationMethod ( ) const

Returns the authentication method.

See also: enableAuthentication

◆ connect() [1/2]

bool Wt::Mail::Client::connect ( )

Connects to the default SMTP server.

This connects to the SMTP server defined by the "smtp-host" property, on port defined by the "smtp-port" property. If these properties are not set, "localhost" and 25 are used as defaults respectively.

Returns whether the connection could be established and the SMTP hand-shake was successful.

◆ connect() [2/2]

bool Wt::Mail::Client::connect	(	const std::string &	smtpHost,
		int	smtpPort = `25`
	)

Connects to a given STMP server and port.

Returns whether the connection could be established and the SMTP hand-shake was successful.

◆ enableAuthentication()

void Wt::Mail::Client::enableAuthentication	(	const std::string &	username,
		const std::string &	password,
		AuthenticationMethod	method = `AuthenticationMethod::Plain`
	)

Enables authentication.

Enable authentication either through this method, or by specifying the following configuration properties:

smtp-auth-username
smtp-auth-password
smtp-auth-method

"smtp-auth-method" can be one of: "none", "plain", or "login".

◆ isSslCertificateVerificationEnabled()

bool Wt::Mail::Client::isSslCertificateVerificationEnabled ( ) const

Gets whether SSL certificate verification is enabled.

See also: setSslCertificateVerificationEnabled

◆ send()

bool Wt::Mail::Client::send ( const Message & message )

Sends a message.

The client must be connected before messages can be sent.

The function returns true on success, false on error. The reason for the error is logged in the log file.

◆ setSslCertificateVerificationEnabled()

void Wt::Mail::Client::setSslCertificateVerificationEnabled ( bool enabled )

Sets whether SSL certificate verification is enabled.

Defaults to true

◆ setTransportEncryption()

void Wt::Mail::Client::setTransportEncryption ( TransportEncryption method )

Sets the transport encryption method.

The default is TransportEncryption::None

Enable transport encryption either through this method, or by specifying the "smtp-transport-encryption" configuration property. Its value can be one of: "none", "starttls", or "tls".

◆ transportEncryption()

TransportEncryption Wt::Mail::Client::transportEncryption ( ) const

Get the encryption method.

See also: setTransportEncryption

Public Member Functions