mireka.transmission.immediate

Class IndirectImmediateSender

Object

mireka.transmission.immediate.IndirectImmediateSender

All Implemented Interfaces:

ImmediateSender

@NotThreadSafe
public class IndirectImmediateSender
extends Object
implements ImmediateSender

IndirectImmediateSender synchronously sends all mails through other SMTP servers specified in the configuration, typically to a smarthost, instead of sending the mail directly to the SMTP servers of the recipients. It tries all listed smarthosts until a working one is found. The smarthost will in turn transmit the mail to remote domains. This is useful for example if a network is behind a dynamic IP address, considering that dynamic IP addresses are frequently rejected by SMTP servers.

If a smart host name resolves to more than one IP addresses, than only the first one is used.

Instead of specifying a single smarthost, an Upstream with more servers can also be supplied and Mireka will distribute outgoing mails like a simple load balancer.

Constructor Summary

Constructors

Constructor and Description
IndirectImmediateSender()

Method Summary

Modifier and Type	Method and Description
MailToHostTransmitter	getMailToHostTransmitter()
Upstream	getUpstream()
void	send(Mail mail) Transmits mail to a smart host.
void	setBackendServer(BackendServer server) Sets the upstream to the supplied single server.
void	setMailToHostTransmitter(MailToHostTransmitter mailToHostTransmitter)
void	setUpstream(Upstream upstream)
boolean	singleDomainOnly() Returns true if the created ImmediateSender requires that all recipients of the mail to be sent have the same remote-part.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IndirectImmediateSender

public IndirectImmediateSender()

Method Detail

singleDomainOnly

public boolean singleDomainOnly()

Description copied from interface: ImmediateSender

Returns true if the created ImmediateSender requires that all recipients of the mail to be sent have the same remote-part.

Specified by:

singleDomainOnly in interface ImmediateSender

send

public void send(Mail mail)
          throws SendException,
                 RecipientsWereRejectedException,
                 IllegalArgumentException,
                 PostponeException

Transmits mail to a smart host.

Specified by:

send in interface ImmediateSender

Throws:

PostponeException - if transmission to all of the hosts must be postponed, because all of them are assumed to be busy at this moment.

IllegalArgumentException - if the domains of the recipients are not the same, or if the recipient is the special global postmaster address, which has no absolute domain.

SendException

RecipientsWereRejectedException

getMailToHostTransmitter

public MailToHostTransmitter getMailToHostTransmitter()

Category:

GETSET

setMailToHostTransmitter

public void setMailToHostTransmitter(MailToHostTransmitter mailToHostTransmitter)

Category:

GETSET

setBackendServer

public void setBackendServer(BackendServer server)

Sets the upstream to the supplied single server.

Category:

GETSET

getUpstream

public Upstream getUpstream()

Category:

GETSET

setUpstream

public void setUpstream(Upstream upstream)

Category:

GETSET