MailCommon::SearchRule

Search for usage in LXR

#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
}
 
using Ptr = std::shared_ptr<SearchRule>
 
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 &requireModules, QString &code)
 
virtual QString informationAboutNotValidRules () const
 
virtual bool isEmpty () const =0
 
virtual bool matches (const Akonadi::Item &item) const =0
 
const SearchRuleoperator= (const SearchRule &other)
 
QDataStreamoperator>> (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, const char *function, const QString &contents)
 
static SearchRule::Ptr createInstance (const QByteArray &field=QByteArray(), Function function=FuncContains, const QString &contents=QString())
 
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
 

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 23 of file searchrule.h.

Member Typedef Documentation

◆ Ptr

using MailCommon::SearchRule::Ptr = std::shared_ptr<SearchRule>

Defines a pointer to a search rule.

Definition at line 29 of file searchrule.h.

Member Enumeration Documentation

◆ 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.).

Definition at line 40 of file searchrule.h.

◆ RequiredPart

Possible required parts.

Enumerator
Envelope 

Envelope.

Header 

Header.

CompleteMessage 

Whole message.

Definition at line 68 of file searchrule.h.

Constructor & Destructor Documentation

◆ SearchRule() [1/2]

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

Creates new new search rule.

Parameters
fieldThe field to search in.
functionThe function to use for searching.
contentsThe contents to search for.

Definition at line 52 of file searchrule.cpp.

◆ SearchRule() [2/2]

SearchRule::SearchRule ( const SearchRule & other)
default

Creates a new search rule from an other rule.

◆ ~SearchRule()

SearchRule::~SearchRule ( )
virtualdefault

Destroys the search rule.

Member Function Documentation

◆ addQueryTerms()

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

Adds query terms to the given term group.

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

Definition at line 231 of file searchrule.h.

◆ akonadiComparator()

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

Converts the rule function into the corresponding Akonadi query operator.

Definition at line 525 of file searchrule.cpp.

◆ asString()

const QString SearchRule::asString ( ) const
nodiscard

Returns the rule as string for debugging purpose.

Definition at line 516 of file searchrule.cpp.

◆ contents()

QString SearchRule::contents ( ) const
nodiscard

Returns the contents of the rule.

Definition at line 511 of file searchrule.cpp.

◆ createInstance() [1/4]

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
fieldThe field to search in.
functionThe name of the function to use for searching.
contentsThe contents to search for.

Definition at line 96 of file searchrule.cpp.

◆ createInstance() [2/4]

SearchRule::Ptr SearchRule::createInstance ( const QByteArray & field = QByteArray(),
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
fieldThe field to search in.
functionThe function to use for searching.
contentsThe contents to search for.

Definition at line 76 of file searchrule.cpp.

◆ createInstance() [3/4]

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

Creates a new search rule by cloning an other rule.

Definition at line 101 of file searchrule.cpp.

◆ createInstance() [4/4]

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

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

Definition at line 125 of file searchrule.cpp.

◆ createInstanceFromConfig()

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

Creates a new search rule from a given config group.

Parameters
groupThe config group to read the structure from.
indexThe 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 106 of file searchrule.cpp.

◆ field()

QByteArray SearchRule::field ( ) const
nodiscard

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.

◆ function()

SearchRule::Function SearchRule::function ( ) const

Returns the filter function of the rule.

Definition at line 491 of file searchrule.cpp.

◆ generateSieveScript()

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

Definition at line 246 of file searchrule.cpp.

◆ informationAboutNotValidRules()

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

Definition at line 238 of file searchrule.h.

◆ isEmpty()

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::SearchRuleNumerical, and MailCommon::SearchRuleStatus.

◆ isNegated()

bool SearchRule::isNegated ( ) const
nodiscardprotected

Helper that returns whether the rule has a negated function.

Definition at line 566 of file searchrule.cpp.

◆ matches()

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::SearchRuleNumerical, and MailCommon::SearchRuleStatus.

◆ operator=()

const SearchRule & SearchRule::operator= ( const SearchRule & other)

Initializes this rule with an other rule.

Definition at line 63 of file searchrule.cpp.

◆ operator>>()

QDataStream & SearchRule::operator>> ( QDataStream & s) const

Definition at line 585 of file searchrule.cpp.

◆ requiredPart()

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::SearchRuleNumerical, and MailCommon::SearchRuleStatus.

◆ setContents()

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.

◆ setField()

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.

◆ setFunction()

void SearchRule::setFunction ( Function function)

Sets the filter function of the rule.

Definition at line 486 of file searchrule.cpp.

◆ writeConfig()

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

Saves the object into a given config group.

Parameters
groupThe config group.
indexThe 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 163 of file searchrule.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri Dec 6 2024 12:02:04 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.