Validate Lucene search results Do access checks, create ref_ids from obj_ids... More...

Collaboration diagram for ilLuceneSearchResultFilter:

Public Member Functions
	addFilter (ilLuceneResultFilter $filter)

	setCandidates (ilLuceneSearchResult $a_ids)
	Set result ids. More...

	getCandidates ()
	get result ids More...

	getUserId ()
	Get user id. More...

	getRequiredPermission ()
	Get required permission. More...

	isLimitReached ()
	Check if search max hits is reached. More...

	getResultIds ()
	get filtered ids More...

	getResultObjIds ()
	get filtered ids More...

	getResults ()
	get results More...

	getMaxHits ()
	get max hits More...

	loadFromDb ()
	Load results from db. More...

	filter ()
	Filter search results. More...

Static Public Member Functions
static	getInstance (int $a_user_id)

Protected Member Functions
	__construct (int $a_user_id)
	Singleton constructor. More...

	checkFilter (int $a_ref_id)
	check appended filter More...

	append (int $a_ref_id, int $a_obj_id)
	Append to filtered results. More...

	isOffsetReached (int $a_current_nr)
	Check if offset is reached. More...

Protected Attributes
int	$user_id

ilLuceneSearchResult	$result = null

array	$checked = []

ilSearchSettings	$settings

ilUserSearchCache	$cache

string	$required_permission = 'visible'

bool	$limit_reached = false

int	$offset = 0

array	$filters = array()

ilAccess	$access

Static Protected Attributes
static ilLuceneSearchResultFilter	$instance = null

Detailed Description

Validate Lucene search results Do access checks, create ref_ids from obj_ids...

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 29 of file class.ilLuceneSearchResultFilter.php.

Constructor & Destructor Documentation

◆ __construct()

ilLuceneSearchResultFilter::__construct ( int $a_user_id )

protected

Singleton constructor.

Definition at line 50 of file class.ilLuceneSearchResultFilter.php.

    {
        global $DIC;
 
        $this->access = $DIC->access();
        $this->user_id = $a_user_id;
        $this->settings = ilSearchSettings::getInstance();
        $this->cache = ilUserSearchCache::_getInstance($this->getUserId());
        $this->offset = $this->settings->getMaxHits() * ($this->cache->getResultPageNumber() - 1);
    }

References $DIC, ilUserSearchCache\_getInstance(), ILIAS\Repository\access(), ilSearchSettings\getInstance(), getUserId(), and ILIAS\Repository\settings().

Here is the call graph for this function:

Member Function Documentation

◆ addFilter()

ilLuceneSearchResultFilter::addFilter ( ilLuceneResultFilter $filter )

Definition at line 69 of file class.ilLuceneSearchResultFilter.php.

                                                           : void
    {
        $this->filters[] = $filter;
    }

◆ append()

ilLuceneSearchResultFilter::append	(	int	$a_ref_id,
		int	$a_obj_id
	)

protected

Append to filtered results.

Definition at line 238 of file class.ilLuceneSearchResultFilter.php.

                                                           : void
    {
        $this->checked[$a_ref_id] = $a_obj_id;
    }

References ILIAS\UI\examples\Symbol\Glyph\Checked\checked().

Referenced by filter().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkFilter()

ilLuceneSearchResultFilter::checkFilter ( int $a_ref_id )

protected

check appended filter

Definition at line 225 of file class.ilLuceneSearchResultFilter.php.

                                                 : bool
    {
        foreach ($this->filters as $filter) {
            if (!$filter->filter($a_ref_id)) {
                return false;
            }
        }
        return true;
    }

Referenced by filter().

Here is the caller graph for this function:

◆ filter()

ilLuceneSearchResultFilter::filter ( )

Filter search results.

Do RBAC checks.

Definition at line 166 of file class.ilLuceneSearchResultFilter.php.

                            : bool
    {
        // get ref_ids and check access
        $counter = 0;
        $offset_counter = 0;
 
        foreach ($this->getCandidates() as $obj_id) {
            // Check referenced objects
            foreach (ilObject::_getAllReferences($obj_id) as $ref_id) {
                // Check filter
                if (!$this->checkFilter($ref_id)) {
                    $this->cache->appendToFailed($ref_id);
                    continue;
                }
 
                // Access failed by prior check
                if ($this->cache->isFailed($ref_id)) {
                    continue;
                }
                // Offset check
                if ($this->cache->isChecked($ref_id) and !$this->isOffsetReached($offset_counter)) {
                    ilLoggerFactory::getLogger('src')->debug('Result was checked');
                    $offset_counter++;
                    break;
                }
 
                // RBAC check
                if ($this->access->checkAccessOfUser(
                    $this->getUserId(),
                    $this->getRequiredPermission(),
                    '',
                    $ref_id,
                    '',
                    $obj_id
                )) {
                    ++$counter;
                    $offset_counter++;
                    $this->append($ref_id, $obj_id);
                    $this->cache->appendToChecked($ref_id, $obj_id);
                    break;
                } else {
                    $this->cache->appendToFailed($ref_id);
                }
            }
            if ($counter >= $this->settings->getMaxHits()) {
                $this->limit_reached = true;
                $this->cache->setResults($this->getResultIds());
                $this->cache->save();
                return false;
            }
        }
        $this->cache->setResults($this->getResultIds());
        $this->cache->save();
        return true;
    }

References $counter, $ref_id, ilObject\_getAllReferences(), ILIAS\Repository\access(), append(), checkFilter(), getCandidates(), ilLoggerFactory\getLogger(), getResultIds(), and ILIAS\Repository\settings().

Here is the call graph for this function:

◆ getCandidates()

ilLuceneSearchResultFilter::getCandidates ( )

get result ids

Definition at line 85 of file class.ilLuceneSearchResultFilter.php.

                                   : ?ilLuceneSearchResult
    {
        return $this->result;
    }

References $result.

Referenced by filter().

Here is the caller graph for this function:

◆ getInstance()

static ilLuceneSearchResultFilter::getInstance ( int $a_user_id )

static

Definition at line 61 of file class.ilLuceneSearchResultFilter.php.

                                                      : ilLuceneSearchResultFilter
    {
        if (self::$instance == null) {
            return self::$instance = new ilLuceneSearchResultFilter($a_user_id);
        }
        return self::$instance;
    }

References $instance.

Referenced by ilLuceneSearchGUI\performSearch(), ilSoapObjectAdministration\searchObjects(), and ilLuceneSearchGUI\showSavedResults().

Here is the caller graph for this function:

◆ getMaxHits()

ilLuceneSearchResultFilter::getMaxHits ( )

get max hits

Definition at line 149 of file class.ilLuceneSearchResultFilter.php.

                                : int
    {
        return $this->settings->getMaxHits();
    }

References ILIAS\Repository\settings().

Here is the call graph for this function:

◆ getRequiredPermission()

ilLuceneSearchResultFilter::getRequiredPermission ( )

Get required permission.

Definition at line 101 of file class.ilLuceneSearchResultFilter.php.

                                           : string
    {
        return $this->required_permission;
    }

References $required_permission.

◆ getResultIds()

ilLuceneSearchResultFilter::getResultIds ( )

get filtered ids

Returns: int[] array of filtered ref_ids

Definition at line 119 of file class.ilLuceneSearchResultFilter.php.

                                  : array
    {
        return $this->checked;
    }

References $checked.

Referenced by filter().

Here is the caller graph for this function:

◆ getResultObjIds()

ilLuceneSearchResultFilter::getResultObjIds ( )

get filtered ids

Returns: int[] array of filtered obj_ids

Definition at line 128 of file class.ilLuceneSearchResultFilter.php.

                                     : array
    {
        $obj_ids = [];
        foreach ($this->checked as $obj_id) {
            $obj_ids[] = $obj_id;
        }
        return $obj_ids;
    }

References ILIAS\UI\examples\Symbol\Glyph\Checked\checked().

Here is the call graph for this function:

◆ getResults()

ilLuceneSearchResultFilter::getResults ( )

get results

Returns: int[] array of ids

Definition at line 141 of file class.ilLuceneSearchResultFilter.php.

    {
        return $this->checked;
    }

References $checked.

◆ getUserId()

ilLuceneSearchResultFilter::getUserId ( )

Get user id.

Definition at line 93 of file class.ilLuceneSearchResultFilter.php.

                               : int
    {
        return $this->user_id;
    }

References $user_id.

Referenced by __construct().

Here is the caller graph for this function:

◆ isLimitReached()

ilLuceneSearchResultFilter::isLimitReached ( )

Check if search max hits is reached.

Returns: bool max hits reached

Definition at line 110 of file class.ilLuceneSearchResultFilter.php.

                                    : bool
    {
        return $this->limit_reached;
    }

References $limit_reached.

◆ isOffsetReached()

ilLuceneSearchResultFilter::isOffsetReached ( int $a_current_nr )

protected

Check if offset is reached.

Parameters

int $a_current_nr Current result number

Returns: bool

Definition at line 248 of file class.ilLuceneSearchResultFilter.php.

                                                         : bool
    {
        return !($a_current_nr < $this->offset);
    }

References $offset.

◆ loadFromDb()

ilLuceneSearchResultFilter::loadFromDb ( )

Load results from db.

Definition at line 157 of file class.ilLuceneSearchResultFilter.php.

                                : void
    {
        $this->checked = $this->cache->getResults();
    }

References ILIAS\UI\examples\Symbol\Glyph\Checked\checked().

Here is the call graph for this function:

◆ setCandidates()

ilLuceneSearchResultFilter::setCandidates ( ilLuceneSearchResult $a_ids )

Set result ids.

Definition at line 77 of file class.ilLuceneSearchResultFilter.php.

                                                              : void
    {
        $this->result = $a_ids;
    }

Field Documentation

◆ $access

ilAccess ilLuceneSearchResultFilter::$access

protected

Definition at line 44 of file class.ilLuceneSearchResultFilter.php.

◆ $cache

ilUserSearchCache ilLuceneSearchResultFilter::$cache

protected

Definition at line 37 of file class.ilLuceneSearchResultFilter.php.

◆ $checked

array ilLuceneSearchResultFilter::$checked = []

protected

Definition at line 35 of file class.ilLuceneSearchResultFilter.php.

Referenced by getResultIds(), and getResults().

◆ $filters

array ilLuceneSearchResultFilter::$filters = array()

protected

Definition at line 42 of file class.ilLuceneSearchResultFilter.php.

◆ $instance

ilLuceneSearchResultFilter ilLuceneSearchResultFilter::$instance = null

staticprotected

Definition at line 31 of file class.ilLuceneSearchResultFilter.php.

Referenced by getInstance().

◆ $limit_reached

bool ilLuceneSearchResultFilter::$limit_reached = false

protected

Definition at line 39 of file class.ilLuceneSearchResultFilter.php.

Referenced by isLimitReached().

◆ $offset

int ilLuceneSearchResultFilter::$offset = 0

protected

Definition at line 40 of file class.ilLuceneSearchResultFilter.php.

Referenced by isOffsetReached().

◆ $required_permission

string ilLuceneSearchResultFilter::$required_permission = 'visible'

protected

Definition at line 38 of file class.ilLuceneSearchResultFilter.php.

Referenced by getRequiredPermission().

◆ $result

ilLuceneSearchResult ilLuceneSearchResultFilter::$result = null

protected

Definition at line 34 of file class.ilLuceneSearchResultFilter.php.

Referenced by getCandidates().

◆ $settings

ilSearchSettings ilLuceneSearchResultFilter::$settings

protected

Definition at line 36 of file class.ilLuceneSearchResultFilter.php.

◆ $user_id

int ilLuceneSearchResultFilter::$user_id

protected

Definition at line 33 of file class.ilLuceneSearchResultFilter.php.

Referenced by getUserId().

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

components/ILIAS/Search/classes/Lucene/class.ilLuceneSearchResultFilter.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addFilter()

◆ append()

◆ checkFilter()

◆ filter()

◆ getCandidates()

◆ getInstance()

◆ getMaxHits()

◆ getRequiredPermission()

◆ getResultIds()

◆ getResultObjIds()

◆ getResults()

◆ getUserId()

◆ isLimitReached()

◆ isOffsetReached()

◆ loadFromDb()

◆ setCandidates()

Field Documentation

◆ $access

◆ $cache

◆ $checked

◆ $filters

◆ $instance

◆ $limit_reached

◆ $offset

◆ $required_permission

◆ $result

◆ $settings

◆ $user_id