basic SMTP client. More...

#include <smtp_client.hpp>

Inheritance diagram for join::BasicSmtpClient< Protocol >:

Public Types
using	Endpoint = typename Protocol::Endpoint

using	Stream = typename Protocol::Stream

Public Member Functions
	BasicSmtpClient (const char *host, uint16_t port=Protocol::defaultPort)
	create the basic SMTP client instance.

	BasicSmtpClient (const std::string &host, uint16_t port=Protocol::defaultPort)
	create the basic SMTP client instance.

	BasicSmtpClient (TlsContext ctx, const char *host, uint16_t port=Protocol::defaultPort)
	create the basic SMTP client instance using the given context.

	BasicSmtpClient (TlsContext ctx, const std::string &host, uint16_t port=Protocol::defaultPort)
	create the basic SMTP client instance using the given context.

	BasicSmtpClient (const BasicSmtpClient &other)=delete
	create the basic SMTP client instance by copy.

BasicSmtpClient &	operator= (const BasicSmtpClient &other)=delete
	assign the basic SMTP client instance by copy.

	BasicSmtpClient (BasicSmtpClient &&other)
	create the basic SMTP client instance by move.

BasicSmtpClient &	operator= (BasicSmtpClient &&other)
	assign the basic SMTP client instance by move.

virtual	~BasicSmtpClient ()=default
	destroy the basic SMTP client instance.

virtual std::string	scheme () const
	get scheme.

const std::string &	host () const
	get host.

uint16_t	port () const
	get port.

std::string	authority () const
	get authority.

std::string	url () const
	get URL.

void	credentials (const std::string &login, const std::string &password)
	set credentials.

int	send (const SmtpMessage &message)
	send mail message.

Protected Member Functions
virtual int	connect (const Endpoint &endpoint)
	make a connection to the given endpoint.

void	close ()
	close the connection.

int	sendMessage (const std::string &message)
	send message.

std::string	readReplies (std::vector< std::string > *replies=nullptr)
	read replies.

int	greeting ()
	handle greeting.

int	initialize (std::vector< std::string > &replies)
	client init.

int	startTls ()
	start encryption.

int	loginAuthenticate ()
	authenticate using LOGIN.

int	plainAuthenticate ()
	authenticate using PLAIN.

int	sendFrom (const SmtpMessage &message)
	send sender address.

int	sendTo (const SmtpMessage &message)
	send recpient address.

int	sendData (const SmtpMessage &message)
	send message.

int	quit ()
	send quit.

std::string	hostname () const
	get host name.

Protected Attributes
Stream	_stream
	stream.

std::string	_host
	SMTP host.

uint16_t	_port
	SMTP port.

std::string	_login
	SMTP login.

std::string	_password
	SMTP password.

Detailed Description

template<class Protocol>
class join::BasicSmtpClient< Protocol >

basic SMTP client.

Member Typedef Documentation

◆ Endpoint

template<class Protocol >

using join::BasicSmtpClient< Protocol >::Endpoint = typename Protocol::Endpoint

◆ Stream

template<class Protocol >

using join::BasicSmtpClient< Protocol >::Stream = typename Protocol::Stream

Constructor & Destructor Documentation

◆ BasicSmtpClient() [1/6]

template<class Protocol >

join::BasicSmtpClient< Protocol >::BasicSmtpClient	(	const char *	host,
		uint16_t	port = Protocol::defaultPort )

inline

create the basic SMTP client instance.

Parameters

host	host.
port	port (default: 25).

◆ BasicSmtpClient() [2/6]

template<class Protocol >

join::BasicSmtpClient< Protocol >::BasicSmtpClient	(	const std::string &	host,
		uint16_t	port = Protocol::defaultPort )

inline

create the basic SMTP client instance.

Parameters

host	host.
port	port (default: 25).

◆ BasicSmtpClient() [3/6]

template<class Protocol >

join::BasicSmtpClient< Protocol >::BasicSmtpClient	(	TlsContext	ctx,
		const char *	host,
		uint16_t	port = Protocol::defaultPort )

inline

create the basic SMTP client instance using the given context.

Parameters

ctx	TLS context used by the STARTTLS upgrade.
host	host.
port	port (default: 25).

◆ BasicSmtpClient() [4/6]

template<class Protocol >

join::BasicSmtpClient< Protocol >::BasicSmtpClient	(	TlsContext	ctx,
		const std::string &	host,
		uint16_t	port = Protocol::defaultPort )

inline

create the basic SMTP client instance using the given context.

Parameters

ctx	TLS context used by the STARTTLS upgrade.
host	host.
port	port (default: 25).

◆ BasicSmtpClient() [5/6]

template<class Protocol >

join::BasicSmtpClient< Protocol >::BasicSmtpClient ( const BasicSmtpClient< Protocol > & other )

delete

create the basic SMTP client instance by copy.

Parameters

other request to copy.

◆ BasicSmtpClient() [6/6]

template<class Protocol >

join::BasicSmtpClient< Protocol >::BasicSmtpClient ( BasicSmtpClient< Protocol > && other )

inline

create the basic SMTP client instance by move.

Parameters

other request to move.

◆ ~BasicSmtpClient()

template<class Protocol >

virtual join::BasicSmtpClient< Protocol >::~BasicSmtpClient ( )

virtualdefault

destroy the basic SMTP client instance.

Member Function Documentation

◆ authority()

template<class Protocol >

std::string join::BasicSmtpClient< Protocol >::authority ( ) const

inline

get authority.

Returns: authority.

◆ close()

template<class Protocol >

void join::BasicSmtpClient< Protocol >::close ( )

inlineprotected

close the connection.

Returns: this on success, nullptr on failure.

◆ connect()

template<class Protocol >

virtual int join::BasicSmtpClient< Protocol >::connect ( const Endpoint & endpoint )

inlineprotectedvirtual

make a connection to the given endpoint.

Parameters

endpoint endpoint to connect to.

Returns: 0 on success, -1 on failure.

Reimplemented in join::BasicSmtpSecureClient< Protocol >.

◆ credentials()

template<class Protocol >

void join::BasicSmtpClient< Protocol >::credentials	(	const std::string &	login,
		const std::string &	password )

inline

set credentials.

Parameters

login	login.
password	password.

◆ greeting()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::greeting ( )

inlineprotected

handle greeting.

Returns: 0 on success, -1 on failure.

◆ host()

template<class Protocol >

const std::string & join::BasicSmtpClient< Protocol >::host ( ) const

inline

get host.

Returns: host.

◆ hostname()

template<class Protocol >

std::string join::BasicSmtpClient< Protocol >::hostname ( ) const

inlineprotected

get host name.

Returns: host name.

◆ initialize()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::initialize ( std::vector< std::string > & replies )

inlineprotected

client init.

Parameters

replies server replies.

Returns: 0 on success, -1 on failure.

◆ loginAuthenticate()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::loginAuthenticate ( )

inlineprotected

authenticate using LOGIN.

Returns: 0 on success, -1 on failure.

◆ operator=() [1/2]

template<class Protocol >

BasicSmtpClient & join::BasicSmtpClient< Protocol >::operator= ( BasicSmtpClient< Protocol > && other )

inline

assign the basic SMTP client instance by move.

Parameters

other request to move.

Returns: a reference of the current object.

◆ operator=() [2/2]

template<class Protocol >

BasicSmtpClient & join::BasicSmtpClient< Protocol >::operator= ( const BasicSmtpClient< Protocol > & other )

delete

assign the basic SMTP client instance by copy.

Parameters

other request to copy.

Returns: a reference of the current object.

◆ plainAuthenticate()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::plainAuthenticate ( )

inlineprotected

authenticate using PLAIN.

Returns: 0 on success, -1 on failure.

◆ port()

template<class Protocol >

uint16_t join::BasicSmtpClient< Protocol >::port ( ) const

inline

get port.

Returns: port.

◆ quit()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::quit ( )

inlineprotected

send quit.

Returns: 0 on success, -1 on failure.

◆ readReplies()

template<class Protocol >

std::string join::BasicSmtpClient< Protocol >::readReplies ( std::vector< std::string > * replies = nullptr )

inlineprotected

read replies.

Parameters

replies replies to read.

Returns: reply code.

◆ scheme()

template<class Protocol >

virtual std::string join::BasicSmtpClient< Protocol >::scheme ( ) const

inlinevirtual

get scheme.

Returns: scheme.

Reimplemented in join::BasicSmtpSecureClient< Protocol >.

◆ send()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::send ( const SmtpMessage & message )

inline

send mail message.

Parameters

message mail message to send.

Returns: 0 on success, -1 on failure.

◆ sendData()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::sendData ( const SmtpMessage & message )

inlineprotected

send message.

Parameters

message message to send.

Returns: 0 on success, -1 on failure.

◆ sendFrom()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::sendFrom ( const SmtpMessage & message )

inlineprotected

send sender address.

Parameters

message mail message.

Returns: 0 on success, -1 on failure.

◆ sendMessage()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::sendMessage ( const std::string & message )

inlineprotected

send message.

Parameters

message message to send.

Returns: 0 on success, -1 on failure.

◆ sendTo()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::sendTo ( const SmtpMessage & message )

inlineprotected

send recpient address.

Parameters

message mail message.

Returns: 0 on success, -1 on failure.

◆ startTls()

template<class Protocol >

int join::BasicSmtpClient< Protocol >::startTls ( )

inlineprotected

start encryption.

Returns: 0 on success, -1 on failure.

◆ url()

template<class Protocol >

std::string join::BasicSmtpClient< Protocol >::url ( ) const

inline

get URL.

Returns: URL.

Member Data Documentation

◆ _host

template<class Protocol >

std::string join::BasicSmtpClient< Protocol >::_host

protected

SMTP host.

◆ _login

template<class Protocol >

std::string join::BasicSmtpClient< Protocol >::_login

protected

SMTP login.

◆ _password

template<class Protocol >

std::string join::BasicSmtpClient< Protocol >::_password

protected

SMTP password.

◆ _port

template<class Protocol >

uint16_t join::BasicSmtpClient< Protocol >::_port

protected

SMTP port.

◆ _stream

template<class Protocol >

Stream join::BasicSmtpClient< Protocol >::_stream

protected

stream.

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

services/include/join/smtp_client.hpp
services/include/join/smtp_protocol.hpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ Endpoint

◆ Stream

Constructor & Destructor Documentation

◆ BasicSmtpClient() [1/6]

◆ BasicSmtpClient() [2/6]

◆ BasicSmtpClient() [3/6]

◆ BasicSmtpClient() [4/6]

◆ BasicSmtpClient() [5/6]

◆ BasicSmtpClient() [6/6]

◆ ~BasicSmtpClient()

Member Function Documentation

◆ authority()

◆ close()

◆ connect()

◆ credentials()

◆ greeting()

◆ host()

◆ hostname()

◆ initialize()

◆ loginAuthenticate()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ plainAuthenticate()

◆ port()

◆ quit()

◆ readReplies()

◆ scheme()

◆ send()

◆ sendData()

◆ sendFrom()

◆ sendMessage()

◆ sendTo()

◆ startTls()

◆ url()

Member Data Documentation

◆ _host

◆ _login

◆ _password

◆ _port

◆ _stream