Message search terms for the Jakarta Mail API. This package defines classes that can be used to construct a search expression to search a folder for messages matching the expression; see the
Note that the exact search capabilities depend on the protocol, provider, and server in use. For the POP3 protocol, all searching is done on the client side using the Jakarta Mail classes. For IMAP, all searching is done on the server side and is limited by the search capabilities of the IMAP protocol and the IMAP server being used. For example, IMAP date based searches have only day granularity.
In general, all of the string patterns supported by search terms are just simple strings; no regular expressions are supported.
Class Summary Class Description AddressStringTermThis abstract class implements string comparisons for Message addresses. AddressTermThis class implements Message Address comparisons. AndTermThis class implements the logical AND operator on individual SearchTerms. BodyTermThis class implements searches on a message body. ComparisonTermThis class models the comparison operator. DateTermThis class implements comparisons for Dates FlagTermThis class implements comparisons for Message Flags. FromStringTermThis class implements string comparisons for the From Address header. FromTermThis class implements comparisons for the From Address header. HeaderTermThis class implements comparisons for Message headers. IntegerComparisonTermThis class implements comparisons for integers. MessageIDTermThis term models the RFC822 "MessageId" - a message-id for Internet messages that is supposed to be unique per message. MessageNumberTermThis class implements comparisons for Message numbers. NotTermThis class implements the logical NEGATION operator. OrTermThis class implements the logical OR operator on individual SearchTerms. ReceivedDateTermThis class implements comparisons for the Message Received date RecipientStringTermThis class implements string comparisons for the Recipient Address headers. RecipientTermThis class implements comparisons for the Recipient Address headers. SearchTermSearch criteria are expressed as a tree of search-terms, forming a parse-tree for the search expression. SentDateTermThis class implements comparisons for the Message SentDate. SizeTermThis class implements comparisons for Message sizes. StringTermThis class implements the match method for Strings. SubjectTermThis class implements comparisons for the message Subject header.
Exception Summary Exception Description SearchExceptionThe exception thrown when a Search expression could not be handled.