jodd.mail

Class EmailFilter

java.lang.Object

jodd.mail.EmailFilter

public class EmailFilter
extends java.lang.Object

EmailFilter helps in building boolean queries of search terms. There are two ways how it can be used, both can be combined.

First way is constructing boolean expression using groups. Just use and(EmailFilter...), or(EmailFilter...) and not(EmailFilter) methods that takes any number of filters that will be joined with chosen boolean operator.

Second way is more fluent. It may not be used to express some complex queries, but for every-day use it would be enough. Use methods and() and or() to define how all next terms will be joined. Method not() marks the one next term to be added as NOT term.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EmailFilter.Operator Comparison operator.

Field Summary

Fields

Modifier and Type	Field and Description
protected javax.mail.search.SearchTerm	searchTerm

Constructor Summary

Constructors

Constructor and Description
EmailFilter()

Method Summary

Modifier and Type	Method and Description
EmailFilter	and() Changes concatenation mode to AND.
EmailFilter	and(EmailFilter... emailFilters) Defines AND group of filters.
protected void	and(javax.mail.search.SearchTerm searchTerm)
EmailFilter	bcc(java.lang.String bccAddress) Defines filter for BCC field.
EmailFilter	cc(java.lang.String ccAddress) Defines filter for CC field.
protected void	concat(javax.mail.search.SearchTerm searchTerm) Concatenates last search term with new one.
static EmailFilter	filter() Creates new Email filter.
EmailFilter	flag(javax.mail.Flags.Flag flag, boolean value) Defines filter for single flag.
EmailFilter	flags(javax.mail.Flags flags, boolean value) Defines filter for many flags at once.
EmailFilter	from(java.lang.String fromAddress) Defines filter for FROM field.
javax.mail.search.SearchTerm	getSearchTerm() Returns search term.
EmailFilter	header(java.lang.String headerName, java.lang.String pattern) Defines filter for header.
EmailFilter	messageId(int messageId) Defines filter for message id.
EmailFilter	messageId(java.lang.String messageId) Defines filter for message id.
EmailFilter	messageNumber(int messageNumber) Defines message number filter.
EmailFilter	not() Marks next condition to be NOT.
EmailFilter	not(EmailFilter emailFilter) Appends single filter as NOT.
EmailFilter	or() Changes concatenation mode to OR.
EmailFilter	or(EmailFilter... emailFilters) Defines OR group of filters.
protected void	or(javax.mail.search.SearchTerm searchTerm)
EmailFilter	receivedDate(EmailFilter.Operator operator, long milliseconds) Defines filter for received date.
EmailFilter	sentDate(EmailFilter.Operator operator, long milliseconds) Defines filter for sent date.
EmailFilter	size(EmailFilter.Operator comparison, int size) Defines filter for message size.
EmailFilter	subject(java.lang.String subject) Defines filter for SUBJECT field.
EmailFilter	text(java.lang.String pattern) Defines filter on a message body.
EmailFilter	to(java.lang.String toAddress) Defines filter for TO field.

Methods inherited from class java.lang.Object

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

Field Detail

searchTerm

protected javax.mail.search.SearchTerm searchTerm

Constructor Detail

EmailFilter

public EmailFilter()

Method Detail

filter

public static EmailFilter filter()

Creates new Email filter.

subject

public EmailFilter subject(java.lang.String subject)

Defines filter for SUBJECT field.

messageId

public EmailFilter messageId(java.lang.String messageId)

Defines filter for message id.

messageNumber

public EmailFilter messageNumber(int messageNumber)

Defines message number filter.

messageId

public EmailFilter messageId(int messageId)

Defines filter for message id.

from

public EmailFilter from(java.lang.String fromAddress)

Defines filter for FROM field.

to

public EmailFilter to(java.lang.String toAddress)

Defines filter for TO field.

cc

public EmailFilter cc(java.lang.String ccAddress)

Defines filter for CC field.

bcc

public EmailFilter bcc(java.lang.String bccAddress)

Defines filter for BCC field.

flags

public EmailFilter flags(javax.mail.Flags flags,
                         boolean value)

Defines filter for many flags at once.

flag

public EmailFilter flag(javax.mail.Flags.Flag flag,
                        boolean value)

Defines filter for single flag.

receivedDate

public EmailFilter receivedDate(EmailFilter.Operator operator,
                                long milliseconds)

Defines filter for received date.

sentDate

public EmailFilter sentDate(EmailFilter.Operator operator,
                            long milliseconds)

Defines filter for sent date.

text

public EmailFilter text(java.lang.String pattern)

Defines filter on a message body. All parts of the message that are of MIME type "text/*" are searched.

header

public EmailFilter header(java.lang.String headerName,
                          java.lang.String pattern)

Defines filter for header.

size

public EmailFilter size(EmailFilter.Operator comparison,
                        int size)

Defines filter for message size.

and

public EmailFilter and()

Changes concatenation mode to AND.

or

public EmailFilter or()

Changes concatenation mode to OR.

not

public EmailFilter not()

Marks next condition to be NOT.

and

public EmailFilter and(EmailFilter... emailFilters)

Defines AND group of filters.

or

public EmailFilter or(EmailFilter... emailFilters)

Defines OR group of filters.

not

public EmailFilter not(EmailFilter emailFilter)

Appends single filter as NOT.

concat

protected void concat(javax.mail.search.SearchTerm searchTerm)

Concatenates last search term with new one.

and

protected void and(javax.mail.search.SearchTerm searchTerm)

or

protected void or(javax.mail.search.SearchTerm searchTerm)

getSearchTerm

public javax.mail.search.SearchTerm getSearchTerm()

Returns search term.