org.subethamail.smtp.helper

Class BasicMessageHandlerFactory.BasicMessageHandler

java.lang.Object

org.subethamail.smtp.helper.BasicMessageHandlerFactory.BasicMessageHandler

All Implemented Interfaces:

MessageHandler

Enclosing class:

BasicMessageHandlerFactory

public static class BasicMessageHandlerFactory.BasicMessageHandler
extends Object
implements MessageHandler

Constructor Summary

Constructors

Constructor and Description
BasicMessageHandler(MessageContext context, BasicMessageListener listener, int maxMessageSize)

Method Summary

Modifier and Type	Method and Description
String	data(InputStream is) Called when the DATA part of the SMTP exchange begins.
void	done() Called after all other methods are completed.
void	from(String from) Called first, after the MAIL FROM during a SMTP exchange.
void	recipient(String recipient) Called once for every RCPT TO during a SMTP exchange.

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicMessageHandler

public BasicMessageHandler(MessageContext context,
                           BasicMessageListener listener,
                           int maxMessageSize)

Method Detail

from

public void from(String from)
          throws RejectException

Description copied from interface: MessageHandler

Called first, after the MAIL FROM during a SMTP exchange. A MessageHandler is created after the MAIL command is received, so this function is always called, even if the mail transaction is aborted later.

Specified by:

from in interface MessageHandler

Parameters:

from - is the sender as specified by the client. It will be a mostly rfc822-compliant email address, already validated by the server. The validation is performed by the JavaMail InternetAddress.parse function, according to the strict rules, which means that "many (but not all) of the RFC822 syntax rules are enforced".

Throws:

RejectException - if the sender should be denied.

DropConnectionException - if the connection should be dropped

recipient

public void recipient(String recipient)
               throws RejectException

Description copied from interface: MessageHandler

Called once for every RCPT TO during a SMTP exchange. This will occur after a from() call.

Specified by:

recipient in interface MessageHandler

Parameters:

recipient - is a rfc822-compliant email address, validated by the server.

Throws:

RejectException - if the recipient should be denied.

DropConnectionException - if the connection should be dropped

data

public String data(InputStream is)
            throws RejectException,
                   TooMuchDataException,
                   IOException

Description copied from interface: MessageHandler

Called when the DATA part of the SMTP exchange begins. This will occur after all recipient() calls are complete. Note: If you do not read all the data, it will be read for you after this method completes.

Specified by:

data in interface MessageHandler

Parameters:

is - will be the smtp data stream, stripped of any extra '.' chars. The data stream will be valid only for the duration of the call.

Returns:

custom success message without response code like 'OK message received' or null if return message shouldn't be customized.

Throws:

RejectException - if at any point the data should be rejected.

DropConnectionException - if the connection should be dropped

TooMuchDataException - if the listener can't handle that much data. An error will be reported to the client.

IOException - if there is an IO error reading the input data.

done

public void done()

Description copied from interface: MessageHandler

Called after all other methods are completed. Note that this method will be called even if the mail transaction is aborted at some point after the initial from() call.

Specified by:

done in interface MessageHandler