MailCommon::SearchRule Class Reference

#include <searchrule.h>

Inheritance diagram for MailCommon::SearchRule:

Public Types
enum	Function {   FuncNone = -1, FuncContains = 0, FuncContainsNot, FuncEquals,   FuncNotEqual, FuncRegExp, FuncNotRegExp, FuncIsGreater,   FuncIsLessOrEqual, FuncIsLess, FuncIsGreaterOrEqual, FuncIsInAddressbook,   FuncIsNotInAddressbook, FuncIsInCategory, FuncIsNotInCategory, FuncHasAttachment,   FuncHasNoAttachment, FuncStartWith, FuncNotStartWith, FuncEndWith,   FuncNotEndWith }
typedef boost::shared_ptr < SearchRule >	Ptr
enum	RequiredPart { Envelope = 0, Header, CompleteMessage }

Public Member Functions
	SearchRule (const QByteArray &field=QByteArray(), Function function=FuncContains, const QString &contents=QString())
	SearchRule (const SearchRule &other)
virtual	~SearchRule ()
virtual void	addQueryTerms (Akonadi::SearchTerm &groupTerm, bool &emptyIsNotAnError) const
const QString	asString () const
QString	contents () const
QByteArray	field () const
Function	function () const
void	generateSieveScript (QStringList &requires, QString &code)
virtual QString	informationAboutNotValidRules () const
virtual bool	isEmpty () const =0
virtual bool	matches (const Akonadi::Item &item) const =0
const SearchRule &	operator= (const SearchRule &other)
QDataStream &	operator>> (QDataStream &) const
virtual SearchRule::RequiredPart	requiredPart () const =0
void	setContents (const QString &contents)
void	setField (const QByteArray &name)
void	setFunction (Function function)
void	writeConfig (KConfigGroup &group, int index) const

Static Public Member Functions
static SearchRule::Ptr	createInstance (const QByteArray &field=0, Function function=FuncContains, const QString &contents=QString())
static SearchRule::Ptr	createInstance (const QByteArray &field, const char *function, const QString &contents)
static SearchRule::Ptr	createInstance (const SearchRule &other)
static SearchRule::Ptr	createInstance (QDataStream &stream)
static SearchRule::Ptr	createInstanceFromConfig (const KConfigGroup &group, int index)

Protected Member Functions
Akonadi::SearchTerm::Condition	akonadiComparator () const
bool	isNegated () const
QString	quote (const QString &content) const

Detailed Description

This class represents one search pattern rule.

Incoming mail is sent through the list of mail filter rules before it is placed in the associated mail folder (usually "inbox"). This class represents one mail filter rule. It is also used to represent a search rule as used by the search dialog and folders.

Definition at line 38 of file searchrule.h.

Member Typedef Documentation

typedef boost::shared_ptr<SearchRule> MailCommon::SearchRule::Ptr

Defines a pointer to a search rule.

Definition at line 44 of file searchrule.h.

Member Enumeration Documentation

enum MailCommon::SearchRule::Function

Describes operators for comparison of field and contents.

If you change the order or contents of the enum: do not forget to change funcConfigNames[], sFilterFuncList and matches() in SearchRule, too. Also, it is assumed that these functions come in pairs of logical opposites (ie. "=" <-> "!=", ">" <-> "<=", etc.).

Enumerator
FuncNone
FuncContains
FuncContainsNot
FuncEquals
FuncNotEqual
FuncRegExp
FuncNotRegExp
FuncIsGreater
FuncIsLessOrEqual
FuncIsLess
FuncIsGreaterOrEqual
FuncIsInAddressbook
FuncIsNotInAddressbook
FuncIsInCategory
FuncIsNotInCategory
FuncHasAttachment
FuncHasNoAttachment
FuncStartWith
FuncNotStartWith
FuncEndWith
FuncNotEndWith

Definition at line 55 of file searchrule.h.

enum MailCommon::SearchRule::RequiredPart

Enumerator
Envelope
Header
CompleteMessage

Definition at line 79 of file searchrule.h.

Constructor & Destructor Documentation

SearchRule::SearchRule ( const QByteArray &  field = QByteArray(), Function  function = FuncContains, const QString &  contents = QString()  )

explicit

Creates new new search rule.

Parameters

field	The field to search in.
function	The function to use for searching.
contents	The contents to search for.

Definition at line 64 of file searchrule.cpp.

SearchRule::SearchRule

(

const SearchRule &

other

)

Creates a new search rule from an other rule.

Definition at line 71 of file searchrule.cpp.

SearchRule::~SearchRule ( )

virtual

Destroys the search rule.

Definition at line 152 of file searchrule.cpp.

Member Function Documentation

virtual void MailCommon::SearchRule::addQueryTerms ( Akonadi::SearchTerm &  groupTerm, bool &  emptyIsNotAnError  ) const

inlinevirtual

Adds query terms to the given term group.

Reimplemented in MailCommon::SearchRuleStatus, MailCommon::SearchRuleString, MailCommon::SearchRuleNumerical, and MailCommon::SearchRuleDate.

Definition at line 246 of file searchrule.h.

Akonadi::SearchTerm::Condition SearchRule::akonadiComparator ( ) const

protected

Converts the rule function into the corresponding Akonadi query operator.

Definition at line 526 of file searchrule.cpp.

const QString SearchRule::asString

(

)

const

Returns the rule as string for debugging purpose.

Definition at line 516 of file searchrule.cpp.

QString SearchRule::contents

(

)

const

Returns the contents of the rule.

Definition at line 511 of file searchrule.cpp.

SearchRule::Ptr SearchRule::createInstance ( const QByteArray &  field = 0, Function  function = FuncContains, const QString &  contents = QString()  )

static

Creates a new search rule of a certain type by instantiating the appropriate subclass depending on the field.

Parameters

field	The field to search in.
function	The function to use for searching.
contents	The contents to search for.

Definition at line 91 of file searchrule.cpp.

SearchRule::Ptr SearchRule::createInstance ( const QByteArray &  field, const char *  function, const QString &  contents  )

static

Creates a new search rule of a certain type by instantiating the appropriate subclass depending on the field.

Parameters

field	The field to search in.
function	The name of the function to use for searching.
contents	The contents to search for.

Definition at line 109 of file searchrule.cpp.

SearchRule::Ptr SearchRule::createInstance ( const SearchRule &  other )

static

Creates a new search rule by cloning an other rule.

Definition at line 116 of file searchrule.cpp.

SearchRule::Ptr SearchRule::createInstance ( QDataStream &  stream )

static

Creates a new search rule by deseralizing its structure from a data stream.

Definition at line 140 of file searchrule.cpp.

SearchRule::Ptr SearchRule::createInstanceFromConfig ( const KConfigGroup &  group, int  index  )

static

Creates a new search rule from a given config group.

Parameters

group	The config group to read the structure from.
index	The identifier that is used to distinguish rules within a single config group.

Note

This function does no validation of the data obtained from the config file. You should call isEmpty yourself if you need valid rules.

Definition at line 121 of file searchrule.cpp.

QByteArray SearchRule::field

(

)

const

Returns the message header field name (without the trailing ':').

There are also six pseudo-headers:

• <message>: Try to match against the whole message.
• <body>: Try to match against the body of the message.
• <any header>: Try to match against any header field.
• <recipients>: Try to match against both To: and Cc: header fields.
• <size>: Try to match against size of message (numerical).
• <age in days>: Try to match against age of message (numerical).
• <status>: Try to match against status of message (status).
• <tag>: Try to match against message tags.

Definition at line 501 of file searchrule.cpp.

SearchRule::Function SearchRule::function

(

)

const

Returns the filter function of the rule.

Definition at line 491 of file searchrule.cpp.

void SearchRule::generateSieveScript	(	QStringList &	requires,
		QString &	code
	)

Definition at line 263 of file searchrule.cpp.

virtual QString MailCommon::SearchRule::informationAboutNotValidRules ( ) const

inlinevirtual

Reimplemented in MailCommon::SearchRuleStatus, MailCommon::SearchRuleString, MailCommon::SearchRuleNumerical, and MailCommon::SearchRuleDate.

Definition at line 250 of file searchrule.h.

virtual bool MailCommon::SearchRule::isEmpty ( ) const

pure virtual

Determines whether the rule is worth considering.

It isn't if either the field is not set or the contents is empty. The calling code should make sure that it's rule list contains only non-empty rules, as matches doesn't check this.

Implemented in MailCommon::SearchRuleStatus, MailCommon::SearchRuleString, MailCommon::SearchRuleNumerical, and MailCommon::SearchRuleDate.

bool SearchRule::isNegated ( ) const

protected

Helper that returns whether the rule has a negated function.

Definition at line 567 of file searchrule.cpp.

virtual bool MailCommon::SearchRule::matches ( const Akonadi::Item &  item ) const

pure virtual

Tries to match the rule against the KMime::Message in the given item.

Returns

true if the rule matched, false otherwise.

Note

Must be implemented by subclasses.

Implemented in MailCommon::SearchRuleStatus, MailCommon::SearchRuleString, MailCommon::SearchRuleNumerical, and MailCommon::SearchRuleDate.

const SearchRule & SearchRule::operator=

(

const SearchRule &

other

)

Initializes this rule with an other rule.

Definition at line 78 of file searchrule.cpp.

QDataStream & SearchRule::operator>>

(

QDataStream &

s

)

const

Definition at line 586 of file searchrule.cpp.

QString MailCommon::SearchRule::quote ( const QString &  content ) const

protected

virtual SearchRule::RequiredPart MailCommon::SearchRule::requiredPart ( ) const

pure virtual

Returns the required part from the item that is needed for the search to operate.

See RequiredPart

Implemented in MailCommon::SearchRuleStatus, MailCommon::SearchRuleString, MailCommon::SearchRuleNumerical, and MailCommon::SearchRuleDate.

void SearchRule::setContents

(

const QString &

contents

)

Set the contents of the rule.

This can be either a substring to search for in or a regexp pattern to match against the header.

Definition at line 506 of file searchrule.cpp.

void SearchRule::setField

(

const QByteArray &

name

)

Sets the message header field name.

Note

Make sure the name contains no trailing ':'.

Definition at line 496 of file searchrule.cpp.

void SearchRule::setFunction

(

Function

function

)

Sets the filter function of the rule.

Definition at line 486 of file searchrule.cpp.

void SearchRule::writeConfig	(	KConfigGroup &	group,
		int	index
	)		const

Saves the object into a given config group.

Parameters

index

The identifier that is used to distinguish rules within a single config group.

Note

This function will happily write itself even when it's not valid, assuming higher layers to Do The Right Thing(TM).

Definition at line 180 of file searchrule.cpp.

---

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

• searchrule.h
• searchrule.cpp