Collaboration diagram for ILIAS\Mail\Folder\MailFolderSearch:

Public Member Functions
	__construct (private readonly MailFolderData $folder, private readonly MailFilterData $filter, private readonly bool $lucene_enabled,)

	getCount ()
	Get a cached count of mails for the filter criteria. More...

	getUnread ()
	Get a cached count of unread mails for the filter criteria. More...

	getMaiIds ()
	Get the ids of all filtered mails. More...

	getRecords ()
	Get record objects of all filtered mails. More...

	getPagedRecords (int $limit, int $offset, ?MailBoxOrderColumn $order_column, ?string $order_direction)
	Get record objects of filtered and paged mails. More...

	forMailIds (array $ids)
	Inject already filtered mail ids, e.g. More...

Private Member Functions
	getFilteredIds ()
	Get the cached mail ids from a lucene search for selected filter criteria These will be used as additional filter for the mailbox query. More...

Private Attributes
MailBoxQuery	$mailbox_query

ilMailLuceneSearcher	$lucene_searcher = null

ilMailSearchResult	$lucene_result = null

array	$filtered_ids = null

int	$count = null

int	$unread = null

Detailed Description

Search in mail folders.

utilises database and (if active) lucene based searchers
caches results for counting of all or unread mails

Definition at line 35 of file MailFolderSearch.php.

Constructor & Destructor Documentation

◆ __construct()

ILIAS\Mail\Folder\MailFolderSearch::__construct	(	private readonly MailFolderData	$folder,
		private readonly MailFilterData	$filter,
		private readonly bool	$lucene_enabled
	)

Definition at line 45 of file MailFolderSearch.php.

      {
        $this->mailbox_query = (new MailBoxQuery(
            $this->folder->getUserId()
        ))
            ->withFolderId($this->folder->getFolderId())
            ->withSender($this->filter->getSender())
            ->withRecipients($this->filter->getRecipients())
            ->withSubject($this->filter->getSubject())
            ->withBody($this->filter->getBody())
            ->withPeriodStart($this->filter->getPeriodStart())
            ->withPeriodEnd($this->filter->getPeriodEnd())
            ->withIsUnread($this->filter->isUnread())
            ->withIsSystem($this->filter->isSystem())
            ->withHasAttachment($this->filter->hasAttachment());
 
        if ($this->lucene_enabled && (
            ($this->filter->getSender() ?? '') !== '' ||
            ($this->filter->getRecipients() ?? '') !== '' ||
            ($this->filter->getSubject() ?? '') !== '' ||
            ($this->filter->getBody() ?? '') !== '' ||
            ($this->filter->getAttachment() ?? '') !== ''
        )) {
            $query_parser = new ilMailLuceneQueryParser('');
            $query_parser->setFields([
                'title' => $this->filter->getSubject(),
                'content' => $this->filter->getBody(),
                'mattachment' => $this->filter->getAttachment(), // only possible with lucene
                'msender' => $this->filter->getSender(),
            ]);
            $query_parser->parse();
 
            // lucene search wil be done and cached by getFilteredIds
            $this->lucene_result = new ilMailSearchResult();
            $this->lucene_searcher = new ilMailLuceneSearcher($query_parser, $this->lucene_result);
        }
    }

References ILIAS\Repository\filter().

Here is the call graph for this function:

Member Function Documentation

◆ forMailIds()

ILIAS\Mail\Folder\MailFolderSearch::forMailIds ( array $ids )

Inject already filtered mail ids, e.g.

from a selection

Parameters

int[] $ids

Definition at line 172 of file MailFolderSearch.php.

                                          : self
    {
        $clone = clone $this;
        $clone->filtered_ids = $ids;
        return $clone;
    }

◆ getCount()

ILIAS\Mail\Folder\MailFolderSearch::getCount ( )

Get a cached count of mails for the filter criteria.

Definition at line 89 of file MailFolderSearch.php.

                              : int
    {
        if ($this->count === null) {
            $this->count = $this->mailbox_query->withFilteredIds($this->getFilteredIds())->count();
        }
 
        return $this->count;
    }

References ILIAS\Mail\Folder\MailFolderSearch\$count, and ILIAS\Mail\Folder\MailFolderSearch\getFilteredIds().

Here is the call graph for this function:

◆ getFilteredIds()

ILIAS\Mail\Folder\MailFolderSearch::getFilteredIds ( )

private

Get the cached mail ids from a lucene search for selected filter criteria These will be used as additional filter for the mailbox query.

Returns: null|list<int>

Definition at line 156 of file MailFolderSearch.php.

                                     : ?array
    {
        if ($this->filtered_ids === null &&
            $this->lucene_result !== null &&
            $this->lucene_searcher !== null) {
            $this->lucene_searcher->search($this->folder->getUserId(), $this->folder->getFolderId());
            $this->filtered_ids = $this->lucene_result->getIds();
        }
 
        return $this->filtered_ids;
    }

Referenced by ILIAS\Mail\Folder\MailFolderSearch\getCount(), ILIAS\Mail\Folder\MailFolderSearch\getMaiIds(), ILIAS\Mail\Folder\MailFolderSearch\getRecords(), and ILIAS\Mail\Folder\MailFolderSearch\getUnread().

Here is the caller graph for this function:

◆ getMaiIds()

ILIAS\Mail\Folder\MailFolderSearch::getMaiIds ( )

Get the ids of all filtered mails.

Returns: list<int>

Definition at line 114 of file MailFolderSearch.php.

                               : array
    {
        return $this->mailbox_query
            ->withFilteredIds($this->getFilteredIds())
            ->queryMailIds();
    }

References ILIAS\Mail\Folder\MailFolderSearch\getFilteredIds().

Here is the call graph for this function:

◆ getPagedRecords()

ILIAS\Mail\Folder\MailFolderSearch::getPagedRecords	(	int	$limit,
		int	$offset,
		?MailBoxOrderColumn	$order_column,
		?string	$order_direction
	)

Get record objects of filtered and paged mails.

Returns: list<MailRecordData>

Definition at line 136 of file MailFolderSearch.php.

     : array {
        return $this->mailbox_query
            ->withFilteredIds($this->getFilteredIds())
            ->withLimit($limit)
            ->withOffset($offset)
            ->withOrderColumn($order_column)
            ->withOrderDirection($order_direction)
            ->query(true);
    }

◆ getRecords()

ILIAS\Mail\Folder\MailFolderSearch::getRecords ( )

Get record objects of all filtered mails.

Returns: list<MailRecordData>

Definition at line 125 of file MailFolderSearch.php.

                                : array
    {
        return $this->mailbox_query
            ->withFilteredIds($this->getFilteredIds())
            ->query(true);
    }

References ILIAS\Mail\Folder\MailFolderSearch\getFilteredIds().

Here is the call graph for this function:

◆ getUnread()

ILIAS\Mail\Folder\MailFolderSearch::getUnread ( )

Get a cached count of unread mails for the filter criteria.

Definition at line 101 of file MailFolderSearch.php.

                               : int
    {
        if ($this->unread === null) {
            $this->unread = $this->mailbox_query->withFilteredIds($this->getFilteredIds())->countUnread();
        }
 
        return $this->unread;
    }

References ILIAS\Mail\Folder\MailFolderSearch\$unread, and ILIAS\Mail\Folder\MailFolderSearch\getFilteredIds().

Here is the call graph for this function:

Field Documentation

◆ $count

int ILIAS\Mail\Folder\MailFolderSearch::$count = null

private

Definition at line 42 of file MailFolderSearch.php.

Referenced by ILIAS\Mail\Folder\MailFolderSearch\getCount().

◆ $filtered_ids

int[] null ILIAS\Mail\Folder\MailFolderSearch::$filtered_ids = null

private

Definition at line 41 of file MailFolderSearch.php.

◆ $lucene_result

ilMailSearchResult ILIAS\Mail\Folder\MailFolderSearch::$lucene_result = null

private

Definition at line 39 of file MailFolderSearch.php.

◆ $lucene_searcher

ilMailLuceneSearcher ILIAS\Mail\Folder\MailFolderSearch::$lucene_searcher = null

private

Definition at line 38 of file MailFolderSearch.php.

◆ $mailbox_query

MailBoxQuery ILIAS\Mail\Folder\MailFolderSearch::$mailbox_query

private

Definition at line 37 of file MailFolderSearch.php.

◆ $unread

int ILIAS\Mail\Folder\MailFolderSearch::$unread = null

private

Definition at line 43 of file MailFolderSearch.php.

Referenced by ILIAS\Mail\Folder\MailFolderSearch\getUnread().

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

components/ILIAS/Mail/classes/Folder/MailFolderSearch.php

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ forMailIds()

◆ getCount()

◆ getFilteredIds()

◆ getMaiIds()

◆ getPagedRecords()

◆ getRecords()

◆ getUnread()

Field Documentation

◆ $count

◆ $filtered_ids

◆ $lucene_result

◆ $lucene_searcher

◆ $mailbox_query

◆ $unread